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


Création d'un projet avec l'assistant Projet

  Restrictions	  Etape suivante	  Rubriques connexes

Pour créer un projet avec l'assistant Projet :

1	Cliquez sur [image] dans la barre d'outils ou cliquez deux fois sur le noeud Projets racine. Une boîte de dialogue apparaît et vous demande si vous voulez créer un projet avec l'assistant Projet ou via la boîte de dialogue Nouveau projet.

2	Cliquez sur le bouton d'option Assistant Projet.

3	Procédez comme indiqué pour créer un projet autonome. Pour plus d'informations, reportez-vous à l'aide sur l'assistant Projet.


Création d'un projet sans l'assistant Projet

  Restrictions	  Etape suivante	  Rubriques connexes

Pour créer un projet sans l'assistant Projet :

1	Cliquez sur [image] dans la barre d’outils pour afficher la boîte de dialogue de nouveau projet.

2	Si nécessaire, passez au répertoire où vous voulez stocker votre fichier de projet. Naviguez comme à l'accoutumée en utilisant la boîte de dialogue de fichiers de votre système.

3	Entrez le nom de votre projet dans le champ de texte Nom de fichier. Il n'y a pas d'extension par défaut ou obligatoire.

Le système crée, dans le répertoire indiqué, un fichier de projet ayant le nom que vous avez indiqué.


Restrictions : Création d'un projet

Vous ne pouvez enregistrer de fichiers de projet que dans votre système de fichiers. Vous ne pouvez pas en enregistrer dans une base de données.


Ajout d'un type aux bases de registres utilisateur ou globale

  Etape suivante	  Rubriques connexes

Pour ajouter un type à vos bases de registres utilisateur ou globale :

1	Sélectionnez Outils [image] Assistant Type de module.

2	Suivez les instructions des écrans de l'assistant Type de module en vous laissant guider par l'aide.


Ajout d'une action à un élément

  Exemple	  Etape suivante	      Rubriques connexes

Pour ajouter une action à un élément :

1	Dans le Navigateur de projet, sélectionnez l'élément à modifier. Conseil

2	Dans le menu instantané, sélectionnez Nouvelle action pour afficher la boîte de dialogue correspondante.

3	Puis :

•	Indiquez un nom d'action dans le champ de texte Nom. Ou, pour développer la définition d'une action existante [image] c'est-à-dire créer une action Génération pour un nouveau compilateur [image] sélectionnez l'action dans la liste déroulante.

•	(Facultatif) Entrez la description de l'action dans le champ texte Description. Si vous ajoutez cette action au menu instantané, la description entrée devient l'option de menu correspondante. Si vous décidez de ne pas entrer de description, le nom de l'action apparaît dans le menu instantané. Pour utiliser des touches accélératrices, marquez la touche à utiliser en insérant une esperluette (&) devant la lettre correspondante. Par exemple, si vous entrez « Im&primer » comme description, la touche accélératrice est le « P ». Pour insérer dans la commande le caractère esperluette sans marquer de touche accélératrice, doublez-le (&&).

•	Choisissez dans la liste déroulante Agit sur type le type d'élément sur lequel l'action doit porter.

Remarque : Si vous ajoutez une action à un type dans la base de registres utilisateur, tous les éléments de ce type qui font référence à la base de registres utilisateur héritent de la nouvelle action. Si vous ajoutez une action à un élément, elle ne s'applique qu'à cet élément, sauf si ce dernier est un projet ou un sous-projet. L'action est alors appliquée à tous les éléments du projet appartenant au type indiqué dans le champ Agit sur type.

•	Cliquez sur la case à cocher Ajouter au menu instantané pour inclure l'action dans le menu instantané associé au type ou à l'élément. Si vous choisissez de ne pas inclure l'action dans le menu instantané, elle sera inaccessible ; vous pouvez utiliser cette procédure pour masquer des actions sans les supprimer.

4	Définissez l'action dans la zone de texte. La définition de l'action est la commande lancée pour l'appeler. Vous pouvez entrer directement la chaîne de commande dans le champ texte ou utiliser les onglets suivants : Remarque

•	Cliquez sur l'onglet Application et sélectionnez l'application à utiliser pour exécuter l'action dans la liste ou la boîte de dialogue Parcourir qui apparaît. Cliquez sur Insérer dans commande. L'exécutable que vous sélectionnez remplace le texte sélectionné dans la zone de texte Commande ou est inséré à l'emplacement du curseur.

Après avoir ajouté l'exécutable, n'oubliez pas d'ajouter les paramètres requis (ou facultatifs) dans la chaîne de commande. Si vous ne les connaissez pas, consultez le manuel d'utilisation approprié. (Vous pouvez utiliser les macros prédéfinies de Project Builder pour représenter certains paramètres, tels que {n} pour le nom de fichier.)

•	Cliquez sur l'onglet Macros et sélectionnez une macro dans la liste répertoriant toutes les macros intégrées, toutes les macros prédéfinies et toutes les macros que vous avez définies pour l'élément. Cliquez sur Insérer dans commande. La macro sélectionnée remplace le texte sélectionné dans la zone de texte Commande ou est insérée à l'emplacement du curseur. Elle est développée lorsque l'action est appelée.

•	L'onglet Insérer élément n'est disponible que pour les actions globales (actions Génération, Livrer ou de contrôle de source) et il est désactivé pour tous les autres types d'action. Toutefois, si vous ajoutez une action pour écraser ou développer l'une des actions globales, cliquez sur cet onglet pour sélectionner le type d'élément d'entrée requis.

Un élément d'entrée est le fichier source sur lequel porte l'action. Par exemple, les fichiers .fmb (ou fichiers de type Document Forms) sont les éléments d'entrée requis pour générer des fichiers .fmx. Si l'élément d'entrée voulu n'apparaît pas, définissez-en un ou modifiez un élément existant en cliquant sur Ajouter à la liste ou sur Edition. Lorsque vous avez sélectionné l'élément d'entrée voulu, cliquez sur Insérer dans commande. L'élément d'entrée sélectionné remplace le texte sélectionné dans la zone de texte Commande ou est inséré à l'emplacement du curseur. Dans la zone de texte Commande, l'élément d'entrée apparaît sous forme d'un chiffre correspondant à son code d'entrée sur l'onglet Insérer élément. Un seul chiffre apparaît pour chaque élément d'entrée, même si l'action accepte plusieurs entrées.

5	Cliquez sur OK pour fermer la boîte de dialogue, et associer l'action au type ou à l'élément.


Ajout d'une action à un type

  Rubriques connexes

Pour ajouter une action à un type :

1	Dans le Navigateur de projet, sélectionnez le type à modifier. Conseil

2	Sélectionnez Outils [image] Assistant Type de module.

3	Cliquez sur l'onglet Actions.

4	Cliquez sur Ajouter pour afficher la boîte de dialogue Nouvelle/Editer action.

5	Puis :

•	Indiquez un nom d'action dans le champ de texte Nom. Ou, pour développer la définition d'une action existante [image] c'est-à-dire créer une action Génération pour un nouveau compilateur [image] sélectionnez l'action dans la liste déroulante.

•	(Facultatif) Entrez la description de l'action dans le champ texte Description. Si vous ajoutez cette action au menu instantané, la description entrée devient l'option de menu correspondante. Si vous décidez de ne pas entrer de description, le nom de l'action apparaît dans le menu instantané. Pour utiliser des touches accélératrices, marquez la touche à utiliser en insérant une esperluette (&) devant la lettre correspondante. Par exemple, si vous entrez « Im&primer » comme description, la touche accélératrice est le « P ». Pour insérer dans la commande le caractère esperluette sans marquer de touche accélératrice, doublez-le (&&).

•	Cliquez sur la case à cocher Ajouter au menu instantané pour inclure l'action dans le menu instantané associé au type ou à l'élément. Si vous choisissez de ne pas inclure l'action dans le menu instantané, elle sera inaccessible ; vous pouvez utiliser cette procédure pour masquer des actions sans les supprimer.

4	Définissez l'action dans la zone de texte. La définition de l'action est la commande lancée pour l'appeler. Vous pouvez entrer directement la chaîne de commande dans le champ texte ou utiliser les onglets suivants : Remarque

•	Cliquez sur l'onglet Application et sélectionnez l'application à utiliser pour exécuter l'action dans la liste ou la boîte de dialogue Parcourir qui apparaît. Cliquez sur Insérer dans commande. L'exécutable que vous sélectionnez remplace le texte sélectionné dans la zone de texte Commande ou est inséré à l'emplacement du curseur.

Après avoir ajouté l'exécutable, n'oubliez pas d'ajouter les paramètres requis (ou facultatifs) dans la chaîne de commande. Si vous ne les connaissez pas, consultez le manuel d'utilisation approprié. (Vous pouvez utiliser les macros prédéfinies de Project Builder pour représenter certains paramètres, tels que {n} pour le nom de fichier.)

•	Cliquez sur l'onglet Macros et sélectionnez une macro dans la liste répertoriant toutes les macros intégrées, toutes les macros prédéfinies et toutes les macros que vous avez définies pour l'élément. Cliquez sur Insérer dans commande. La macro sélectionnée remplace le texte sélectionné dans la zone de texte Commande ou est insérée à l'emplacement du curseur. Elle est développée lorsque l'action est appelée.

•	L'onglet Entrées n'est disponible que pour les actions globales (actions Génération, Livrer ou de contrôle de source) et il est désactivé pour tous les autres types d'action. Toutefois, si vous ajoutez une action pour écraser ou développer l'une des actions globales, cliquez sur cet onglet pour sélectionner le type d'élément d'entrée requis.

Un élément d'entrée est le fichier source sur lequel porte l'action. Par exemple, les fichiers .fmb (ou fichiers de type Document Forms) sont les éléments d'entrée requis pour générer des fichiers .fmx. Si l'élément d'entrée voulu n'apparaît pas, définissez-en un ou modifiez un élément existant en cliquant sur Ajouter à la liste ou sur Edition. Lorsque vous avez sélectionné l'élément d'entrée voulu, cliquez sur Insérer dans commande. L'élément d'entrée sélectionné remplace le texte sélectionné dans la zone de texte Commande ou est inséré à l'emplacement du curseur. Dans la zone de texte Commande, l'élément d'entrée apparaît sous forme d'un chiffre correspondant à son code d'entrée sur l'onglet Insérer élément. Un seul chiffre apparaît pour chaque élément d'entrée, même si l'action accepte plusieurs entrées.

5	Cliquez sur OK pour fermer la boîte de dialogue et revenir à l'assistant Type de module.

6	Pour définir une action comme action par défaut, mettez-la en surbrillance dans l'onglet Actions, puis cliquez sur En faire la valeur par défaut.


Avant de sélectionner un type ou un élément, soyez sûr de comprendre toutes les implications de l'héritage. Par exemple, au lieu de définir la même action pour plusieurs fichiers du même type, il suffit de définir l'action pour le type lui-même.


Lorsque vous créez vos actions et vos macros, souvenez-vous que la syntaxe des commandes dépend de votre plate-forme. Le transfert de telles actions vers une autre plate-forme exige la modification de la syntaxe pour qu'elle soit conforme aux règles de la nouvelle plate-forme. D'éventuels conflits peuvent être dus, entre autres, à la longueur des noms de fichiers, à la distinction maj/min, ainsi qu'à l'utilisation des caractères / et \.

Pour plus d'informations, reportez-vous à la section de l'aide en ligne intitulée Informations propres aux plates-formes Forms ou Reports Developer.


Exemple : Ajout d'une action à un type

Project Builder fournit une action Ouvrir pour la plupart des types de fichier. Toutefois, supposez que cette action, associée à des fichiers texte, n'appelle pas l'éditeur que vous voulez utiliser ; par exemple, vous préférez WordPad à Notepad ou emacs à vi. Vous pouvez associer une action Edition à des fichiers texte et choisir Edition dans le menu instantané au lieu de l'option Ouvrir.

1	Assurez-vous que vous avez une copie du type Fichiers texte dans votre base de registres utilisateur. Sélectionnez-la. Remarque

2	Sélectionnez Outils [image] Assistant Type de module. Comme vous avez choisi le type Fichiers texte à l'étape 1, certains champs de l'assistant sont remplis avec les informations adéquates.

3	Cliquez sur l'onglet Actions, puis sur Ajouter pour afficher la boîte de dialogue Ajout d'actions.

4	Entrez Edition dans le champ Nom de la boîte de dialogue Ajout d'actions.

5	Sélectionnez Texte dans la liste déroulante Agit sur type.

6	Ajoutez une description. Cette description constituera l'entrée du menu instantané.

7	Assurez-vous que vous avez sélectionné Ajouter au menu instantané pour que votre description apparaisse dans ce menu.

8	Dans la zone de texte Commande, indiquez la commande d'appel de l'outil à utiliser, ainsi qu'un nom de fichier du type approprié. Pour cela, vous devrez disposer d'une application (chaîne d'appel sur la ligne de commande) et d'une macro (fournissant les paramètres ou options nécessaires, comme le nom du fichier à ouvrir).

Dans cet exemple, vous souhaitez indiquer WordPad, mais vous ignorez où se trouve l'exécutable. Cliquez sur l'onglet Application pour afficher une liste des exécutables ayant déjà été sélectionnés. Si WordPad ne figure pas dans cette liste, cliquez sur Parcourir et effectuez une recherche dans le système de fichiers. Lorsque vous avez trouvé l'exécutable de WordPad, sélectionnez-le et cliquez sur Ouvrir pour fermer la boîte de dialogue et insérer le nom de l'exécutable dans la zone de texte Commande.

Indiquez ensuite à WordPad le fichier à ouvrir. Entrez un espace, puis cliquez sur l'onglet Macro pour afficher la liste des macros prédéfinies. La macro {n}, lorsqu'elle est développée, correspond au nom de fichier complet de l'élément sur lequel porte la macro. Cliquez deux fois dessus pour l'insérer dans la définition de l'action.

9	Cliquez sur OK pour fermer la boîte de dialogue et revenir à l'onglet Action de l'assistant Type de module.

10	Pour définir l'action Edition comme action par défaut, sélectionnez-la, puis cliquez sur En faire la valeur par défaut. Dorénavant, lorsque vous sélectionnez un fichier texte dans le Navigateur de projet et cliquez deux fois dessus, il est ouvert dans WordPad.


Si vous n'êtes pas l’administrateur du projet, il est déconseillé de modifier la définition de type figurant dans la base de registres globale.


Création d'une macro

  Exemple	  Etape suivante	  Rubriques connexes

Pour créer une macro :

1	Dans le Navigateur de projet, vérifiez que l'élément auquel vous voulez appliquer la macro est sélectionné.

2	Choisissez Nouvelle macro dans le menu instantané pour afficher la boîte de dialogue correspondante.

3	Entrez le nom de votre macro dans la zone de texte Nom.

4	Sélectionnez le type de la macro dans la liste déroulante Type. Tous les types de macro, à l'exception de Texte statique, affichent au cours de l'exécution un menu instantané invitant l'utilisateur à entrer une valeur.

5	Entrez la définition de la macro dans la zone de texte Valeur.

•	Si votre macro comporte un nom de fichier, cliquez sur Insérer nom de fichier pour afficher la boîte de dialogue Insérer application de votre système de fichiers.

•	Si votre macro peut comporter des macros imbriquées ou déjà définies, cliquez sur Insérer macro et sélectionnez dans la liste la ou les macros à inclure. Remarque

6	Entrez une valeur dans tous les champs supplémentaires requis par le type de macro sélectionné à l'étape 4.

7	Cliquez sur OK pour créer votre macro et fermer la boîte de dialogue.


Exemple : Création d'une macro

Supposons que vous êtes responsable du développement d'affichages Graphics Builder pour distribution interne et externe. La distribution interne implique l'exportation des affichages vers des bitmaps en vue de leur intégration dans des états imprimés, alors que la distribution externe implique l'exportation des affichages vers des fichiers .gif afin qu'ils soient affichés sur le site web de votre entreprise.

Vous pouvez créer une macro contenant les options d'exécution de Graphics Builder pour modifier l'action Exécuter associée à un affichage. Pour générer un bitmap, définissez la macro de manière à demander l'export vers un fichier bitmap. Pour générer un fichier .gif, définissez la macro en demandant l'export vers un fichier .gif.

Pour cela :

1	Assurez-vous que vous avez une copie du type Exécutable Graphics dans votre base de registres utilisateur. Sélectionnez-la. Note

2	Choisissez Nouvelle macro dans le menu instantané pour afficher la boîte de dialogue correspondante.

3	Entrez EXPORT dans le champ de texte Nom (qui apparaîtra automatiquement en majuscules).

4	Sélectionnez Texte statique dans la liste déroulante Type.

5	Définissez votre macro dans la zone de texte Valeur. Voici un exemple :

exportimage={b}.gif

Notez que, dans cet exemple, exportimage est l'option d'exécution, {b}est le nom de fichier de base et .gif est l'extension correspondant au format d'export à utiliser. Le nom de fichier de base est lui-même une macro, prédéfinie par Project Builder. Pour l'insérer dans la définition de votre macro, cliquez sur Insérer macro pour afficher la liste des macros prédéfinies ; sélectionnez la macro à ajouter, puis cliquez sur OK. Elle est insérée à l'emplacement du curseur.

6	Cliquez sur OK.

Vous pouvez désormais utiliser votre macro EXPORT pour modifier l'action Exécuter associée aux fichiers de type Exécutables graphiques (en d'autres termes, les affichages). Telle qu'elle est écrite, la macro exporte les fichiers vers des fichiers .gif. Lorsque vous voulez exporter des affichages vers des fichiers bitmaps, éditez simplement la macro EXPORT et changez l'extension du fichier en .bmp.


Ajout d'un fichier à un projet ou à un sous-projet

  Etape suivante	  Rubriques connexes

Pour ajouter un fichier à un projet ou à un sous-projet :

1	Dans le Navigateur de projet, assurez-vous que le noeud du projet auquel vous ajoutez les fichiers est sélectionné.

2	Cliquez sur [image] dans la barre d'outils pour afficher la boîte de dialogue d'ajout de fichiers à un projet.

3	Si nécessaire, passez au répertoire contenant les fichiers que vous voulez ajouter.

4	Sélectionnez les fichiers en utilisant la méthode de sélection de fichiers séquentiels ou non séquentiels de votre plate-forme, si nécessaire.

5	Cliquez sur Ouvrir pour ajouter les fichiers à votre projet ou à votre sous-projet.

Remarque : Sous Windows, vous ne pouvez sélectionner des fichiers que dans un répertoire à la fois. En outre, Windows limite le nombre de fichiers que vous pouvez sélectionner dans la boîte de dialogue de fichiers. Ce nombre dépend de la longueur des noms de fichiers. Vous pouvez sélectionner environ 250 fichiers ayant des noms longs, et environ 600 fichiers ayant des noms limités à la notation « 8.3 ».

Si vous sélectionnez trop de fichiers, aucun ne sera ajouté à votre projet. Cliquez sur [image] pour afficher la boîte de dialogue de fichiers, diminuez le nombre de fichiers à ajouter et répétez l’opération si nécessaire.


Définition d'une chaîne de connexion

  Etape suivante	  Rubriques connexes

Pour définir une chaîne de connexion :

1	Sélectionnez le noeud Connexions dans le Navigateur de projet et choisissez Nouvelle connexion dans le menu instantané pour afficher la boîte de dialogue correspondante.

2	Entrez un titre dans la zone de texte Titre. Le titre fournit le libellé de la chaîne de connexion dans le Navigateur de projet.

3	Entrez un nom utilisateur, un mot de passe et une chaîne de connexion dans les zones de texte correspondantes. La syntaxe est généralement la suivante :

username/password@network_protocol:network_node:source_name

Notez que si vous vous connectez à une source de données ODBC, la syntaxe est la suivante :

nomutilisateur/motdepasse@ODBC:sourcededonnées[:nombasededonnées]

Si nombasededonnées n'est pas précisé, la source de données actuelle de la connexion ODBC est utilisée.

4	(Etape facultative) Ajoutez des commentaires dans le champ de texte Commentaires.

5	Cliquez sur OK pour valider le dialogue et ajouter la connexion à votre liste de connexions possibles.

Remarque : Vous pouvez accéder aux mots de passe stockés dans les connexions de projet en exportant le projet et en consultant le fichier d'export résultant sous un éditeur de texte.


Modification de la chaîne de connexion d'un élément

  Etape suivante	  Rubriques connexes

Pour changer la chaîne de connexion d'un élément :

1	Dans le Navigateur de projet, développez le noeud Connexions. Sélectionnez la connexion que vous voulez associer à l'élément.

2	Faites glisser la connexion et déposez-la sur l'élément.

La nouvelle chaîne de connexion est insérée dans les actions appropriées pour tous les éléments du projet (si vous l'avez attribuée à un projet) ou de l'élément de projet.

Vous pouvez aussi sélectionner un projet ou un élément de projet, choisir Outils [image] Palette de propriétés, puis cliquer sur le champ Nom sous l'en-tête Connexion. Une liste déroulante répertoriant les connexions actuellement définies apparaît ; sélectionnez la connexion à appliquer au projet ou à l'élément de projet.


Modification d'un type dans les bases de registres utilisateur ou globale

  Etape suivante	  Rubriques connexes

Pour modifier un type dans les bases de registres utilisateur ou globale :

1	Dans le Navigateur de projet, choisissez le noeud du type que vous voulez éditer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Editez les propriétés voulues. La méthode exacte dépend de la propriété que vous éditez. Le système peut afficher :

•	Un champ de texte, lorsque la propriété en cours peut être définie par l'entrée d'une valeur de texte. Pour les propriétés demandant des valeurs de texte plus longues, un bouton d'icône à côté du champ de texte permet d’appeler un éditeur modal ou la boîte de dialogue appropriée.

•	Une liste instantanée, pour des propriétés qui ont la valeur True ou False, ou qui ont un ensemble fixe de valeurs valides.

•	Un bouton . . ., lorsque la propriété en cours demande des valeurs plus complexes. La sélection de ce bouton permet d’appeler une boîte de dialogue dans laquelle vous entrez les informations voulues.


Edition des propriétés d'un élément

  Rubriques connexes

Pour éditer les propriétés d'un élément :

1	Dans le Navigateur de projet, sélectionnez le noeud de l'élément à éditer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Editez l'élément voulu. La méthode exacte dépend de la propriété que vous éditez. Le système peut afficher :

•	Un champ de texte, lorsque la propriété en cours peut être définie par l'entrée d'une valeur de texte. Pour les propriétés demandant des valeurs de texte plus longues, un bouton d'icône à côté du champ de texte permet d’appeler un éditeur modal ou la boîte de dialogue appropriée.

•	Une liste instantanée, pour des propriétés qui ont la valeur True ou False, ou qui ont un jeu fixe de valeurs valides.

•	Un bouton . . ., lorsque la propriété en cours demande des valeurs plus complexes. La sélection de ce bouton permet d’appeler une boîte de dialogue dans laquelle vous entrez les informations voulues.


Edition d'une action

  Etape suivante	  Rubriques connexes

Pour éditer une action :

1	Dans le Navigateur de projet, choisissez le noeud de l'élément ou du type modifié par l'action que vous voulez éditer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Si nécessaire, développez le noeud Actions, puis cliquez pour placer le curseur dans le champ texte correspondant à l'action que vous voulez éditer, et apportez les modifications voulues. Vous pouvez éditer l'action directement dans le champ de texte, ou cliquer sur . . . pour appeler la boîte de dialogue d'édition d'action, dans laquelle vous pouvez effectuer des modifications plus importantes. Remarque

Remarque : Si vous éditez une action d'un type dans la base de registres utilisateur, tous les éléments de ce type faisant référence à cette base de registres héritent de la nouvelle action. Si vous ajoutez une action à un élément, l'action ne s'applique qu'à cet élément, sauf s'il s'agit d'un projet ou d'un sous-projet. L'action s'applique alors à tous les éléments du projet, en supposant qu'ils sont du même type que celui pour lequel l'action est définie.


Modification d'une action par utilisation d'une macro

  Exemple	  Etape suivante	  Rubriques connexes

Pour modifier une action à l’aide d’une macro :

1	Dans le Navigateur de projet, choisissez le noeud de l'élément ou du type modifié par l'action que vous voulez éditer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Si nécessaire, développez le noeud Actions, puis cliquez pour placer le curseur dans le champ texte de l'action que vous voulez modifier et apportez les modifications voulues. Si vous connaissez la macro que vous voulez ajouter, vous pouvez éditer l'action directement dans le champ texte. Vous pouvez également cliquer sur le bouton . . . pour appeler la boîte de dialogue d'édition d'action. Remarque

4	Cliquez dans la zone de texte Définition d'action pour y placer le curseur, puis cliquez sur l'onglet Macro. Sélectionnez une macro de la liste.

5	Cliquez sur Insérer dans commande pour ajouter la macro à la chaîne de commande.

6	Cliquez sur OK pour valider les modifications apportées à l'action et fermer la boîte de dialogue.

Remarque : Si vous utilisez une macro pour modifier une action d'un type dans la base de registres utilisateur, tous les éléments de ce type faisant référence à cette base héritent de l'action modifiée. Si vous modifiez une action ou un élément de cette manière, l'action ne s'applique qu'à cet élément, sauf s'il s'agit d'un projet ou d'un sous-projet. L'action s'applique alors aux éléments fils du projet si elle correspond au type de l'élément.


Modification d'une action à l'aide d'une macro - Exemple
Modification d'une action à l’aide d'une macro - Exemple

Supposons que vous êtes responsable du développement d'affichages Graphics Builder pour distribution interne et externe. La distribution interne implique l'exportation des affichages vers des bitmaps en vue de leur intégration dans des états imprimés, alors que la distribution externe implique l'exportation des affichages vers des fichiers .gif afin qu'ils soient affichés sur le site web de votre entreprise.

Vous avez créé une macro, contenant des options d'exécution Graphics Builder, qui vous permet d'indiquer le format de fichier vers lequel vous voulez exporter votre affichage. Vous pouvez maintenant l'utiliser pour modifier l'action Exécuter associée aux affichages.

Pour cela :

1	Assurez-vous que vous avez une copie du type Exécutable Graphics dans votre base de registres utilisateur. Sélectionnez-la. Note

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Sous Actions, sélectionnez l'action Exécuter. Cliquez sur . . . pour afficher la boîte de dialogue d'édition d'action.

4	Faites passer le curseur à la fin de la chaîne d'action, cliquez sur l'onglet Macros, choisissez votre macro EXPORT et cliquez sur Insérer dans commande. La macro est insérée dans votre définition d'action à l'emplacement du curseur. Cliquez à nouveau sur OK pour valider la modification et sortir de la boîte de dialogue d'édition d'action.

Vos affichages seront désormais automatiquement exportés vers les fichiers .gif. Lorsque vous voulez exporter des affichages vers des fichiers bitmaps, éditez la macro EXPORT et changez l'extension du fichier en .bmp.

Si vous ne voulez pas que cette action s'applique à tous les affichages, vous pouvez modifier les actions Exécuter associées aux différents affichages de votre projet.


Edition d'une macro

  Exemple	  Etape suivante	  Rubriques connexes

Pour éditer une macro :

1	Dans le Navigateur de projet, choisissez le noeud de l'élément ou du type modifié par la macro que vous voulez éditer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Si nécessaire, développez le noeud Macros, puis cliquez pour placer le curseur dans le champ texte de la macro que vous voulez éditer et apportez les modifications voulues. Vous pouvez éditer la macro directement dans le champ de texte, ou cliquez sur . . . pour appeler la boîte de dialogue d'édition de macro, dans laquelle vous pouvez effectuer des modifications plus importantes. Note

Remarque : Si vous éditez une macro qui modifie une action d'un type dans la base de registres utilisateur, tous les éléments de ce type faisant référence à cette base héritent de l'action modifiée. Si vous modifiez une action ou un élément de cette manière, l'action ne s'applique qu'à cet élément, sauf s'il s'agit d'un projet ou d'un sous-projet. L'action s'applique alors aux éléments fils du projet si elle correspond au type de l'élément.


Edition d'une macro - Exemple

Supposons que tous les membres de votre équipe utilisent un compilateur C classique sans intérêt, vous voulez le plus récent et le plus puissant. Malheureusement, le type Fichier objet de la base de registres globale de votre projet comporte déjà une action Générer, et n'utilise pas votre compilateur.

Heureusement, la référence au compilateur est incluse dans une macro, et il vous suffit d'éditer la macro et de modifier sa définition pour qu'elle fasse référence à votre compilateur.

Pour cela :

1	Assurez-vous que vous avez une copie du type Fichier objet dans votre base de registres utilisateur. Sélectionnez-la. Remarque

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Sous Macros, sélectionnez la macro CC, puis cliquez sur . . . pour afficher la boîte de dialogue d'édition de macro.

4	Modifiez la définition de la macro.

5	Cliquez sur OK pour valider la nouvelle définition et fermer la boîte de dialogue d'édition de macro.

Si vous ne voulez pas que cette modification s'applique à tous les fichiers, vous pouvez modifier la macro CC associée aux différents fichiers de votre projet.


Appel d'une action

  Rubriques connexes

Pour appeler une action :

1	Dans le Navigateur de projet, sélectionnez le noeud du fichier que vous voulez éditer. Puis :

•	Si l'action que vous voulez effectuer est l'action par défaut, cliquez deux fois sur le noeud, ou

•	Choisissez l'action appropriée dans le menu instantané.

Si une action n'apparaît pas dans le menu instantané :

1	Sélectionnez Outils [image] Palette de propriétés.

2	Cliquez deux fois sur l'action pour afficher la boîte de dialogue Editer action.

3	Cliquez sur la case à cocher Ajouter au menu instantané.


Changement de nom d'un élément de projet

  Etape suivante	  Rubriques connexes

Pour changer le nom d'un élément de projet :

1	Dans le Navigateur de projet, sélectionnez l'élément que vous voulez renommer.

2	Cliquez à nouveau sur le nom de l'élément, qui devient un champ de texte éditable, et modifiez-le.

3	Cliquez dans le Navigateur de projet pour supprimer le point d'insertion du champ de texte.

Remarque : Renommer un fichier de projet change le nom sous lequel il est affiché, mais ne change pas le nom de fichier sous-jacent. Pour cela, renommez le fichier en utilisant la méthode classique de votre système d'exploitation.


Suppression d'un élément du Navigateur de projet

  Etape suivante	  Rubriques connexes

Pour supprimer un élément du Navigateur de projet :

Si l’élément est un fichier :

1	Dans le Navigateur de projet, sélectionnez les entrées correspondant aux fichiers à supprimer de votre projet. Utilisez la méthode de sélection de fichiers contigus ou non contigus propre à votre plate-forme, selon vos besoins. Remarque : La suppression du nom d'un fichier dans le Navigateur de projet ne supprime pas le fichier sous-jacent de votre système de fichiers.

2	Cliquez sur [image] dans la barre d'outils.

Remarque : En cliquant sur [image], vous supprimez également le ou les noms de fichiers sélectionnés, mais sans demander confirmation de l'opération. Dans tous les cas, en cliquant sur [image], vous restaurez la ou les entrées supprimées.

Si l’élément est un type ou une connexion :

1	Dans le Navigateur de projet, sélectionnez le ou les noeuds du ou des types ou des connexions que vous voulez supprimer. Utilisez la méthode de sélection de fichiers séquentiels ou non séquentiels de votre plate-forme, le cas échéant.

2	Cliquez sur [image] pour supprimer l'entrée ou les entrées sélectionnées.

Remarque :  ne demande pas la confirmation de l'opération. Si nécessaire, cliquez sur [image] pour restaurer l'élément supprimé.

Important : Evitez de supprimer les types prédéfinis UPDANY, UPDTEXT, UPDPROJ et UPDLINK, même si vous avez en créé vos propres définitions. Il ne vous est pas interdit de supprimer ces types, mais ce type d'opération risquerait de nuire sérieusement au système d'héritage de Project Builder et à son aptitude à réer des projets et des sous-projets.


Suppression d'un projet du Navigateur de projet

  Rubriques connexes

Pour supprimer un projet :

1	Dans le Navigateur de projet, sélectionnez le projet que vous voulez supprimer.

2	Cliquez sur [image] dans la barre d'outils. Un message d'alerte apparaît.

3	Pour supprimer le projet du Navigateur de projet et supprimer le fichier de base de registres de projet sous-jacent, cliquez sur Oui. Pour ne supprimer que le projet du Navigateur de projet, et conserver le fichier de base de registres de projet sous-jacent, cliquez sur Non.

Remarques :

•	Si un autre utilisateur a ouvert le projet, le message d'alerte n'apparaît pas. Bien que vous puissiez supprimer le projet de votre Navigateur de projet (en suivant les instructions de l'étape 2), vous ne pouvez pas supprimer le fichier de base de registres de projet sous-jacent lorsqu'il est en cours d'utilisation. Si vous tenez à supprimer le fichier de base de registres de projet, attendez que tous les autres utilisateurs aient fermé le projet.

•	La sélection de Fichier [image] Fermer projet supprime le ou les projets sélectionnés sans supprimer la définition de projet.

•	La suppression d'un projet supprime son fichier de base de registres, mais pas les fichiers sous-jacents représentés par ce projet. Par exemple, si un projet comportant l'application Forms grant.fmb est supprimé, grant.fmb n'est pas supprimée. Pour supprimer GRANT.FMB, utilisez la commande de suppression standard de votre système de fichiers.


Enregistrement d'un projet

Pour enregistrer un projet :

 Aucun enregistrement explicite n'est nécessaire. Project Builder enregistre vos projets automatiquement.


Création manuelle d'une dépendance

  Etape suivante	  Rubriques connexes

Pour créer manuellement une dépendance :

1	Dans le Navigateur de projet, sélectionnez l'élément pour lequel vous voulez créer une dépendance, par exemple, un fichier .fmb qui fait référence à une bibliothèque PL/SQL spécifique.

2	Cliquez sur [image] dans la barre d'outils pour afficher la boîte de dialogue d'ajout de fichiers à un projet.

3	Si nécessaire, accédez au répertoire ou aux fichiers dont l'élément dépend.

4	Sélectionnez les fichiers en utilisant la méthode de sélection de fichiers séquentiels ou non séquentiels de votre plate-forme, si nécessaire.

5	Cliquez sur Ouvrir pour ajouter des fichiers à votre projet ou à votre sous-projet, sous l'élément sélectionné dans le Navigateur de projet.

Remarques :

•	Sous Windows, vous ne pouvez sélectionner des fichiers que dans un répertoire à la fois. En outre, Windows limite le nombre de fichiers que vous pouvez sélectionner simultanément dans la boîte de dialogue de fichier. Le nombre maximum de fichiers dépend de la longueur des noms de fichiers. Vous pouvez sélectionner environ 250 fichiers ayant des noms longs et environ 600 fichiers ayant des noms limités à la notation 8.3.

Si vous sélectionnez trop de fichiers, aucun ne sera ajouté à votre projet. Cliquez sur [image] pour afficher la boîte de dialogue de fichiers, diminuez le nombre de fichiers à ajouter et répétez l’opération si nécessaire.

•	Vous ne pouvez pas créer de dépendance manuelle si l'élément dont dépend un autre apparaît déjà dans le Navigateur de projet. La boîte de dialogue d'ajout de fichiers est le seul moyen d'établir une dépendance.


Création d'un sous-projet avec l'assistant Projet

  Restrictions	  Etape suivante	  Rubriques connexes

Pour créer un sous-projet avec l'assistant Projet :

1	Cliquez sur [image] dans la barre d'outils pour afficher l'assistant Projet.

2	Procédez comme indiqué pour créer un sous-projet. Pour plus d'informations, reportez-vous à l'aide sur l'assistant Projet.


Création d'un sous-projet sans l'assistant Projet

  Restrictions	  Etape suivante	  Rubriques connexes

Pour créer un sous-projet sans l'assistant Projet :

1	Dans le Navigateur de projet, sélectionnez le projet sous lequel vous voulez créer un sous-projet.

2	Choisissez Nouveau sous-projet dans le menu instantané pour afficher la boîte de dialogue de nouveau sous-projet. Sélectionnez le répertoire dans lequel vous voulez stocker votre définition de sous-projet.

3	Le système crée un nouveau sous-projet vide. Renommez-le dans le Navigateur de projet et ajoutez les fichiers nécessaires.


Création d'un sous-projet - Restrictions

Vous ne pouvez enregistrer de sous-projets que dans votre système de fichiers. Vous ne pouvez pas enregistrer de sous-projets dans une base de données.


Changement de l'ordre des fichiers à l'aide de glisser-déposer
Changement de l'ordre des fichiers à l’aide de glisser-déposer

  Etape suivante	  Rubriques connexes

Pour changer l'ordre des fichiers d'un projet ou d'un sous-projet :

1	Dans le Navigateur de projet, sélectionnez le noeud du fichier que vous voulez déplacer.

2	Faites glisser le noeud jusqu’à l'endroit voulu, puis relâchez le bouton de la souris.

Le fichier est transféré dans le Navigateur de projet à son nouvel emplacement.

Remarque : Vous ne pouvez pas déplacer un élément d'un projet à l'autre. Cependant, vous pouvez faire glisser un fichier dans un sous-projet d'un projet, ou copier ou couper l'élément d'un projet et le coller dans un autre.


Couper/copier/coller un élément dans un projet

  Etape suivante	  Rubriques connexes

Pour couper un élément dans un projet :

 Sélectionnez le noeud de l'élément que vous voulez couper. Cliquez sur [image]. L'élément est supprimé du projet, mais copié dans le presse-papiers pour pouvoir être collé ailleurs.

Pour copier un élément dans un projet :

 Sélectionnez le noeud de l'élément que vous voulez copier. Cliquez sur [image]. L'élément est copié dans le presse-papiers, sans être supprimé du projet, pour être collé ailleurs.

Pour coller un élément dans un projet :

 Sélectionnez le projet dans lequel vous voulez coller l'élément. Cliquez sur [image]. L'élément est collé à l'endroit voulu dans le projet.

Remarque : Cliquer sur [image] annule chacune des opérations ci-dessus.


Génération des fichiers sélectionnés

  Etape suivante	  Rubriques connexes

Pour générer les fichiers sélectionnés :

1	Dans le Navigateur de projet, sélectionnez tous les fichiers que vous voulez générer. Utilisez la méthode de sélection de fichiers séquentiels ou non séquentiels de votre plate-forme, le cas échéant.

2	Cliquez sur [image] dans la barre d'outils. Project Builder génère les fichiers en fonction de l’action définie à Génération pour chacun des types de fichier sélectionnés.

Une boîte de dialogue de confirmation apparaît à la fin du processus de génération.


Génération de fichiers modifiés

  Etape suivante	  Rubriques connexes

Pour générer des fichiers modifiés :

1	Dans le Navigateur de projet, sélectionnez le noeud contenant les fichiers que vous voulez générer.

2	Cliquez sur [image] dans la barre d'outils.

Project Builder détecte les fichiers ayant été modifiés depuis la dernière génération, en comparant les horodateurs des cibles avec ceux des éléments d'entrée, puis génère les fichiers périmés en fonction de l'action Générer à partir de <type> définie pour chacun des types de fichier.

Une boîte de dialogue de confirmation apparaît à la fin du processus de génération.


Génération d'un projet

  Etape suivante	  Rubriques connexes

Pour générer un projet :

1	Dans le Navigateur de projet, sélectionnez le noeud du projet que vous voulez générer.

2	Choisissez Compiler tout dans le menu instantané. Project Builder impose la génération de tous les fichiers, en fonction de l'action définie à Génération pour chaque type de fichier se rapportant au projet.

Une boîte de dialogue de confirmation indiquant le nombre d'éléments générés apparaît à la fin du processus de génération.


Personnalisation de l'action de livraison

  Rubriques connexes

Pour personnaliser l'action de livraison :

1	Dans le Navigateur de projet, sélectionnez le projet à livrer.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Sous Macros, localisez PACKFILE.

4	Cliquez dans le champ situé à droite, puis cliquez sur le bouton . . . pour afficher la boîte de dialogue d'édition de macro.

5	Entrez le nom de votre fichier package dans le champ de texte Définition de macro, par exemple, pack.zip.

6	Cliquez sur OK pour valider la définition et quitter la boîte de dialogue d'édition de macro.

Lorsque vous exécutez l'action de livraison du projet (à l'aide de l'assistant Livraison), le projet est packagé dans le fichier indiqué dans la macro PACKFILE.


Livraison d'un projet

  Rubriques connexes

Pour livrer un projet :

 Choisissez Outils [image] Assistant Livraison. L'assistant Livraison crée pour vous une zone de mise en oeuvre, puis il copie ou transfère vers cette zone, par FTP (protocole de transfert de fichier), vos fichiers de projet terminés. L'assistant Livraison peut également créer les scripts nécessaires à l'installation de votre produit via Oracle Installer.

Remarque : L'assistant Livraison développe la fonctionnalité fournie par l'action de livraison. Toutefois, si vous voulez toujours exécuter cette action, l'assistant Livraison fournit l'option nécessaire.


Avant de packager votre application, vous devez modifier la macro PACKFILE pour indiquer un nom de fichier package.


Changement d'affichage

  Rubriques connexes

Pour changer d'affichage :

 Choisissez Affichage [image] Affichage de dépendances pour visualiser les dépendances ou Affichage [image] Affichage projet pour visualiser les projets.


Définition d'une action par défaut pour un type

  Rubriques connexes

Pour définir une action par défaut pour un type :

1	Sélectionnez le type pour lequel vous voulez définir une action par défaut, puis sélectionnez Outils [image] Assistant Type de module.

2	Cliquez sur l'onglet Actions.

3	Sélectionnez l'action à désigner comme action par défaut.

4	Cliquez sur En faire la valeur par défaut.

5	Cliquez sur Fin.

L'action sélectionnée est appelée chaque fois que l'utilisateur clique deux fois sur un fichier de ce type. En outre, elle apparaît au début du menu instantané des éléments de ce type.

Remarque : Si vous définissez une action (par défaut ou autre) sur un type, tous les éléments de ce type qui n'ont pas remplacé l'action en héritent.


Substitution d'une action héritée

  Etape suivante	  Rubriques connexes

Pour remplacer une action héritée :

1	Dans le Navigateur de projet, sélectionnez l'élément de projet dont vous voulez remplacer l'action.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Si nécessaire, développez le noeud Actions, cliquez dans le champ de texte de l’action à remplacer pour y placer le curseur, et apportez les modifications voulues. Vous pouvez éditer l'action directement dans le champ de texte, ou cliquer sur le bouton . . . pour appeler la boîte de dialogue d'édition d'action, dans laquelle vous pouvez apporter des modifications plus importantes.

Notez que l'icône d’héritage [image] est remplacée par [image] pour indiquer le remplacement d'une action héritée.


Héritage d'une action

  Etape suivante	  Rubriques connexes

Pour hériter une action :

1	Dans le Navigateur de projet, sélectionnez l'élément dont vous voulez hériter une action.

2	Choisissez Palette de propriétés dans le menu instantané pour afficher la Palette de propriétés.

3	Si nécessaire, développez le noeud Actions, sélectionnez l'action, puis cliquez sur [image] pour hériter l'action.

Remarque : Si vous indiquez que l'élément ré-hérite l'action, notez que l'icône de substitution [image] est remplacée par [image] pour indiquer que l'action est héritée.


Ajout d'un outil au Lanceur

  Etape suivante	  Rubriques connexes

Pour ajouter un outil au Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, cliquez sur Ajouter pour afficher la boîte de dialogue d'ajout d'entrée de Lanceur. Dans cette boîte de dialogue :

•	Cliquez sur le bouton d'option Elément pour indiquer un élément unique, et non un groupe.

•	Cliquez dans la zone de texte Commande pour y placer le curseur et entrez la chaîne de lancement de l'outil. Si nécessaire, cliquez sur Insérer application pour rechercher le fichier exécutable de votre outil ou sur Insérer connexion pour ajouter une connexion. Notez que les chaînes de lancement ont le même format que les définitions d'action. En outre, seules les macros intégrées et les macros de variable d'environnement sont prises en charge.

•	Entrez un libellé dans la zone de texte Libellé d'icône et (facultatif) une description dans la zone de texte Conseil.

•	(Etape facultative) Choisissez l'icône qui représentera l'outil. Si nécessaire, cliquez dans la case à cocher De fichier, puis cliquez sur Parcourir et utilisez la boîte de dialogue d'ouverture pour rechercher le fichier d'icône que vous voulez utiliser.

•	Cliquez sur OK pour fermer la boîte de dialogue d'ajout d'entrée du Lanceur.

4	Cliquez sur OK pour valider la boîte de dialogue de préférences et ajouter l'outil au Lanceur.


Ajout d'un groupe au Lanceur

  Etape suivante	  Rubriques connexes

Pour ajouter un groupe au Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, cliquez sur Ajouter pour afficher la boîte de dialogue d'ajout d'entrée de Lanceur. Dans cette boîte de dialogue :

•	Cliquez sur le bouton d'option Groupe pour indiquer un élément de groupe, et non un élément isolé.

•	Entrez un libellé dans la zone de texte Libellé d'icône et (facultatif) une description dans la zone de texte Conseil.

•	(Etape facultative) Choisissez l'icône qui représentera le groupe. Si nécessaire, cliquez dans la case à cocher De fichier, puis sur Parcourir, et utilisez la boîte de dialogue d'ouverture pour rechercher le fichier d'icône que vous voulez utiliser.

•	Cliquez sur OK pour fermer la boîte de dialogue d'ajout d'entrée du Lanceur.

4	Si les outils que vous voulez ajouter au nouveau groupe se trouvent déjà dans le Lanceur, ajoutez-les en les faisant glisser et en les déposant dans le groupe. Si les outils que vous voulez inclure dans le nouveau groupe n'ont pas encore été ajoutés au Lanceur, sélectionnez le noeud de groupe dans le Navigateur du Lanceur, puis ajoutez les outils de la manière habituelle.


Changement de l'emplacement du Lanceur

  Etape suivante	  Rubriques connexes

Pour changer l'emplacement du Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sous Présentation, cliquez sur le bouton d'option correspondant à l'endroit où vous voulez placer le Lanceur : Flottante crée un Lanceur sans mode que vous pouvez déplacer sur l'affichage. Attachée en haut place le Lanceur horizontalement en haut du Navigateur de projet. Attachée à gauche positionne le Lanceur verticalement, du côté gauche du Navigateur de projet.

4	Cliquez sur OK pour quitter la boîte de dialogue de préférences et valider les modifications.


Edition d'une entrée d'outils du Lanceur

  Etape suivante	  Rubriques connexes

Pour éditer une entrée d'outil du Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, sélectionnez l'outil dont vous voulez éditer l'entrée dans le Navigateur du Lanceur, puis cliquez sur Editer pour afficher la boîte de dialogue d'édition d'entrée du Lanceur.

4	Apportez les modifications nécessaires puis cliquez sur OK pour fermer la boîte de dialogue d'édition d'entrée du Lanceur.

5	Cliquez sur OK pour quitter la boîte de dialogue de préférences et valider les modifications apportées à l'entrée de l'outil.


Déplacement d'un outil ou d'un groupe sur le Lanceur

  Etape suivante	  Rubriques connexes

Pour déplacer un outil ou un groupe sur le Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Dans le Navigateur du Lanceur, cliquez sur l'outil ou le groupe que vous voulez déplacer, faites-le glisser jusqu’à son nouvel emplacement et déposez-le.

4	Cliquez sur OK pour quitter la boîte de dialogue de préférences et valider les modifications.


Masquage d'un outil ou d'un groupe du Lanceur

  Rubriques connexes

Pour masquer un outil ou un groupe du Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, sélectionnez l'outil ou le groupe que vous voulez masquer, puis cliquez sur Editer pour afficher la boîte de dialogue d'édition d'entrée du Lanceur.

4	Sélectionnez la case Masqué. Cliquez sur OK pour quitter la boîte de dialogue.

5	Cliquez sur OK pour quitter la boîte de dialogue de préférences et valider la modification. Notez que l'outil n'apparaît plus dans le Lanceur.

Les outils et les groupes masqués ne sont pas définitivement supprimés du Lanceur. Pour les afficher à nouveau, il suffit d'éditer l'entrée appropriée et de décocher la case à cocher Masqué.


Suppression d'un outil du Lanceur

  Rubriques connexes

Pour supprimer un outil du Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, sélectionnez l'outil que vous voulez supprimer, puis cliquez sur Supprimer. Un message d'alerte vous demande de confirmer l'opération. Sélectionnez Oui pour supprimer l'entrée.

Conseil : Si vous changez d'avis, vous pouvez utiliser Annuler pour annuler la boîte de dialogue de préférences. Votre entrée de Lanceur n'est pas supprimée.


Suppression d'un groupe du Lanceur

  Rubriques connexes

Pour supprimer un groupe du Lanceur :

1	Choisissez Outils [image] Préférences pour afficher la boîte de dialogue de préférences.

2	Cliquez sur l'onglet Lanceur pour afficher les préférences du Lanceur.

3	Sur la page du Lanceur, sélectionnez le groupe que vous voulez supprimer, puis cliquez sur Supprimer. Un message d'alerte vous demande de confirmer l'opération. Sélectionnez Oui pour supprimer le groupe et tous les outils qu'il contient. Si vous voulez uniquement supprimer le groupe, faites glissez les outils hors du groupe, puis positionnez-les ailleurs dans le Navigateur du Lanceur avant de supprimer le groupe.

Conseil : Si vous changez d'avis, vous pouvez utiliser Annuler pour annuler la boîte de dialogue de préférences. Votre entrée de Lanceur n'est pas supprimée.


Importation d'un projet

  Etape suivante	  Rubriques connexes

Pour importer un projet :

1	Choisissez Fichier [image] Importer projet pour afficher la boîte de dialogue d'options d'import.

2	Dans la boîte de dialogue :

•	Pour importer tous les éléments du projet, cliquez sur la case à cocher Importer éléments. Pour importer tous les types associés au projet, cliquez sur la case à cocher Importer types.

•	Si vous voulez que les fichiers du projet importé recouvrent les fichiers ayant des noms identiques, cliquez sur Substituer aux éléments existants. Si vous voulez que les types du projet importé recouvrent les types ayant des noms identiques, cliquez sur Substituer aux types existants.

•	Notez que Importer dans projet est sélectionné. Pour importer votre projet comme un projet autonome, assurez-vous que Projets est sélectionné.

3	Cliquez sur Importer. La boîte de dialogue de sélection de fichier à importer apparaît.

4	Passez au projet que vous voulez importer en procédant comme dans une boîte de dialogue de fichier de votre système. Sélectionnez le fichier et cliquez sur Ouvrir.

5	La boîte de dialogue de sélection de fichier à importer se ferme, et votre projet est importé. La boîte de dialogue d'options d'import reste ouverte pour vous permettre d'importer en une seule opération plusieurs fichiers ou des combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre importation, cliquez sur Fermer.


Importation d'un projet comme un sous-projet

  Etape suivante	  Rubriques connexes

Pour importer un projet comme un sous-projet :

1	Choisissez Fichier [image] Importer projet pour afficher la boîte de dialogue d'options d'import.

2	Dans la boîte de dialogue :

•	Pour importer tous les éléments du projet, cliquez sur la case à cocher Importer éléments. Pour importer tous les types associés au projet, cliquez sur la case à cocher Importer types.

•	Si vous voulez que les fichiers du projet importé recouvrent les fichiers ayant des noms identiques, cliquez sur Substituer aux éléments existants. Si vous voulez que les types du projet importé recouvrent les types ayant des noms identiques, cliquez sur Substituer aux types existants.

•	Notez que Importer dans projet est sélectionné. Pour importer votre projet comme un projet autonome, assurez-vous que Projets est sélectionné.

3	Cliquez sur Importer. La boîte de dialogue de sélection de fichier à importer apparaît.

4	Passez au projet que vous voulez importer en procédant comme dans une boîte de dialogue de fichier de votre système. Sélectionnez le fichier et cliquez sur Ouvrir.

5	La boîte de dialogue de sélection de fichier à importer se ferme, et votre projet est importé. La boîte de dialogue d'options d'import reste ouverte pour vous permettre d'importer en une seule opération plusieurs fichiers ou des combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre importation, cliquez sur Fermer.


Importation d'informations de type

  Etape suivante	  Rubriques connexes

Pour importer des informations de type

1	Choisissez Fichier [image] Importer projet pour afficher la boîte de dialogue d'options d'import.

2	Dans la boîte de dialogue :

•	Pour importer tous les types associés au projet, cliquez sur la case à cocher Importer types.

•	Si vous voulez que les types du projet importé recouvrent les types ayant des noms identiques, cliquez sur Substituer aux types existants.

3	Cliquez sur Importer. La boîte de dialogue de sélection de fichier à importer apparaît.

4	Passez au projet que vous voulez importer en procédant comme dans une boîte de dialogue de fichier de votre système. Sélectionnez le fichier et cliquez sur Ouvrir.

5	La boîte de dialogue de sélection de fichier à importer se ferme et les informations de type stockées avec votre fichier de base de registres de projet sont importées. La boîte de dialogue d'options d'import reste ouverte pour vous permettre d'importer en une seule opération plusieurs fichiers ou combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre importation, cliquez sur Fermer.


Exportation d'un projet

  Rubriques connexes

Pour exporter un projet :

1	Choisissez Fichier [image] Exporter projet pour afficher la boîte de dialogue d'options d'exportation.

2	Cliquez sur Exporter projet(s) et tout descendant dans la liste de boutons d'option d'exportation d'éléments.

3	Choisissez dans la liste déroulante le projet que vous voulez exporter.

4	Sélectionnez dans la liste Types d'export les types que vous voulez exporter. Si vous voulez exporter toutes les informations de type, cliquez sur Sélectionner tous les types.

5	Cliquez sur Exporter pour afficher la boîte de dialogue de sélection de fichier à exporter. Sélectionnez dans la liste de fichiers celui vers lequel vous voulez exporter le projet, ou entrez un nom dans le champ de texte Nom de fichier.

6	Cliquez sur Enregistrer pour exporter le projet.

7	La boîte de dialogue de sélection de fichier à exporter se ferme, et votre projet est exporté. La boîte de dialogue d'options d'exportation reste ouverte pour vous permettre d'exporter en une seule opération plusieurs fichiers ou combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre exportation, cliquez sur Fermer.


Exportation d'une partie de projet

  Rubriques connexes

Pour exporter une partie de projet :

1	Assurez-vous que les éléments de projet que vous voulez exporter sont sélectionnés dans le Navigateur de projet. Choisissez Fichier [image] Exporter projet pour afficher la boîte de dialogue d'options d'import.

2	Pour exporter uniquement les éléments sélectionnés, cliquez sur la case à cocher Exporter élément(s) sélectionné(s) uniquement. Pour exporter les éléments sélectionnés et leurs descendants, cliquez sur Exporter élément(s) sélectionné(s) et tout descendant.

3	Sélectionnez dans la liste Types d'export les types que vous voulez exporter. Si vous voulez exporter toutes les informations de type, cliquez sur Sélectionner tous les types.

4	Cliquez sur Exporter pour afficher la boîte de dialogue de sélection de fichier à exporter. Sélectionnez dans la liste de fichiers celui vers lequel vous voulez exporter le projet, ou entrez un nom dans le champ de texte Nom de fichier.

5	Cliquez sur Enregistrer pour exporter le projet.

6	La boîte de dialogue de sélection de fichier à exporter se ferme, et votre projet est exporté. La boîte de dialogue d'options d'exportation reste ouverte pour vous permettre d'exporter en une seule opération plusieurs fichiers ou combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre exportation, cliquez sur Fermer.


Exportation d'informations de type

  Rubriques connexes

Pour exporter une partie ou la totalité d'une base de registres :

1	Choisissez Fichier [image] Exporter projet pour afficher la boîte de dialogue d'options d'exportation.

2	Assurez-vous que N'exporter aucun élément est sélectionné.

3	Sélectionnez dans la liste Types d'export les types que vous voulez exporter. Si vous voulez exporter toutes les informations de type, cliquez sur Sélectionner tous les types.

4	Cliquez sur Exporter pour afficher la boîte de dialogue de sélection de fichier à exporter. Sélectionnez dans la liste de fichiers celui vers lequel vous voulez exporter le projet, ou entrez un nom dans le champ de texte Nom de fichier.

5	Cliquez sur Enregistrer pour exporter le projet.

6	La boîte de dialogue de sélection de fichier à exporter se ferme, et votre projet est exporté. La boîte de dialogue d'options d'exportation reste ouverte pour vous permettre d'exporter en une seule opération plusieurs fichiers ou combinaisons d'informations d'élément et de type. Lorsque vous avez terminé votre exportation, cliquez sur Fermer.


Génération et impression d'un état de projet

  Etape suivante	  Rubriques connexes

Pour générer et imprimer un état de projet :

1	Dans le Navigateur de projet, sélectionnez le projet pour lequel vous voulez imprimer un état.

2	Sélectionnez Projet [image] Imprimer infos projet pour afficher la boîte de dialogue d'impression d'état de projet.

3	Sélectionnez les informations sur le projet que vous voulez inclure dans l'état.

4	Sélectionnez Imprimer. La boîte de dialogue d'impression de votre système s’affiche. Remplissez-la et validez-la pour imprimer l'état.


Définition du mot de passe d'un projet

  Rubriques connexes

Pour définir un mot de passe pour un fichier de projet :

1	Dans le Navigateur de projet, sélectionnez le noeud du projet à protéger.

2	Choisissez Fichier [image] Administration [image] Définir mot de passe de projet pour afficher la boîte de dialogue Définir mot de passe de projet.

3	Entrez le mot de passe dans le champ Nouveau mot de passe. Sa longueur et le type de caractère qu'il comporte ne sont pas limités. En outre, le mot de passe n'a pas de date d'expiration.

4	Entrez à nouveau le mot de passe dans le champ Confirmer mot de passe pour vérifier son orthographe.

5	Cliquez sur OK.

Lorsque vous (ou un autre utilisateur) tentez d'ouvrir ce projet, une boîte de dialogue vous invite à entrer le mot de passe.


Modification du mot de passe d'un projet

  Rubriques connexes

Pour modifier le mot de passe d'un projet :

1	Dans le Navigateur de projet, sélectionnez le noeud du projet dont vous voulez modifier le mot de passe.

2	Choisissez Fichier [image] Administration [image] Définir mot de passe de projet pour afficher la boîte de dialogue Définir mot de passe de projet.

3	Entrez le mot de passe actuel dans le champ Ancien mot de passe.

4	Entrez le nouveau mot de passe dans le champ Nouveau mot de passe. Sa longueur et le type de caractère qu'il comporte ne sont pas limités. En outre, le mot de passe n'a pas de date d'expiration.

5	Entrez à nouveau ce mot de passe dans le champ Confirmer mot de passe pour vérifier son orthographe.

6	Cliquez sur OK.

Lorsque vous (ou un autre utilisateur) tentez d'ouvrir ce projet, une boîte de dialogue vous invite à entrer le mot de passe.


Suppression du mot de passe d'un projet

  Rubriques connexes

Pour supprimer le mot de passe d'un projet :

1	Dans le Navigateur de projet, sélectionnez le noeud du projet dont vous voulez supprimer le mot de passe.

2	Choisissez Fichier [image] Administration [image] Définir mot de passe de projet pour afficher la boîte de dialogue Définir mot de passe de projet.

3	Entrez le mot de passe actuel dans le champ Ancien mot de passe.

4	Laissez les champs Nouveau mot de passe et Confirmer mot de passe vides.

5	Cliquez sur OK.


Contrôle de la fragmentation de la base de registres du projet

  Rubriques connexes

Pour contrôler la fréquence à laquelle Project Builder vous suggère de défragmenter la base de registres du projet :

1	Dans le Navigateur de projet, choisissez Outils [image] Préférences.

2	Choisissez l'onglet Projets.

3	Dans le champ Défragmenter registres de projet lorsque nombre pourcentage fragmenté, utilisez les boutons d'incrémentation/de décrémentation pour sélectionner un nombre. Plus il est élevé, plus Project Builder espace ses suggestions de défragmentation du registre d'un projet. La valeur 100 % empêche Project Builder d'afficher le message d'alerte de défragmentation (ce qui, dans les faits, désactive la fonction de défragmentation).


Génération d'éléments sélectionnés en mode de traitement par lots

  Rubriques connexes

Pour générer des éléments sélectionnés en mode de traitement par lots :

1	Choisissez Outils [image] Préférences, puis sélectionnez l'onglet Navigateur.

2	Cliquez sur la case à cocher Activer sortie batch.

3	Dans le champ Nom de fichier de sortie, entrez le nom du fichier dans lequel les résultats de la commande Génération (par exemple, les erreurs du compilateur) doivent être consignés. Pour ajouter ces résultats à un fichier existant, cliquez sur la case à cocher Ajouter au fichier ; pour écraser le contenu du fichier journal, ne cochez pas cette case.

4	Cliquez sur OK pour valider vos définitions et fermer la boîte de dialogue Préférences.

5	Dans le Navigateur de projet, sélectionnez tous les fichiers que vous voulez générer. Utilisez la méthode de sélection de fichiers séquentiels ou non séquentiels de votre plate-forme, le cas échéant.

6	Cliquez sur [image] dans la barre d'outils. Project Builder génère les fichiers en fonction de l’action définie à Génération pour chacun des types de fichier sélectionnés.

Aucune boîte de dialogue de confirmation n'apparaît à la fin du processus de génération. Consultez le fichier journal pour connaître le résultat de l'action Génération.


Génération d'un projet en mode de traitement par lots

  Rubriques connexes

Pour générer un projet en mode de traitement par lots :

1	Choisissez Outils [image] Préférences, puis sélectionnez l'onglet Navigateur.

2	Cliquez sur la case à cocher Activer sortie batch.

3	Dans le champ Nom de fichier de sortie, entrez le nom du fichier dans lequel les résultats de la commande Génération (par exemple, les erreurs du compilateur) doivent être consignés. Pour ajouter ces résultats à un fichier existant, cliquez sur la case à cocher Ajouter au fichier ; pour écraser le contenu du fichier journal, ne cochez pas cette case.

4	Cliquez sur OK pour valider vos définitions et fermer la boîte de dialogue Préférences.

5	Dans le Navigateur de projet, sélectionnez le noeud du projet que vous voulez générer.

6	Choisissez Compiler tout dans le menu instantané. Project Builder impose la génération de tous les fichiers, en fonction de l'action définie à Génération pour chaque type de fichier se rapportant au projet.

Aucune boîte de dialogue de confirmation n'apparaît à la fin du processus de génération. Consultez le fichier journal pour connaître le résultat de l'action Génération.


Génération d'éléments modifiés en mode de traitement par lots

  Rubriques connexes

Pour générer des éléments modifiés en mode de traitement par lots :

1	Choisissez Outils [image] Préférences, puis sélectionnez l'onglet Navigateur.

2	Cliquez sur la case à cocher Activer sortie batch.

3	Dans le champ Nom de fichier de sortie, entrez le nom du fichier dans lequel les résultats de la commande Génération (par exemple, les erreurs du compilateur) doivent être consignés. Pour ajouter ces résultats à un fichier existant, cliquez sur la case à cocher Ajouter au fichier ; pour écraser le contenu du fichier journal, ne cochez pas cette case.

4	Cliquez sur OK pour valider vos définitions et fermer la boîte de dialogue Préférences.

5	Dans le Navigateur de projet, sélectionnez le noeud contenant les fichiers que vous voulez générer.

6	Cliquez sur [image] dans la barre d'outils.

Project Builder détecte les fichiers ayant été modifiés depuis la dernière génération, en comparant les horodateurs des cibles avec ceux des éléments d'entrée, puis génère les fichiers périmés en fonction de l'action Générer à partir de <type> définie pour chacun des types de fichier.

Aucune boîte de dialogue de confirmation n'apparaît à la fin du processus de génération. Consultez le fichier journal pour connaître le résultat de l'action Génération.


Suppression de filtres

  Rubriques connexes

Pour supprimer un filtre :

1	Sélectionnez Navigateur [image] Gérer filtres.

2	Dans la fenêtre Filtres disponibles, sélectionnez le filtre à supprimer.

3	Cliquez sur Supprimer filtre.

Le filtre est supprimé de la fenêtre Filtres disponibles.


Application de filtres

  Rubriques connexes

Pour appliquer un filtre :

1	Sélectionnez Navigateur [image] Vues filtrées.

La liste des filtres actuellement définis apparaît.

2	Sélectionnez le filtre à appliquer. (Pour afficher tout le contenu du Navigateur de projet, c'est-à-dire sans filtre, sélectionnez <Aucun filtre>.)

Seuls les projets ou les éléments de projet répondant aux critères de filtrage apparaissent désormais dans le Navigateur. Si nécessaire, les noeuds de projet sont développés afin de faire apparaître les éléments de projet répondant aux critères de filtrage.

Le nom du filtre appliqué figure toujours dans l'angle inférieur gauche de la zone d'état du Navigateur de projet.


Création de filtres

  Exemple	  Rubriques connexes

Pour créer un filtre :

1	Sélectionnez Navigateur [image] Gérer filtres.

2	Cliquez sur Ajouter filtre.

La boîte de dialogue Ajouter filtre apparaît.

3	Entrez un nom pour le filtre dans le champ Nom de filtre.

4	Utilisez les onglets Général, Fichier, Projet, Livraison, Connexion et Macros pour définir des valeurs pour le projet ou les propriétés d'éléments que le filtre doit repérer. Toutes les propriétés sont liées par la condition ET (AND) ; vous ne pouvez utiliser aucune condition OU. Lorsque vous ajoutez des critères, la définition du filtre est enregistrée dans le champ Critères de filtre en cours.

Pour supprimer un critère de votre filtre, sélectionnez la propriété et sa valeur dans le champ Critères de filtre en cours, puis cliquez sur Supprimer.

5	Après avoir créé votre filtre, cliquez sur OK.


Modification de filtres

  Rubriques connexes

Pour modifier un filtre :

1	Sélectionnez Navigateur [image] Gérer filtres.

2	Dans la fenêtre Filtres disponibles, sélectionnez le filtre à modifier.

3	Cliquez sur Editer filtre.

La boîte de dialogue Editer filtre apparaît.

4	Utilisez les onglets Général, Fichier, Projet, Livraison, Connexion et Macros pour ajouter des critères à votre filtre. Toutes les propriétés sont liées par la condition ET ; vous ne pouvez utiliser aucune condition OU. Lorsque vous ajoutez des critères, la définition du filtre est enregistrée dans le champ Critères de filtre en cours.

Pour supprimer un critère de votre filtre, sélectionnez la propriété et sa valeur dans le champ Critères de filtre en cours, puis cliquez sur Supprimer.

5	Après avoir modifié votre filtre, cliquez sur OK.


Exemples : Création de filtres

Ces exemples supposent que vous avez sélectionné Navigateur [image] Gérer filtres, puis que vous avez cliqué sur Ajouter filtre pour afficher la boîte de dialogue Ajouter filtre.

Exemple 1 : Pour créer un filtre qui affiche tous les fichiers .fmb :

1	sélectionnez Projet.

2	Dans la boîte de dialogue Ajouter filtre, entrez Filtre de l'application Forms dans le champ Nom de filtre.

3	Sélectionnez FMB --  document Form Builder dans la liste Type.

4	Cliquez sur OK.

Exemple 2 : Pour créer un filtre affichant tous les éléments implicites ou explicites qui n'ont pas encore été créés.

1	Dans la boîte de dialogue Ajouter filtre, entrez De réserve dans le champ Nom de filtre.

2	Dans l'onglet Fichier, vérifiez que l'option Inclure les fichiers existants ayant les attributs suivants n'est pas cochée. Quand cette option est activée, le filtre repère uniquement les fichiers à créer, et non ceux qui existent déjà.

3	Dans l'onglet Projet, cliquez sur Les deux dans le groupe de boutons d'option Eléments implicites.

4	Cliquez sur OK.


Test d'une action

  Rubriques connexes

Pour tester une action en mode Aperçu des actions :

1	Sélectionnez le menu Projet, puis cliquez sur l'option de menu Mode Aperçu des actions.

2	Exécutez l'action normalement.

L'action apparaît dans un menu instantané, où sont également affichées les valeurs des paramètres et les macros entièrement développées. (Pour des raisons de sécurité, tous les mots de passe apparaissent sous forme d'astérisques.) L'action n'est pas réellement exécutée. Plus exactement, le mode Aperçu des actions permet de visualiser les actions qui seront exécutées lorsque vous le quitterez.

Pour quitter le mode Aperçu des actions, sélectionnez le menu Projet et désélectionnez l'option Mode Aperçu des actions.


Elément que vous créez, par opposition à un élément créé par Project Builder.


Obtention du fichier maître de définition de Lanceur

Pour obtenir une copie du fichier maître de définition du Lanceur :

1	Sélectionnez Outils [image] Préférences.

2	Cliquez sur l'onglet Lanceur.

3	Cliquez sur Par défaut.

Une boîte de dialogue de confirmation apparaît.

Si vous cliquez sur Oui, le fichier maître de définition du Lanceur, qui se trouve dans la zone d'installation du produit (généralement ORACLE_HOME/PJ60), est copié vers votre propre fichier de définition du Lanceur. Si vous avez apporté à votre fichier de définition du Lanceur des modifications qui affectent des éléments également présents dans le fichier maître (par exemple, la commande utilisée pour appeler Form Builder), ces modifications sont perdues. Toutefois, tout élément ajouté à votre fichier Lanceur et n'apparaissant pas dans le fichier maître demeure intact.


Ajout d'un répertoire à un projet ou à un sous-projet

Pour ajouter un répertoire à un projet ou à un sous-projet :

1	Dans le Navigateur de projet, assurez-vous que le noeud du projet auquel vous ajoutez les fichiers est sélectionné.

2	Sélectionnez Projet [image] Ajouter le répertoire au projet.

3	Passez au répertoire contenant les fichiers que vous voulez ajouter.

4	Cliquez sur OK pour ajouter le répertoire à votre projet ou à votre sous-projet.

Non seulement le répertoire est ajouté à votre projet, mais, s'il contient des sous-répertoires, ces derniers sont également ajoutés au projet. Par exemple, supposez que vous ayez sélectionné le projet Outils à l'étape 1. Vous ajoutez ensuite le répertoire Marteau, qui comporte un sous-projet appelé Alêne. Lorsque vous cliquez sur OK à l'étape 4, Marteau est ajouté à Outils en tant que sous-projet ; Alêne est ajouté en tant que sous-projet de Marteau.


Affichage des dépendances des projets

  Rubriques connexes

Pour afficher les dépendances de votre projet :

 Sélectionnez Navigateur [image] Affichage de dépendances.

Dans le Navigateur de projet, les modules sont maintenant classés en fonction de leur interdépendance. Les noeuds de projet sont situés au sommet de la hiérarchie, suivis des noeuds cible, eux-mêmes suivis des composants de ces cibles pouvant être générés (éléments d'entrée).


Création de projets en lecture seule

Pour créer un projet en lecture seule :

1	Créez un fichier de registres de projet à l'aide de l'assistant Projet ou de la boîte de dialogue Nouveau projet.

2	Modifiez les privilèges de lecture ou d'écriture pour le fichier nom.upd en suivant la méthode standard de votre système de fichiers.

Lors du prochain lancement de l'assistant Projet, le fichier de registres de projet est signalé par l'icône de lecture seule, [image]. Notez que l'état de lecture seule d'un projet se rapporte aux éléments du projet, et non aux fichiers représentés par ces éléments. Par exemple, même si l'application Forms dev2.fmb appartient à un projet en lecture seule, elle-même peut toujours être modifiée dans Form Builder. En revanche, les propriétés associées à l'élément de projet dev2.fmb ne sont pas modifiables (par exemple, les actions ou les macros associées à l'élément, son état de livraison, etc.). En outre, vous ne pouvez ni ajouter des éléments de projet à un projet en lecture seule, ni en supprimer.


Attribution d'un nouveau nom à une chaîne de connexion

  Rubriques connexes

Pour renommer une chaîne de connexion :

1	Sous le noeud Connexions du Navigateur de projet, sélectionnez la chaîne de connexion à renommer.

2	Cliquez dessus.

3	Entrez directement le nouveau nom en écrasant l'ancien.


A propos des projets

  Rubriques connexes

Les projets sont des ensembles de pointeurs vers tous les fichiers que vous estimez faire partie de votre application ou que vous voulez regrouper sur le plan conceptuel. Ils constituent les structures de données de base créées par Project Builder. Dans les projets, vous pouvez définir les éditeurs, les compilateurs et les autres outils que vous utilisez pour gérer vos fichiers de projet.

Les fichiers de projet peuvent être partagés et passés d'une plate-forme à l'autre. Pour cela, exportez-les.


A propos des registres de projet

  Rubriques connexes

Un registre de projet est un fichier contenant un projet. Chaque projet possède un registre de projet. Dès que vous créez un registre de projet, avec ou sans l'aide de l'assistant Projet, certaines entités sont automatiquement ajoutées à ce registre pour vous aider dans votre tâche. Ces entités comprennent les actions prédéfinies, les macros intégrées et prédéfinies, ainsi que la base de registres globale.


A propos des sous-projets

  Rubriques connexes

Les sous-projets sont des projets stockés, non pas dans leurs propres fichiers, mais dans d'autres fichiers projet.

Ils permettent notamment de regrouper plus précisément tous les éléments concernant une section particulière d'une application. Vous pouvez, par exemple, créer un sous-projet contenant les graphiques, menus, bibliothèques et documents qui constituent une application Forms donnée.


A propos des bases de registres utilisateur

  Rubriques connexes

Les bases de registres utilisateur stockent des informations de configuration pour chaque utilisateur. Chaque base de registres utilisateur hérite des informations de type provenant de la base de registres globale. Vous pouvez également définir vos propres types dans la base de registres utilisateur et remplacer certains aspects des définitions de type héritées de la base de registres globale. Une base de registres utilisateur stocke également des informations relatives à l'environnement et aux préférences, telles que les chaînes de connexion les plus utilisées, les paramètres de l'interface utilisateur et certaines informations générales relatives au projet.


A propos des types

  Rubriques connexes

Les types sont des descriptions de types de fichiers (affichages ou fichiers texte), auxquelles des actions ont été ajoutées. En d'autres termes, chaque définition de type peut être modifiée par une action qui s'applique alors à tous les fichiers de ce type dans le projet. Par exemple, vous pouvez définir pour les fichiers texte une action d'édition qui appelle toujours l'éditeur de texte que vous utilisez le plus.

Chaque description de type s'applique à un seul type de fichier, à l'exception des trois types définis par Project Builder, qui fournissent des définitions génériques de fichiers texte (type Texte), des fichiers de stockage des informations de projet (type Projet) et des liaisons avec les fichiers de projet (type Liaison de projets). Il existe également un type défini par Project Builder qui fournit une définition générique applicable à n'importe quel fichier (type Tout type). Pour afficher ces définitions de type, accédez à la base de registres globale via le Navigateur de projet, sélectionnez un type, puis choisissez Editer type ou Palette de propriétés dans le menu instantané.

Lorsque vous définissez un nouveau type, vous n'avez pas à fournir tous les détails. Demandez à Project Builder de les extraire d'un fichier exemple que vous indiquez.


A propos des actions

  Rubriques connexes

Les actions sont des chaînes de commande qui s'appliquent à des fichiers d'un type particulier. Une action n'est pas limitée à un seul type de fichier. Par exemple, si l'action Générer à partir de <type> est définie à la fois pour les fichiers d’application Forms et les fichiers d’objet, le fait de sélectionner un projet et de choisir Générer sélection dans le menu permet de compiler tous les fichiers .fmb et tous les fichiers source à l’aide des outils appropriés. Les actions peuvent être définies par rapport aux types d'un registre, par rapport aux projets ou aux sous-projets, ou encore par rapport à des fichiers particuliers dans les projets ou sous-projets.

Il existe deux types d’action :

•	Les actions prédéfinies, qui sont fournies avec Project Builder et mises automatiquement à la disposition de l'utilisateur via les options de menu ou les outils de la barre d'outils. Lorsqu'une action prédéfinie est définie pour un type de fichier pris en charge, elle est appelée pour tout élément de ce type qui est sélectionné lorsque vous appelez l'action à partir de Project Builder. Remarque : les actions prédéfinies ne doivent être modifiées que par l'administrateur de projets.

•	Les actions définies par l’utilisateur, qui sont des actions personnalisées que vous définissez et qui sont accessibles via les options des menus instantanés associés aux types d’objet auxquels vous appliquez les actions. Elles peuvent s'appliquer à un seul type de fichier ou à tous.

De plus, Project Builder fournit certaines actions prédéfinies mais applicables à plusieurs projets et fichiers, car elles s'adaptent aux différents types de fichier. De telles actions, appelées actions globales, sont généralement associées à des options de menu accessibles dans le menu principal. De plus, elles peuvent requérir des éléments d'entrée ou des fichiers source utilisés pour produire des fichiers cible, tels que des fichiers exécutables ou des applications Forms générées. Les actions globales peuvent déterminer si les cibles sont à jour, auquel cas les actions sont inutiles et ne sont pas exécutées. Elles comprennent les actions Générer à partir de <type> (accessible via les options de menu Générer sélection, Générer par incrément et Générer tout) et Livrer.


A propos des actions par défaut

  Rubriques connexes

Vous pouvez définir une action par défaut pour chaque type défini via Project Builder. Lorsqu'un utilisateur clique deux fois sur un élément de ce type, l'action par défaut est exécutée.

Si vous ne définissez pas d'action par défaut pour un type de manière explicite, l'action Edition est exécutée par défaut lorsqu'un utilisateur clique deux fois sur un élément. Si cette action n'existe pas, l'action Ouvrir est exécutée par défaut.


A propos de l'utilisation des actions
A propos de l’utilisation des actions

  Rubriques connexes

Pour utiliser une action, accédez au Navigateur de projet et sélectionnez le ou les éléments sur lesquels vous souhaitez agir. Affichez ensuite le menu instantané (à l'aide du bouton droit de la souris) et choisissez l’action, ou sélectionnez cette action dans le menu principal.

Lorsque vous définissez une action, rappelez-vous que vous ne pouvez pas y accéder, à moins d’indiquer qu’elle doit figurer dans le menu instantané. En outre, les actions globales fournies par Project Builder, telles que Génération, Livrer et les actions de contrôle de source, sont associées à des options de menu figurant dans le menu principal de Project Builder.

Selon votre plate-forme, vous pouvez exécuter l’action proprement dite, ou l’appeler via une fenêtre de shell ou un interpréteur de commandes. Pour plus d'informations, reportez-vous à la section de l'aide en ligne intitulée Informations sur la plate-forme.


A propos des macros

  Rubriques connexes

Les macros sont des variables propres à un type donné, qui peuvent être utilisées 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 expressions).

Les macros offrent une plus grande souplesse de spécification d'options de commande et permettent de modifier des ensembles de commande en modifiant une seule définition de propriété.

Il existe trois types de macro :

•	Les macros intégrées, fournies avec Project Builder. Leur nom comporte un seul caractère et elles ne peuvent pas être modifiées. Pour plus d'informations, reportez-vous à Macros intégrées.

•	Les macros prédéfinies, fournies par Project Builder pour vous aider dans votre tâche. Ces macros sont personnalisables. Elles comprennent la macro ORACONNECT, à utiliser pour les actions qui vous connectent à une source de données.

•	Les macros définies par l'utilisateur, qui sont des macros personnalisées que vous créez afin de modifier les actions prédéfinies et celles définies par l'utilisateur. Lorsque vous définissez une macro, vous pouvez l'utiliser pour modifier autant d'actions différentes que nécessaire. Vous n'avez pas besoin de définir une nouvelle macro pour chaque action.


A propos de la macro ORACONNECT

  Rubriques connexes

La macro ORACONNECT est une macro prédéfinie, constituée de macros conditionnelles imbriquées donnant comme résultat les champs d'une chaîne de connexion SQL*Net. Elle est fournie par Project Builder ; vous l'utilisez pour les actions qui vous connectent à une source de données.

Syntaxe  {nom_utilisateur ? {nom_utilisateur}}{mot_de_passe ? /{mot_de_passe}}{base_de_données ? @{base_de_données}}

où

{nom_utilisateur ? {nom_utilisateur}}	Nom utilisateur, si défini.
{mot_de_passe ? /{mot_de_passe}}	/Mot de passe, si défini.
{base_de_données ? @{base_de_données}}	@Source de données, si définie. Remarque : Si vous vous connectez à une source de données ODBC, la syntaxe est la suivante : @ODBC:source_données[:nom_bd] Si nombasededonnées n'est pas précisé, la source de données actuelle de la connexion ODBC est utilisée.
Toutes les valeurs proviennent des propriétés Nom utilisateur, Mot de passe et Base de données telles qu'elles apparaissent dans la Palette de propriétés. Vous pouvez attribuer ces valeurs en créant un élément de connexion et en le faisant glisser jusqu'à l’élément de projet souhaité, ou en entrant directement les valeurs dans la Palette de propriétés. Ces valeurs suivent les règles d'héritage standard ; elles peuvent être attribuées globalement à un type et remplacées dans la hiérarchie qui en dépend, au niveau de votre choix.

Par exemple, vous pouvez définir une chaîne de connexion standard pour un projet en définissant le nom utilisateur, le mot de passe et la base de données en créant un élément de connexion et en le faisant glisser jusqu'à l’élément de projet. Par contre, si vous créez un autre ensemble de données de test dans une base de données différente, vous pouvez soit remplacer cet élément de connexion par la nouvelle, soit éditer manuellement les valeurs pour Nom utilisateur, Mot de passe et Base de données au niveau approprié (le projet lui-même ou les éléments individuels dans le projet).

Toutes les valeurs de macro sont également facultatives. Si aucune valeur n’est définie, la macro imbriquée correspondante est considérée comme vide et n’est pas prise en compte.


A propos de l'utilisation des macros
A propos de l’utilisation des macros

  Rubriques connexes

Pour simplifier, une macro peut être considérée comme une variable. Vous pouvez créer ce type de variable et lui attribuer une valeur avant de travailler avec vos fichiers projet. Au cours de l'utilisation des fichiers de projet, vous pouvez faire référence à la macro depuis une action. Cette référence est remplacée par la valeur de la macro, ce qui modifie rapidement et simplement le résultat de l'action.

Par exemple, si vous utilisez les mêmes options lorsque vous appelez un outil souvent utilisé, vous pouvez définir une macro nommée options dans la boîte de dialogue Ajouter macro et la définir comme étant égale à la chaîne contenant les options de ligne de commande que vous utilisez. Vous définissez ensuite une action appelant votre outil et faites référence à la macro depuis cette action. Lors du prochain appel de l'outil à l'aide de cette action, toutes vos options sont déjà définies.

Vous pouvez également redéfinir des macros existantes. Toutefois, vous ne pouvez pas redéfinir les macros intégrées fournies par Project Builder.


A propos de la suppression d'éléments
A propos de la suppression d’éléments

  Rubriques connexes

Notez que, lorsque vous supprimez une entrée, vous ne supprimez pas de fichier du système de fichiers, mais uniquement, dans votre projet, le pointeur désignant ce fichier. Le contenu des fichiers et des répertoires reste inchangé.

De plus, lorsque vous supprimez une entrée, vous supprimez également les entrées de tous les fils de cette entrée. Par exemple, si vous supprimez un fichier .fmb, vous supprimez également le fichier .fmt associé. En outre, vous supprimez également tous les éléments implicites associés. Par exemple, si votre projet contient un fichier .fmb, alors que le fichier .fmx correspondant n'a pas encore été généré, la suppression du fichier .fmb entraîne celle du fichier .fmx implicite.


A propos des propriétés

  Rubriques connexes

Une propriété est une caractéristique d'un objet qui détermine le comportement ou l'aspect de cet objet.


A propos des dépendances

  Rubriques connexes

Le terme dépendance de projet fait référence à l'ordre dans lequel les entrées de projet dépendent les unes des autres, les noeuds de projet se trouvant au point le plus élevé de la hiérarchie, suivis des noeuds cible, eux-mêmes suivis par les composants de ces cibles qui peuvent être générés (éléments d’entrée). Par exemple, une application Forms exécutable dépend, et sera suivie, d'un fichier .fmb, qui peut dépendre, et être suivi, d'une bibliothèque utilisée pour une procédure de sortie utilisateur, et ainsi de suite.

Project Builder détecte automatiquement de nombreuses dépendances, sur la base de la propriété Type de livraison et de l'action Générer à partir de <type> des types interdépendants. Par exemple, le type Document d'application Forms (fichiers .fmb) a comme type de livraison la valeur Application Forms exécutable (fichiers .fmx). Project Builder peut donc en déduire que les fichiers .fmx de votre projet dépendent des fichiers .fmb associés et que, si ces fichiers .fmb sont modifiés, les fichiers .fmx doivent être régénérés en fonction de l'action de génération définie pour le type Application Forms exécutable (fichier .fmx). En fait, si votre projet ne comporte encore aucun fichier .fmx, Project Builder l'affiche sous forme d'un élément implicite découlant de l'existence du fichier .fmb.

Certains types de cible, tels que les fichiers .obj, peuvent comporter plusieurs sources ou types d’entrée différents. Ces cibles peuvent être associées à plusieurs actions Générer à partir de <type>. (Par exemple, affichez les propriétés du type Objet global dans la Palette de propriétés et examinez les actions Générer à partir de <type> qui lui sont associées.)

Si vous sélectionnez un projet et que vous choisissiez Projet [image] Générer par incrément, Project Builder compare les horodateurs des éléments cible (les fichiers .fmx dans l’exemple ci-dessus) à ceux de la source ou aux éléments d’entrée (les fichiers .fmb dans l’exemple ci-dessus) et ne régénère que les fichiers périmés.


A propos de la création manuelle de dépendances

  Rubriques connexes

Certains types de dépendance ne peuvent pas être détectés par Project Builder, dans le cas par exemple, où un affichage dépend d'une bibliothèque PL/SQL particulière. Pour être certain que ce type de dépendance est pris en compte dans votre projet, vous pouvez le définir manuellement. Pour cela, ajoutez la dépendance à votre projet, en dessous de l'élément qui en dépend.


A propos des héritages

  Rubriques connexes

L'héritage est l'opération par laquelle un élément de projet obtient d’un noeud ancêtre de l’arborescence des dépendances des informations d'actions, de macros ou de propriétés.

•	Le schéma de l'héritage des actions dépend du type de l'élément de projet.

•	Etant donné que les macros fonctionnent sans tenir compte du type, un élément de projet a accès à toutes les macros définies pour son sous-projet, son projet et le projet racine. De plus, un élément de projet peut accéder à toutes les macros définies pour son type dans les bases de registres utilisateur ou globale, comme peuvent y accéder tous les éléments du même type. S'il existe à deux niveaux différents deux macros portant le même nom, la définition de la macro située au niveau le plus bas (la plus proche de l'élément de projet) est utilisée.

•	Les éléments de projet comme les types peuvent hériter des propriétés. Les propriétés des éléments de projet peuvent être héritées de la définition de type d'un élément correspondant dans les bases de registres utilisateur ou globale ou, si elles n'existent pas, du métatype ou du type Tout type. Toutes les propriétés d'un élément de projet peuvent faire l'objet d'un héritage, à l'exception de Titre, Type, Nom de fichier et des propriétés situées sous le noeud Livraison.

Comme les fichiers de projet, les types peuvent hériter des propriétés de noeuds situés plus haut dans l'arborescence des dépendances. Par exemple, si vous n'avez défini aucune propriété pour le type .fmb mais qu'une propriété a été définie pour le métatype binaire, le type .fmb hérite de cette dernière car un fichier .fmb est considéré comme binaire. Toutes les propriétés de type peuvent faire l'objet d'un héritage, à l'exception de Titre, Format de nom de fichier, Contenu du fichier et Type de livraison.

Qu’elle soit héritée ou non, une propriété donnée est affichée dans la Palette de propriétés par les icônes suivantes :

•	L’icône d’héritage [image] indique qu’une propriété est héritée.

•	L’icône de remplacement [image] indique qu’une propriété héritée est remplacée.

•	L’icône Local [image] indique que la propriété a été définie dans la Palette de propriétés (et non transmise par héritage).

•	L’icône par défaut [image] indique que la propriété n’est pas encore définie.


A propos de l'héritage d'actions

  Rubriques connexes

L'élément de projet proprement dit se trouve au bas de l'arborescence du projet. Si une action ou une propriété est définie pour un élément, cette définition concerne uniquement cet élément ; elle n'a d'effet sur aucun autre. Dès lors, le facteur le plus important pour déterminer la manière dont un élément hérite des actions est son type. Par exemple, si vous n'avez pas défini l'action STOPGEN pour l'élément mais qu'elle est définie pour le sous-projet dans lequel l'élément se trouve, cet élément hérite de l'action tant qu'elle est définie pour son type d'élément. Ainsi, si l'action STOPGEN est définie pour les exécutables et que l'élément est un fichier texte, cet élément n'hérite pas de cette action.

Depuis le sous-projet, l'héritage remonte au niveau du projet duquel l'élément reçoit par héritage toutes les actions applicables au type d'élément [image] en supposant qu'elles n'entrent pas en conflit avec les définitions de niveau inférieur (sous-projet ou élément). Toujours en remontant dans l'arborescence des dépendances, l'élément hérite des actions comme suit :

•	Depuis le noeud Projets, situé au niveau le plus élevé, puis...

•	Depuis la définition du type dans la base de registres utilisateur, si ce type existe, puis...

•	Depuis la définition du type dans la base de registres globale. Si un type figure dans la base de registres globale et dans votre base de registres utilisateur, les éléments de projet héritent des actions de ce type depuis la base de registres utilisateur, puis...

•	Depuis le métatype de l'élément (texte, binaire ou Autre que fichier).

Enfin, l'élément hérite des actions du type Tout type, tant qu'elles n'entrent pas en conflit avec les définitions de niveau inférieur. Ainsi, si l'action PUT est définie pour le type Tout type mais qu'il existe également une action PUT définie pour les fichiers .fmx au niveau du projet racine, tous les fichiers .fmx d'un projet utilisent la définition du niveau du projet racine car il est situé à un niveau inférieur dans l'arborescence.


Membre d'un projet ou d'un sous-projet.


Toute entité pour laquelle une action peut être définie : élément, sous-projet, projet ou type.


A propos des métatypes

  Rubriques connexes

Les métatypes permettent de définir des actions qui affectent plusieurs types et, par conséquent, plusieurs fichiers, à la fois. Par exemple, les commandes tar et zip traitent les fichiers texte et les fichiers binaires de manière différente. Si vous définissez ces actions au niveau du métatype, tous les fichiers texte et binaires héritent de l'action correspondant à leur type.

Tous les éléments de projet appartiennent à l'un des trois métatypes suivants : texte, binaire ou Autre que fichier.

•	Un élément Texte est un élément pouvant être modifié à l'aide d'un éditeur tel que vi ou WordPad. Le nom interne est UPDTEXT. Dès que vous créez un fichier portant l'extension .txt, celui-ci appartient automatiquement au métatype Texte.

•	Un élément binaire est un fichier ne pouvant pas être lu à l'aide d'un éditeur de texte, comme un fichier exécutable ou une bibliothèque. Le nom interne est UPDBINARY.

•	Un élément Autre que fichier est un élément qui n'est pas un fichier réel, comme une table de base de données ou une URL. Etant donné que les éléments Autre que fichier n'ont pas d'horodatage, Project Builder génère toujours l'élément lorsque vous exécutez l'action Générer par incrément. Le nom interne est UPDNONFILE.

Lorsque vous définissez un nouveau type à l'aide de l'assistant Type de module, vous êtes invité à choisir le métatype dont ce nouveau type doit hériter des informations.

Les métatypes sont stockés dans la base de registres globale. Pour afficher les propriétés d'un métatype, cliquez deux fois sur son noeud dans la base de registres globale, puis sélectionnez l'assistant Type de module. Ces propriétés sont personnalisables.


A propos des éléments implicites

  Rubriques connexes

Les éléments implicites sont des éléments de projet, qui résultent habituellement d'une génération automatique, pour lesquels Project Builder crée automatiquement des entrées dans le Navigateur de projet.

Project Builder sait quels éléments implicites créer en établissant une corrélation entre la valeur de la propriété Type de livraison pour chacun des types définis et les éléments d’entrée, ou source, requis pour chaque action Générer à partir de <type>.

Par exemple, la valeur Type de livraison d'un fichier .fmb est un exécutable Form Builder, ou fichier .fmx. Examinez maintenant l'action Générer à partir de <type> du type Exécutables Forms dans la base de registres globale. Elle indique Générer à partir de FMB. Cela signifie que les fichiers .fmb constituent les éléments d'entrée à utiliser pour créer des fichiers .fmx. Project Builder peut identifier chaque fichier .fmb de vos projets et reconnaître qu'un fichier .fmx est créé de manière implicite à cause de l'existence du fichier .fmb, que ce fichier .fmx existe déjà réellement ou non.

Prenez un autre exemple. Supposez que vous ajoutiez un fichier source C à un fichier de bibliothèque. Dans ce cas, Project Builder ajoute les fichiers de n’importe quels autres types nécessaires à l’obtention du chemin complet des actions Générer à partir de <type> d’un type de fichier à l’autre (un fichier d’objet, par exemple).

Bien que la redéfinition des propriétés d'un élément implicite soit d'une utilisation limitée (puisque la compilation suivante détruit les modifications), ces éléments présentent l’avantage de pouvoir être examinés par des actions d’édition, d’affichage ou d’impression.


A propos des cibles

  Rubriques connexes

Une cible est la sortie finale logique d'un fichier ou d'un groupe de fichiers de votre projet. Par exemple, un exécutable est une cible (de compilation) d'une bibliothèque, alors qu'une bibliothèque est une cible d'un groupe d'objets, et qu'un objet est une cible d'un fichier source. Les cibles sont générées à partir d’éléments d’entrée ; les éléments d’entrée sont livrés sous forme de cibles.


A propos des éléments d'entrée
A propos des éléments d’entrée

  Rubriques connexes

Les éléments d'entrée sont des fichiers source utilisés pour générer des cibles telles que des fichiers exécutables : par exemple, un fichier .fmb est l'entrée d'un fichier .fmx. Les éléments d'entrée sont livrés sous forme de cibles ; les cibles sont générées à partir d'éléments d'entrée.


A propos de la livraison d'applications
A propos de la livraison d’applications

  Rubriques connexes

L'expression livraison d'une application renvoie au processus de préparation d'une application complète en vue de la diffuser et de la déployer. Utilisez l'assistant Livraison pour livrer votre application.


A propos de l'affichage des dépendances
A propos de l’affichage des dépendances

  Rubriques connexes

L'affichage des dépendances présente, dans le Navigateur de projet, les fichiers triés suivant leurs relations de dépendance, les noeuds de projet se trouvant au point le plus élevé de la hiérarchie, suivis des noeuds cible, eux-mêmes suivis de leurs composants pouvant être générés (éléments d’entrée). Par exemple, une application Forms exécutable dépend, et sera suivie, d'un fichier .fmb, qui peut dépendre, et être suivi, d'une bibliothèque utilisée pour une procédure de sortie utilisateur, et ainsi de suite.

Notez que vous pouvez définir les dépendances manuellement, en ajoutant des fichiers à un projet se trouvant en dessous de l'élément qui en dépend.

L'affichage des dépendances permet essentiellement de vérifier les dépendances entre les fichiers.


A propos de l'affichage de projet
A propos de l’affichage de projet

  Rubriques connexes

L'affichage de projet présente les éléments de projet, classés par type et en fonction des relations de projet à sous-projet. Les projets sont classés en ordre alphabétique par fichier de projet, puis en ordre alphabétique par catégorie. L'affichage de projet permet essentiellement de savoir à tout moment le nombre de fichiers de votre projet, et leur type.


A propos du Lanceur

  Rubriques connexes

Le Lanceur est la barre d'outils secondaire qui se trouve par défaut en haut de la fenêtre de Project Builder. Il offre des fonctions d'organisation et de lancement d'applications.

Le Lanceur permet notamment de centraliser l'accès aux outils que vous utilisez le plus fréquemment.


A propos des groupes

  Rubriques connexes

Les groupes sont des ensembles d'éléments connexes auxquels vos pouvez accéder par des sous-menus du Lanceur. Ils vous permettent de configurer le Lanceur pratiquement comme le menu Démarrer de Windows 95, et comportent des options instantanées qui révèlent d'autres applications et/ou ensembles d'applications. Par exemple, vous pouvez définir un groupe appelé « Outils admin, » contenant un éditeur de texte, un programme de planification et d'autres outils de gestion.


A propos de l'administration de projets
A propos de l’administration de projets

  Rubriques connexes

Si vous êtes administrateur de projets, certaines options vous sont proposées lorsque vous installez Project Builder et que vous le mettez à la disposition des membres de votre équipe de développement. Notez, lorsque vous choisissez la configuration à utiliser, que Project Builder dépend, pour sa sécurité, de protocoles de partage de fichiers natifs.

Si votre équipe travaille en réseau, vous pouvez installer la base de registres globale dans un répertoire partagé afin que tous les développeurs puissent accéder à la même copie. Ceci garantit que toutes les versions de la base de registres globale utilisée sont à jour. Toutefois, si vous choisissez cette option, effectuez de préférence l'installation dans un répertoire auquel vous seul avez un accès en écriture. Vous évitez ainsi toute altération accidentelle de la base de registres globale.

L'autre option consiste à donner à tous les membres de votre équipe de développement leurs propres copies locales de la base de registres globale. Les mises à jour de cette base de registres doivent alors être transmises par les fonctions Export et Import de Project Builder. Si vous choisissez cette option, n'oubliez pas que les bases de registres globales individuelles ne sont alors pas à l'abri des suppressions ou des écrasements accidentels.

Vous pouvez également installer tous les fichiers sur un serveur de réseau, pour que tous les membres de votre équipe partagent non seulement la base de registres globale mais aussi toutes les bases de registres utilisateur, tous les fichiers de registre de projet, etc. Cette solution peut être suffisante si les membres de votre équipe de développement n'éditent que les fichiers eux-mêmes, et non les projets. Cependant, si vous choisissez cette option, tenez compte des risques de modifications conflictuelles de types, d'actions, de projets et de fichiers de projet.


A propos de la base de registres globale

  Rubriques connexes

La base de registres globale contient des informations communes à toute une installation Forms ou Reports Developer. Ces informations sont limitées aux définitions de type et aux options qui leur sont associées, ainsi qu'aux propriétés intégrées ou définies pour l'utilisateur. L'utilisation de la base de registres globale est facultative. Ses fonctions peuvent être exécutées par des registres utilisateurs individuels.

La base de registres globale ne doit être modifiée que par l'administrateur de projets.


A propos de l'export d'un projet
A propos de l’export d’un projet

  Rubriques connexes

L'export d'un projet est l'écriture d'un fichier, contenant des définitions de projet, de type, d'action et/ou de macro, dans un format portable, en vue de sa transmission à d'autres utilisateurs travaillant éventuellement sur des plates-formes différentes.

L'export de projet permet notamment de répartir le développement des applications.


A propos de l'import d'un projet
A propos de l’import d’un projet

  Rubriques connexes

L'import d'un projet est l'incorporation d'un fichier contenant des informations sur un projet.

L'import d'un projet permet notamment de répartir le développement des applications.


A propos des états de projet

  Rubriques connexes

Les états de projet sont des états contenant des informations sur vos projets : types définis pour le projet, actions modifiant les types de projet, éléments associés à vos projets, définitions de connexion et informations concernant le Lanceur, par exemple. Project Builder vous permet de générer automatiquement des états de projet.

Les états de projet sont intéressants dans un environnement de développement en équipe.


A propos de la défragmentation des registres de projet

  Rubriques connexes

Lorsque vous ajoutez ou supprimez des éléments d'un registre de projet, une fragmentation de la zone de stockage peut se produire. Pour empêcher cette fragmentation de réduire les performances du système, Project Builder propose un outil de défragmentation pour récupérer la mémoire inutilisée.

Vous pouvez contrôler le niveau de fragmentation toléré pour les fichiers de registres de projet en définissant un pourcentage dans la boîte de dialogue Préférences. Ce pourcentage indique la quantité d'espace vide pouvant coexister avec vos données. Chaque fois que vous ouvrez un projet qui dépasse ce pourcentage, un message d'alerte vous invite à lancer le processus de défragmentation.

En choisissant le pourcentage de fragmentation à tolérer, vous devez trouver un compromis entre les risques de dégradation possible des performances et le temps passé à réagir au message d'alerte en cas de fragmentation. Si vous choisissez une valeur élevée, l'affichage du message d'alerte est assez rare, mais votre système peut être ralenti par la fragmentation. Si vous choisissez une valeur peu élevée, votre système fonctionne correctement (en supposant que vous choisissiez d'effectuer la défragmentation lorsque vous y êtes invité), mais vous consacrez du temps à la défragmentation pratiquement à chaque ouverture d'un projet. Le pourcentage par défaut est 10 %.


A propos du partage de projets

  Rubriques connexes

Si vous prévoyez de partager vos projets avec d'autres utilisateurs, vous pouvez gagner du temps en changeant tous les chemins d'accès absolus de votre fichier PJUSER.UPD en chemins d'accès relatifs. Pour ce faire, consultez les champs Répertoire du projet , Répertoire père et Nom de fichier de la Palette de propriétés de chaque projet, sous-projet et élément, en modifiant manuellement les chemins d'accès absolus quel que soit l'endroit où ils apparaissent. Par exemple, si la valeur du champ Nom de fichier est /HOME/COOKIES/SUGAR/crumb.fmb et que le projet père est /HOME/COOKIES/SUGAR, vous pouvez tout supprimer à l'exception de crumb.fmb pour en faire un nom de fichier relatif.

En vous assurant que toutes les entrées correspondant à des noms de fichiers, des répertoires de projet pères et des répertoires de projet indiquent des chemins d'accès relatifs, vous permettez à d'autres utilisateurs de partager vos projets simplement en copiant le fichier .UPD et votre structure de répertoires, puis en modifiant le nom du projet racine pour refléter l'emplacement de racine correct. Si tous les chemins d'accès aux fichiers sont relatifs, vous pouvez commencer immédiatement à travailler sur ces fichiers. Si des chemins absolus sont présents en un point quelconque de votre projet, chacune des personnes partageant ce projet doit remplacer manuellement toutes les occurrences de l'emplacement racine, avant de pouvoir travailler sur les fichiers.


A propos du répertoire de projet et du répertoire père

  Rubriques connexes

La Palette de propriétés comporte trois champs dont il est important de comprendre le fonctionnement si vous projetez de partager vos projets avec d'autres utilisateurs : Répertoire du projet, Répertoire père et Nom de fichier .

•	Le champ Répertoire du projet contient le nom du répertoire où se trouvent les fichiers du projet. (Ce champ n'est utilisé que pour les projets et les sous-projets.) Pour les sous-projets, le répertoire de projet renvoie au sous-répertoire approprié dans l'arborescence du projet père. (Par exemple, si le sous-projet SUGAR se trouve dans /HOME/COOKIES, le répertoire de projet est SUGAR et le répertoire père est /HOME/COOKIES.)

Pour faciliter la gestion (et le partage) des projets, il est recommandé de placer les fichiers de projet dans le répertoire de projet et de créer des sous-projets pour refléter les sous-répertoires de ce répertoire.

•	Le champ Répertoire père correspond au nom du répertoire où se trouve un élément. Pour la plupart des éléments, il s'agit simplement du nom du répertoire de projet. Si l'élément appartient à un sous-projet, le répertoire père est la combinaison du répertoire de projet père et du répertoire de projet (en fait, le sous-répertoire). Par exemple, si l'élément crumb.fmb se trouve dans /HOME/COOKIES/SUGAR, la combinaison suivante est également le nom de son répertoire père : le répertoire de projet père (/HOME/COOKIES), plus le répertoire du projet (SUGAR).

•	Le champ Nom de fichier est le nom de l'élément proprement dit. L'affichage de chemins d'accès absolus ou relatifs dans ce champ dépend de l'emplacement réel du fichier. Si le fichier se trouve dans le répertoire du projet, le chemin d'accès relatif apparaît. Si le fichier se trouve dans un autre répertoire, le chemin d'accès complet est utilisé.

Si le champ Répertoire du projet est vide, cela signifie qu'aucun répertoire n'a été indiqué lors de la création du projet. Dans ce cas, tous les éléments ajoutés au projet figurent avec leur chemin relatif par rapport au répertoire de projet racine. (Pour connaître le nom de ce répertoire, sélectionnez le noeud Projet, ouvrez la Palette de propriétés et lisez le contenu du champ Répertoire du projet.)


A propos des filtres

  Rubriques connexes

Un filtre vous permet d'afficher dans le Navigateur de projet uniquement les projets ou éléments de projet répondant à certains critères. Lorsque vous appliquez un filtre, les objets ne répondant pas aux critères indiqués dans la définition du filtre sont masqués. Vous pouvez générer vos filtres à partir de la totalité, de certaines ou simplement d'une seule des propriétés de la Palette de propriétés. Par exemple, vous pouvez afficher tous les éléments dont la propriété Livrer est activée, quel que soit le projet auquel ils appartiennent. Vous pouvez également afficher tous les fichiers .fmb des projets actuellement ouverts.

Avant d'appliquer un filtre, vérifiez que tous les projets dans lesquels vous voulez effectuer une recherche sont ouverts. Les filtres sont simplement un moyen de limiter le contenu du Navigateur de projet, et ce dernier n'affiche que les projets ouverts.

Le nom du filtre appliqué figure toujours dans l'angle inférieur gauche de la zone d'état du Navigateur de projet.


A propos du mode Aperçu des actions

  Rubriques connexes

Le mode Aperçu des actions vous permet de tester les actions et de connaître les valeurs utilisées pour divers paramètres et macros, sans exécuter réellement l'action. Lorsque vous appelez une action en mode Aperçu des actions, l'action entièrement développée apparaît à l'écran. Tant que vous restez en mode Aperçu des actions, toutes les actions opèrent de cette manière ; vous ne pouvez pas réellement les exécuter tant que ce mode n'est pas désactivé.


A propos de l'action Génération

  Rubriques connexes

Project Builder propose deux méthodes de génération de projets, d'éléments sélectionnés et d'éléments modifiés :

•	En mode interactif, via les options Projet [image] Génération. Cette méthode est plus interactive, car vous voyez apparaître à la fois des boîtes de dialogue et des messages d'erreur auxquels vous pouvez réagir.

•	En mode de traitement par lots, que vous activez en cochant la case Activer sortie batch de l'onglet Navigateur de la boîte de dialogue Préférences. En mode de traitement par lots, l'action Génération est exécutée sans contrôle ni participation de votre part.


Entrez ici les libellés des nouvelles rubriques


Types prédéfinis

Les types prédéfinis à utiliser dans les projets dépendent des produits installés.

Pour connaître ces types prédéfinis, développez le noeud Types sous la base de registres globale.


Utilisation générale des macros

  Rubriques connexes

Les macros sont des variables qui s'appliquent à des éléments de projet de types spécifiques. Pour définir une macro, utilisez la boîte de dialogue Ajouter Macro pour indiquer son nom et la rendre équivalente à la chaîne que vous voulez exécuter lorsque vous utilisez la macro.

Pour utiliser une macro, indiquez son nom, entre accolades, dans la chaîne comprenant une action ou une autre définition de macro. Placez la macro où vous entreriez normalement la chaîne à laquelle elle équivaut.

Pour inclure une chaîne qui doit être entourée d'accolades mais ne doit pas être développée, entourez-la, accolades comprises, de guillemets simples ou doubles.

En outre, vous pouvez imbriquer des macros dans d'autres macros, définir des conditions (pour créer une situation de réponse par oui/non) et définir une action qui appelle un autre Interpréteur de commandes et exécute des fichiers batch. Pour plus d'informations sur l'imbrication des macros, reportez-vous à Imbrication des macros. Pour plus d'informations sur les macros conditionnelles, reportez-vous à Macros conditionnelles. Pour plus d'informations sur l'appel d'un Interpréteur de commandes propre à une plate-forme et sur l'exécution de fichiers batch, reportez-vous à la section de l'aide intitulée Informations propres à la plate-forme Forms Developer.

Notes d'utilisation

•	Vous pouvez indiquer un nom de macro en utilisant toute combinaison de caractères alphanumériques et de caractères de soulignement. Par exemple, Ma_Macr0 est valide, mais Ma&macr@ ne l'est pas.

•	Les macros sont étendues de manière récursive : si la valeur d'une macro appelée bar est définie à la macro {foo} qui existe déjà, lorsqu'une action ou une autre macro fait référence à bar, la valeur de foo lui est substituée.

•	Il est conseillé de ne pas utiliser de noms en un caractère lorsque vous indiquez des noms de macro. Réservez les noms de macro en un caractère aux macros intégrées qui seront fournies dans les futures versions de Project Builder.


Types de macro

  Rubriques connexes

Lorsque vous créez une nouvelle macro, vous êtes invité à définir son type. Tous les types de macro, à l'exception du type Texte statique, affichent à l'exécution un menu instantané invitant l'utilisateur à entrer des informations ou à accepter la valeur par défaut. Les différents types de macro sont les suivants :

Texte statique	Choisissez ce type si l'utilisateur n'a pas besoin de fournir ou de remplacer de valeurs à l'exécution.
Texte	Choisissez ce type pour permettre à l'utilisateur d'afficher à l'exécution la totalité de la définition de la macro et, s'il le désire, de remplacer des valeurs ou d'en fournir de nouvelles.
Liste	Choisissez ce type si vous voulez que l'utilisateur sélectionne une valeur dans la liste que vous avez définie. Exemple : Sélection de l'ID d'une imprimante vers laquelle envoyer une sortie.
Editer liste	Choisissez ce type si vous voulez que l'utilisateur sélectionne une valeur dans la liste que vous avez définie ou qu'il entre une nouvelle valeur dans la zone de liste déroulante.
Number	Choisissez ce type si vous voulez que l'utilisateur fournisse un nombre compris dans une plage particulière. Exemple : Indication du nombre de copies à envoyer à une imprimante.
Vrai/Faux	Choisissez ce type si vous voulez que l'utilisateur détermine si une condition est vraie ou fausse. Exemple : Détermination de la production d'un code optimisé par le compilateur. Si l'utilisateur clique sur Vrai, un code optimisé est produit. S'il clique sur Faux, un code débogué est produit.
Fichier	Choisissez ce type si l'utilisateur doit fournir un nom de fichier pour répondre à la macro. Le menu instantané contient un bouton Parcourir pour aider l'utilisateur. Exemple : Attribution d'un nom au fichier dans lequel un fichier .zip est décompressé.
Répertoire	Choisissez ce type si l'utilisateur doit indiquer un répertoire pour répondre à la macro. Le menu instantané contient un bouton Parcourir pour aider l'utilisateur. Exemple : Attribution d'un nom au répertoire dans lequel un fichier .zip est décompressé.


Macros utilisées dans Project Builder.
Macros utilisées dans Project Builder

  Rubriques connexes

Les macros utilisées avec Project Builder peuvent appartenir à l'un [image] ou à une combinaison de plusieurs [image] des types suivants :

•	macros simples

•	macros intégrées

•	macros prédéfinies

•	variables d'environnement


Macros simples

  Exemple	  Rubriques connexes

Description  Les macros simples sont des macros qui équivalent à des chaînes simples. Lorsque vous faites référence à ce type de macro à partir d'une action ou d'une autre macro, la macro est remplacée par cette chaîne.

Utilisation

•	Pour faire référence à une macro simple, entrez son nom, entre accolades, dans l'action ou la macro au point de la commande où cette chaîne serait exécutée.

•	Pour inclure une chaîne entre accolades sans la développer, placez-la entre guillemets ou entre apostrophes.

•	Pour inclure une chaîne contenant des guillemets ou des apostrophes, mais qui doit être développée, entrez chaque guillemet ou apostrophe dans son inverse : utilisez des apostrophes pour encadrer un guillemet (‘ " ’), utilisez des guillemets pour encadrer une apostrophe (" ‘ ").

•	Pour inclure les caractères ":" (deux-points), "?" (point d'interrogation), et "{" ou "}" (accolade ouvrante ou fermante), entrez-les entre guillemets ou apostrophes. Comme ces caractères sont utilisés par les macres de Project Builder, l'omission des guillemets ou apostrophes risquerait d'entraîner des erreurs d'interprétation. Pour plus d'informations, reportez-vous à Macres conditionnelles.

Notes d'utilisation  La syntaxe de la chaîne est fonction de votre plate-forme. Le portage de ces macros sur une plate-forme différente demandera d'adapter la syntaxe aux règles de la nouvelle plate-forme. Les conflits possibles peuvent être - mais sans limitation - des conflits de longueur de nom de fichier, de différence entre majuscules et minuscules et de barres obliques normales ou inversées. Pour plus d'informations, reportez-vous à la section de l'aide intitulée Informations propres à la plate-forme Forms Developer.


Utilisation d'une macro simple - Exemple

Vous utilisez un format standard pour l'impression des états et voulez définir une action d'impression pour imprimer vos états à partir de Project Builder.

Vous pouvez définir une macro appelée monimprim et la déclarer comme égale au nom de l'imprimante à utiliser. Par exemple, vous pouvez entrer « "HPLASER_101" » dans la zone de texte Valeur (sans oublier les guillemets qui entourent la chaîne).

Si votre exécutable d'impression est print.exe, vous pouvez alors définir une action d'impression de la manière suivante :

print.exe {n}{monimprim}

où {n} est la macro intégrée qui fait référence au nom complet du fichier en cours.

Lorsque vous sélectionnez l'état sales.rep dans le Navigateur de projet et choisissez Imprimer dans le menu instantané, Project Builder remplace {n} par le nom complet de sales.rep et {monimprim} par HPLASER_101, et envoie la commande résultante

print.exe c:\projects\reports\ventes.rep HPLASER_101

au système d'exploitation. au système d'exploitation.

Remarque :  Dans l'exemple ci-dessus, Project Builder a développé la macro n au nom totalement qualifié de sales.rep. Cependant, si vous créez une macro contenant une ligne de commande DOS, n'oubliez pas de mettre les deux-points qui suivent la lettre du lecteur entre guillemets simples : c':'\projects\reports\sales.rep pour que le signe deux-points soit évalué correctement.


Macros intégrées

  Exemple	  Rubriques connexes

Description  Macros fournies par Project Builder.

Les macros fournies par Project Builder pour être utilisées avec des actions sont les suivantes :

Macro	Signification
1-9	Fait référence aux types d'entrées 1 à 9 demandées par une action. Seules les actions de contrôle de version, de génération et de livraison acceptent des entrées.
b	Fait référence au nom de fichier de base de l'élément ou du fichier sur lequel l'action doit porter (en d'autres termes, au nom du fichier sans extension).
d	Fait référence au répertoire dans lequel se trouve l'élément.
f	Fait référence au nom de fichier de l'élément.
i	Fait référence à tous les éléments d'entrée nécessaires à une action. Seules les actions de contrôle de version, de génération et de livraison acceptent des entrées.
l	Fait référence à un fichier journal temporaire dont le nom de fichier est généré automatiquement.
n	Fait référence au nom complet de la cible.
p	Fait référence au répertoire de projet de la cible contenant le projet ou le sous-projet.
s	Fait référence au séparateur utilisé sur la plate-forme en cours (/ ou \). (Cette propriété est déterminée par le système d'exploitation.)
t	Fait référence au nom abrégé du type de cible ; par exemple FMB pour un document Form Builder.
Utilisation  Pour faire référence à une macro intégrée, entrez son nom, entre accolades, au point de l'action auquel cette chaîne serait exécutée. Vous pouvez également procéder de la même manière pour inclure des macros intégrées dans d'autres macros.

Notes d'utilisation

•	Vous ne pouvez pas redéfinir la valeur d'une macro intégrée.

•	Comme les futures versions de Project Builder comporteront des macros intégrées ayant des noms en un caractère, il est conseillé de ne pas utiliser à l'heure actuelle ce type de noms de macro.

•	Pour connaître le mode de résolution de diverses macros intégrées, essayez de les insérer dans des actions, puis d'exécuter ces actions en mode Aperçu des actions.


Utilisation d'une macro intégrée - Exemple

Project Builder utilise souvent des macros intégrées dans des actions prédéfinies. Pour en visualiser quelques exemples, procédez de la manière suivante :

1	Si nécessaire, développez le nœud Types globaux pour afficher les types globaux.

2	Choisissez Tout type, puis sélectionnez Palette de propriétés dans le menu instantané.

3	Si nécessaire, développez le nœud Actions de la Palette de propriétés et examinez les différentes actions de contrôle de source prédéfinies, comme la vérification du fichier à l'archivage et l'extraction. Le fichier que vous voulez archiver ou extraire (fichier d'entrée) est indiqué par la macro intégrée 1 (bien évidemment entre accolades). La macro intégrée n apparaît dans d'autres commandes, et fait référence au nom complet de fichier.

Vous pouvez procéder de la même manière pour utiliser des macros intégrées dans vos propres actions. N'oubliez pas d'entrer le nom des macros intégrées entre accolades.


Macros prédéfinies

  Exemple	  Rubriques connexes

Description  Macros personnalisables qui sont fournies par Project Builder et auxquelles sont attribuées des valeurs préliminaires.

Utilisation  Les macros prédéfinies s'utilisent comme toutes les autres macros.

Notes d'utilisation

•	Les macros prédéfinies disponibles dépendent à la fois de la plate-forme et des outils Forms Developer que vous avez installés. Pour connaître les macros que vous pouvez utiliser pour un élément donné (type, projet ou fichier), sélectionnez l'élément dans le Navigateur de projet, affichez la Palette de propriétés et, si nécessaire, développez la section Macros. Pour afficher les macros prédéfinies utilisables pour tous les éléments, sélectionnez Tout Type dans la base de registres globale et examinez les macros associées dans la Palette de propriétés.

•	Les valeurs associées aux macros prédéfinies sont facilement personnalisables en fonction de vos préférences. Les valeurs possibles dépendent des outils existant sur votre plate-forme. Par exemple, sur les plates-formes Windows, la macro D2KEDITOR est définie sous la forme {EDITOR ? {EDITOR} : notepad}, ce qui signifie que votre éditeur par défaut est Notepad (Bloc-notes), sauf si vous définissez une macro appelée EDITOR et que vous la rendez équivalente à un autre traitement de texte existant sous Windows. Sous Motif, D2KEDITOR est définie sous la forme {EDITOR ? {EDITOR} : vi}, ce qui signifie que votre éditeur par défaut est vi, sauf si vous définissiez une macro appelée EDITOR et que vous la rendez équivalente à un autre traitement de texte existant sous Motif.

Remarque : Dans les macros ci-dessus, les blancs qui précèdent et suivent le point d'interrogation et les deux-points ne sont pas obligatoires.


Utilisation d'une macro prédéfinie - Exemple

Si vous avez installé Form Builder, la macro F50GENOPTS est prédéfinie pour être utilisée avec tous les types de Form Builder. La valeur initiale qui lui a été attribuée est :

Batch=NO Help=NO Logon={ORACONNECT ? YES : NO} Module_Access=FILE Options_Screen=NO Statistics=NO

En d'autres termes, ces options sont celles de la ligne de commande, avec les valeurs de mots-clés par défaut, pour F50GEN.

Si vous avez plusieurs fichiers à exécuter par lots, vous pouvez éditer la macro F50GENOPTS de la Palette de propriétés pour donner à Batch la valeur YES au niveau voulu dans la hiérarchie de Project Builder : modifiez la macro dans les types Form Builder au niveau de votre base de registres utilisateur pour la modifier pour tous les documents Form Builder de tous les projets, ou sélectionnez dans vos projets les documents Form Builder que vous voulez modifier.

Remarque : Dans l'exemple ci-dessus, les blancs qui précèdent et suivent le point d'interrogation et les deux-points ne sont pas obligatoires.


Variables d'environnement utilisées comme macros

  Exemple	  Rubriques connexes

Description  Vous pouvez utiliser des variables d'environnement, également appelées logiques, comme valeurs de macros. Lorsque Project Builder rencontre une référence de macro contenant le nom d'une variable d'environnement, il recherche l'élément d'abord dans la liste des macros déjà définies pour l'élément, puis dans les variables d'environnement existantes, et effectue la substitution appropriée.

Les variables d'environnement permettent d'établir des chemins relatifs d'accès à différents types de fichiers, comme des exécutables et des icônes.

Utilisation  Pour faire référence à une variable d'environnement sous la forme d'une macro, entrez le nom de la variable d'environnement, entre accolades, au point approprié de l'action. Vous pouvez procéder de la même manière pour inclure des variables d'environnement dans d'autres macros.

Notes d'utilisation

•	Si la variable d'environnement à laquelle vous tentez de faire référence n'est pas définie ou est mal définie, la résolution de la macro donnera une chaîne vide et la macro ne sera pas prise en compte.

•	Les variables d'environnement que vous pouvez utiliser dans les macros de Project Builder dépendent de votre plate-forme. Pour plus d'informations, reportez-vous à la section de l'aide intitulée Informations propres à la plate-forme Forms Developer.


Utilisation d'une variable d'environnement comme une macro - Exemple

Project Builder utilise des variables d'environnement dans différentes actions prédéfinies. Pour en afficher un exemple, procédez de la manière suivante :

1	Si nécessaire, développez le nœud Types globaux pour afficher les types globaux.

2	Sélectionnez le type de document d'application Forms, puis sélectionnez Palette de propriétés dans le menu instantané.

3	Si nécessaire, développez le nœud Actions de la Palette de propriétés, et examinez l'action de génération (FMT). Notez l'utilisation de ORACLE_HOME. Il n'y a pas de macro ORACLE_HOME sous le nœud Macros, car la macro ORACLE_HOME utilisée par cette action est une variable d'environnement.

Notez également sa position dans l'action : elle se trouve au début d'un chemin et est utilisée dans cette action et dans d'autres pour créer le chemin d'accès relatif à un exécutable nécessaire.

N'oubliez pas qu'il n'est pas nécessaire de définir des variables d'environnement comme des macros. Il suffit d'entrer leur nom, entre accolades, dans votre action.


Définition de macros conditionnelles

  Exemple	  Rubriques connexes

Vous pouvez demander que la valeur d'une macro dépende d'une condition. Pour cela, utilisez l'expression :

{nommacro ? expression1 : expression2}

où :

nommacro	Nom de la macro
expression1	Expression à laquelle la macro est évaluée si elle a été définie et si une valeur lui a été attribuée.
expression2	(Facultative)  Expression à laquelle la macro est évaluée si elle n'a pas été préalablement définie ou si elle a été définie sans qu'une valeur lui ait été attribuée.
Si vous voulez rendre la macro équivalente à une chaîne vide, si elle n'a pas encore été définie et n'a pas de valeur attribuée, omettez simplement l'expression finale :

{nommacro ? expression1}

Dans ce cas, si la macro nommacro a été définie et si une valeur lui a été attribuée, le résultat de l'évaluation sera expression1. Si la macro n'a pas été définie ou a été rendue équivalente à une chaîne vide, elle restera une chaîne vide.

Remarque : Dans une macro, les blancs ne sont pas pris en compte. Par exemple, dans la première expression ci-dessus, tous les blancs qui précèdent et suivent le point d'interrogation et les deux-points ne sont ni obligatoires ni évalués.


Définition d'une macro conditionnelle - Exemple

Supposez que votre compilateur produise un code débogué lorsque vous insérez l'option de ligne de commande -g et un code optimisé lorsque vous insérez l'option de ligne de commande -O. La plupart du temps [image] plus particulièrement lors du cycle de développement [image] vous voulez produire un code débogué, mais vous voulez conserver facilement l'option permettant de produire un code optimisé.

Pour ce faire, définissez une macro texte statique appelée DEBUG et entrez yes dans le champ Valeur. (Vous pouvez entrer une valeur différente de yes, du moment que vous en indiquez une.) Ensuite, dans votre action de compilation, remplacez l'option de ligne de commande DEBUG par la macro de débogage conditionnelle suivante :

{DEBUG ? -g : -O}

Etant donné que la macro DEBUG a été définie et que vous lui avez attribué une valeur de chaîne non vide, elle est évaluée à -g, la première expression, et la compilation produit un code débogué. Lorsque vous êtes prêt à produire un code optimisé, supprimez simplement la valeur yes de la macro DEBUG. Comme cette dernière ne contient plus de chaîne non vide, elle est évaluée à -O, la seconde expression, et le compilateur produit un code optimisé.

Remarque : Dans l'exemple ci-dessus, les blancs qui précèdent et suivent le point d'interrogation et les deux-points ne sont pas obligatoires.


Quand définir une macro conditionnelle ou créer une macro Vrai/Faux

  Rubriques connexes

Project Builder propose deux méthodes pour évaluer une situation à l'exécution et, en fonction du résultat, choisir l'une des deux actions suivantes : définition d'une macro conditionnelle ou création d'une macro Vrai/Faux. Le choix de la méthode à utiliser dépend essentiellement de la fréquence à laquelle vous (ou vos utilisateurs) souhaitez prendre cette décision. Si vous voulez choisir entre deux options chaque fois que l'action contenant la macro est exécutée, créez une macro Vrai/Faux. Toutefois, si vous prenez la plupart du temps la même décision et n'optez pour l'autre solution qu'occasionnellement, la définition d'une macro conditionnelle est probablement la meilleure solution. Considérez l'exemple suivant.

L'action F50RUNOPTS, définie sur le type .fmx, contient la macro conditionnelle suivante pour générer des statistiques sur les performances :

F50RUNOPTS. . . . {PERFORMANCE ? PECS=ON STATISTICS=YES}. . . .

Par défaut, comme il n'existe pas de macro performance, les statistiques sur les performances ne sont pas générées comme faisant partie de l'action F50RUNOPTS. Si cela vous suffit, vous pouvez laisser l'instruction conditionnelle telle qu'elle. Lorsque vous décidez de générer des statistiques sur les performances, créez simplement une macro texte statique appelée performance et donnez-lui comme valeur n'importe quelle chaîne non vide.

Supposez toutefois que, lorsque vous exécutez vos applications Forms, vous générez des statistiques de performances près d'une fois sur deux. Dans ce cas, il est trop pénible de modifier la définition de performance chaque fois que vous exécutez une application Forms, et de devoir le faire à l'avance. Une macro Vrai/Faux est ici la meilleure solution. Pour créer une macro de ce type, procédez comme suit :

1	Dans la base de registres globale, sélectionnez le type .fmx.

2	Sélectionnez Fichier [image] Nouveau [image] Macro pour afficher la boîte de dialogue Ajouter macro.

3	Nommez la macro F50STATS et choisissez le type de macro Vrai/Faux. Dans le champ Libellé, entrez « Générer des statistiques de performances ? » ou une chaîne similaire.

4	Cliquez sur le bouton d'option Vrai sous Par défaut. Dans le champ Résultat, si vrai, entrez PECS=ON STATISTICS=YES ; laissez le champ Résultat si faux vide. Cliquez sur OK pour enregistrer la macro et fermer la boîte de dialogue Ajouter macro.

5	Dans la Palette de propriétés, cliquez deux fois sur la définition de la commande F50RUNOPTS pour afficher la boîte de dialogue Editer action.

6	Remplacez {PERFORMANCE ? PECS=ON STATISTICS=YES} par le nom de la nouvelle macro {F50STATS}.

Chaque fois que exécutez une application Forms, un menu instantané vous demande si vous souhaitez générer des statistiques sur les performances. Si vous cliquez sur Vrai, les statistiques sont générées.


Macros imbriquées

  Exemple	  Rubriques connexes

Pour insérer une macro dans une autre, entrez son nom, entre accolades, dans la chaîne à laquelle la macro extérieure est rendue équivalente.

La ou les macros situées le plus à l'intérieur sont développées en premier, suivies de celles du niveau suivant, et ainsi de suite, jusqu'à ce que l'action contenant les macros imbriquées soit évaluée et exécutée. En outre, les macros sont développées de manière récursive. En d'autres termes, si la valeur d'une macro appelée bar est définie à la macro déjà définie {foo}, lorsqu'une action ou une autre macro fait référence à bar, la valeur qui la remplace sera celle de foo.


Imbrication de macros - Exemple

Pour garder trace des options de ligne de commande pour les outils fréquemment utilisés, l'une des solutions les plus pratiques consiste à les inclure toutes dans seule macro, comme le fait automatiquement Project Builder dans la macro F50GENOPTS, afin de pouvoir l'utiliser pour générer des applications Forms.

Cependant, vous pouvez vouloir un contrôle encore plus fin de votre liste d'options ; ainsi, lorsque vous imprimez un fichier, si seul le nom de votre imprimante change et si les autres options restent inchangées, vous pouvez définir une macro pname contenant le nom de l'imprimante et l'imbriquer en utilisant la définition de macro liste_options de la manière suivante :

option, option, {pname}, option, option, . . .

Si votre action d'impression est définie sous la forme print.exe {n} {liste_options}, lorsque vous sélectionnez un fichier dans le Navigateur de projet et choisissez Imprimer dans le menu instantané, Project Builder envoie au système d'exploitation une commande de type :

print.exe filename option, option, nom_imprimante, option, option. . .

où nom_imprimante est le développement de la macro pname.


Remplacement de définitions de macros de projet pour des éléments

  Exemple

Vous pouvez obtenir la valeur héritée d'une macro et l'utiliser dans une autre définition de macro simplement en insérant un caret (symbole ^) devant le nom de la macro référencée. Vous pouvez ainsi conserver une définition de macro au niveau du projet, et personnaliser ou développer cette définition pour certains éléments du projet.


Exemple : Remplacement de définitions de macros de projet pour des éléments

Exemple 1 : Supposez que votre projet possède une macro appelée OUTDIR, définie comme c:/new/output, emplacement des résultats du compilateur du projet. Au lieu d'utiliser ce répertoire général, vous voulez diriger les résultats de votre propre compilateur vers un sous-répertoire de OUTDIR, quel que soit l'emplacement de ce dernier. Pour chaque élément compilé, vous créez une macro utilisant le même nom, OUTDIR, et vous la définissez comme {^OUTDIR}/monrép. Le caret indique à Project Builder d'utiliser d'abord la macro OUTDIR telle qu'elle est définie pour le projet (c:/new/output), puis d'ajouter la macro OUTDIR telle qu'elle est définie pour l'élément (monrép). Le répertoire de sortie final devient alors c:/new/output/monrép.

Exemple 2 : Pour votre projet CDEV, vous avez défini la macro CFLAGS avec le paramètre -Wall, qui génère des avertissements au cours de la compilation des fichiers C. Pour les éléments et les sous-projets de CDEV, cependant, vous voulez recevoir des avertissements plus fréquents, ainsi que des informations si le code source n'est pas entièrement conforme aux normes ANSI. Pour ces éléments et sous-projets, vous allez donc définir {^CFLAGS} -ansi -pedantic. La macro est développée et devient CFLAGS -Wall -ansi -pedantic, c'est-à-dire la définition de CFLAGS au niveau du projet, plus les deux paramètres supplémentaires définis au niveau des sous-projets et des éléments.


Boîte de dialogue Nouvelle/Editer action

  Rubriques connexes

Description : La boîte de dialogue Nouvelle/Editer action vous permet de définir une nouvelle action ou d'éditer une action existante pour un type ou un fichier.

Cette boîte de dialogue contient les éléments suivants :

Nom	Zone de texte où vous entrez le nom de l'action. (Si vous éditez une action, ce champ n'est pas modifiable.) Les actions prédéfinies par Project Builder et les actions définies par l'utilisateur figurent dans la liste déroulante. Cette liste permet d'accéder facilement aux actions existantes pour étendre leurs possibilités aux types récemment définis ou pour bénéficier des outils récemment installés. Par exemple, vous pouvez être amené à définir une action de génération pour un nouveau type de compilateur ou à personnaliser l'action d'ouverture des bibliothèques pour utiliser un outil tiers.
Description	Zone de texte où vous entrez la description de l'action. Même si cette description est facultative, notez que ce que vous saisissez ici apparaît comme option de menu correspondant à l'action, dans le menu instantané associé. Si vous choisissez de ne pas saisir de description, le nom de l'action apparaît dans le menu instantané.
Agit sur type	Zone de liste où vous sélectionnez le type sur lequel porte l'action. Si vous avez sélectionné un élément de projet ou un type avant d'appeler cette boîte de dialogue, le type est implicite ; ainsi, cette zone de liste est supprimée. Si vous avez sélectionné un projet, le fait d'utiliser l'option <Tout type> de cette zone de liste applique l'action à tous les éléments du projet, sans tenir compte du type. (Pour que l'action s'applique à tous les éléments de tous vos projets, annulez cette boîte de dialogue, sélectionnez l'option <Tout type> dans la base de registres utilisateur, puis faites réapparaître la boîte de dialogue.)
Ajouter au menu instantané	Cliquez sur cette case à cocher pour inclure l'action dans le menu instantané. Si vous choisissez de ne pas inclure l'action dans le menu instantané, elle sera inaccessible ; ainsi, vous pouvez masquer des actions sans les supprimer.
Définition d'action	Zone de texte dans laquelle vous saisissez la chaîne de commande (telle qu'elle est développée et interprétée par Project Builder) qui est nécessaire pour appeler l'action.
	Cette chaîne peut simplement consister en un appel à un exécutable ou en un appel modifié par des macros intégrées et définies par l'utilisateur. Vous pouvez saisir un texte directement dans ce champ, ou utiliser les onglets Applications, Macros et Elément d'entrée pour vous aider à créer cette commande.
Applications	Cliquez sur cet onglet pour sélectionner l'application à appeler en même temps que votre action.
Insérer dans commande	Sélectionnez un fichier exécutable à insérer dans votre commande, puis cliquez sur Insérer dans commande. (Ou cliquez deux fois sur le nom de l'application.) L'exécutable que vous sélectionnez remplace le texte sélectionné dans la zone Définition d'action ou est inséré à l'emplacement du curseur.
Parcourir	Cliquez sur ce bouton pour accéder au système de fichiers et rechercher d'autres exécutables. Le fichier exécutable que vous sélectionnez dans la boîte de dialogue Parcourir remplace le texte sélectionné dans la zone de texte ou est inséré à l'emplacement du curseur. L'exécutable est également ajouté à la liste des applications pour que vous puissiez y accéder plus tard. Après avoir ajouté le fichier exécutable, assurez-vous de bien ajouter à la chaîne de commande les paramètres requis (ou facultatifs). Si vous ne les connaissez pas, consultez le guide de l'utilisateur approprié. (Vous voudrez éventuellement utiliser les macros prédéfinies par Project Builder pour représenter certains paramètres, comme {n} pour le nom du fichier.)
Supprimer de la liste	Cliquez sur ce bouton pour supprimer de la liste l'exécutable sélectionné.
Macros	Cliquez sur ce bouton pour choisir une macro dans la liste des macros intégrées et définies par l'utilisateur.
Nom	Liste des macros définies pour ce projet, ce type ou cet élément. Lorsque vous insérez une macro, son nom entre accolades est ajouté à la zone Définition d'action. La valeur réelle est évaluée et indiquée au moment de l'exécution.
Type	Toutes les macros, sauf les macros de type texte statique, font apparaître un menu instantané au moment de l'exécution, pour inviter l'utilisateur à saisir une valeur.
Valeur	Définition actuelle de la macro.
Insérer dans commande	Sélectionnez la macro à insérer dans votre commande, puis cliquez sur Insérer dans commande. (Ou cliquez deux fois sur le nom de la macro.) La macro que vous sélectionnez remplace le texte sélectionné dans la zone Définition d'action ou est insérée à l'emplacement du curseur.
Entrées	Cliquez sur ce bouton pour sélectionner un élément d'entrée à inclure dans votre action. Un élément d'entrée correspond au fichier source sur lequel porte l'action. Seules les actions prédéfinies acceptent les éléments d'entrée ; à l'exception de l'action de génération, la plupart des actions indiquent un élément d'entrée de type <Tout type>.
#	Numéro de l'élément d'entrée tel qu'il est assigné par Project Builder. Ce numéro est l'unique représentant d'un élément d'entrée dans la chaîne de commande. Ainsi, si un élément d'entrée .FMB apparaît comme numéro 2 dans la liste Type, il est représenté par {2} dans la chaîne de commande.
Type	Types actuellement définis comme éléments d'entrée.
Format	Format dans lequel l'élément d'entrée doit apparaître dans l'exécutable. Prend par défaut la valeur{n}, c'est-à-dire le nom du fichier.
Plusieurs éléments ?	Indique si votre action peut accepter plusieurs éléments d'entrée. Remarque : Même si la valeur est Oui, un seul numéro (correspondant au type d'élément d'entrée) apparaît dans la zone Définition d'action, qui peut représenter un ou plusieurs fichiers.
Insérer dans commande	Sélectionnez un élément d'entrée à insérer dans votre commande, puis cliquez sur Insérer dans commande. (Ou cliquez deux fois sur un élément d'entrée.) Le numéro qui représente l'élément d'entrée sélectionné remplace le texte sélectionné dans la zone de texte ou est inséré à l'emplacement du curseur.
Ajouter	Fait apparaître la boîte de dialogue Action - Ajouter élément d'entrée, dans laquelle vous déterminez le type et le format d'argument de l'élément d'entrée, et indiquez si les éléments d'entrée multiples sont acceptés.
Edition	Sélectionnez un élément dans la liste, puis cliquez sur ce bouton pour éditer la définition de l'élément d'entrée.
Supprimer	Cliquez sur ce bouton pour supprimer de la liste l'élément sélectionné.
OK	Confirme les propriétés de l'action indiquée et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.
Aperçu	Cliquez sur ce bouton pour faire apparaître l'action, avec les macros développées, dans un menu instantané (également appelé mode Aperçu des actions). Etant donné que Aperçu simule simplement l'action, il n'y a aucun objet auquel appliquer l'action ; ainsi, Project Builder ne développe pas les macros comme {b}, {f}, etc.


Boîte de dialogue Ajouter/Modifier élément d'entrée

  Rubriques connexes

Description : La boîte de dialogue Action - Ajouter élément d'entrée vous permet de définir des éléments d'entrée pour les actions.

Cette boîte de dialogue contient les éléments suivants :

Type d'entrée	Sélectionnez dans cette liste le type de fichier de votre élément d'entrée. Si vous sélectionnez <Tout type>, vous pouvez utiliser comme fichier source tout type de fichier. (Si vous êtes en mode d'édition, ce champ n'est pas modifiable.)
Format d'argument	Indiquez le format auquel l'exécutable s'attend à trouver l'élément d'entrée. Dans la plupart des cas, le format peut être représenté par {n}, nom complet du fichier. Vous pouvez également utiliser {d} et {b} (pour indiquer le nom des bibliothèques UNIX), ou {f} (pour indiquer le nom d'une application JAVA).
Accepter plusieurs fichiers d'entrée	Cochez cette case pour indiquer que votre action peut accepter plusieurs éléments d'entrée de ce type.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Nouveau/Editer type

  Rubriques connexes

Description : La boîte de dialogue Nouveau/Editer type vous permet d'ajouter de nouveaux types de fichier à votre base de registres.

Cette boîte de dialogue contient les éléments suivants :

Type	Zone de texte dans laquelle vous entrez le nom du nouveau type. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Format	Zone de texte dans laquelle vous indiquez le format du nouveau type ; par exemple, {b}.txt, pour indiquer un fichier texte. Project Builder utilise ces informations pour déterminer le type des fichiers que vous ajoutez à votre projet et pour évaluer les éléments implicites qui en résultent, le cas échéant. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Contenu du fichier
Texte	Activez ce bouton d'option si le type que vous définissez est au format texte. Tous les fichiers de ce type héritent des actions et des macros de type UPDTEXT.
Binaire	Activez ce bouton d'option si le type que vous définissez est au format binaire.
Description	(Facultatif) Entrez la description du type dans ce champ. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Livrer en tant que	Dans la liste déroulante, sélectionnez la manière dont vous souhaitez que ces fichiers soient livrés. Votre choix détermine le type d'élément implicite que Project Builder ajoute à chacun des nouveaux fichiers de ce type dans votre projet.
Contrôle de version	Cochez cette case pour indiquer que vous souhaitez contrôler la version des fichiers de ce type.
Livrable	Cochez cette case pour indiquer que les fichiers de ce type doivent être inclus dans le processus de packaging.
Icône	Indiquez l'icône qui symbolise le type dans le Navigateur de projet.
Depuis le fichier	Cochez cette case pour sélectionner une icône dans un fichier. Le nom des fichiers d'icônes déjà utilisés apparaît dans la liste déroulante située au-dessous ; vous pouvez également choisir un fichier dans cette liste.
Parcourir	Fait apparaître la boîte de dialogue Ouvrir, boîte de dialogue de gestion de fichiers standard avec laquelle vous pouvez rechercher, puis ouvrir le fichier d'icônes à utiliser.
Zone de liste Icône disponible	Fait apparaître les icônes fournies par Project Builder. Pour en utiliser une, cliquez dessus pour la sélectionner.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Nouvelle/Editer macro

  Rubriques connexes

Description : La boîte de dialogue Nouvelle/Editer macro vous permet de définir une macro que vous pouvez ensuite utiliser pour modifier une action.

Cette boîte de dialogue contient les éléments suivants :

Nom	Champ texte dans lequel vous entrez le nom de votre nouvelle macro.
Type	Liste déroulante dans laquelle vous sélectionnez le type de macro que vous créez. Tous les types de macro, sauf les macros de type texte statique, font apparaître un menu instantané au moment de l'exécution, pour inviter l'utilisateur à saisir une valeur. Vous trouverez ci-dessous la description de chaque type de macro.
Texte statique	Cette macro ne demande pas à l'utilisateur de saisir une valeur au moment de l'exécution.
Texte	Lors de l'exécution, le menu instantané permet à l'utilisateur d'éditer la chaîne en entier, y compris de remplacer tout paramètre ou toute valeur de la macro, ou d'ajouter de nouveaux paramètres et de nouvelles valeurs.
Liste	Lors de l'exécution, le menu instantané demande à l'utilisateur de sélectionner une valeur dans une liste. Exemple : Sélection de l'ID de l'imprimante voulue. Saisissez chaque valeur de la liste sur une ligne distincte du champ Valeur. La valeur par défaut est la première entrée de la liste.
Editer liste	Lors de l'exécution, le menu instantané demande à l'utilisateur de sélectionner une valeur dans une liste ou de saisir une nouvelle valeur dans la zone de liste déroulante. Saisissez chaque valeur de la liste sur une ligne distincte du champ Valeur. La valeur par défaut est la première entrée de la liste.
Number	Lors de l'exécution, le menu instantané invite l'utilisateur à choisir un numéro dans une plage spécifique. Exemple : Indication du nombre de copies à envoyer à l'imprimante.
Minimum	Limite inférieure de la plage de numéros acceptables.
Maximum	Limite supérieure de la plage de numéros acceptables.
Valeur en cours	Valeur par défaut.
Vrai/Faux	Lors de l'exécution, le menu instantané invite l'utilisateur à répondre Vrai ou Faux à une question. Exemple : Volonté ou non d'établir un code optimisé.
Par défaut	Activez ce bouton d'option pour définir la condition par défaut sur Vrai ou sur Faux.
Résultat, si vrai	Saisissez la chaîne à exécuter si la condition est vraie ; par exemple, l'option de compilation qui établit un code optimisé.
Résultat si faux	Saisissez la chaîne à exécuter si la condition est fausse ; par exemple, l'option de compilation qui établit un code débogué.
Nom de fichier	Lors de l'exécution, le menu instantané invite l'utilisateur à sélectionner un nom de fichier. Ce menu contient un bouton Parcourir pour aider l'utilisateur. Exemple : Indication du fichier dans lequel décompresser un fichier .zip.
Répertoire	Lors de l'exécution, le menu instantané invite l'utilisateur à sélectionner un nom de répertoire. Ce menu contient un bouton Parcourir pour aider l'utilisateur. Exemple : Indication du répertoire dans lequel décompresser un fichier .zip.
Libellé	Zone de texte dans laquelle vous saisissez la question ou les indications à faire apparaître dans l'écran instantané affiché au moment de l'exécution. Si la macro est de type texte statique, ce champ est désactivé.
Valeur	Zone de texte dans laquelle vous entrez la définition de la macro.
Insérer nom de fichier	Cliquez sur ce bouton pour accéder à la boîte de dialogue Insérer nom de fichier, dans laquelle vous pouvez sélectionner un fichier à insérer dans votre définition de macro.
Insérer macro	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Ajouter macro à la définition, qui contient la liste des macros précédemment définies, dans laquelle vous pouvez choisir une entrée.
OK	Confirme les propriétés de la macro et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Ajouter macro à la définition

  Rubriques connexes

Description : La boîte de dialogue Ajouter macro à la définition vous permet de sélectionner une macro dans la liste des macros existantes, et de l'ajouter à une nouvelle définition de macro ou à une définition d'action.

Cette boîte de dialogue contient les éléments suivants :

Macros	Liste déroulante des macros précédemment définies.
Nom	Liste des noms des macros précédemment définies. Cliquez sur une macro pour la sélectionner.
Type	Type de la macro (Prédéfini, Texte statique, Texte, Liste, Editer liste, Number, Vrai/Faux, Nom de fichier ou Répertoire).
Valeur	Définitions de macros.
OK	Confirme votre sélection et ferme la boîte de dialogue. Vous revenez à la boîte de dialogue précédente.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue. Vous revenez à la boîte de dialogue précédente.


Boîte de dialogue Nouvelle/Editer connexion

  Rubriques connexes

Description : La boîte de dialogue Nouvelle/Editer connexion vous permet de définir des chaînes de connexion qui peuvent être assignées à des fichiers de projet spécifiques.

Cette boîte de dialogue contient les éléments suivants :

Titre	Champ texte où vous entrez le libellé sous lequel la connexion doit figurer dans le Navigateur. (Pour modifier le titre de la connexion, cliquez dessus dans le Navigateur de projet, puis entrez le nouveau nom.)
Nom utilisateur	Champ texte où vous entrez votre nom utilisateur. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Mot de passe	Champ texte où vous entrez votre mot de passe. Pour éditer l'entrée existante, apportez les modifications de votre choix. (Etant donné que le mot de passe est protégé, il apparaît sous forme d'astérisques au fur et à mesure que vous le saisissez.)
Base de données	Champ texte où vous entrez la chaîne de connexion de la source de données à laquelle vous souhaitez vous connecter. Elle se présente généralement sous la forme :
	protocole_réseau:noeud_réseau:nom_source
	Chaque champ est séparé par le caractère deux-points (:). Adressez-vous à l'administrateur de votre base de données pour obtenir la chaîne de connexion correcte pour votre source de données. Pour éditer l'entrée existante, apportez les modifications de votre choix. Notez que si vous vous connectez à une source de données ODBC, la syntaxe est la suivante :
	nomutilisateur/motdepasse@ODBC:sourcededonnées[:nombasededonnées] Si nombasededonnées n'est pas précisé, la source de données actuelle de la connexion ODBC est utilisée.
Commentaires	Zone de texte où vous pouvez inclure, si vous le souhaitez, des commentaires sur la connexion. Pour éditer l'entrée existante, apportez les modifications de votre choix.
OK	Confirme vos sélections, ouvre la bibliothèque et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Options d'import

  Rubriques connexes

Description : La boîte de dialogue Options d'import vous permet d'importer des fichiers contenant des informations de projet provenant d'autres sources.

Cette boîte de dialogue contient les éléments suivants :

Importer éléments	Cochez cette case pour importer des informations concernant des éléments de projet.
Remplacer élém exist	Cochez cette case pour que les informations d'éléments de projet que vous importez écrasent les informations des éléments portant le même nom dans le ou les projets actuellement ouverts.
Importer types	Cochez cette case pour importer des informations concernant les types.
Substituer aux types existants	Cochez cette case pour que les informations de types que vous importez remplacent les informations des types portant le même nom dans les bases de registres actuellement ouvertes.
Importer dans projet	Activez ce bouton d'option pour importer les informations de projet dans un projet particulier.
Liste déroulante Projets	Sélectionnez dans cette liste le projet dans lequel vous souhaitez importer les informations.
Importer selon sélection	Activez ce bouton d'option, si un ou plusieurs projets sont sélectionnés dans le Navigateur de projet, pour choisir celui dans lequel vous allez importer les informations.
Liste déroulante Sélection	Sélectionnez dans cette liste le projet dans lequel vous souhaitez importer les informations.
Importer	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Sélectionner fichier à importer, qui vous permet de rechercher et de sélectionner le fichier à importer.
Fermer	Ferme la boîte de dialogue.


Boîte de dialogue Options d'export

  Rubriques connexes

Description : La boîte de dialogue Options d'export vous permet d'écrire les informations de projet sélectionnées sous un format portable et facile à transférer.

Cette boîte de dialogue contient les éléments suivants :

Eléments d'export
N'exporter aucun élément	Activez ce bouton d'option pour exporter uniquement des informations de base de registres.
Exporter élément(s) sélectionné(s) uniquement	Activez ce bouton d'option pour exporter uniquement les informations des éléments que vous avez explicitement sélectionnés dans le Navigateur de projet.
Exporter élément(s) sélectionné(s) et tout descendant	Activez ce bouton d'option pour exporter les informations des éléments sélectionnés dans le Navigateur de projet, et les descendants de ces éléments.
Exporter projet(s) et tout descendant	Activez ce bouton d'option pour exporter les informations du ou des projets sélectionnés et de tous leurs descendants.
Liste des projets	Choisissez les projets à exporter dans la liste déroulante.
Types d'export
Zone de liste Sélection de type	Sélectionnez dans cette liste déroulante les types à exporter. Utilisez les méthodes de sélection d'objets contigus et non contigus habituellement utilisées sur votre plate-forme.
Sélectionner tout	Cliquez sur ce bouton pour sélectionner toutes les informations du type en vue de les exporter.
Désélectionner tout	Cliquez sur ce bouton pour désélectionner toutes les informations du type sélectionnées.
Exporter	Fait apparaître la boîte de dialogue Sélectionner fichier à exporter, qui vous permet de rechercher et de sélectionner un emplacement pour votre fichier d'export. Si vous le souhaitez, vous pouvez également sélectionner un fichier et l'écraser.
Fermer	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Imprimer infos sur projet

  Rubriques connexes

Description : La boîte de dialogue Imprimer états sur projet vous permet de générer et d'imprimer des états contenant les informations de projet sélectionnées.

Cette boîte de dialogue contient les éléments suivants :

Imprimer définitions de type	Cochez cette case pour que l'état contienne des définitions de types.
Imprimer définitions d'élément	Cochez cette case pour que l'état contienne des définitions d'éléments.
Eléments de filtre	Cochez cette case pour appliquer un filtre aux résultats avant l'impression, puis sélectionnez dans la liste déroulante le filtre à appliquer.
Elément sélectionné uniquement	Choisissez cette option pour imprimer uniquement les définitions des éléments sélectionnés dans le Navigateur de projet.
Elément et descendants sélectionnés	Choisissez cette option pour imprimer les définitions des éléments sélectionnés dans le Navigateur de projet et les descendants de ces éléments.
Tous les éléments du projet	Choisissez cette option pour imprimer les définitions de tous les éléments du projet sélectionné.
Inclure actions	Choisissez cette option pour inclure des informations sur les actions définies.
Inclure macros déf util	Choisissez cette option pour inclure des informations sur les macros définies par l'utilisateur.
Imprimer infos sur le Lanceur	Choisissez cette option pour inclure des informations sur la configuration actuelle du lanceur.
Imprimer	Confirme vos sélections et fait apparaître la boîte de dialogue d'impression. Cette boîte de dialogue est propre au système ; remplissez-la comme vous le feriez normalement pour votre système.
Police	Fait apparaître la boîte de dialogue Imprimer projet - Police. Cette boîte de dialogue est propre au système ; remplissez-la comme vous le feriez normalement pour votre système.
Fermer	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Préférences

Description : La boîte de dialogue Préférences propose plusieurs options que vous pouvez sélectionner pour personnaliser l'environnement et les outils de Project Builder.

Cette boîte de dialogue contient les éléments suivants :

Onglet Afficher	Vous permet de personnaliser l'aspect de Project Builder.
Onglet Projets	Vous permet de définir des valeurs par défaut pour les propriétés de projet courantes.
Onglet Navigateur	Vous permet de contrôler l'aspect et le comportement du Navigateur de projet, et de définir des paramètres pour exécuter l'action de génération en mode de traitement par lots.
Onglet Lanceur	Vous permet de personnaliser l'aspect et le fonctionnement du lanceur.


Boîte de dialogue Préférences, onglet Afficher

Description : L'onglet Afficher de la boîte de dialogue Préférences vous permet de personnaliser votre environnement de travail.

Cette boîte de dialogue contient les éléments suivants :

Afficher Lanceur	Cochez cette case pour toujours afficher le lanceur.
Afficher barre d'outils	Cochez cette case pour toujours afficher la barre d'outils.
Afficher boîte de dialogue initiale Bienvenue	Cochez cette case pour faire apparaître la boîte de dialogue Bienvenue à chaque lancement de Project Builder. Si cette case n'est pas cochée, la fenêtre du Navigateur de projet apparaît à la place de la boîte de dialogue Bienvenue.
Afficher écran de bienvenue de l'assistant Projet	Cochez cette case pour faire apparaître l'écran de bienvenue de l'assistant Projet à chaque lancement de cet assistant.
Afficher écran de bienvenue de l'assistant Type de module	Cochez cette case pour faire apparaître l'écran de bienvenue de l'assistant Type de module à chaque lancement de cet assistant.
Afficher écran de bienvenue de l'assistant Livraison	Cochez cette case pour faire apparaître l'écran de bienvenue de l'assistant Livraison à chaque lancement de cet assistant.
Afficher boîte de dialogue de sélection de méthode Nouveau projet	Cochez cette case pour que, lorsque vous sélectionnez Fichier [image] Nouveau [image] Projet (ou que vous cliquez deux fois sur le noeud Projets), une boîte de dialogue apparaisse et vous demande si vous souhaitez utiliser l'assistant Projet ou la boîte de dialogue Nouveau projet.
Afficher boîte de dialogue de sélection de méthode Nouveau sous-projet	Cochez cette case pour que, lorsque vous sélectionnez Fichier [image] Nouveau [image] Sous-projet, une boîte de dialogue apparaisse et vous demande si vous souhaitez utiliser l'assistant Projet ou la boîte de dialogue Nouveau sous-projet.
Afficher barre d'état	Cochez cette case pour faire apparaître la barre d'état en bas de la fenêtre du Navigateur de projet.
Afficher messages d'aide	Cochez cette case pour faire apparaître des messages d'aide dans la barre d'état.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Préférences, onglet Projets

Description : L'onglet Projets de la boîte de dialogue Préférences vous permet de définir des valeurs par défaut pour des informations de projet comme les options Auteur et Connexion.

Cette boîte de dialogue contient les éléments suivants :

Auteur	Zone de texte dans laquelle vous pouvez entrer une valeur. Cette valeur est utilisée comme valeur par défaut pour vos projets.
Connexion	Liste déroulante de toutes les connexions actuellement définies, classées par titre. Choisissez la connexion à utiliser comme connexion par défaut pour vos projets.
Commentaires	Zone de texte dans laquelle vous pouvez entrer des commentaires.
Défragmenter registres de projet lorsque pourcentage fragmenté	Zone d'incrémentation/de décrémentation dans laquelle vous pouvez saisir un nombre indiquant le pourcentage de fragmentation acceptable pour les bases de registres de projet. Lorsque le pourcentage de fragmentation indiqué est atteint pour une base de registres, un message d'alerte apparaît. Vous pouvez compresser la base de données ou quitter la boîte de dialogue sans effectuer de compression. Le pourcentage par défaut (et minimal) est 10 %.
OK	Confirme les éléments saisis et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Préférences, onglet Navigateur

  Rubriques connexes

Description : L'onglet Navigateur de la boîte de dialogue Préférences vous permet de personnaliser l'aspect et le contenu du Navigateur de projet, et d'exécuter l'action de génération en mode de traitement par lots.

Cette boîte de dialogue contient les éléments suivants :

Navigateur de projet
Conserver Palette de propriétés en haut	Cochez cette case pour placer la palette de propriétés devant le Navigateur de projet. (Les fenêtres d'autres applications peuvent apparaître devant la palette de propriétés même si cette préférence est définie.)
Afficher types dans la vue Projet	Cochez cette case pour classer les fichiers par type lorsque le Navigateur de projet est défini sur Affichage par projet.
Afficher éléments implicites	Cochez cette case pour faire apparaître les éléments implicites dans le Navigateur de projet. Par exemple, si cette case n'est pas cochée et que vous ajoutez un fichier .fmb à un projet, le fichier .fmx correspondant n'est pas visible [image] sauf si vous l'ajoutez explicitement.
Génération
Activer sortie batch	Cochez cette case pour exécuter l'action de génération en mode de traitement par lots.
Nom de fichier de sortie	Saisissez le nom du fichier journal où les erreurs du compilateur doivent être écrites ou utilisez le bouton Parcourir pour sélectionner un fichier journal.
Ajouter au fichier	Cochez cette case pour ajouter les résultats de la prochaine action de génération au fichier indiqué dans le champ Nom de fichier de sortie. Pour écraser le contenu du fichier de sortie, laissez cette case.
OK	Confirme les éléments saisis et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Préférences, onglet Lanceur

  Rubriques connexes

Description : L'onglet Lanceur de la boîte de dialogue Préférences vous permet de personnaliser l'aspect et le contenu du lanceur.

Cette boîte de dialogue contient les éléments suivants :

Entrées
Navigateur de lanceur	Utilisez cette représentation hiérarchique des outils du lanceur pour modifier l'apparence de votre lanceur. Par exemple, vous pouvez réorganiser les outils du lanceur à l'aide de la méthode du Glisser-déplacer.
Ajouter	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Ajouter entrée du lanceur, qui vous permet d'ajouter des outils au lanceur.
Edition	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Edition d'entrée du Lanceur, qui vous permet de modifier les entrées correspondant aux outils déjà inclus dans le lanceur ; par exemple, vous pouvez sélectionner une autre icône à afficher dans le lanceur.
Supprimer	Cliquez sur ce bouton pour supprimer un outil du lanceur.
Par défaut	Cliquez sur ce bouton pour copier le fichier maître de définition de lanceur, qui se trouve dans la zone d'installation du produit, vers votre propre fichier de définition de lanceur. Si vous avez apporté à votre fichier de définition de lanceur des modifications qui ont une incidence sur les éléments figurant également dans le fichier maître (par exemple, la commande utilisée pour appeler Form Builder), ces modifications sont perdues. Toutefois, tous les éléments ajoutés à votre fichier de lanceur et qui ne figurent pas dans le fichier maître restent intacts.
Afficher
Icônes uniquement	Activez ce bouton d'option pour faire apparaître dans le lanceur uniquement les icônes représentant les outils.
Icônes et texte	Activez ce bouton d'option pour faire apparaître à la fois les icônes et les libellés des outils du lanceur.
Présentation
Flottante	Activez ce bouton d'option pour faire apparaître le lanceur sous forme de barre d'outils flottante.
Attachée en haut	Activez ce bouton d'option pour faire apparaître le lanceur le long du bord supérieur du Navigateur de projet.
Attachée à gauche	Activez ce bouton d'option pour faire apparaître le lanceur le long du bord gauche du Navigateur de projet.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Ajouter/Editer entrée du Lanceur

  Rubriques connexes

Description : La boîte de dialogue Ajouter/Editer entrée du Lanceur vous permet d'ajouter des outils au lanceur.

Cette boîte de dialogue contient les éléments suivants :

Elément	Activez ce bouton d'option pour indiquer que les éléments entrés concernent un outil.
Grouper	Activez ce bouton d'option pour indiquer que les éléments entrés concernent un groupe.
Caché	Cochez cette case pour créer une entrée pour un outil, sans que ce dernier apparaisse dans le lanceur.
Commande
Champ de saisie de texte	Champ Texte dans lequel vous pouvez entrer directement la chaîne de commande qui lance votre outil. Le format d'une chaîne de lancement est le même que celui des définitions d'actions, mais les chaînes de lancement ne prennent pas en charge les macros. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Insérer application	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Rechercher un exécutable, boîte de dialogue de gestion de fichiers standard avec laquelle vous pouvez sélectionner l'exécutable correspondant à votre outil.
Libellé d'icône	Champ Texte dans lequel vous entrez le libellé de l'icône qui apparaît dans le lanceur pour identifier l'outil. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Conseil	Champ Texte dans lequel vous pouvez entrer, si vous le souhaitez, une brève description de l'outil. Pour éditer l'entrée existante, apportez les modifications de votre choix.
Icône
Depuis le fichier	Cochez cette case pour sélectionner une icône à partir d'un fichier. Les noms des fichiers d'icônes déjà utilisés apparaissent dans la liste déroulante située au-dessous ; vous pouvez également sélectionner un fichier dans cette liste.
Parcourir	Fait apparaître la boîte de dialogue Ouvrir, boîte de dialogue de gestion de fichiers standard avec laquelle vous pouvez rechercher, puis ouvrir le fichier d'icônes à utiliser.
Zone de liste Icône disponible	Fait apparaître les icônes fournies par Project Builder. Pour en utiliser une, cliquez dessus pour la sélectionner.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Génération

  Rubriques connexes

Description : La boîte de dialogue Génération fait apparaître la liste des fichiers sélectionnés en vue de la compilation.

Cette boîte de dialogue contient les éléments suivants :

Zone de liste Fichiers sélectionnés	Liste déroulante des fichiers sélectionnés dans le Navigateur de projet, où l'élément en cours de compilation est mis en surbrillance.
Message d'exécution	Zone de message qui affiche la ligne de commande.
Message de génération	Zone de message qui affiche le fichier d'entrée (le premier fichier d'entrée s'il y en a plusieurs).
Message concernant le fichier de sortie	Zone de messages qui affiche le fichier de sortie.
Message d'état	Zone de messages qui affiche l'état actuel de l'opération (Génération ou Fin).
Annuler/Fermer	Annule la compilation une fois que l'opération en cours est terminée et ferme la boîte de dialogue. Le bouton Annuler se transforme en bouton Fermer lorsque toutes les compilations sont terminées.


Boîte de dialogue Générer sortie

  Rubriques connexes

Description : La boîte de dialogue Générer sortie affiche les informations de consignation des compilations en cours.

Cette boîte de dialogue contient les éléments suivants :

Texte commande de génération	Contient le journal (dans une fenêtre déroulante) de l'opération de génération.
Poursuivre	Cliquez sur ce bouton pour poursuivre l'opération de génération.
Annuler	Annule l'opération de génération une fois que l'opération en cours est terminée et ferme la boîte de dialogue.


Boîte de dialogue Commentaires

Description : La boîte de dialogue Commentaires vous permet d'ajouter des commentaires et des explications aux éléments du projet.

Cette boîte de dialogue contient les éléments suivants :

Commentaires	Zone de texte dans laquelle vous pouvez saisir des commentaires concernant un élément de projet. Les commentaires apparaissent dans la palette de propriétés de cet élément.
OK	Confirme les éléments saisis et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue A propos de Project Builder

Description : La boîte de dialogue A propos de Project Builder fait apparaître des informations sur le copyright et la liste des composants de Project Builder.

Cette boîte de dialogue contient les éléments suivants :

Mention Copyright	Contient les informations de copyright de Project Builder.
Zone de liste Composant produit	Contient la liste des composants de Project Builder. Ces informations peuvent être utiles lorsque vous contactez le support technique.
OK	Ferme la boîte de dialogue.


Boîte de dialogue Editeur d'icône

Description : La boîte de dialogue Editeur d'icône vous permet d'indiquer une icône pour représenter un type dans le Navigateur de projet.

Cette boîte de dialogue contient les éléments suivants :

Depuis le fichier	Cochez cette case pour sélectionner une icône à partir d'un fichier. Les noms des fichiers d'icônes déjà utilisés apparaissent dans la liste déroulante située au-dessous ; vous pouvez également choisir un fichier dans cette liste.
Parcourir	Fait apparaître la boîte de dialogue Ouvrir, boîte de dialogue de gestion de fichiers standard avec laquelle vous pouvez rechercher, puis ouvrir le fichier d'icônes à utiliser.
Zone de liste Icône disponible	Fait apparaître les icônes fournies par Project Builder. Pour en utiliser une, cliquez dessus pour la sélectionner.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Bienvenue

Description : La boîte de dialogue Bienvenue vous aide à sélectionner la tâche initiale à exécuter lorsque vous lancez Project Builder. Sélectionnez l'une des tâches indiquées et cliquez sur OK dans la boîte de dialogue.

Cette boîte de dialogue contient les éléments suivants :

Conception
Utilisation de l'assistant Projet	Fait apparaître l'assistant projet pour que vous puissiez immédiatement commencer à définir un nouveau projet.
Utilisation du navigateur de projet	Ouvre le Navigateur de projet, dans lequel vous pouvez générer un nouveau projet, ouvrir un projet existant, etc.
Ouverture d'un projet existant	Fait apparaître la boîte de dialogue Ouvrir projet pour que vous puissiez immédiatement ouvrir un projet.
Apprentissage
Afficher Aperçu produit (concepts)	Fait apparaître Oracle Developer - Aperçu produit, présentation multimédia en ligne. Cliquez sur l'icône Project Builder pour en savoir plus sur ce produit.
Parcourir les Assistants (tâches)	Fait apparaître les assistants Project Builder, qui décrivent les étapes à suivre pour exécuter les tâches les plus courantes dans Project Builder.
Afficher cet écran ultérieurement	Si cette option est sélectionnée, la boîte de dialogue Bienvenue apparaît au prochain démarrage de Project Builder.
Note d'utilisation

•	Pour rappeler la boîte de dialogue Bienvenue si vous n'avez pas coché la case Afficher cet écran ultérieurement, sélectionnez Outils [image] Préférences, choisissez l'onglet Afficher, et cochez la case Afficher boîte de dialogue initiale "Bienvenue".


Boîte de dialogue Editeur de propriété

Description : La boîte de dialogue Editeur de propriété est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui change selon la propriété que vous modifiez dans la palette de propriétés :

•	Si vous modifiez la propriété Nom de fichier, la boîte de dialogue Editeur de propriété vous permet de choisir un nouveau nom pour l'élément de projet.

•	Si vous modifiez la propriété Répertoire du projet, la boîte de dialogue Editeur de propriété vous permet de choisir un nouveau répertoire de projet.

Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Sélectionner fichier à exporter

Description : La boîte de dialogue Sélectionner fichier à exporter est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet d'indiquer un nom et un emplacement pour votre fichier d'export. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Sélectionner fichier à importer

Description : La boîte de dialogue Sélectionner fichier à importer est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet d'indiquer le nom et l'emplacement du fichier à importer. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Ouvrir

Description : La boîte de dialogue Ouvrir est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de sélectionner et/ou d'ouvrir une entité Project Builder (un projet, par exemple, ou un fichier d'icônes si vous êtes en train de définir un nouveau type). Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Dériver type

Description : La boîte de dialogue Dériver type est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de sélectionner le fichier à partir duquel votre nouveau type va hériter des informations de type. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Sélectionner une application

Description : La boîte de dialogue Sélectionner une application est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet d'indiquer les exécutables à utiliser pour appeler les actions que vous définissez pour les types. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Rechercher un exécutable

Description : La boîte de dialogue Rechercher un exécutable est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet d'indiquer les exécutables à utiliser pour appeler les outils du lanceur Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.


Boîte de dialogue Ajouter fichiers au projet

Description : La boîte de dialogue Ajouter fichiers au projet est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de rechercher et d'indiquer les fichiers à ajouter aux projets sélectionnés. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.

Remarque : Lorsque vous ajoutez des fichiers qui se trouvent dans le répertoire du projet, la boîte de dialogue Ajouter fichiers au projet supprime le chemin d'accès de chaque fichier, de façon à ce que seul son nom apparaisse dans le champ Nom de fichier de la palette de propriétés ; le répertoire apparaît dans le champ Répertoire père. Lorsque vous ajoutez au projet des fichiers qui se trouvent dans un répertoire différent, le chemin d'accès complet apparaît dans le champ Nom de fichier. Le nom des sous-répertoires apparaît dans le champ Répertoire du projet de la palette de propriétés ; le nom du répertoire de projet père apparaît dans le champ Répertoire père.


Boîte de dialogue Ajouter le répertoire au projet

Description : La boîte de dialogue Ajouter le répertoire au projet est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de rechercher et d'indiquer les répertoires à ajouter aux projets sélectionnés. Lorsque vous ajoutez un répertoire, tous les sous-répertoires de l'arborescence sont également ajoutés. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.

Remarque : L'affichage, dans le champ Répertoire du projet de la palette de propriétés, du chemin d'accès complet ou relatif du répertoire, dépend du fait que le répertoire récemment ajouté est un sous-répertoire du projet père ou non. Si le répertoire est un sous-répertoire du projet père, son chemin d'accès relatif apparaît. Dans le cas contraire, le chemin d'accès complet apparaît. Le champ Répertoire père contient toujours le nom du projet qui contient le sous-projet (ou l'élément).


Boîte de dialogue Nouveau projet

Description : La boîte de dialogue Nouveau projet est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de créer un nouveau fichier de base de registres de projet. Utilisez cette boîte de dialogue comme vous utiliseriez toute boîte de dialogue de gestion de fichiers sur votre système.

Remarque : Le nom de fichier que vous indiquez n'est pas celui qui apparaît dans le Navigateur de projet. Par défaut, le nom qui apparaît est « Nouveau projet # », auquel est ajouté le numéro approprié. Pour modifier le nom du projet de sorte qu'il soit plus significatif, cliquez une fois dessus, puis entrez le nouveau nom en écrasant l'ancien.


Boîte de dialogue Editeur de paramètre

Description : La boîte de dialogue Nouveau projet est une boîte de dialogue de gestion de fichiers propre à la plate-forme qui vous permet de créer un nouveau fichier de base de registres de projet. Utilisez cette boîte de dialogue comme vous utiliseriez normalement toute boîte de dialogue de gestion de fichiers sur votre système.

Remarque : Le nom de fichier que vous indiquez n'est pas celui qui apparaît dans le Navigateur de projet. Par défaut, le nom qui apparaît est « Nouveau projet ».


Boîte de dialogue Nouveau sous-projet

Description : La boîte de dialogue Nouveau sous-projet vous permet de créer un nouveau sous-projet dans le projet ou le sous-projet sélectionné.


Boîte de dialogue Echec de la livraison

Description : La boîte de dialogue Echec de la livraison indique que votre livraison n'a pas réussi. Les problèmes les plus courants sont les suivants :

•	Un fichier du projet livré porte le même nom qu'un fichier du répertoire cible, mais ce dernier est en lecture seule.

•	Project Builder a tenté de joindre via FTP une machine située sur un réseau, mais la machine ou le réseau est indisponible.

Cette boîte de dialogue contient les éléments suivants :

Oui	Cliquez sur ce bouton pour poursuivre ou recommencer l'opération de livraison.
Oui à tous	Cliquez sur ce bouton pour recommencer cette opération, ainsi que toutes les opérations de nature similaire.
Non	Cliquez sur ce bouton pour ignorer ce fichier et poursuivre la livraison.
Annuler	Cliquez sur ce bouton pour annuler la livraison dans sa totalité.


Boîte de dialogue Définir mot de passe de projet

  Rubriques connexes

Description : La boîte de dialogue Définir mot de passe de projet vous permet de définir un mot de passe pour le projet sélectionné. Lorsque vous créez un mot de passe pour un projet, les utilisateurs sont invités à le saisir lorsqu'ils tentent d'ouvrir le projet.

Cette boîte de dialogue contient les éléments suivants :

Ancien mot de passe	Si le projet n'a pas encore de mot de passe, ce champ est désactivé. Pour changer un mot de passe, saisissez le mot de passe existant dans ce champ. Pour supprimer un mot de passe, saisissez dans ce champ le mot de passe en vigueur, mais ne remplissez pas les champs Nouveau mot de passe et Confirmer mot de passe.
Nouveau mot de passe	Saisissez le nouveau mot de passe du projet. Le mot de passe n'est pas limité en nombre de caractères et il peut contenir tous les caractères. Le mot de passe n'a pas de date d'expiration.
Confirmer mot de passe	Saisissez une nouvelle fois le nouveau mot de passe pour le confirmer.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Gérer filtres

  Rubriques connexes

Description : La boîte de dialogue Gérer filtres vous permet d'ajouter, de modifier et de supprimer des filtres pour vos projets. Un filtre vous permet d'afficher un sous-ensemble des données du projet, en fonction des paramètres que vous définissez ; par exemple, tous les éléments .fmb ou tous les éléments gérés par un système de contrôle de la version source.

Cette boîte de dialogue contient les éléments suivants :

Filtres diponisbles	Dresse la liste des filtres actuellement définis.
Ajouter filtre	Cliquez sur ce bouton pour faire apparaître la boîte de dialogue Ajouter filtre, dans laquelle vous pouvez définir les critères d'un nouveau filtre.
Editer filtre	Sélectionnez un filtre dans la liste Filtres disponibles, puis cliquez sur Editer filtre pour le modifier. La boîte de dialogue correspondante apparaît.
Supprimer filtre	Sélectionnez un filtre dans la liste Filtres disponibles, puis cliquez sur Supprimer filtre pour le supprimer.
Critères de filtre	Liste des critères actuellement définis pour le filtre. Cette liste évolue lorsque vous sélectionnez une autre entrée dans la liste Filtres disponibles.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Ajouter filtre

Description : La boîte de dialogue Ajouter filtre vous permet de définir ou de modifier les propriétés d'un filtre.

Cette boîte de dialogue contient les éléments suivants :

Nom de filtre	Saisissez dans ce champ le nom du filtre. Si vous éditez un filtre, ce champ n'est pas modifiable.
Définir/modifier critères de filtre	Série d'onglets dans lesquels vous pouvez définir/modifier les critères du filtre. Toutes les propriétés de la palette de propriétés sont représentées sur ces onglets.
Général	Contient les propriétés générales des éléments de projet.
Titre	Saisissez le titre de l'élément que le filtre doit rechercher ou sélectionnez-le dans la liste déroulante. Par exemple, utilisez ce champ pour rechercher des fichiers portant le même nom, mais ayant une extension différente. Vous pouvez également saisir les premiers caractères du nom, en majuscules ou en minuscules, et Project Builder utilise cette chaîne initiale pour la recherche.
Nom de fichier	Entrez le nom de fichier du ou des éléments que le filtre doit rechercher, ou sélectionnez-les dans la liste déroulante. Vous pouvez également saisir les premiers caractères du nom, en majuscules ou en minuscules, et Project Builder utilise cette chaîne initiale pour la recherche.
Type	Sélectionnez le type de fichier que le filtre doit rechercher.
Fichier	Contient les propriétés relatives aux attributs de fichier des éléments de projet.
Inclure les fichiers existants ayant les attributs suivants	Case à cocher à trois états : • Par défaut, le filtre recherche à la fois les fichiers existants et non existants. (La case à cocher est grisée.) • Cliquez une fois sur la case pour supprimer la coche : le filtre recherche uniquement les éléments qui n'existent pas encore dans le système de fichiers. (La case n'est pas cochée.) • Cliquez une nouvelle fois sur la case pour que le filtre recherche uniquement les éléments existants. (La case est cochée.)
Contient texte	Saisissez dans ce champ le texte que le filtre doit rechercher. Si un fichier répond aux autres critères de filtre spécifiés, le programme recherche dans ce fichier la chaîne indiquée.
Dernière modification entre	Saisissez la plage de dates où doit être comprise la date de dernière modification des fichiers cibles. Utilisez le format jj/mm/aaaa.
Taille de fichier entre	Utilisez les boutons d'incrémentation/de décrémentation pour spécifier la plage de tailles des fichiers cibles, en octets.
Projet	Contient les propriétés concernant l'état de contrôle de version des éléments de projet, l'état de génération, et des informations indiquant si l'élément est implicite ou explicite.
Contrôle de  version	Cliquez sur le bouton d'option approprié pour indiquer si vous souhaitez que le filtre recherche uniquement les fichiers dont la version est contrôlée, uniquement les fichiers non contrôlés, ou les deux à la fois.
Eléments implicites	Cliquez sur le bouton d'option approprié pour indiquer si vous souhaitez que le filtre recherche uniquement les éléments implicites (ceux que Project Builder crée pour vous), uniquement les éléments explicites (ceux que vous créez), ou les deux à la fois.  Vous pouvez créer des pseudovariables pour les éléments que vous créez, tout comme Project Builder en crée pour les éléments implicites. Pour que le filtre recherche uniquement les éléments déjà créés, pensez à cliquer sur la case Inclure les fichiers existants ayant les attributs suivants de l'onglet Fichier.
Générer état	Cliquez sur le bouton d'option approprié pour indiquer si le filtre doit rechercher uniquement les éléments obsolètes, les éléments à jour venant juste d'être générés, ou les deux à la fois.
Livraison	Contient des propriétés relatives à l'état de livraison des éléments de projet.
Rechercher fichiers livrables ?	Cliquez sur Oui pour que le filtre recherche les éléments dont la propriété Livraison est définie sur Oui, sur Non si cette propriété doit être définie sur Non et sur N/A si cela n'a pas d'importance.
Rechercher éléments à livrer ?	Cliquez sur Oui pour que le filtre recherche les éléments qui n'ont pas été livrés depuis la dernière livraison du projet, sur Non si vous ne souhaitez pas rechercher ces éléments et sur N/A si cela n'a pas d'importance.
Connexion	Contient des propriétés relatives aux connexions des projets.
Connexion	Sélectionnez dans la liste déroulante la connexion à rechercher. Les champs Nom utilisateur, Mot de passe et Base de données sont remplis en conséquence, et ajoutés au champ Critère. (Vous ne pouvez pas faire de recherche sur le nom de la connexion, mais uniquement sur le nom utilisateur, le mot de passe et la base de données qui constituent cette connexion.)
Nom utilisateur	Saisissez dans ce champ le nom utilisateur que le filtre doit rechercher. Vous pouvez, par exemple, rechercher tous les éléments pour lesquels le nom utilisateur pour la connexion est FRED.
Mot de passe	Saisissez dans ce champ le mot de passe que le filtre doit rechercher. Vous pouvez, par exemple, rechercher tous les éléments pour lesquels le mot de passe de connexion est DEV1.
Base de données	Saisissez dans ce champ la base de données que le filtre doit rechercher. Vous pouvez, par exemple, rechercher tous les éléments pour lesquels la base de données de connexion est TIGER.
Macro	Contient des propriétés relatives aux macros.
Nom	Saisissez le nom de la macro que le filtre doit rechercher. Ce filtre isole tous les éléments de projet pour lesquels cette macro est définie.
Valeur	Saisissez la valeur que le filtre doit rechercher. Si vous ne remplissez pas ce champ, le filtre recherche le nom de la macro sans tenir compte de sa valeur. Si vous saisissez une valeur, la macro doit être définie sur cette valeur pour être identifiée par le filtre.
Ajouter macro	Cliquez sur ce bouton pour ajouter une ligne à la liste des macros à rechercher.
Supprimer macro	Cliquez sur ce bouton pour supprimer de la liste la macro mise en surbrillance.
Critères de filtre en cours	Critères actuellement définis pour le filtre.
Supprimer	Cliquez sur ce bouton pour supprimer les critères sélectionnés dans le champ Critères de filtre en cours.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Ajouter connexion à la définition

Description : La boîte de dialogue Ajouter connexion à la définition vous permet d'insérer une connexion dans la chaîne de commande que vous définissez dans la boîte de dialogue Ajouter/Editer entrée du Lanceur.

Cette boîte de dialogue contient les éléments suivants :

Nom	Nom défini pour la connexion.
Valeur	Connexion proprement dire, au format nom_utilisateur@base_de_données.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Nouveau projet

Description : La boîte de dialogue Nouveau projet vous permet de choisir la méthode de création de votre projet : via l'assistant Projet ou via la boîte de dialogue Nouveau projet.

Cette boîte de dialogue contient les éléments suivants :

Créer le projet	Cliquez sur le bouton d'option qui correspond à la méthode à utiliser :
. . . via l'assistant Projet	Cliquez sur ce bouton pour créer votre projet en utilisant l'assistant Projet, qui vous guide au long des étapes nécessaires pour créer et compléter un projet.
. . . via la boîte de dialogue Nouveau projet	Cliquez sur ce bouton pour créer votre projet en utilisant la boîte de dialogue Nouveau projet, qui vous permet de créer le fichier de base de registres du projet. Vous pouvez alors utiliser la palette de propriétés et d'autres options de menu pour entrer des informations sur le projet et ajouter des fichiers à votre projet.
Afficher cette boîte de dialogue ultérieurement	Si vous avez l'intention d'utiliser l'assistant Projet ou la boîte de dialogue Nouveau projet de manière régulière, cliquez sur le bouton d'option approprié, puis cliquez sur cette case pour empêcher l'affichage de cette boîte de dialogue. La prochaine fois que vous sélectionnez Fichier [image] Nouveau [image] Projet, la méthode choisie est automatiquement employée. Remarque : Pour faire réapparaître cette boîte de dialogue ultérieurement, sélectionnez Outils [image] Préférences, puis désactivez la case à cocher Afficher boîte de dialogue de sélection de méthode Nouveau projet de l'onglet Afficher.


Boîte de dialogue Nouveau sous-projet

Description : La boîte de dialogue Nouveau sous-projet vous permet de choisir la méthode de création de votre sous-projet : via l'assistant Projet ou via la boîte de dialogue Nouveau sous-projet.

Cette boîte de dialogue contient les éléments suivants :

Créer le sous-projet	Cliquez sur le bouton d'option qui correspond à la méthode à utiliser :
. . . via l'assistant Projet	Cliquez sur ce bouton pour créer votre sous-projet en utilisant l'assistant Projet, qui vous guide au long des étapes nécessaires pour créer et compléter un sous-projet.
. . . via la boîte de dialogue Nouveau sous-projet	Cliquez sur ce bouton pour créer votre sous-projet en utilisant la boîte de dialogue Nouveau sous-projet, qui vous permet de créer le fichier de base de registres du projet. Vous pouvez alors utiliser la palette de propriétés et d'autres options de menu pour entrer des informations sur le projet et ajouter des fichiers à votre sous-projet.
Afficher cette boîte de dialogue ultérieurement	Si vous avez l'intention d'utiliser l'assistant Projet ou la boîte de dialogue Nouveau sous-projet de manière régulière, cliquez sur le bouton d'option approprié, puis cliquez sur cette case pour empêcher l'affichage de cette boîte de dialogue. La prochaine fois que vous sélectionnez Fichier [image] Nouveau [image] Sous-projet, la méthode choisie est automatiquement employée. Remarque : Pour faire réapparaître cette boîte de dialogue ultérieurement, sélectionnez Outils [image] Préférences, puis désactivez la case à cocher Afficher boîte de dialogue de sélection de méthode Nouveau sous-projet de l'onglet Afficher.


Boîte de dialogue Editeur de paramètre

  Rubriques connexes

Description : La boîte de dialogue Editeur de paramètre vous invite à saisir une valeur ou à confirmer la valeur par défaut afin de développer pleinement une macro. Tous les types de macro, à l'exception de celles de type statique, font apparaître cette boîte de dialogue lorsqu'elles sont appelées.

Cette boîte de dialogue contient les éléments suivants :

Texte propre à la macro	Selon le type de macro, cette zone peut afficher une valeur par défaut et vous demander de la confirmer ou de saisir une nouvelle valeur.
OK	Confirme vos sélections et ferme la boîte de dialogue.
Annuler	Annule l'opération en cours et ferme la boîte de dialogue.


Boîte de dialogue Mot de passe de projet

Description : La boîte de dialogue Mot de passe de projet apparaît lorsque vous tentez d'ouvrir un projet protégé par mot de passe. Si vous fermez Project Builder alors qu'un projet protégé par mot de passe est ouvert, cette boîte de dialogue apparaît au prochain démarrage de Project Builder.

Cette boîte de dialogue contient les éléments suivants :

Champ Mot de passe	Saisissez le mot de passe correct pour ouvrir le projet.
Annuler	Cliquez sur ce bouton pour quitter cette boîte de dialogue sans ouvrir le projet.


Boîte de dialogue Insérer nom de fichier

Description : La boîte de dialogue Insérer nom de fichier vous permet d'insérer le nom d'un fichier, généralement un fichier exécutable, dans une action ou une macro. Utilisez cette boîte de dialogue comme vous utiliseriez toute boîte de dialogue de gestion de fichiers sur votre système.


La base de registres utilisateur a été verrouillée par un autre utilisateur. Réessayer ou quitter ?

 Cause :	Lors de l'initialisation, Project Builder a tenté de lire votre base de registres utilisateur mais n'y est pas parvenu, probablement parce qu'un autre utilisateur était en train de la modifier et l'avait verrouillée pour une opération d'écriture.

 Action :	Pour essayer à nouveau d'accéder à la base de registres utilisateur, cliquez sur Réessayer. Pour quitter Project Builder et réessayer ultérieurement, cliquez sur Quitter.


La base de registres globale a été verrouillée par un autre utilisateur. Réessayer la base de registres ou quitter ?

 Cause :	Lors de l'initialisation, Project Builder a tenté de lire la base de registres globale mais n'y est pas parvenu, probablement parce qu'un autre utilisateur était en train de la modifier et l'avait verrouillée pour une opération d'écriture.

 Action :	Pour essayer à nouveau d'accéder à la base de registres globale, cliquez sur Réessayer. Pour quitter Project Builder et réessayer ultérieurement, cliquez sur Quitter.


La base de registres de projet a été verrouillée par un autre utilisateur : <nom du fichier de base de registres>. Réessayer cette base de registres ou poursuivre avec la suivante ?

 Cause :	Lors de l'initialisation ou d'une opération d'ouverture de projet, Project Builder a tenté de lire la base de registres de projet indiquée ci-dessus mais n'y est pas parvenu, probablement parce qu'un autre utilisateur était en train de la modifier et l'avait verrouillée pour une opération d'écriture.

 Action :	Pour essayer à nouveau d'accéder à la base de registres de projet, cliquez sur Réessayer. Pour sauter ce projet et poursuivre votre session Project Builder, cliquez sur Continuer.


La base de registres utilisateur a été modifiée par un autre utilisateur ; votre dernière modification a été supprimée.

 Cause :	Vous avez tenté de modifier votre base de registres utilisateur mais en avez été empêché pour éviter que vos modifications ne remplacent une modification antérieure.

 Action :	Cliquez sur OK pour rafraîchir votre copie de la base de registres utilisateur et obtenir les dernières modifications, puis, le cas échéant, effectuez de nouveau vos propres modifications.


La base de registres globale a été modifiée par un autre utilisateur ; votre dernière modification a été supprimée.

 Cause :	Vous avez tenté de modifier la base de registres globale mais en avez été empêché pour éviter que vos modifications ne remplacent une modification antérieure.

 Action :	Cliquez sur OK pour rafraîchir votre copie de la base de registres globale et obtenir les dernières modifications, puis, le cas échéant, effectuez de nouveau vos propres modifications.


La base de registres de projet a été supprimée par un autre utilisateur : <nom du fichier de base de registres>. Votre dernière modification a été supprimée.

 Cause :	Vous avez tenté de modifier la base de registres de projet mais en avez été empêché pour éviter que vos modifications ne remplacent une modification antérieure.

 Action :	Cliquez sur OK pour rafraîchir votre copie de la base de registres de projet et obtenir les dernières modifications, puis, le cas échéant, effectuez de nouveau vos propres modifications.


La base de registres utilisateur a été altérée. Voulez-vous récupérer les données de la base de registres ou sortir ?

 Cause :	Le fichier de la base de registres utilisateur a été altéré.

 Action :	Cliquez sur Récupérer pour récupérer autant d'informations que possible ou cliquez sur Quitter pour sortir. Si vous disposez d'une copie de sauvegarde, vous pouvez restaurer le fichier depuis cette copie.


La base de registres globale a été altérée. Voulez-vous récupérer les données de la base de registres ou sortir ?

 Cause :	Le fichier de la base de registres globale a été altéré.

 Action :	Cliquez sur Récupérer pour récupérer autant d'informations que possible ou cliquez sur Quitter pour sortir. Si vous disposez d'une copie de sauvegarde, vous pouvez restaurer le fichier depuis cette copie.


La base de registres projet a été altérée. Voulez-vous récupérer les données de la base de registres ou sortir ?

 Cause :	Le fichier de la base de registres projet a été altéré.

 Action :	Cliquez sur Récupérer pour récupérer autant d'informations que possible ou cliquez sur Annuler pour laisser le fichier fermé. Si vous disposez d'une copie de sauvegarde, vous pouvez restaurer le fichier depuis cette copie.


La base de registres utilisateur est une ancienne version. Doit-elle être mise à niveau ?

 Cause :	Le fichier de la base de registres utilisateur est une ancienne version.

 Action :	Cliquez sur OK pour mettre le fichier au niveau de la version la plus récente ou cliquez sur Annuler pour ne pas le modifier.

Remarque : Si vous ne mettez pas le fichier à niveau, certaines fonctions peuvent manquer.


La base de registres globale est une ancienne version. Doit-elle être mise à niveau ?

 Cause :	Le fichier de la base de registres globale est une ancienne version.

 Action :	Cliquez sur OK pour mettre le fichier au niveau de la version la plus récente ou cliquez sur Annuler pour ne pas le modifier.

Remarque : Si vous ne mettez pas le fichier à niveau, certaines fonctions peuvent manquer.


La base de registres projet est une ancienne version. Doit-elle être mise à niveau ?

 Cause :	Le fichier de la base de registres projet est une ancienne version.

 Action :	Cliquez sur OK pour mettre le fichier au niveau de la version la plus récente ou cliquez sur Annuler pour ne pas le modifier.

Remarque : Si vous ne mettez pas le fichier à niveau, certaines fonctions peuvent manquer.


La base de registres utilisateur est fragmentée à <nombre> pour cent. Doit-elle être défragmentée ?

Cause :	Dans la boîte de dialogue Préférences (onglet Projets), vous avez indiqué que vous vouliez compresser les bases de registres à partir d'un pourcentage de fragmentation particulier. Ce pourcentage a été atteint pour la base de registres indiquée.

 Action :	Cliquez sur Oui pour compresser la base de registres utilisateur ou sur Non pour différer la compression. Si vous cliquez sur Non, ce message d'alerte apparaît chaque fois que vous démarrez Project Builder tant que vous n'avez pas compressé la base de registres ou augmenté la valeur du pourcentage de fragmentation toléré.


La base de registres globale est fragmentée à <nombre> pour cent. Doit-elle être défragmentée ?

Cause :	Dans la boîte de dialogue Préférences (onglet Projets), vous avez indiqué que vous vouliez compresser les bases de registres à partir d'un pourcentage de fragmentation particulier. Ce pourcentage a été atteint pour la base de registres indiquée.

 Action :	Cliquez sur Oui pour compresser la base de registres globale ou sur Non pour différer la compression. Si vous cliquez sur Non, ce message d'alerte apparaît chaque fois que vous démarrez Project Builder tant que vous n'avez pas compressé la base de registres ou augmenté la valeur du pourcentage de fragmentation toléré.


La base de registres projet est fragmentée à <nombre> pour cent. Doit-elle être défragmentée ?

 Cause :	Dans la boîte de dialogue Préférences (sur l'onglet Projets), vous avez indiqué que vous vouliez compresser la base de registres projet à partir d'un pourcentage de fragmentation particulier. Ce pourcentage a été atteint pour la base de registres indiquée.

 Action :	Cliquez sur Oui pour compresser la base de registres projet ou sur Non pour différer la compression. Si vous cliquez sur Non, ce message d'alerte apparaît chaque fois que vous démarrez Project Builder tant que vous n'avez pas compressé la base de registres ou augmenté la valeur du pourcentage de fragmentation toléré.


Imprimante introuvable. Vérifiez la configuration de l'imprimante.

 Cause :	Project Builder n'a pas trouvé d'imprimante installée sur votre système.

 Action :	Consultez la documentation de votre système d'exploitation, installez une imprimante et relancez l'application Project Builder.


Vérification de l'action suivante : <ligne de commande>

 Cause :	Vous êtes en mode Aperçu des actions et vous appelez une action. Les commandes transmises au système d'exploitation pour l'exécution de cette action sont affichées, mais ne sont pas réellement exécutées.

 Action :	Cliquez sur OK pour continuer le débogage.


Base de données non valide ou altérée.

 Cause :	Votre base de registres projet n'est pas valide ou est altérée.

 Action :	Vous pouvez récupérer tout ou partie de la base de registres projet en l'exportant vers un fichier texte, puis en important ce fichier texte vers Project Builder. Choisissez Fichier [image] Exporter projet pour exporter la base de registres, puis choisissez Fichier [image] Importer projet pour importer le fichier texte.


Mot de passe de projet non valide.

 Cause :	Vous avez entré un mot de passe non valide.

 Action :	Vérifiez que votre mot de passe est correct et bien orthographié, puis entrez-le à nouveau.


De nouvelles entrées du Lanceur ont été installées dans la zone globale. Voulez-vous les copier maintenant ?

 Cause :	Un nouveau produit a été installé et a copié ses informations de Lanceur dans la base de registres globale.

 Action :	Cliquez sur Oui pour mettre à jour votre Lanceur en fonction des nouvelles informations ou sur Non pour préserver l'état actuel de votre Lanceur.


Supprimer définitivement les entrés sélectionnées ? Confirmer.

 Cause :	Vous avez cliqué sur Supprimer dans la boîte de dialogue Préférences du Lanceur alors qu'une entrée était sélectionnée.

 Action :	Cliquez sur Oui pour supprimer définitivement cette entrée du Lanceur ou sur  Non pour préserver l'état actuel de votre Lanceur.


:	Erreur d'analyse de : <chaîne>.

 Cause :	Project Builder n'est pas parvenu à interpréter la chaîne indiquée.

 Action :	Déboguez votre commande, puis essayez à nouveau.


Erreur d'exécution de la chaîne de lancement (code d'erreur OS <nn>) : <message du système d'exploitation>.

 Cause :	Project Builder a tenté de lancer un outil mais a détecté l'erreur de système d'exploitation indiquée.

 Action :	Pour plus d'informations, reportez-vous à la documentation relative à votre plate-forme.


Aucune sélection.

 Cause :	Vous avez cliqué sur Supprimer ou sur Editer dans l'onglet Lanceur de la boîte de dialogue Préférences alors qu'aucune entrée de Lanceur n'était sélectionnée.

 Action :	Vous devez sélectionner un outil dans le Navigateur du Lanceur avant de le supprimer ou de l'éditer.


Echec de création du projet

 Cause :	Project Builder n'est pas parvenu à créer votre projet. L'une des causes suivantes est à l'origine du problème :

A.              Vous ne disposez pas du droit d'accès en écriture à votre fichier projet.

B.              Un autre utilisateur a modifié votre fichier projet alors que vous étiez en train de le créer.

C.              Vous êtes à court de mémoire.

 Action :	Pour remédier à cette erreur, entreprenez les actions suivantes :

Cause A.   Vérifiez auprès de votre administrateur que vous avez accès au répertoire dans lequel vous créez votre projet.

Cause B.   Régénérez la base de registres de votre projet (l'une des méthodes consiste à changer de vue).

Cause C.   Fermez toutes les applications inutiles.


Vous devez entrer un nom d'action.

 Cause :	Vous avez tenté de créer/modifier une action sans lui donner de nom.

 Action :	Vous devez entrer un nom pour votre action dans le champ texte Nom avant de continuer.


Vous devez entrer un nom de fichier pour les données de sortie batch.

 Cause :	Vous avez tenté de créer un fichier de sortie de traitement par lots (batch) sans lui donner de nom.

 Action :	Vous devez entrer un nom pour votre fichier de sortie batch dans le champ texte Nom avant de continuer.


Vous devez entrer un nom de connexion.

 Cause :	Chaque connexion doit porter un nom.

 Action :	Entrez un nom pour la nouvelle connexion dans le champ texte Titre, puis entrez les informations de connexion.


Destination inexistante pour cet élément.

 Cause :	Chaque fichier du projet livré doit posséder un répertoire de destination par défaut.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis indiquez un répertoire par défaut dans le champ Répertoire de destination et nom de fichier.


Le nom de produit doit contenir au maximum 8 caractères alphabétiques, sans espace.

 Cause :	Vous avez entré un nom de plus de 8 caractères, ou comportant des caractères spéciaux ou un espace.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis entrez un nom respectant les conventions d'appellation.


Indiquez un répertoire de mise en oeuvre.

 Cause :	L'assistant Livraison ne peut pas copier ou transférer par FTP vos fichiers sans répertoire de mise en oeuvre.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis indiquez, dans le champ approprié, le répertoire devant servir de répertoire de mise en oeuvre.


Entrez un nom de produit.

 Cause :	Vous devez entrer un nom de produit.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis entrez un nom de produit dans le champ texte Nom. Ce nom doit contenir au maximum 8 caractères, sans caractère spécial ni espace.


Entrez le nom de la variable d'environnement ou supprimez cette ligne.

 Cause :	Pour que vous puissiez effectuer une livraison, l'écran Fichiers à livrer doit répertorier au moins un fichier.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis utilisez les flèches pour déplacer les fichiers de l'écran Ensemble de fichiers à livrer=Oui à l'écran Fichiers à livrer.


Echec de connexion !

 Cause :	Votre opération de transfert par FTP a échoué car Project Builder n'a pas réussi à se connecter à l'ordinateur hôte.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison. Vérifiez que vous avez entré un nom utilisateur, un mot de passe, un nom d'hôte et un nom de compte (si nécessaire) corrects, puis essayez à nouveau d'effectuer l'opération de livraison.


Les éléments sélectionnés ne sont associés à aucun fichier. Doivent-ils être omis de la présente édition ?

 Cause :	L'assistant Livraison a trouvé des éléments sans fichier associé.

 Action :	Cliquez sur Oui pour omettre les fichiers non attachés de cette version ou cliquez sur Non, puis fermez l'assistant Livraison pour générer à nouveau le projet et inclure les fichiers manquants.


Aucun élément à livrer.

 Cause :	Pour que vous puissiez effectuer une livraison, l'écran Fichiers à livrer doit répertorier au moins un fichier.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis utilisez les flèches pour déplacer les fichiers de l'écran Fichiers du projet à l'écran Fichiers à livrer.


Vous devez entrer un nom de connexion.

Cause :	Chaque connexion doit porter un nom.

 Action :	Entrez un nom pour la nouvelle connexion dans le champ texte Titre, puis entrez les informations de connexion.


Vous devez entrer un nom de fichier pour l'élément.

 Cause :	Vous avez effacé ou supprimé le nom de fichier d'un élément dans le Navigateur ou dans la Palette de propriétés.

 Action :	Vous devez entrer à nouveau un nom de fichier pour l'élément avant de continuer.


Vous devez entrer un nom d'élément.

 Cause :	Vous avez effacé ou supprimé le nom d'un élément dans le Navigateur ou dans la Palette de propriétés.

 Action :	Vous devez entrer à nouveau un nom d'élément avant de continuer.


Vous devez entrer un nom de type.

 Cause :	Vous avez tenté de créer/modifier un type sans lui donner de nom.

 Action :	Vous devez entrer un nom pour votre type dans le champ texte Type avant de continuer.


Les noms de macro ne peuvent contenir que des caractères alphanumériques et des caractères de soulignement.

 Cause :	Vous avez utilisé un caractère non autorisé dans un nom de macro.

 Action :	Entrez à nouveau le nom de la macro en utilisant uniquement des caractères alphanumériques ou des caractères de soulignement.


Vous devez entrer un nom de macro.

 Cause :	Vous avez tenté de créer/modifier une macro sans lui donner de nom.

 Action :	Vous devez entrer un nom pour votre macro dans le champ texte Nom de macro avant de continuer.


Vous ne pouvez pas utiliser le nom d'une macro prédéfinie.

 Cause :	Certains noms d'une seule lettre, comme b, n, d et f, sont réservés aux macros prédéfinies.

 Action :	Choisissez un autre nom pour la macro.


Le nouveau mot de passe et le mot de passe de confirmation ne concordent pas. Entrez-les à nouveau.

 Cause :	Vous avez vraisemblablement fait une faute de frappe en entrant le mot de passe de confirmation.

 Action :	Entrez à nouveau le nouveau mot de passe ainsi que le mot de passe de confirmation.


Avertissement : Echec de l'enregistrement des préférences

 Cause :	Project Builder a tenté d'enregistrer vos préférences dans votre fichier de préférences mais n'y est pas parvenu.

 Action :	Vérifiez que le répertoire contenant votre fichier de préférences est accessible en écriture.


Avertissement : Echec de la définition d'attributs de projet. (Assurez-vous qu'il est possible d'écrire dans le registre de projet.)

 Cause :	Project Builder a tenté d'enregistrer les attributs de votre projet dans le fichier de définition de projet mais n'y est pas parvenu.

 Action :	Vérifiez que le fichier de définition de projet et le répertoire dans lequel il se trouve sont tous deux accessibles en écriture.


Les entrées du Lanceur installées dans la zone globale vont être copiées dans votre Lanceur. Confirmez-vous la copie ?

 Cause :	Vous avez cliqué sur Par défaut dans l'onglet Lanceur de la boîte de dialogue Préférences.

 Action :	Cliquez sur Oui pour mettre à jour votre Lanceur en fonction des informations de Lanceur de la base de registres globale (certaines parties des informations de Lanceur peuvent être remplacées) ou cliquez sur Non pour préserver l'état actuel de votre Lanceur.


Supprimer les fichiers registres de projet ainsi que les éléments de projet ?

 Cause :	Vous êtes sur le point de supprimer un projet entier. Vous pouvez choisir d'enregistrer le fichier registre de ce projet ou de le supprimer avec les éléments du projet.

 Action :	Cliquez sur Oui pour supprimer le fichier registre du projet. Cliquez sur Non pour enregistrer le fichier registre du projet et ne supprimer que les éléments du projet. Cliquez sur Annuler pour abandonner la suppression du projet.


Avertissement : Echec de création d'une palette de propriétés. Assurez-vous que la mémoire est suffisante.

 Cause :	Project Builder n'est pas parvenu à générer une palette de propriétés à la demande, probablement du fait de mémoire insuffisante.

 Action :	Augmentez la quantité de mémoire disponible en fermant les applications inutiles.


Echec de création ou de modification du type demandé. Assurez-vous qu'il est possible d'écrire dans le registre du type et que celui-ci n'est pas en cours de modification par un autre utilisateur.

 Cause :	Project Builder a tenté d'enregistrer les propriétés de votre type dans la base de registres appropriée. L'une des causes suivantes est à l'origine du problème :

A.	    Vous ne disposez pas du droit d'accès en écriture à votre fichier projet.

B.	    Un autre utilisateur a modifié votre fichier projet.

 Action :	Pour remédier à cette erreur, entreprenez les actions suivantes :

Cause A.   Vérifiez auprès de votre administrateur que vous avez accès au répertoire dans lequel vous créez votre projet.

Cause B.    Assurez-vous qu'aucun autre utilisateur ne modifie votre projet.


Entrez un nom de fichier registre de projet.

 Cause :	Vous avez cliqué sur Suivant dans l'assistant Projet sans entrer de nom de fichier pour le nouveau projet.

 Action :	Vous devez entrer un nom de fichier dans la zone de texte Nom de fichier registre de projet avant de continuer.


Entrer un nom de fichier.

 Cause :	Vous avez tenté de passer à la page suivante de l'assistant Projet sans entrer de nom de fichier pour votre projet.

 Action :	Avant de continuer, entrez un nom de projet dans le champ texte Nom de fichier de la base de données de projet ou parcourez les noms de fichier pour en sélectionner un.


Entrer un répertoire.

 Cause :	Vous avez tenté de passer à la page suivante de l'assistant Projet sans préciser de répertoire par défaut pour votre fichier projet.

 Action :	Avant de continuer, entrez le nom du répertoire par défaut de votre projet dans le champ texte Répertoire par défaut de l'élément de projet ou parcourez les noms de répertoire pour en sélectionner un.


Enregistrement impossible de l'état du lanceur.

 Cause :	Project Builder a tenté d'enregistrer vos préférences de Lanceur dans votre fichier de préférences mais n'y est pas parvenu.

 Action :	Vérifiez que le répertoire contenant votre fichier de préférences est accessible en écriture.


Voulez-vous supprimer les fichiers liés au projet ainsi que les liens eux-mêmes ?

 Cause :	Vous avez choisi Couper ou Effacer alors qu'un projet était sélectionné dans le Navigateur de projet.

 Action :	Cliquez sur Oui pour non seulement supprimer le projet du Navigateur de projet mais aussi supprimer le fichier de définition de projet de votre système de fichiers. Pour garder le projet, cliquez sur Non.


Le ou les éléments sélectionnés vont être supprimés de votre projet. Confirmez-vous la suppression ?

 Cause :	Vous avez choisi Supprimer des fichiers du projet alors que des fichiers sont sélectionnés dans le Navigateur de projet.

 Action :	Cliquez sur Oui pour confirmer que vous voulez supprimer le ou les fichier(s) sélectionné(s) de votre projet (cette action ne supprime pas les éléments correspondants de votre système de fichiers). Pour garder les fichiers sélectionnés, cliquez sur Non.


Entrez un nom de script.

 Cause :	L'assistant Livraison doit disposer d'un nom de script pour générer des scripts Oracle Installer. Le nom de script est utilisé en interne pour effectuer le suivi de votre produit.

 Action :	Cliquez sur OK pour revenir à l'assistant Livraison, puis entrez un nom dans le champ Script.


Le Navigateur de projet

Le Navigateur de projet affiche, en ordre hiérarchique, le contenu de tous vos projets ouverts pour vous permettre d'y accéder. Cliquez sur une rubrique pour un complément d'information :

A propos du Navigateur de projet

A propos de la hiérarchie des projets

A propos du développement et de la réduction des noeuds

Suppression d'un objet

Développement des noeuds

Réduction des noeuds

Pose de signets

Passage à des signets


A propos du Navigateur de projet

  Rubriques connexes

Le Navigateur de projet offre un affichage hiérarchique de tous les projets ouverts et de tous les éléments qu'ils contiennent.

Ses composants sont les suivants :

zone d'affichage des noeuds	Principal composant du Navigateur de projet. Zone dans laquelle tous les objets auxquels vous pouvez avoir accès sont regroupés hiérarchiquement. (Les projets identifiés par [image] sont en lecture seule.)
objet courant	Affiche le type, la connexion, le projet, le sous-projet ou l'élément sélectionné. Utilisez la liste déroulante pour afficher l'objet en fonction de la hiérarchie courante. Les projets ouverts sont toujours répertoriés dans l'ordre dans lequel ils apparaissent dans le Navigateur de projet ; les autres noeuds sont mentionnés uniquement si l'objet courant leur appartient. En mettant un objet en surbrillance dans la liste déroulante, vous le sélectionnez également dans le Navigateur de projet.
champ Rechercher	Permet de rechercher, dans le Navigateur de projet, la chaîne de texte indiquée. Si le sous-projet, le type ou l'élément cible apparaît dans un noeud réduit, le noeud est développé. Utilisez les icônes [image] et [image] pour répéter l'action de recherche, vers l'avant ou vers l'arrière dans la hiérarchie.
barre d'outils	Contient les commandes courantes auxquelles vous pouvez également accéder à partir d'un certain nombre de menus comme Ouvrir, Couper, Copier, Coller, Générer sélection et Générer par incrément. Pour identifier un outil, placez la souris sur le bouton.
Lanceur	Barre d'outils secondaire située par défaut sur le côté gauche du Navigateur de projet. Le Lanceur vous permet d'organiser et de lancer directement, par Project Builder, les outils que vous utilisez le plus fréquemment en cours de développement.
zone d'état	Zone divisée en trois sections : - Filtre : indique le filtre appliqué au Navigateur de projet - Connexion : connexion du projet sélectionné - Chemin d'accès complet au fichier de registres du projet en cours OU conseils d'aide pour la barre d'outils et les éléments de menu.


A propos de la hiérarchie des projets

  Rubriques connexes

Le Navigateur de projet présente vos projets et les éléments qui leur sont associés (types et chaînes de connexion à la source de données, par exemple) en ordre hiérarchique.

En haut de la hiérarchie se trouve la base de registres globale, fournie par Project Builder comme base de tous les projets et qui contient la description d'un grand nombre de types de fichier utilisés dans les applications Forms et Reports Developer. Les informations figurant dans ces descriptions portent, notamment, sur la façon d'ouvrir et d'éditer les fichiers ou de packager des fichiers en vue de leur livraison.

La base de registres globale est suivie d'une ou de plusieurs bases de registres utilisateur. Ces bases de registres contiennent les définitions des types propres à l'utilisateur, ainsi que les modifications des types fournis par la base de registres globale. Les bases de registres utilisateur peuvent également contenir des informations propres à des sessions Project Builder d'un utilisateur donné, comme par exemple les chaînes de connexion utilisées pour accéder à différentes sources de données.

Au bas de la hiérarchie se trouvent le projet et ses entrées, qui sont les véritables pointeurs de fichier. Les entrées apparaissent classées soit par type, soit selon les dépendances entre fichiers, suivant la façon dont vous voulez afficher vos projets. Les fichiers héritent les informations stockées dans leurs définitions de type ; la définition contenue dans le registre utilisateur, s'il existe et, dans le cas contraire, la définition contenue dans la base de registres globale. Vous pouvez également remplacer les informations de type pour un fichier donné.


A propos du développement et de la réduction des noeuds

  Rubriques connexes

Au départ, lorsque le Navigateur de projet s’affiche, seuls ses noeuds de niveau supérieur sont visibles. Un signe plus (+) indique que le noeud contient des sous-objets cachés (c'est-à-dire que l'objet est réduit). Un signe moins (-) indique que tous les sous-objets sont visibles (c'est-à-dire que l'objet est développé).

Vous pouvez développer et réduire des noeuds niveau à niveau, ou tous les niveaux à la fois.


Suppression d'éléments

  Rubriques connexes

Pour supprimer un élément :

1	Cliquez sur le noeud de l'élément pour le sélectionner.

2	Choisissez Navigateur [image] Supprimer, ou cliquez sur [image] dans la barre d'outils.

Si vous choisissez la commande de menu, un message d'alerte vous demande de confirmer la suppression. Si vous choisissez l’outil, la confirmation de la suppression ne vous est pas demandée.


Développement des noeuds

  Rubriques connexes

Pour développer la première couche de sous-noeuds d'un noeud :

 Cliquez sur le signe plus (+) du noeud.

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

1	Cliquez sur un noeud réduit.

2	Choisissez Navigateur [image] Développer tout dans le menu.


Réduction des noeuds

  Rubriques connexes

Pour réduire un noeud et masquer sa première couche de sous-noeuds :

 Cliquez sur le signe moins (-) du noeud.

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

1	Cliquez sur un noeud développé.

2	Choisissez Navigateur [image] Réduire tout dans le menu.


Pose de signets

  Rubriques connexes

Pour poser un signet :

1	Cliquez sur le noeud sur lequel vous voulez poser un signet.

2	Choisissez Navigateur [image] Signet dans le menu.

Remarques :

•	Vous ne pouvez poser qu’un seul signet dans le Navigateur de projet. Chaque signet que vous créez ensuite remplace le signet créé précédemment.

•	Les signets sont particulièrement utiles lorsque la Palette de propriétés est ouverte et que vous voulez comparer rapidement les propriétés de deux éléments.


Passage à des signets

  Rubriques connexes

Pour passer à un signet :

 Choisissez Navigateur [image] Atteindre signet dans le menu.

Remarque : La sélection répétitive de Navigateur [image] Atteindre signet vous fait passer de la sélection en cours au signet. Ceci est particulièrement utile lorsque la Palette de propriétés est ouverte et que vous voulez comparer rapidement les propriétés de deux éléments.


Palette de propriétés

La Palette de propriétés vous permet d’accéder aux propriétés du ou des éléments sélectionnés dans le Navigateur de projet. Cliquez sur une rubrique pour un complément d’information :

A propos de la Palette de propriétés

A propos des sélections multiples dans la Palette de propriétés

A propos de la copie de propriétés

A propos des commandes de barre d’outils dans la Palette de propriétés

A propos des icônes dans la Palette de propriétés

Appel de la Palette de propriétés

Fermeture de la Palette de propriétés

Définition des propriétés dans la Palette de propriétés

Comparaison des propriétés de deux éléments

Copie des propriétés d’un élément à un autre

A propos des répertoires père et des répertoires de projet


A propos de la Palette de propriétés

La Palette de propriétés comporte une interface de type encadrement qui vous permet de visualiser, de localiser et d’obtenir des propriétés d’objets.

Lorsque vous sélectionnez un élément du Navigateur de projet, 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 modifiée lorsque vous sélectionnez un autre objet. Vous pouvez figer une palette particulière en cliquant sur [image] dans la barre d’outils de la Palette de propriétés. Pour libérer la Palette de propriétés, cliquez sur [image].

Pour comparer les propriétés de deux objets, vous pouvez appeler les palettes supplémentaires nécessaires.

Pour que la Palette de propriétés soit toujours affichée devant les autres fenêtres, choisissez Outils [image] Préférences, cliquez sur l'onglet Navigateur, puis cochez la case Conserver Palette de propriétés en haut.

La Palette de propriétés offre les options suivantes :

Liste de propriétés

La liste de propriétés contient, en 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 fonctionnels (actions ou macros, par exemple). Pour sélectionner des propriétés de la liste, cliquez sur celles qui vous intéressent, puis naviguez en utilisant les touches de défilement vers le haut ou vers le bas. Pour définir des propriétés dans l’écran de liste de propriétés, sélectionnez la propriété, puis tapez ou cliquez deux fois, selon le cas.

Nom

Le champ Nom, qui se trouve directement sous la barre d’outils, contient le nom de l’objet sélectionné dans le Navigateur de projet. Ce champ n’est pas affiché lorsqu’aucun objet n’est sélectionné ou que plusieurs objets sont sélectionnés simultanément.

Définition de commandes de propriétés

Lorsqu’une propriété est sélectionnée dans la liste des propriétés, un champ de texte, une liste instantanée ou un bouton Suite... s’affiche à côté de la propriété :

•	Un champ texte s’affiche lorsque la propriété peut être définie par l’entrée d’une valeur de texte. Pour les propriétés qui demandent des valeurs de texte plus longues, un bouton d’icône, à côté du champ texte, appelle un éditeur modal.

•	Une liste instantanée s’affiche pour les propriétés qui peuvent avoir la valeur True ou False, ou un ensemble fixe de valeurs valides.

•	Un bouton Suite... s’affiche lorsque la propriété en cours demande des valeurs plus complexes. Le fait de cliquer sur le bouton appelle une boîte de dialogue dans laquelle vous entrez les informations requises.


A propos des sélections multiples dans la Palette de propriétés

Vous pouvez sélectionner simultanément plusieurs objets en utilisant Maj+Clic ou Ctrl+Clic dans le Navigateur de projet. Une fois que vous avez sélectionné plusieurs objets, Sélection multiple apparaît en haut de la Palette de propriétés, au lieu du nom d’un objet.

L’outil Intersection/union [image] / [image] de la barre d’outils de la Palette de propriétés détermine les propriétés qui sont affichées dans la liste des propriétés lorsque plusieurs objets sont sélectionnés. Le fait d’alterner entre Intersection et Union change la liste des 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 définition de la propriété est la même pour tous les objets qui l'ont en commun, la définition commune est affichée.

•	Si la définition de la propriété est différente pour les objets qui l'ont en commun, la chaîne *** est affichée.


A propos de la copie de propriétés

Vous pouvez utiliser [image] et [image] de la barre d’outils Palette de propriétés pour copier les définitions de propriétés d’un objet dans un autre.

Dans la plupart des cas, vous copierez les propriétés d’un objet sur un ou plusieurs objets du même type.

Cependant, vous pouvez également copier les propriétés d’un objet sur des objets d’un type différent. Dans ce cas, les propriétés qui ne s’appliquent pas à l’objet cible ne sont pas prises en compte. Lorsque vous copiez les propriétés d’une sélection multiple, seules celles dont les valeurs ne sont pas conflictuelles sont placées dans le presse-papiers. Par exemple, si vous copiez les propriétés de trois fichiers texte sélectionnés dans le Navigateur de projet, les opérations d’édition ne sont copiées qui si elles sont toutes identiques.


A propos des commandes de la barre d'outils de la Palette de propriétés
A propos des commandes de la barre d’outils de la Palette de propriétés

La barre d’outils permet d’accéder rapidement aux commandes. Cliquez une fois sur l’outil correspondant à la commande que vous voulez exécuter.

Copier propriétés	Copie dans le presse-papiers les définitions de propriétés affichées dans la Palette de propriétés.
Coller propriété	Colle les définitions de propriétés stockées dans le presse-papiers dans la liste des propriétés dans la palette de propriétés. Les propriétés qui sont dans le presse-papiers mais non dans la liste de propriétés ne sont pas prises en compte.
Ajouter propriété	Affiche la boîte de dialogue Ajouter action ou Ajouter macro, en fonction de l’emplacement de la sélection lorsque vous cliquez sur l’outil.
Supprimer propriété	Supprime la propriété sélectionnée dans la liste de propriétés.
Hériter	Redéfinit la Palette de propriétés à sa valeur héritée ou à la valeur par défaut.
Intersection/union	Alterne entre les modes d’affichage Intersection et Union. Cette option détermine les propriétés qui apparaissent 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 la synchronisation et l’annulation 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 éléments sélectionnés dans le Navigateur de projet. 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.


A propos des icônes dans la Palette de propriétés

En plus des outils dans la barre d’outils de Palette de propriétés, il existe des icônes vous donnant des informations particulières sur les propriétés d’élément de projet :

•	L’icône d’héritage [image] indique qu’une propriété est héritée.

•	L’icône de remplacement [image] indique qu’une action héritée est remplacée.

•	L’icône locale [image] indique que la propriété a été définie dans la Palette de propriétés (et non héritée).

•	L’icône par défaut [image] indique que la propriété n’est pas encore définie.


Appel de la Palette de propriétés

Pour appeler la Palette de propriétés:

•	Choisissez Outils [image] Palette de propriétés.

Ou

•	Cliquez sur l’élément de votre choix, puis choisissez Propriétés dans le menu instantané.


Pour fermer la Palette de propriétés

Fermeture de la Palette de propriétés :

 Le mode de fermeture de la Palette de propriétés dépend de la plate-forme utilisée ; fermez la fenêtre comme vous le feriez normalement sur votre plate-forme.


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	Sélectionnez l’élément dont vous voulez définir les propriétés.

2	Choisissez Outils [image] Palette de propriétés.

La Palette de propriétés affiche les propriétés de l’élément sélectionné.

3	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 de texte, une liste instantanée ou le bouton Suite... s’affiche à côté de la propriété.

4	Définissez la propriété.


Définition de propriétés de sélections multiples

Pour définir les propriétés de sélections multiples :

1	Dans le Navigateur de projet, sélectionnez les éléments dont vous voulez définir les propriétés. Ils peuvent être de types différents ou même se trouver dans des documents différents.

2	Dans la Palette de propriétés, cliquez sur [image] pour afficher toutes les propriétés de tous les objets ou laissez l’outil sous la forme [image] pour n’afficher que les propriétés communes aux objets.

3	Définissez les propriétés de la manière voulue.

Tout changement apporté à une définition de propriété est répercuté sur tous les éléments de la sélection en cours auxquels s’applique cette propriété.


Comparaison de deux éléments

Pour comparer les propriétés de deux éléments :

1	Dans le Navigateur de projet, sélectionnez le premier élément 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 de projet, sélectionnez le second élément, puis choisissez Palette de propriétés dans le menu instantané.

Une seconde Palette de propriétés apparaît. Si la seconde fenêtre se trouve sur la première, déplacez-la pour l’amener le long de la première.


Copie des propriétés d'un élément à un autre
Copie des propriétés d’un élément à un autre

Pour copier les propriétés d’un élément à un autre :

1	Sélectionnez les éléments dont vous voulez copier les définitions de propriétés.

2	Cliquez sur [image] sur la barre d’outils.

3	Sélectionnez le ou les éléments cibles.

4	Cliquez sur [image] pour coller les propriétés à partir du presse-papiers.


Menu Edition

Annuler

Couper

Copier

Coller

Supprimer

Sélectionner tout


Annuler

Permet d’annuler l’effet de la dernière opération que vous avez effectuée. Par exemple, si vous avez supprimé accidentellement un objet, Annuler le restitue.

Notez que certaines opérations ne peuvent pas être annulées. Dans ce cas, la commande de menu Annuler est inactive.

Vous ne pouvez pas sélectionner Annuler dans une boîte de dialogue. Pour annuler les modifications effectuées, cliquez sur Annuler ou Fermer dans la boîte de dialogue sans valider vos modifications.


Couper

Permet de supprimer le texte ou les éléments sélectionnés et de les stocker dans le presse-papiers. Vous pouvez alors utiliser la commande de menu Coller pour placer le contenu du presse-papiers dans le Navigateur de projet.

Chaque nouvelle opération Couper remplace le contenu précédent du presse-papiers. Lorsque vous annulez une opération Couper, le contenu précédent du presse-papiers n’est pas restauré.


Copier

Permet de stocker le texte ou les éléments sélectionnés dans le presse-papiers, sans les supprimer (ce que fait Couper). Vous pouvez alors utiliser la commande de menu Coller pour placer le contenu du presse-papiers dans votre affichage.

Chaque nouvelle opération Copier remplace le précédent contenu du presse-papiers. Une opération Copier ne peut pas être annulée.


Coller

Permet de placer le contenu du presse-papiers - c'est-à-dire le ou les dernier(s) élément(s) ou le dernier texte que vous avez coupé(s) ou copié(s) - dans la présentation de la fenêtre en cours.

Si le presse-papiers est vide ou s'il n'est pas possible d'effectuer une opération Coller, l'élément de menu Coller est inactif.

Une opération Coller est sans effet sur le contenu du presse-papiers. Vous pouvez coller plusieurs fois le contenu du presse-papiers.


Supprimer

Permet de supprimer le texte ou le ou les élément(s) sélectionné(s), sans les stocker dans le presse-papiers (ce que fait Couper).

Une opération Supprimer est sans effet sur le contenu du presse-papiers.


Sélectionner tout

Permet de sélectionner plusieurs éléments en fonction de l'élément et de l'affichage (par dépendance ou par projet) sélectionnés dans le Navigateur de projet lorsque cette commande de menu est sélectionnée.

Si aucun élément n'est sélectionné dans le Navigateur de projet lorsque vous choisissez Sélectionner tout, tous les éléments de la base de registres utilisateur dans la suite de la séquence de la hiérarchie du Navigateur de projet sont sélectionnés. Si vous avez sélectionné un projet lorsque vous choisissez Sélectionner tout, tous les éléments du projet sont sélectionnés. Si vous sélectionnez un élément comportant des fils, tous les fils sont sélectionnés. Par exemple, si vous sélectionnez un fichier .fmx et si vous choisissez Sélectionner tout, le fichier .fmb qui est le fichier d’entrée utilisé pour la génération du fichier .fmx est également sélectionné (tant que vous êtes en mode Affichage par dépendance).


Menu Aide

Rubriques d'aide de Project Builder

Assistants

Aperçu produit

Manuels

A propos de Project Builder


Rubriques d'aide de Project Builder

Permet d'appeler l'aide de Project Builder. Le cas échéant, le système utilise l'interface d'aide standard de votre système d'exploitation.


Manuels

Permet d'appeler la documentation en ligne de Forms Developer.


Assistants

Permet d'appeler les Assistants, qui sont des fichiers d'instructions expliquant comment effectuer la plupart des tâches élémentaires de Project Builder.


Aperçu produit

Permet d'appeler l'Aperçu produit, qui est une brève présentation des outils de Project Builder et des principales étapes du processus d'élaboration d'un projet.


A propos de Project Builder

Permet d'afficher la boîte de dialogue A propos de Project Builder, qui contient des informations sur l'exécutable Project Builder et notamment le numéro de version et les mentions de copyright. Pour plus d'informations, reportez-vous à la boîte de dialogue A propos de Project Builder.


Menu Fichier

Nouveau

Ouvrir projet

Fermer projet

Importer projet

Exporter projet

Administration

Imprimer infos projet

Configuration de l'imprimante (mise en page)

Liste des derniers fichiers ouverts

Quitter


Nouveau

Permet de créer un nouvel élément de projet.

Cet élément de menu affiche les éléments de sous-menu suivants :

Projet	Permet d’afficher la boîte de dialogue de nouveau projet, dans laquelle vous pouvez définir un fichier de projet nouveau. Cette boîte de dialogue est une boîte de dialogue de fichiers standard. Pour plus d’informations, reportez-vous à la documentation de votre système.
Sous-projet	Permet d’afficher la boîte de dialogue de nouveau sous-projet dans laquelle vous pouvez sélectionner un répertoire par défaut pour un nouveau sous-projet.
Connexion	Permet d’afficher la boîte de dialogue d’ajout de connexion, dans laquelle vous pouvez indiquer une nouvelle connexion.
Type	Permet d’afficher l'assistant Type de module, qui vous aide à définir un nouveau type.
Action	Permet d’afficher la boîte de dialogue d’ajout d’action, dans laquelle vous pouvez définir un nouveau type.
Macro	Permet d’afficher la boîte de dialogue d’ajout de macro, dans laquelle vous pouvez définir un nouveau type.


Ouvrir projet

Permet d’afficher la boîte de dialogue d’ouverture de projet que vous pouvez utiliser pour rechercher un fichier de projet existant. Vous pouvez ouvrir plusieurs projets à la fois.

Cette boîte de dialogue est une boîte de dialogue de fichiers standard. Pour plus d’informations, reportez-vous à la documentation de votre système.


Fermer projet

Permet de fermer le projet en cours après l’avoir enregistré automatiquement.


Importer projet

Permet d’afficher la boîte de dialogue d’options d'importation, qui sert à importer des projets et des informations concernant la base de registres. Pour plus d’informations, reportez-vous à la boîte de dialogue d’options d’importation.


Exporter projet

Permet d’afficher la boîte de dialogue d’options d'exportation, qui sert à exporter des projets et des informations concernant la base de registres. Pour plus d’informations, reportez-vous à la boîte de dialogue d’options d’exportation.


Administration

Cet élément de menu permet d’afficher les éléments de sous-menu suivants :

Extraction	Permet d’appeler la boîte de dialogue d’extraction de votre système de contrôle de source.
Archivage	Permet d’appeler la boîte de dialogue d’archivage de votre système de contrôle de source.
Gestion des archives et rapports	Permet d’appeler la boîte de dialogue d’options de votre système de contrôle de source.
Définir mot de passe de projet	Permet d'appeler la boîte de dialogue permettant de définir un mot de passe pour le projet sélectionné.


Imprimer infos projet

Permet d’afficher la boîte de dialogue d’impression d’états de projets qui sert à imprimer un état contenant des informations sur les projets sélectionnés. Pour plus d’informations, reportez-vous à la boîte de dialogue d’impression des états des projets.


Configuration de l'imprimante (mise en page)
Configuration de l’imprimante (mise en page)

Permet d’afficher la boîte de dialogue d’impression de votre plate-forme.


Liste des derniers fichiers ouverts

Permet d’afficher, classés en ordre décroissant, les quatre derniers fichiers de projet auxquels vous avez accédé.


Quitter

Permet de mettre fin à votre session Project Builder.

Tous les projets ouverts sont fermés et la session prend fin. Les projets sont enregistrés automatiquement.


Menu Projet

Ajouter fichiers au projet

Ajouter le répertoire au projet

Générer sélection

Générer par incrément

Générer tout

Mode Aperçu des actions


Ajouter fichiers au projet

Permet d'afficher la boîte de dialogue d'ajout de fichiers à un projet, qui est une boîte de dialogue de fichiers standard, à utiliser comme vous le feriez normalement sur votre système.

Remarque : Sous Windows, vous ne pouvez sélectionner des fichiers que dans un répertoire à la fois. En outre, Windows limite le nombre de fichiers que vous pouvez sélectionner à un moment donné dans la boîte de dialogue de fichiers. Ce nombre dépend de la longueur des noms de fichier : vous pouvez sélectionner environ 250 fichiers ayant des noms longs et environ 600 fichiers ayant des noms limités à la notation «8.3».

Si vous sélectionnez trop de fichiers, aucun ne sera ajouté à votre projet. Cliquez sur [image] pour afficher la boîte de dialogue de fichiers, diminuez le nombre de fichiers à ajouter et répétez l'opération si nécessaire.


Générer sélection

Permet de générer tous les fichiers sélectionnés dans le Navigateur de projet. La génération s'effectue en fonction des actions (généralement Compiler) associées à leurs types.


Générer par incrément

Permet de détecter tous les fichiers obsolètes dans le ou les projets sélectionnés et de les générer en fonction des actions (généralement Compiler) associées à leurs types.


Générer tout

Permet de générer tous les fichiers qu'il est possible de générer dans le ou les projets sélectionnés. La génération s'effectue en fonction des actions (généralement Compiler) associées à leurs types.


Ajouter le répertoire au projet

Permet d'afficher la boîte de dialogue dans laquelle vous pouvez ajouter un répertoire au projet sélectionné.


Mode Aperçu des actions

Cliquez sur cette option pour passer en mode Aperçu des actions, que vous pouvez utiliser pour tester les actions et les macros. Dans ce mode, les actions appelées sont affichées au lieu d'être exécutées. Ainsi, vous pouvez avoir un aperçu de l'effet de l'action avant de l'appeler réellement.


Menu Outils

Assistant Projet

Assistant Livraison

Palette de propriétés

Préférences


Assistant Projet
Assistant Projet...

Permet d’afficher l'assistant Projet qui sert à définir facilement et rapidement de nouveaux projets et/ou sous-projets autonomes. Pour plus d’informations, appelez l'assistant Projet et consultez l'aide en ligne.


Assistant Type de module
Assistant Type de module...

Permet d’afficher l'assistant Type de module qui sert à définir facilement et rapidement d'autres types. Pour plus d’informations, appelez l'assistant Type de module et consultez l'aide en ligne.


Palette de propriétés

Permet d’afficher la Palette de propriétés. Pour plus d’informations, reportez-vous à A propos de la Palette de propriétés.


Préférences

Permet d’afficher la boîte de dialogue de préférences qui sert à personnaliser différents aspects de votre session Project Builder et notamment les options par défaut du Lanceur et du projet. Pour plus d’informations, reportez-vous à la boîte de dialogue de préférences.


Assistant Livraison

Permet d’afficher l'assistant Livraison qui sert à créer une zone de mise oeuvre de votre produit fini dans laquelle vous allez copier vos fichiers ou les envoyer par FTP. A l'aide de cet assistant, vous pouvez également créer les scripts requis pour installer votre produit via Oracle Installer. Pour plus d'informations, reportez-vous à A propos de l'assistant Livraison.


Menu Navigateur

Affichage par projet

Affichage par dépendance

Vues filtrées

Gérer filtres

Développer

Réduire

Développer tout

Réduire tout

Créer

Supprimer

Signet

Atteindre signet


Affichage par projet

Permet d'alterner entre l'affichage du Navigateur de projet et l'affichage par projet. Pour plus d'informations sur l'affichage par projets, reportez-vous à A propos de l'affichage par projet.


Affichage par dépendance

Permet d'alterner entre l'affichage du Navigateur de projet et l'affichage par dépendance. Pour plus d'informations sur l'affichage par dépendance, reportez-vous à A propos de l'affichage par dépendance.


Développer

Permet de développer le noeud sélectionné (s'il a été réduit) dans le Navigateur de projet.


Réduire

Permet de réduire le noeud sélectionné (s'il a été développé) dans le Navigateur de projet.


Développer tout

Permet de développer tous les noeuds réduits dans le Navigateur de projet.


Réduire tout

Permet de réduire tous les noeuds développés dans le Navigateur de projet.


Créer

Permet de créer un nouvel élément de même type que l'élément sélectionné.


Supprimer

Permet de supprimer l'élément sélectionné, après confirmation.


Signet

Permet de poser un repère sur le noeud sélectionné. Vous pouvez alors travailler sur d'autres éléments du Navigateur de projet, puis revenir au noeud marqué d'un signet en choisissant la commande de menu Atteindre signet.


Atteindre signet

Permet de sélectionner le noeud préalablement marqué d'un signet, en choisissant la commande de menu Signet.


Vues filtrées

Présente la liste des filtres actuellement définis, que vous pouvez appliquer au Navigateur de projet.


Gérer filtres

Affiche la boîte de dialogue de gestion des filtres permettant de créer, de modifier et de supprimer des filtres.


Puis-je mettre mon projet à jour sans le fermer et le rouvrir ?

Mon administrateur de projet m'a indiqué qu'il avait mis à jour un fichier registre. Comment récupérer les modifications sans fermer mon projet et le rouvrir ?

Changez d’affichage ; en d'autres termes, si le Navigateur de projet affiche votre projet en utilisant l'affichage des dépendances, choisissez Navigateur [image] Affichage de projet, et si le Navigateur de projet affiche votre projet en utilisant l'affichage des projets, choisissez Navigateur [image] Affichage des dépendances.


Comment associer ma bibliothèque PL/SQL au type correct de document ?

J'ai une bibliothèque PL/SQL référencée par un écran, mais elle figure dans mon projet sous la forme d'un document de bibliothèque d'application Forms. Pourquoi ? comment corriger le problème ?

La possibilité de partager PL/SQL est l'un des points forts de Developer/2000. Les documents créés par un outil peuvent faire référence au même PL/SQL. Tous les PL/SQL sont donc identiques pour Project Builder, qui ne peut pas faire la distinction entre les bibliothèques référencées par les applications Forms, les états ou les écrans. La réponse de Project Builder consiste à attribuer PL/SQL par défaut à Form Builder.

Pour résoudre ce problème, vous pouvez créer des types personnalisés pour PL/SQL, référencés par Graphics Builder et Report Builder, et attribuer manuellement les documents PL/SQL aux types corrects.


Comment créer une dépendance qui n'a pas encore été détectée par Project Builder ?

Mon état fait référence à une bibliothèque PL/SQL, mais l'arborescence de dépendance de projets n'affiche que la relation entre le fichier .rdf et le fichier .rep. Comment faire pour inclure la bibliothèque dans l'arborescence de dépendance ?

Créer des dépendances manuellement ne pose aucun problème. Sélectionnez le fichier concerné par la dépendance (dans ce cas, le fichier .rdf), puis ajoutez le fichier auquel il fait référence (dans ce cas, la bibliothèque). La dépendance avec Project Builder est créée.


Quelle est la meilleure façon de gérer des fichiers de projet dans un environnement de travail d'équipe ?
Quelle est la meilleure façon de gérer des fichiers de projet dans un environnement de travail d’équipe ?

Mon équipe doit mettre au point un projet sur lequel nous devons tous travailler, mais nous ne voulons pas nous marcher sur les pieds au niveau du développement. Comment configurer notre projet ?

Project Builder utilise les fonctions de sécurité de votre système d'exploitation pour protéger vos fichiers de projet contre toute suppression ou tout écrasement. Ne l'oubliez pas lorsque vous mettez votre projet au point. Si votre équipe travaille en réseau, nous vous conseillons d'installer la base de registres globale dans un répertoire partagé afin que tous les développeurs puissent avoir accès à une seule et même copie d'un document. Toutes les versions de la base de registres globale utilisées sont donc en permanence à jour. Si vous choisissez cette option, cependant, l'installation dans un répertoire auquel seul l'administrateur de projets a accès en écriture empêche toute altération accidentelle de la base de registres globale.

Si vous voulez protéger davantage votre base de registres globale, vous pouvez déclarer que le fichier sera en lecture seule. Les définitions de fichier seront alors utilisables pendant vos sessions de Project Builder, mais ne pourront pas être modifiées par qui que ce soit, pas même par l'administrateur de projets.

En outre, il est possible de copier des fichiers sur des fichiers projet périmés en utilisant une version mise à jour, mais dans ce cas la maintenance est extrêmement difficile. Nous conseillons aux développeurs d'importer les modifications apportées aux projets.


Pouvez-vous me donner quelques conseils d'utilisation des macros ?

Nous venons d'installer Project Builder, et on nous a dit que les macros pouvaient être très utiles. Pourriez-vous nous en donner quelques exemples, pour nous aider à débuter ?

Les macros sont utiles dans de nombreux cas. Par exemple :

•	Vous pouvez utiliser les macros pour modifier des actions rapidement et sans difficulté. Définissez, par exemple, deux macros différentes contenant deux ensembles différents d'options runtime pour votre compilateur C, l'un pour le débogage, l'autre pour l'optimisation de votre code, puis remplacez l'une par l'autre dans l'action Build, si nécessaire. Vous pouvez modifier l'action sur le type, pour affecter tous les fichiers, sur le projet, pour affecter les fichiers de projet, et sur les différents fichiers eux-mêmes.

•	Vous pouvez également utiliser une macro pour stocker toutes les options runtime et modifier les macros en cas de besoin. Cette opération a déjà été effectuée pour vous par Form Builder avec les options runtime de Form Builder, qui définissent la macro F50RUNOPTS que vous pouvez trouver en sélectionnant le type d’application Forms exécutable dans la base de registres globale, en affichant ses propriétés et en étudiant les macros proposées.

•	Vous pouvez définir certaines propriétés projet par projet. Définissez, par exemple, la macro PACKFILE pour des projets isolés (cette macro indique le nom du fichier zip ou tar à utiliser pour packager votre application).

•	Vous pouvez utiliser une macro pour indiquer des options de ligne de commande pour des types de fichier, par exemple la connexion à votre source de données. Project Builder a déjà défini la macro ORACONNECT et l'a incorporée dans les actions correspondantes (l'appel de tous les outils Developer/2000, par exemple).

Vous pouvez définir une macro pour appeler l’interpréteur de ligne de commande pour votre plate-forme (par exemple, {SHELL} = c:\windows\command /c) et l’utiliser lors de la définition d’actions que vous souhaitez exécuter à l’aide de l’interpréteur de ligne de commande.


Comment déterminer l'action par défaut d'un type ?

Dans les boîtes de dialogue d'ajout d'action et de modification d'action, le nombre d'actions par défaut disponibles pour un type semble illimité. Est-ce vrai ? Dans l'affirmative, comment puis-je déterminer la véritable action par défaut ?

Vous pouvez indiquer qu'un type peut être associé à plusieurs actions par défaut. Dans ce cas, Project Builder choisira l'action à exécuter lorsque vous cliquez deux fois sur un élément de ce type. L'action choisie par Project Builder apparaîtra en premier dans le menu contextuel de l'élément.

Si vous voulez préciser l'action par défaut, désélectionnez la case Action par défaut pour toutes les autres actions.


Comment indiquer des noms de chemin relatif ?

Je souhaite ajouter à mes projets des fichiers stockés sur un serveur et je doute que toute mon équipe ait le disque Produit répertorié dans l’unité Q. Comment puis-je supprimer l’unité et n’utiliser que le chemin relatif ?

Si vous sélectionnez des fichiers à ajouter à votre projet à l’aide de la boîte de dialogue Ajouter fichier, vous supprimez automatiquement du chemin la référence de répertoire si vos fichiers figurent dans le répertoire de projet.

Dans tous les autres cas, la boîte de dialogue Ajouter fichier impose l’enregistrement du chemin complet comme valeur de la propriété Nom de fichier pour le module que vous ajoutez à votre projet. Pour indiquer un chemin relatif, sélectionnez le module dans le Navigateur de projet, ouvrez la palette de propriétés et modifiez manuellement le chemin.

Notez que l'emplacement du projet, comme le nom du fichier et le chemin d'accès à chaque module inclus, est une propriété du projet. S'il a été copié à différents endroits pour différents membres de votre équipe, ceux-ci devront avoir des copies séparées du fichier de projet, avec des valeurs différentes selon l’emplacement du projet : Q:\myproj, R:\, etc., le cas échéant.


Comment vérifier si mes macros fonctionnent correctement ?

L’une de mes macros semble provoquer l’échec d’une action, mais je n’en suis pas certain, car je ne peux pas visualiser la chaîne pour la macro étendue. Que dois-je faire ?

Vous pouvez visualiser la chaîne pour la macro étendue. Sous Windows, incluez la commande suivante dans votre action :

command.com/k echo

Cette commande empêche la fermeture de la fenêtre DOS, ce qui vous permet d'examiner l'action, y compris la macro étendue, sur la ligne de commande. Vous pouvez également utiliser la commande command.com/k echo et la faire suivre par > /tmp/macrolog.txt (ou tout autre nom de fichier similaire) pour réorienter la commande vers un fichier, dans lequel vous pourrez l'examiner.

Sous UNIX, vous pouvez ajouter la commande echo au début de chaque ligne de l'action et la commande sleep 10 sur une ligne distincte à la fin de l'action. La fenêtre de terminal restera ouverte pendant 10 secondes, ce qui vous permettra de lire la sortie.


Comment faire pour que le Navigateur effectue des mises à jour correctement ?

Parfois, lorsque j’entreprends une action qui devrait se refléter dans le Navigateur de projet, rien ne se produit. Comment puis-je faire pour que le Navigateur effectue les mises à jour correctement ?

Changez d’affichage ; c’est-à-dire, si le Navigateur de projet affiche votre projet par dépendance, choisissez Navigateur [image] Affichage par projet. Si le Navigateur de projet affiche votre projet par projet, choisissez Navigateur [image] Affichage par dépendance.


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.


Sécurité des fichiers et restrictions

  Rubriques connexes

Project Builder utilise l'environnement de votre système d'exploitation pour déterminer la sécurité des modules stockés dans les fichiers. La façon d'acquérir l'autorisation d'accéder aux modules stockés dans les fichiers dépend du système d'exploitation. Pour plus d'informations, reportez-vous à la documentation de votre système.


Sécurité par mot de passe

  Rubriques connexes

La sécurité par mot de passe a été considérablement améliorée dans la version 6.0 de Project Builder. Dans cette version, tous les mots de passe sont représentés par des astérisques dans les boîtes de dialogue ou les zones d'état, et tous les mots de passe stockés dans les connexions de projet sont codés. Par exemple, la zone d'état de l'action Générer et la boîte de dialogue affichée lorsque vous exécutez une action en mode Aperçu des actions affichent le mot de passe de connexion à la base de données sous forme d'astérisques. En outre, si vous exportez un projet et examinez le fichier d'export obtenu dans un éditeur de texte, le mot de passe est codé.

Vous pouvez également protéger les fichiers de projet par mot de passe, pour éviter que les utilisateurs ouvrent la base de données de projet pour accéder aux mots de passe Oracle. Pour plus d'informations, reportez-vous à Rubriques connexes.


PJ10

  Rubriques connexes

Utilisez l'exécutable PJ10 pour invoquer Project Builder, dans lequel vous pouvez créer et gérer des projets.

Syntaxe	pj10 {ws-options} {reg_file_name}

où :

{ws-options}	(facultatif)  sont les options reconnues par votre système de fenêtrage, comme par exemple -bg dans Motif. Pour plus d'informations sur les options possibles, reportez-vous à la documentation de votre système de fenêtrage.

{reg_file_name}	(facultatif)  est le nom de votre base de registres utilisateur. La valeur par défaut est pjuser<lang>.upd.

Remarque : L'invocation effective de Project Builder et le nom de l'exécutable dépendent de la plate-forme. Pour plus d'informations sur la façon de démarrer Project Builder sur votre plate-forme, reportez-vous à la section de l'aide intitulée Informations sur les plates-formes.


Bases de registres de Project Builder

  Rubriques connexes

Project Builder contient deux bases de registres :

Nom	Fichier
types<lang>.upd où <lang> indique la langue en cours	Base de registres globale contenant la définition de tous les types globaux. Ce fichier est réinscriptible de façon globale sur votre plate-forme par défaut. Si vous souhaitez restreindre l'accès à ce fichier, vérifiez qu'il est en lecture seule ou que les autorisations d'accès sont limitées.
pjuser<lang>.upd où <lang> indique la langue en cours.	Base de registres utilisateur par défaut, dans lequel sont stockées les informations de vos projets personnels.


Conventions d'appellation de fichiers

  Rubriques connexes

Les extensions suivantes sont affectées aux fichiers Project Builder sur les plates-formes qui requièrent des extensions :

Extension	Type de contenu
upd	Extension affectée à une base de registres Project Builder.
upx	Extension affectée à un fichier d'export Project Builder, créé lors de l'export d'informations de projet à l'aide de la boîte de dialogue Options d'export.


Utilisation générale des actions

  Rubriques connexes

Les actions sont des chaînes de commande qui s'appliquent à des éléments de projet de certains types. Pour définir une action, utilisez la boîte de dialogue Ajouter action afin de lui donner un nom et de lui attribuer une chaîne de commande à exécuter lorsque cette action est choisie. Le contenu de cette chaîne de commande dépend de la plate-forme, à une exception près : vous pouvez également inclure des macros Project Builder, entre accolades ({}). Pour plus d'informations sur l'utilisation des macros, reportez-vous à Utilisation générale des macros.

Pour utiliser une action, sélectionnez dans le Navigateur de projet l'élément sur lequel vous voulez agir et cliquez sur le bouton droit de la souris pour afficher le menu instantané. Choisissez l'option de menu correspondant à l'action.

S'il s'agit d'une action globale, telle que Générer ou Livrer, ou d'une des actions de contrôle source, vous pouvez également la sélectionner à partir du menu principal.

Notes d'utilisation

•	Le nom d'une action peut être une combinaison quelconque de caractères alphanumériques et de traits de soulignement. Par exemple, Mon_Acti0n est valide, mais Mon&acti@n ne l'est pas.

•	Si vous souhaitez utiliser des mnémoniques, il vous suffit de faire précéder la lettre voulue d'une perluète lorsque vous entrez la description de l'action dans la boîte de dialogue Ajouter ou Editer action ; par exemple, si vous indiquez &Imprimer comme description, la lettre I fera office de mnémonique. Pour inclure dans la commande une perluète qui n'est pas une mnémonique, doublez cette perluète (&&).


Types d'actions

  Rubriques connexes

On distingue trois types d'actions :

•	actions prédéfinies telles qu'Imprimer et Ouvrir, applicables à des types spécifiques

•	actions définies par l'utilisateur

•	actions globales telles que Générer et Livrer, qui peuvent agir sur différents types de fichier. Les actions globales sont un sous-ensemble d'actions prédéfinies.


Actions prédéfinies

  Rubriques connexes

Description  Actions fournies avec Project Builder et disponibles automatiquement par l'intermédiaire d'options de menus ou d'outils de la barre d'outils.

Utilisation  Dans le Navigateur de projet, sélectionnez l'élément auquel vous voulez que s'applique l'action, puis choisissez l'option de menu correspondante dans le menu instantané ou dans le menu principal.

Notes d'utilisation

•	Les actions prédéfinies diffèrent selon le type. Pour déterminer quelles sont les actions prédéfinies disponibles pour un type spécifique, sélectionnez celui-ci dans le Navigateur de projet, affichez la palette des propriétés, puis consultez les entrées du noeud Actions.

•	Les chaînes de commande des actions prédéfinies dépendent de la plate-forme et sont basées sur des outils généralement disponibles sur ces plates-formes ou exploitent des commandes déjà enregistrées par le système d'exploitation pour les différents types ; par exemple, sous Windows, l'action prédéfinie Ouvrir invoque la commande Ouvrir déjà associée à ce type de fichier dans l'Explorateur de Windows. Pour plus d'informations sur la façon dont les actions sont mises en oeuvre sur différentes plates-formes, reportez-vous à la section de l'aide intitulée Informations sur les plates-formes Forms Developer.

•	Contrairement aux macros internes, les actions prédéfinies sont entièrement personnalisables. Vous pouvez les modifier dans la boîte de dialogue Editer action afin de changer des caractéristiques telles que les outils invoqués pour exécuter les actions ou les options incluses dans les chaînes de commande.

•	La longueur maximum de la chaîne de commande constituant une action dépend de la plate-forme. Pour plus d'informations, reportez-vous à la documentation relative à votre plate-forme.


Actions définies par l'utilisateur

  Rubriques connexes

Description  Actions personnalisées définies par vous-même.

Utilisation  Lorsque vous définissez une action, vérifiez que l'option Ajouter au menu instantané est sélectionnée. Dans le Navigateur de projet, sélectionnez l'élément auquel vous voulez que l'action s'applique, puis choisissez dans le menu instantané l'option correspondante.

Notes d'utilisation

•	Lorsque vous exportez des projets vers différentes plates-formes, n'oubliez pas d'adapter en conséquence la syntaxe de vos actions et d'utiliser les outils disponibles sur la nouvelle plate-forme.

•	La longueur maximum de la chaîne de commande constituant une action dépend de la plate-forme. Pour plus d'informations, reportez-vous à la documentation relative à votre plate-forme.

•	Si votre plate-forme reconnaît déjà des commandes associées à certains types de fichier, vous pouvez en tirer parti dans vos actions. Par exemple, si vous voulez créer une action de lecture pour les fichiers vidéo sous Windows et que l'Explorateur de Windows a déjà associé une commande à ces fichiers, vous pouvez utiliser celle-ci en l'intégrant entre crochets dans votre définition d'action, comme ceci : [play {n}], où {n} est la macro interne qui prend la valeur de l'élément que vous avez sélectionné dans le Navigateur de projet. Pour plus d'informations, reportez-vous à la section de l'aide intitulée Informations sur les plates-formes Forms Developer.


Actions globales

  Rubriques connexes

Description  Actions comprises dans Project Builder et qui fonctionnent sur plusieurs projets et fichiers en s'adaptant aux divers types de fichier. Les actions globales sont un sous-ensemble des actions prédéfinies et regroupent les actions suivantes :

•	actions de génération (Générer sélection, Générer par incrément, Générer tout)

•	actions d'empackage (Livrer)

•	contrôle de source (Extraire, Archiver, etc.)

Les actions globales peuvent accepter des éléments d'entrée (généralement, les fichiers sur lesquels porte l'action afin d'obtenir un résultat ; par exemple, l'élément d'entrée pour un fichier .rep est un fichier .rdf, et l'élément d'entrée pour un fichier .fmx est un fichier .fmb.) Les éléments d'entrée sont générés dans des cibles et les cibles sont créées à partir d'éléments d'entrée. Les éléments d'entrée sont représentés dans l'action par une ou plusieurs macros internes.

Utilisation  Dans le Navigateur de projet, sélectionnez l'élément auquel vous voulez que l'action s'applique, puis choisissez l'option correspondante dans le menu instantané ou dans le menu principal, ou encore dans la barre d'outils (pour Générer sélection et Générer par incrément).

Notes d'utilisation

•	La longueur maximum de la chaîne de commande constituant une action dépend de la plate-forme. Pour plus d'informations, reportez-vous à la documentation relative à votre plate-forme.

•	Les actions globales, comme les autres actions prédéfinies, sont entièrement personnalisables. Vous pouvez les modifier dans la boîte de dialogue Editer action afin de changer des caractéristiques telles que les outils invoqués pour exécuter les actions ou les options incluses dans les chaînes de commande. Par exemple, vous pouvez installer le package de contrôle de source qui répond le mieux à vos besoins et modifier les actions de contrôle de source dans le but de l'invoquer.

•	Certaines actions globales peuvent recevoir plusieurs éléments d'entrée, comme par exemple l'action Générer pour les fichiers .exe (les types reconnus pour les éléments d'entrée sont les fichiers .obj, .lib, etc.) Pour plus d'informations, reportez-vous à Eléments d'entrée.

•	Lorsque vous packagez vos fichiers pour la livraison, n'oubliez pas que l'action Livrer proprement dite accepte tous les types de fichiers . les fichiers effectivement empackagés sont ceux dont la propriété Livrer fichier a la valeur Oui pour l'élément que vous voulez inclure dans le package. (Ceci est vrai même si vous utilisez l'assistant Livraison au lieu de l'action Livrer pour packager vos fichiers.) Pour cela, sélectionnez l'élément dans le Navigateur de projet, affichez la palette des propriétés et modifiez la propriété Livrer fichier.


Eléments d'entrée

  Rubriques connexes

Description  Les éléments d'entrée sont les fichiers utilisés pour construire les cibles. Par exemple, .fmb est le type d'entrée d'un fichier .fmx.

Utilisation  Avec les actions globales Générer, Livrer et les actions de contrôle de source. Pour indiquer un élément d'entrée, sélectionnez l'élément de projet que vous voulez modifier (il peut s'agir d'un type ou d'un fichier) et affichez la palette des propriétés. Modifiez l'action voulue. Dans la boîte de dialogue Editer action, cliquez sur l'onglet Entrées. Faites un choix dans la table ou, si vous ne trouvez pas le type souhaité, cliquez sur Ajouter à la liste et choisissez le type voulu. Après avoir sélectionné un type, cliquez sur Insérer dans commande. L'élément d'entrée est ajouté à la chaîne de commande ; il est représenté par le numéro qui lui correspond dans la table. (Même si le fichier exécutable peut accepter plusieurs entrées de ce type, un seul numéro apparaît dans la chaîne de commande.)

Si l'action accepte des types d'entrée différents, répétez l'opération si nécessaire. Vérifiez la position de votre curseur, car l'élément d'entrée est inséré à cet endroit.

Notes d'utilisation

•	Comme les éléments d'entrée ne peuvent pas être imbriqués, vous ne pouvez indiquer aucune macro numérique intégrée ({1} -{9}) comme format d'argument. Vous pouvez néanmoins utiliser les autres macros internes applicables ; par exemple, vous pouvez indiquer un argument {b} pour ajouter le nom de fichier de base de l'entrée à la ligne de commande.

•	Certaines cibles, telles que les fichiers objets, peuvent être créées à l'aide de plusieurs types d'entrée. Ces cibles possèdent une action Générer à partir de <type> distincte pour chaque type d'élément d'entrée.


A propos de l'assistant Livraison

  Rubriques connexes

Après avoir développé et testé votre projet (application constituée d'un ensemble de fichiers Forms, d'états, de graphiques et de modules PL/SQL), vous devez le packager et le déployer sur vos environnements cible. L'assistant Livraison vous aide à accomplir ces tâches en vous permettant de :

•	Copier ou transférer par FTP le projet ou le produit terminé vers une zone de mise en oeuvre. Depuis cette zone, vous pouvez copier ou archiver vos fichiers sur un support de diffusion ou les rendre disponibles en interne.

•	Générer les scripts nécessaires à l'installation du produit sous Windows 95 et sous Windows NT via Oracle Installer. Vous pouvez également packager les environnements d'exécution de Forms ou de Reports Developer avec votre projet afin que les utilisateurs puissent installer le package dans sa totalité [image] votre application, ainsi que l'environnement d'exécution requis [image] à partir d'un seul appel d'Oracle Installer.

•	Exécuter votre action de livraison personnalisée sur un projet. Dans la version 1.0, vous exécutiez l'action de livraison depuis Fichier [image] Administration ; dans les versions plus récentes, l'action de livraison est activée uniquement via l'assistant Livraison.

Une fois la livraison de vos fichiers terminée, l'assistant Livraison enregistre les informations entrées comme propriétés du projet livré. Lors des livraisons suivantes du projet, vous n'avez pas besoin d'entrer ou de modifier ces informations sauf si vous le désirez.

Si vous désactivez la case à cocher Afficher cette page la prochaine fois, puis changez d'avis par la suite, choisissez Outils [image] Préférences, puis activez la case à cocher Afficher écran de bienvenue de l'assistant Livraison.


Zone de votre PC ou du réseau dans laquelle les fichiers sont préparés puis copiés vers le support de diffusion.


Ensemble des supports (bandes, CD ou disquettes par exemple) à partir desquels les utilisateurs installent votre application.


Configuration de la livraison

  Rubriques connexes

1	Sélectionnez le projet à livrer.

Le projet par défaut est celui sélectionné lorsque l'assistant Livraison est appelé. (Si un élément est sélectionné, le projet le plus proche de cet élément est considéré comme projet par défaut.) La liste déroulante répertorie tous les projets et sous-projets ouverts dans le Navigateur de projet, en les décalant pour refléter la hiérarchie du projet. Si le projet à livrer n'apparaît pas, quittez l'assistant Livraison et vérifiez que le projet est ouvert.

Conseil

2	Cliquez sur le bouton d'option indiquant si vous souhaitez :

•	Livrer uniquement les fichiers modifiés depuis la dernière livraison. L'assistant Livraison vérifie l'horodateur de livraison de chaque fichier livré dans un projet.

•	Livrer tous les fichiers du projet. Seuls les fichiers dont la propriété de livraison est définie sur Oui dans la palette de propriétés peuvent être livrés.

Quelle que soit l'option sélectionnée, vous avez la possibilité d'affiner la liste des fichiers à livrer dans l'un des écrans qui suivent.


Si vous n'avez pas encore créé de projet pour les fichiers à livrer, vous pouvez facilement y remédier. Quittez l'assistant Livraison, puis choisissez Outils [image] Assistant Projet. L'assistant Projet vous guide au fil des étapes de création d'un projet. Lorsque vous avez terminé, rappelez l'assistant Livraison.


Choix d'une méthode de livraison

  Rubriques connexes

1	Cliquez sur le bouton d'option qui décrit l'action de livraison choisie :

•	Créer une zone de mise en oeuvre locale et y copier les fichiers de votre projet. Depuis cette zone, vous pouvez copier le produit sur un support de diffusion ou rendre les fichiers disponibles en interne.

•	Créer une zone de mise en oeuvre, y copier vos fichiers et créer des scripts Oracle Installer pour que votre produit puisse être installé via Oracle Installer. Les scripts terminés sont placés dans votre répertoire de mise en oeuvre.

•	Utiliser le protocole de transfert de fichier (FTP) pour copier les fichiers de votre environnement Windows vers une machine hôte.

•	Exécuter l'action de livraison personnalisée que vous avez définie dans la palette de propriétés.

2	Si vous avez choisi l'une des trois premières options, entrez un emplacement pour la zone de mise en oeuvre (l'action de livraison opère sur le répertoire du projet). Si cette zone de mise en oeuvre se trouve sous Windows, vous pouvez cliquer sur Parcourir pour sélectionner un emplacement.

Remarques :

•	Par défaut, la zone de mise en oeuvre correspond au répertoire du projet en cours de livraison.

•	Si vous avez déjà livré votre projet dans cette zone et si vous créez actuellement des scripts Oracle Installer, sachez que les scripts sont écrasés à chaque livraison et non mis à jour. Par conséquent, si vous créez une application de mise à jour/correction, il est préférable de désigner une nouvelle zone de mise en oeuvre pour cette application plutôt que d'utiliser la zone de mise en oeuvre d'origine. Vos clients peuvent ainsi recevoir la dernière version du produit en installant d'abord la zone de mise en oeuvre d'origine, puis la nouvelle zone de correction.


Génération de scripts Oracle Installer

  Rubriques connexes

1	Entrez un nom unique pour votre produit dans le champ Script. Ce nom ne doit pas dépasser 8 caractères. Par défaut, le nom du script est celui du projet.

Le nom du script est ajouté au début des scripts Oracle Installer. Par exemple, si vous entrez le nom de script Prod, vos scripts Oracle Installer sont appelés prod.MAP, prod.VRF, prod.INS et prod.DEI.

Le nom du script est également entré comme nom de variable dans la base de registres de Windows, sous la clé Oracle. Sa valeur est le répertoire de destination final de votre produit, quel que soit l'emplacement d'installation défini par l'utilisateur.

2	Si vous le souhaitez, entrez le nom du produit tel que voulez qu'il apparaisse dans le champ Programmes du menu Démarrer de Windows. Vous avez la possibilité de personnaliser le sous-menu de Programmes dans l'un des panneaux qui suivent : vous devez y entrer le nom de chaque fichier du projet.

3	Entrez un numéro de version pour le produit dans le champ Version.

Exprimez cette version sous forme numérique suivant le modèle n(n)(.nn)(.nn)(.nn)(.nna). Par convention, la lettre située à la fin est réservée aux mises à jours.

Exemples : 1, 1.0, 16.41 et 1.1.1.1.1b sont toutes des valeurs valides.

4	Pour packager les environnements d'exécution de Forms ou de Reports Developer avec votre produit, cliquez sur Oui.

Dans ce cas, les utilisateurs voient apparaître votre application dans le volet Produits disponibles lorsqu'ils appellent Oracle Installer, ainsi que les environnements d'exécution des fichiers Forms, des états et des graphiques.

Remarque : Pour masquer une entrée [image] par exemple, votre application ne comporte pas d'état et vous ne voulez donc pas afficher Reports Runtime [image] modifiez le fichier PRD à l'aide d'un éditeur de texte et définissez le champ Visible ? sur Faux. Pour plus d'informations sur le fichier PRD, reportez-vous à Rubriques connexes.


Sélection des fichiers à livrer

  Rubriques connexes

Utilisez les flèches pour vérifier que tous les fichiers à copier vers l'emplacement cible apparaissent dans le volet Fichiers à livrer. Les fichiers qui apparaissent dans le volet Fichiers du projet ne sont pas livrés.

•	Si vous cliquez sur Livrer par incrément, seuls les fichiers mis à jour depuis la dernière livraison effectuée apparaissent dans le volet Fichiers à livrer. Sur les fichiers restants du projet, seuls ceux dont la propriété de livraison est définie sur Oui apparaissent dans le volet Fichiers du projet car seuls ces fichiers peuvent être livrés. Pour modifier ce paramétrage, quittez l'assistant Livraison, utilisez la Palette de propriétés pour modifier le paramètre, puis rappelez l'assistant Livraison.

•	Si vous cliquez sur Tout livrer dans le premier écran, tous les fichiers livrables du projet apparaissent par défaut dans le volet Fichiers à livrer. Si vous décidez de ne pas copier un fichier, utilisez la flèche vers la gauche pour le déplacer vers le volet Fichiers du projet.


Indication d'emplacements cible

  Rubriques connexes

Indiquez où Oracle Installer doit installer les fichiers de votre projet sur l'ordinateur de l'utilisateur.

1	Si vous le souhaitez, modifiez la destination par défaut dans le champ Répertoire de destination et nom de fichier.

De même que %PROD_HOME%, vous pouvez inclure les variables Oracle Installer suivantes dans ce champ :

•	%ORACLE_HOME%

•	%WIN_HOME%

2	Pour faire apparaître un fichier dans le sous-menu du groupe de programmes, entrez un nom dans le champ Libellé du menu de départ.

Par exemple, vous pouvez inclure le nom du fichier uniquement, comme dans README.TXT, ou créer d'autres libellés descriptifs, tels que Forms 5.0 pour F50gen32.exe. Les libellés contenus dans le menu Démarrer doivent être uniques au sein d'un même groupe de programmes.


Définition de variables d'environnement

Créez des variables d'environnement pour votre produit. Oracle Installer les intègre dans la base de registres de Windows sous la clé Oracle lorsque les utilisateurs installent votre produit.

1	Cliquez sur Ajouter ligne pour insérer une ligne.

Remarque : Si vous décidez de ne pas créer de variable après avoir inséré une ligne, n'oubliez pas de supprimer cette ligne à l'aide de Supprimer ligne en cours. L'assistant Livraison émet un signal d'alerte lorsque vous tentez de passer à l'écran suivant en laissant une ligne vide.

2	Entrez un nom pour la variable dans le champ Nom.

Vous ne pouvez pas insérer d'espace dans le nom d'une variable.

3	Indiquez une valeur pour la variable dans le champ Valeur. Pour inclure une macro définie pour le projet, cliquez sur Insérer macro dans valeur. La macro sélectionnée est ajoutée à la fin de toute valeur entrée dans le champ Valeur, bien que vous puissiez ajouter des caractères à sa suite.

Lorsque vous entrez une valeur, le champ Intégral montre l'expansion des macros dans le champ Valeur, en fonction des paramètres de projet actuellement définis dans la palette de propriétés.

Par exemple, supposez que vous définissiez une variable appelée HelpFile et que vous entriez une valeur {f}, qui représente le nom du fichier d'aide. Dans la palette de propriétés, f est définie en tant que upc60.hlp. Lorsque les utilisateurs installent votre projet, Oracle Installer place une variable appelée HelpFile dans la base de registres de Windows et lui attribue la valeur pj10us.hlp.

4	Pour ajouter cette valeur à une valeur existante, entrez Oui dans le champ Annexer. Pour écraser une valeur existante ou pour définir une valeur de manière explicite, entrez Non dans ce champ. Le champ ne peut pas rester vide.

Par exemple, si vous ajoutez un nom au chemin d'accès du fichier de l'utilisateur, définissez le champ Annexer sur Oui.

Pour insérer une ligne, sélectionnez une ligne et cliquez sur Ajouter ligne. La nouvelle ligne est insérée après la ligne sélectionnée.

Pour supprimer une ligne, sélectionnez-la et cliquez sur Supprimer ligne en cours.


Choix d'une connexion FTP

Entrez les informations qui décrivent la connexion au site FTP sur lequel vous voulez copier vos fichiers :

Nom utilisateur	Nom de la connexion FTP. Pour une connexion anonyme, entrez anonymous.
Mot de passe	Mot de passe. Si vous utilisez le protocole FTP de façon anonyme, utilisez votre adresse électronique comme mot de passe.
Compte	Facultatif.
Nom ou adresse IP de l'hôte	Nom ou adresse IP de la machine hôte. Exemples : xworld.us.oracle.com                       144.25.83.103
Port	Numéro du port Internet de la machine distante où le service FTP (démon) est enregistré.


Etape suivante

L'écran final résume les informations de livraison que vous avez indiquées pour ce projet ou groupe de fichiers. Vous avez maintenant trois options :

•	Cliquer sur Fin pour copier vos fichiers ou les transférer par FTP vers la zone de mise en oeuvre, exécuter l'action de livraison, ou copier les fichiers et créer des scripts Oracle Installer. Les paramètres définis dans l'assistant [image] à l'exception de Livrer tout ou Livrer par incrément [image] sont enregistrés comme faisant partie de votre projet. Lorsque vous sélectionnez par la suite ce projet pour le livrer, les écrans de l'assistant Livraison sont remplis à l'aide des informations entrées ici.

Remarque : Bien que les paramètres de l'assistant Livraison soient enregistrés comme éléments du projet, ils n'apparaissent pas dans la palette de propriétés.

•	Cliquer sur Annuler pour quitter l'assistant Livraison sans livrer le projet et sans enregistrer les paramètres.

•	Cliquer sur Précédent pour revenir à l'écran précédent de l'assistant et affiner davantage vos paramètres.


A propos des scripts Oracle Installer

  Rubriques connexes

Les scripts Oracle Installer permettent d'installer une application via Oracle Installer. Dans Project Builder version 1.0, vous pouviez utiliser Oracle File Packager pour créer ces scripts ou les créer manuellement. L'assistant Livraison remplace et enrichit Oracle File Packager.

Les scripts Oracle Installer sont précédés du nom entré dans le champ Script de l'assistant Livraison. Il existe quatre scripts différents :

nom.MAP	Répertorie tous les fichiers qui composent une application, y compris les fichiers à copier vers l'ordinateur de l'utilisateur, les répertoires vers lesquels ils sont copiés, le groupe de programmes destiné à contenir le ou les programmes, etc.
nom.VRF	Vérifie (VeRiFy) que toutes les dépendances correctes sont identifiées et installées. Par exemple, si vous précisez que votre application dépend de Forms Runtime, le processus d'installation de votre application détecte automatiquement si Forms Runtime est déjà présent sur la machine de l'utilisateur. Si ce n'est pas le cas, Forms Runtime est installé.
nom.INS	Installe (INStall) les fichiers qui constituent un composant installable, définit les variables d'environnement nécessaires et inscrit le produit auprès d'Oracle Installer.
nom.DEI	Désinstalle (DEInstall) les fichiers qui constituent un composant installable. Supprime également les variables d'environnement et retire le composant de la base de registres une fois ce dernier désinstallé.
Pour afficher des exemples de scripts Oracle Installer, consultez le répertoire /DEPLOY/RELEASE/FORWIN95/YOURAPP/FORMSAPP. Ce dernier est installé au cours de l'installation de Forms ou de Reports Developer ; s'il n'est pas disponible sur votre ordinateur local, cherchez-le sur votre réseau local (LAN) ou sur le support de diffusion Forms ou Reports Developer.


A propos du fichier PRD

  Rubriques connexes

Le fichier PRD répertorie tous les composants installables dans une zone de mise en oeuvre donnée. Il identifie également le nom de fichier de base et l'emplacement des scripts Oracle Installer de chaque composant. En d'autres termes, le fichier PRD répertorie tous les fichiers qui apparaissent dans le volet Produits disponibles d'Oracle Installer.

Il existe une zone de mise en oeuvre PRD par plate-forme. Lorsque vous demandez à l'assistant Livraison de créer des scripts Oracle Installer en vue d'une livraison, deux fichiers PRD sont créés pour vous : WIN95.PRD pour Windows 95 et NT.PRD pour Windows NT. Ils sont tous deux placés dans votre zone de mise en oeuvre.

Les champs du fichier PRD sont les suivants :

Nom de colonne	Description
####	Numéro du produit. Il est normalement inutile de modifier ce champ.
Produit	Nom du script tel qu'il est indiqué dans l'assistant Livraison.
Père	A laisser sous la forme root.
Nom de fichier	Nom de fichier de base de vos scripts d'installation MAP, VRF, INS et DEI. Identique au champ de nom de script.
Version	Numéro de version de votre application.
Libellé de l'interface	Nom de votre application tel qu'il apparaît dans la fenêtre Produits disponibles d'Oracle Installer.
Emplacement	Chemin d'accès du répertoire contenant les scripts Oracle Installer et tous les fichiers qui composent votre application.
Taille	Taille totale du composant installable.
Visible ?	Détermine si le composant apparaît ou non dans le volet Produits disponibles d'Oracle Installer.
Sélectionné ?	Détermine si le composant est sélectionné ou non dans le volet Produits disponibles d'Oracle Installer.
Ouvert ?	Utilisé pour les composants parent/enfant.
Description	Décrit votre application.
Volume	Correspond normalement au texte du champ Nom de fichier .


Tout produit (par exemple, Forms Runtime, les fichiers standard de l'interface utilisateur, etc.) possédant son propre ensemble de scripts Oracle Installer.


Livraison de plusieurs applications

  Rubriques connexes

Si vous avez plusieurs applications à installer pour vos clients via Oracle Installer, voici quelques options de livraison à prendre en compte :

•	Création d'un processus d'installation en plusieurs étapes. Vos clients en interne installent les applications à partir de plusieurs zones de mise en oeuvre différentes, chacune possédant son propre fichier PRD. Cette option est pratique si vous devez distribuer plusieurs applications Forms et Reports Developer et si vous ne les distribuez pas en externe.

•	Création d'un processus d'installation en une étape. Vos clients installent l'application et les environnements d'exécution Forms ou Reports Developer à partir d'un seul appel d'Oracle Installer. Cette approche est plus pratique pour vos clients en interne qu'un processus en plusieurs étapes. Toutefois, si vous réalisez une livraison en externe, c'est la seule option disponible.


Création d'un processus d'installation en plusieurs étapes

  Rubriques connexes

Pour créer un processus en plusieurs étapes :

1	Exécutez l'assistant Livraison pour chaque application en créant une zone de mise en oeuvre différente pour chacune.

Considérez que les environnements d'exécution Forms ou Reports Developer ne sont pas disponibles ailleurs et indiquez à l'assistant Livraison de les inclure avec l'une de vos applications.

2	Indiquez à vos clients de cliquer sur ORAINST.EXE ou sur SETUP.EXE pour appeler Oracle Installer, de cliquer ensuite sur De, puis d'accéder à votre zone de mise en oeuvre. Votre produit apparaît dans le volet Produits disponibles.

Est-ce ORAINST.EXE ou SETUP.EXE ? Comment vérifier que l'utilisateur final y a accès ?


Création d'un processus d'installation en une seule étape

  Rubriques connexes

Pour créer un processus en une seule étape :

1	Exécutez l'assistant Livraison pour la première application. Si vous effectuez une livraison en externe ou si vos utilisateurs en interne n'ont pas accès ailleurs aux environnements d'exécution de Forms ou Reports Developer, incluez-les dans cette livraison.

2	Exécutez l'assistant Livraison pour l'application suivante en choisissant une autre zone de mise en oeuvre.

3	Copiez la ligne du deuxième fichier PRD dans le premier ; vous créez ainsi un fichier PRD maître.

4	Exécutez l'assistant Livraison pour chacune des applications restantes en choisissant à chaque fois une zone de mise en oeuvre différente. Lorsque le processus de livraison est terminé, copiez la ligne du nouveau fichier PRD dans le fichier PRD principal créé à l'étape 1.

5	Après avoir exécuté l'assistant Livraison pour chaque application, appliquez l'une des procédures suivantes [image] ou les deux [image] :

•	Indiquez aux clients en interne de cliquer deux fois sur SETUP.EXE dans la zone de mise en oeuvre créée à l'étape 1. Etant donné qu'Oracle Installer est appelé à l'endroit où le fichier PRD principal est situé, toutes vos applications apparaissent dans le panneau Produits disponibles.

•	Pour les clients en externe, copiez toutes les zones de mise en oeuvre, y compris les scripts Oracle Installer, vers le support de diffusion. Ne copiez pas les fichiers PRD de chaque zone de mise en oeuvre. Copiez plutôt uniquement le fichier PRD principal créé à l'étape 1. Il comprend toutes les informations nécessaires pour réussir l'installation de vos applications avec Oracle Installer.


A propos des variables Oracle Installer

  Rubriques connexes

Bien qu'il existe de nombreuses variables Oracle Installer, seules quelques-unes sont importantes :

Variable	Description
%ORACLE_HOME%	Répertoire dans lequel tous les produits Oracle sont installés. Est paramétré par défaut sur ORAWIN95 sur les plates-formes Windows 95 et sur ORAWINT sur les plates-formes NT, bien que l'utilisateur puisse remplacer cette valeur dans Oracle Installer. Cette variable est entrée dans la base de registres de Windows. Vos applications peuvent donc s'y référer.
%PROD_HOME%	Répertoire dans lequel un produit Oracle particulier est installé. Est paramétré par défaut sur %ORACLE_HOME%/nom du script, dans lequel nom du script est le nom entré dans le champ Script de l'assistant Livraison. L'utilisateur peut remplacer la valeur par défaut dans Oracle Installer.  Cette variable n'est pas entrée dans la base de registres de Windows. Toutefois, la variable nom du script, qui possède la même valeur, y est répertoriée. Par exemple, supposez que vous entriez PROD dans le champ Script de l'assistant Livraison. Le répertoire de destination par défaut dans Oracle Installer est C:\ORAWIN95\PROD (en supposant qu'il s'agit d'une installation Windows 95). Si l'utilisateur change la destination en C:\ORAWIN95\MONAPP, la variable PROD (ainsi que %PROD_HOME%) est définie sur C:\ORAWIN95\MONAPP.
%WIN_HOME%	Répertoire dans lequel Windows 95 ou Windows NT sont installés.


A propos de l'assistant Projet

  Rubriques connexes

L'assistant Projet propose une méthode simple et rapide pour créer des projets à l'aide de différentes boîtes de dialogue de Project Builder. L'assistant Projet vous guide, écran par écran, au fil des étapes nécessaires à la définition d'un projet ou d'un sous-projet. Lorsque vous avez terminé la création de votre projet, l'assistant Projet vous aide à y ajouter des fichiers.

Remarque : Pour empêcher l'écran de bienvenue d'apparaître à chaque appel de l'assistant Projet, prenez soin de désélectionner la case à cocher Afficher cet écran ultérieurement. (Si vous changez d'avis par la suite et que vous vouliez restaurer cet écran, sélectionnez Outils [image] Préférences. Cliquez ensuite sur l'onglet Afficher, puis cochez la case Afficher écran de bienvenue de l'assistant Projet.)


Définition du projet ou du sous-projet

•	Cliquez sur le bouton d'option qui décrit l'objet que vous créez : projet ou sous-projet. Un sous-projet est un projet qui fait partie d'un projet plus important. Par exemple, vous pouvez créer un sous-projet pour une application Forms particulière et ses menus, qui font partie d'une application plus importante. Conseil


Il est recommandé de créer des sous-projets pour refléter les sous-répertoires du répertoire de projet. Par exemple, si le répertoire du projet comporte deux sous-répertoires, IMAGES et MENUS, vous pouvez créer deux sous-projets en leur attribuant ces deux noms pour gérer les fichiers de ces répertoires.


Attribution d'un nom au registre de projet

Pour créer un projet, vous devez tout d'abord définir le fichier de registre du projet, qui contient les propriétés du projet, ainsi que les informations relatives aux relations et aux dépendances entre les éléments du projet.

•	Entrez le nom du nouveau fichier de registre du projet, ou cliquez sur Parcourir et utilisez la boîte de dialogue de gestion de fichiers qui apparaît pour sélectionner un fichier et l'écraser. Par défaut, l'extension des registres de projet est .UPD ; cette extension est ajoutée automatiquement.


Choix d'un titre et d'un répertoire

1	Entrez un titre pour le projet ou le sous-projet dans le champ Titre. Le projet apparaît sous ce nom dans le Navigateur de projet ; ce nom peut être différent du nom interne figurant dans le registre du projet et que vous sélectionnez dans le dernier écran.

2	Entrez un nom pour le répertoire par défaut du projet, ou cliquez sur Parcourir et sélectionnez-en un dans la liste de répertoires fournie. Le répertoire de projet est l'emplacement où seront stockés les fichiers du projet. Cliquez sur OK pour confirmer votre choix.

Remarque : Bien que ce champ soit facultatif, il est fortement recommandé d'indiquer un répertoire de projet. Si vous ne le faites pas, tous les fichiers ajoutés au projet le sont avec un chemin d'accès absolu et non avec un chemin d'accès relatif. Le partage de votre projet avec d'autres utilisateurs est alors plus difficile. Pour plus d'informations, reportez-vous à A propos du partage de projets.


Indication d'une connexion

Indiquez la connexion de base de données par défaut du projet. Par exemple, si les applications Forms et les états du projet s'appuient sur les informations stockées dans la base de données SALES, indiquez une connexion accédant à cette base de données. Lorsque vous cliquez deux fois sur une application Forms ou sur un état dans le projet, l'élément concerné est ouvert et automatiquement rempli avec les données SALES adéquates.

Utilisez l'une des méthodes suivantes pour choisir une connexion :

•	Sélectionnez une connexion prédéfinie dans la liste déroulante Connexion. Cette dernière présente toutes les connexions déjà définies via la boîte de dialogue Nouvelle connexion.

•	Entrez les informations de connexion dans les champs Nom utilisateur, Mot de passe et Base de données. La connexion est stockée avec le projet, mais n'est pas accessible pour d'autres projets tant qu'elle n'est pas définie explicitement dans la boîte de dialogue Nouvelle connexion.

Quelle que soit la méthode choisie, la connexion indiquée est utilisée pour tous les fichiers du projet sauf si vous la remplacez pour des fichiers particuliers (soit en modifiant les paramètres dans la Palette de propriétés, soit en sélectionnant une autre connexion sous le noeud Connexions dans le Navigateur de projet et en la faisant glisser vers le fichier).

Si vous n'entrez aucune indication dans cet écran, le projet hérite la connexion d'un projet père ou du projet racine, ou utilise la connexion par défaut définie dans la base de registres Windows ou dans la variable d'environnement UNIX.


Personnalisation du projet

Les champs de cet écran sont facultatifs, mais ils peuvent aider les autres utilisateurs à rechercher des informations sur le projet.

1	Dans le champ Auteur, entrez le nom ou l'ID utilisateur du responsable de la gestion du projet.

2	Dans le champ Commentaires, entrez toute information susceptible d'aider les autres utilisateurs. Ces derniers peuvent afficher ces commentaires dans la Palette de propriétés du projet. (Vous pouvez remplacer ou ajouter des commentaires par la suite en cliquant deux fois sur le champ Commentaires de la Palette de propriétés.)


Attribution d'un nom au projet père

•	Choisissez le projet dont le sous-projet fait partie (appelé également projet père) dans la liste déroulante. Cette liste répertorie tous les projets et sous-projets actuellement ouverts. (Vous pouvez imbriquer des sous-projets dans d'autres sous-projets, à l'infini.) Si le projet à désigner comme projet père n'apparaît pas dans la liste, quittez l'assistant Projet, ouvrez le projet, puis rappelez l'assistant Projet.


Etape suivante

Lorsque vous avez fini de définir le nouveau projet, l'assistant Projet vous offre trois possibilités :

•	Cliquez sur Créer un projet vide, puis sur Fin pour quitter l'assistant Projet et afficher immédiatement le Navigateur de projet. Le Navigateur de projet contient le nouveau projet, mais ce dernier ne contient aucun fichier.

•	Cliquez sur Sélectionner des fichiers à ajouter, puis sur Fin pour quitter l'assistant Projet et afficher une boîte de dialogue de gestion de fichiers standard, que vous pouvez utiliser pour commencer immédiatement à ajouter des fichiers à votre projet (option par défaut).

•	Cliquez sur Ajouter tous les fichiers au répertoire du projet, puis sur Fin pour quitter l'assistant Projet et afficher immédiatement le Navigateur de projet. Le projet contient tous les fichiers présents dans le répertoire indiqué à l'étape Choix d'un titre et d'un répertoire. Pour inclure également les fichiers des sous-répertoires, cochez la case Inclure les sous-répertoires. Un sous-projet est créé pour chaque sous-répertoire du répertoire. Remarque

Si vous choisissez de quitter l'assistant Projet sans ajouter de fichier, vous pouvez encore travailler sur votre projet, éventuellement en ajoutant des types ou en créant des macros en vue de l’ajout de fichiers. Pour commencer à ajouter des fichiers à votre projet, cliquez sur [image] pour afficher la boîte de dialogue de gestion de fichiers.

Si vous choisissez de commencer à ajouter immédiatement des fichiers, utilisez la boîte de dialogue de gestion de fichiers pour accéder au répertoire de votre choix et sélectionner les fichiers à ajouter. Appliquez votre méthode habituelle de sélection de fichiers, selon les besoins.

Remarque : Sous Windows, vous ne pouvez sélectionner des fichiers que dans un répertoire à la fois. En outre, Windows limite le nombre de fichiers que vous pouvez sélectionner dans la boîte de dialogue de fichiers. Ce nombre dépend de la longueur des noms de fichiers. Vous pouvez sélectionner environ 250 fichiers ayant des noms longs, et environ 600 fichiers ayant des noms limités à la notation « 8.3 ».

Si vous sélectionnez trop de fichiers, aucun ne sera ajouté à votre projet. Cliquez sur [image] pour afficher la boîte de dialogue de fichiers, diminuez le nombre de fichiers à ajouter et répétez l’opération si nécessaire.


Si vous choisissez cette option, le champ Nom de fichier de la Palette de propriétés affiche le chemin d'accès relatif de chaque élément (en fait, le nom de l'élément), par opposition au chemin d'accès complet, ou absolu. Lorsque vous ajoutez au projet des fichiers du répertoire de projet, le chemin d'accès relatif est utilisé ; lorsque les fichiers ajoutés proviennent d'un autre répertoire, le chemin d'accès complet est utilisé. Pour plus d'informations, reportez-vous à A propos du répertoire de projet et du répertoire père.


A propos de l'assistant Type de module

L'assistant Type de module permet d'ajouter et de modifier rapidement et simplement des définitions de type Project Builder. Vous pouvez utiliser l'assistant Type de module pour définir un nouveau type lorsque vous vous procurez une nouvelle application et que vous voulez commencer à gérer ses fichiers à l'aide de Project Builder. Vous pouvez également utiliser cet assistant pour modifier l'action par défaut d'un type particulier. Par exemple, vous pouvez définir CorelDraw! comme action par défaut pour les fichiers .JPEG. L'assistant Type de module rend ces tâches plus faciles.

Remarque : Si vous ne voulez plus que l'écran de bienvenue apparaisse chaque fois que vous appelez l'assistant Type de module, vérifiez que la case Afficher cet écran ultérieurement n'est pas cochée. (Si vous changez d'avis par la suite et que vous vouliez restaurer cet écran, sélectionnez Outils [image] Préférences ; cliquez ensuite sur l'onglet Afficher, puis cochez la case Afficher écran de bienvenue de l'assistant Type.)


Choix d'un nom et d'un emplacement

1	Si vous avez accès à un fichier du nouveau type, cliquez sur Choisir fichier pour modèle et sélectionnez le fichier voulu dans la boîte de dialogue Dériver type. L'assistant Type de module remplit plusieurs de ses champs avec des informations adéquates en se basant sur le fichier sélectionné.

2	Attribuez au type un nom interne dans le champ Nom interne. Dans la plupart des cas, il s'agit simplement de l'extension du fichier qui est unique (par exemple, FM pour les fichiers FrameMaker).

3	Entrez la description du type dans le champ Description. Le nom saisi apparaît sous les noeuds Types globaux ou Types d'utilisateur.

4	Cliquez sur le bouton d'option Registre global pour rendre le type accessible à tous les autres utilisateurs ou sur le bouton d'option Registre utilisateur si vous seul devez avoir accès au nouveau type.


Définition du format et du contenu

1	Dans la zone Nom de fichier, cliquez sur le bouton d'option qui décrit le mode de reconnaissance de ce type de fichier par Project Builder : par extension (entrez l'extension du fichier) ou par motif. Un motif est une chaîne littérale quelconque, ou la combinaison d'une chaîne littérale et de l'une des macros intégrées suivantes : b, d, f ou n. Conseil

2	Dans la zone Contenu de fichier, cliquez sur le bouton d'option qui décrit le contenu du fichier : Binaire (pour les fichiers exécutables), Textuel (pour les fichiers non exécutables) ou Autre que fichier (pour les URL, les tables de base de données ou les autres entités qui ne sont pas gérées comme des fichiers).

3	Dans la zone Options, cochez les cases qui décrivent d'autres attributs du type :

•	Cliquez sur Fichiers contrôlés par version de ce type pour définir automatiquement la propriété Fichier de contrôle de version sur Oui pour tous les fichiers de ce type. En procédant ainsi, vous activez également les actions Archivage/Exctraction dans Fichier [image] Administration.

•	Cliquez sur Livrer fichiers de ce type pour définir automatiquement la propriété Livrer fichier sur Oui pour tous les fichiers de ce type.

•	Si à la suite de l'action Build les fichiers de ce type changent de type (par exemple, des fichiers .FMB qui deviennent des fichiers .FMX), sélectionnez le type cible dans la liste déroulante Générer fichiers de ce type dans. Si le fichier choisi n'apparaît pas, vérifiez que le type cible a été défini. Vous devrez peut-être définir entièrement le type en cours, définir le type cible, puis revenir au type d'origine et sélectionner le type cible dans cette liste déroulante.


Voici quelques exemples de situations dans lesquelles les motifs sont utiles :

•	Sur les plates-formes UNIX, lorsque vous devez limiter le nom de base d'un fichier. Par exemple, supposez que vous disposiez d'une bibliothèque UNIX appelée libfoo.so, conformément à la convention d'appellation standard des bibliothèques UNIX. Vous voulez définir une action de compilation dans Project Builder se référant à cette bibliothèque, mais vous devez enlever le préfixe lib et n'utiliser que le nom de base, c'est-à-dire foo. Pour ce faire, définissez o lib{b}.so comme motif du type de la bibliothèque UNIX. Ceci garantit que seul le nom de base est utilisé dans toute référence à la bibliothèque.

•	Lorsque vous définissez un type pour un élément implicite et que vous vouliez créer cet élément dans un répertoire différent de celui où la source est située. Par exemple, pour créer vos éléments .fmx dans un répertoire appelé US, définissez le motif du type comme US/{b}.fmx. Vous pouvez également utiliser un nom de macro au lieu d'un nom de répertoire explicite. Pour créer l'élément .fmx dans le répertoire indiqué par la valeur actuelle de la macro NLS_LANG, définissez le motif du type .fmx comme {NLS_LANG}/{b}.fmx.

•	Vous voulez que le nom de fichier lui-même comporte une macro. Par exemple, vous voulez que vos fichiers .fmx se terminent par le nom de la langue. Pour cela, définissez {b}{NLS_LANG}.fmx pour le type .fnx.


Définition d'actions

  Rubriques connexes

Utilisez cet écran pour définir ou modifier les actions associées à ce type.

•	Pour ajouter une action au type, cliquez sur Ajouter. La boîte de dialogue Nouvelle action apparaît.

•	Pour modifier le nom d'une action, sa description ou son paramètre par défaut, sélectionnez l'action et cliquez sur Edition. La boîte de dialogue Editer Action apparaît.

•	Pour supprimer une action de la définition du type, sélectionnez l'action et cliquez sur Supprimer.

•	Pour définir une action comme action par défaut du type, sélectionnez-la et cliquez sur En faire la valeur par défaut. Par la suite, cette action est exécutée lorsque vous cliquez deux fois sur un élément de ce type dans le Navigateur de projet. L'action apparaît également en haut du menu contextuel pour tous les éléments de ce type.

Remarque : Si vous le désirez, cliquez sur les en-têtes Nom, Description ou Par défaut pour trier la liste sur ces colonnes. Vous pouvez également redimensionner les colonnes en plaçant le curseur sur une colonne jusqu'à l'apparition de la flèche, et en faisant glisser les flèches pour augmenter ou diminuer la taille de la colonne. La première colonne, qui n'a pas de libellé, comporte les icônes des actions : héritée, remplacée et par défaut.


Choix d'une icône

Sélectionnez une icône pour représenter votre type à l'aide de l'une des méthodes suivantes :

•	Cliquez sur la case à cocher Depuis le fichier, puis utilisez le bouton Parcourir pour sélectionner un fichier. Si vous avez sélectionné Choisir fichier pour modèle à la deuxième étape de l'assistant, l'icône adéquate est sélectionnée pour vous. Si vous devez sélectionner un fichier, essayez de choisir un fichier exécutable ou de bibliothèque, auxquels sont généralement associées des icônes. Si vous choisissez un fichier sans icône associée, un message d'alerte apparaît.

•	Si vous n'avez accès à aucun fichier contenant l'icône adéquate, choisissez une icône dans la liste d'icônes prédéfinies. Vérifiez que la case Depuis le fichier n'est pas cochée, puis cliquez sur l'icône à associer à ce type.

Cliquez sur Fin pour terminer la création ou la modification de ce type.


Assistant Type de module

  Rubriques connexes

L'assistant Type de module vous permet de définir rapidement et facilement de nouveaux types à utiliser dans Project Builder, ou de modifier des types existants. Pour appeler cet assistant, sélectionnez Outils [image] Assistant Type de module. Pour plus d'informations, reportez-vous à Rubriques connexes.


Protection des projets par mot de passe

  Rubriques connexes

Vous pouvez maintenant définir des mots de passe pour protéger les projets contre un affichage ou une modification par des utilisateurs non autorisés. Lorsqu'un utilisateur tente d'ouvrir un projet protégé par mot de passe, une boîte de dialogue lui demande de saisir ce mot de passe. Si l'utilisateur en est incapable, l'accès au projet lui est refusé. Pour plus d'informations, reportez-vous à Rubriques connexes.


Mode Aperçu des actions

  Rubriques connexes

Le mode Aperçu des actions permet de tester les actions et de voir les valeurs correspondant aux divers paramètres et macros, sans exécuter l'action. Pour plus d'informations, reportez-vous à Rubriques connexes.


Valeurs de macros fournies par l'utilisateur

  Rubriques connexes

Lorsque vous créez une macro, vous devez maintenant définir son type. La plupart de ces types de macro provoquent l'apparition d'une invite instantanée au moment de l'exécution, dans laquelle l'utilisateur doit entrer des informations ou accepter la valeur par défaut. Pour plus d'informations, reportez-vous à Rubriques connexes.


Nouveaux métatypes

  Rubriques connexes

Les métatypes permettent de définir en une seule opération des actions ayant une incidence sur de nombreux types, et donc sur de nombreux fichiers. Par exemple, les commandes TAR et ZIP traitent les fichiers texte différemment des fichiers binaires. Lorsque vous définissez ces actions au niveau du métatype, tous les fichiers texte et binaire héritent de l'action qui leur convient. Pour plus d'informations, reportez-vous à Rubriques connexes.


Sous-répertoires ajoutés en tant que sous-projets

  Rubriques connexes

Project Builder dispose maintenant de l'élément de menu Projet [image] Ajouter le répertoire au projet, qui vous permet d'ajouter à votre projet des répertoires entiers en tant que sous-projets. Si un répertoire contient des sous-répertoires, ces derniers sont également ajoutés. Pour plus d'informations, reportez-vous à Rubriques connexes.


Vues filtrées du Navigateur de projet

  Rubriques connexes

Un filtre permet de n'afficher que les projets ou les éléments de projet du Navigateur de projet qui correspondent à certains critères. Lorsque vous appliquez un filtre, les objets qui ne correspondent pas aux critères indiqués dans la définition du filtre sont masqués. Pour plus d'informations, reportez-vous à Rubriques connexes.


Défragmentation automatique

  Rubriques connexes

Lorsque vous ajoutez ou que vous supprimez des éléments dans la base de registres d'un projet, une fragmentation de l'espace de stockage peut survenir. Pour empêcher cette fragmentation de diminuer les performances système, Project Builder propose un outil de défragmentation permettant de récupérer l'espace de stockage non utilisé. Pour plus d'informations, reportez-vous à Rubriques connexes.


Remplacement des définitions de macro du projet au niveau de l'élément

  Rubriques connexes

Vous pouvez lire la valeur héritée d'une macro et l'utiliser dans la définition d'une autre macro en insérant simplement un caret en face du nom de la macro référencée. Vous pouvez ainsi conserver la définition de la macro dans un projet tout en la personnalisant pour des éléments distincts de ce projet. Pour plus d'informations, reportez-vous à Rubriques connexes.


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 :

•	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 :

•	OCA_DEBUG_SQL=TRUE

•	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 :

•	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é.


Project Builder
nnProject Builder

  Rubriques connexes

Project Builder de Forms Developer vous aide à organiser et à tenir à jour les différents fichiers composant une application. Dans un même projet, vous pouvez suivre toutes les opérations, depuis la documentation des applications, créée sous votre traitement de texte préféré, jusqu'aux états, grilles et tableaux qu'ils contiennent, aux sorties utilisateur et aux routines qu'ils appellent.

Project Builder peut également vous fournir un unique point de contact en intégrant la totalité des outils, fichiers et tâches constituant un projet de développement, et notamment les applications Forms, les états, les fichiers graphiques, les menus, les fichiers .INI, les icônes, les scripts SQL et les pages Web.


L'assistant Projet

  Rubriques connexes

L'assistant Projet facilite la création d'un projet. Vous l'utiliserez pour créer un fichier de registre de projets qui vous permettra d'associer les fichiers composant une application, et donc de gérer plus efficacement le processus de création de votre application.

L'assistant Projet vous explique, page après page, les différentes étapes nécessaires à la définition d'un projet. C'est vous qui décidez si vous voulez définir un nouveau projet autonome ou un sous-projet, c'est-à-dire un projet dépendant d'un autre, plus important, car une grille et ses menus peuvent constituer une partie d'une application plus importante. Vous nommez votre projet, choisissez le répertoire dans lequel il doit résider et indiquez une connexion par défaut. Lorsque vous avez fini d'utiliser l'assistant Projet, vous êtes prêt à commencer à ajouter des fichiers.


Le Lanceur

  Rubriques connexes

Le Lanceur est la barre d'outils secondaire qui se trouve par défaut en haut du Navigateur de projet. Il vous permet d'organiser et de lancer les outils que vous utilisez le plus fréquemment au cours du développement de vos produits, directement à partir de Project Builder.


Entrez ici le libellé pour une nouvelle rubrique.


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.


A propos du contrôle de source

  Rubriques connexes

Ce contrôle permet de gérer et de tenir à jour plusieurs révisions d'un fichier dans une archive.

Une archive est un répertoire, défini par l'utilisateur, qui contient une version texte du fichier, ainsi que des informations sur chacune des révisions effectuées, notamment la description et la date de toutes les modifications.

L'archive permet à un membre d'une équipe de développement d'extraire, de modifier et de mettre en place une révision fiable et cohérente.

Ses composants (Form Builder par exemple) proposent un contrôle de source par une interface générique avec le fournisseur de contrôle de source de votre choix. A l'heure actuelle, il existe des modules enfichables pour le système PVCS (Polytron Version Control System) de INTERSOLV et Pure-Atria Clearcase, mais d'autres modules sont en cours de développement.

Pour toute information sur l'installation et l'utilisation de PVCS, reportez-vous à votre documentation INTERSOLV.

PVCS prend également en charge le verrouillage des fichiers et l'établissement d'états sur les archives.


A propos des fichiers de configuration

Il existe quatre variables d’environnement qui doivent être définies pour optimiser les performances de l’interface de source de contrôle. Sous Windows 3.1, celles-ci sont définies dans oracle.ini, alors que sous Windows NT ou Windows 95/98, elles figurent dans la base de registres, dans la clé SOFTWARE/ORACLE.

DEV2000_SOURCECONTROL indique le système de contrôle de source à utiliser. Il doit être défini à «PVCS». La valeur par défaut étant définie à PVCS par ses composants (Forms Builder par exemple), l’omission de cette variable n’aura aucun effet perceptible dans la présente version. Cependant, comme ils prennent également en charge d’autres système de contrôle de source, la définition de cette variable vous assure un bon fonctionnement de l’interface de contrôle de source.

DEV2000_PROJECT remplace la variable TVCCFG d’Oracle Developer versions 1.0 et 1.1, et identifie le fichier de configuration de projet PVCS (.CFG) à utiliser. Si vous n’indiquez pas de fichier configuration de projet via une variable d’environnement, vous devrez en choisir un dans la boîte de dialogue Contrôle de source : Options pour chaque session.

DEV2000_SCVIEWER contrôle l’affichage des résultats d’un journal de contrôle de source ou d’un état des différences. Pour désactiver l’affichage des résultats, définissez cette variable à NULL (aucune valeur).

DEV2000_SCCONVERT contrôle la conversion des fichiers en code ASCII avant leur archivage dans PVCS, et leur reconversion en binaire avant leur extraction. A moins que ne vouliez mettre à niveau PVCS d’une version antérieure d’Oracle Developer et souhaitiez le conserver, laissez la valeur par défaut FALSE.

Exemple d’une partie du contenu du fichier oracle.ini :

...

DEV2000_SOURCECONTROL=PVCS

DEV2000_PROJECT=C:\PROJECTS\MYPROJ\MYPROJ.CFG

DEV2000_SCVIEWER=NOTEPAD.EXE

DEV2000_SCCONVERT=FALSE

...


A propos de la mise en oeuvre de PVCS

Lorsque vous archivez certains objets (applications Forms, menus, états, affichages, bibliothèques PL/SQL) le fichier binaire est automatiquement converti en un fichier texte équivalent, qui est archivé dans le contrôle de source. Par exemple, si vous avez archivé MONAPPLI.FMB, ce fichier est automatiquement converti en MONAPPLI.FMT (équivalent en format texte), puis ce dernier est archivé dans le contrôle de source.

De même, lorsque vous extrayez un fichier archivé, Developer/2000 convertit la version texte du fichier en son équivalent en format binaire, qui peut être lu par les interfaces de développement. Si vous voulez extraire MONAPPLI.FMT, il sera converti en MONAPPLI.FMB pour que vous puissiez l'éditer.

L'archivage est effectué sur la version texte du fichier pour permettre la génération entre les différentes versions d'un fichier d'états des différences plus significatifs. PVCS archive les fichiers binaires, mais ne crée pas d'états des différences entre les différentes révisions de ces fichiers.

Une fois cette conversion de fichiers effectuée, votre répertoire de travail peut contenir des fichiers supplémentaires, en fonction des options que vous avez choisies pour PVCS. Si la configuration de votre projet prévoit la création de fichiers de travail en lecture seule après l'archivage, votre répertoire contiendra le fichier binaire et un fichier texte en lecture seule. Mais si la suppression des fichiers de travail après archivage est prévue dans la configuration, votre répertoire de travail ne contiendra que le fichier binaire.


A propos de l'archivage d'un fichier

  Rubriques connexes

Tout fichier modifié et entré dans une archive devient une nouvelle révision. Lorsque vous archivez un fichier (par exemple, un fichier de bibliothèque PL/SQL ayant le suffixe .pll), PVC le convertit automatiquement de binaire en texte et l'archive à l'emplacement indiqué, sous la forme d'un fichier texte ayant le suffixe approprié (par exemple, .pld). PVCS utilise le fichier texte pour générer des états d'archive.

Un libellé de version indique qu'une révision appartient à un groupe constituant généralement une version complète de votre application. Les libellés de version permettent d'exécuter une opération simultanément sur tous les fichiers associés à une version particulière en ne faisant référence qu'à un seul nom. Si vous avez déjà archivé une version du module en cours, les informations appropriées sont entrées automatiquement dans le champ Archive.


A propos de l'extraction d'un fichier

  Rubriques connexes

L'extraction d'un fichier archivé vous permet d'accéder à ce fichier pour le parcourir, l'éditer ou l'imprimer. Par défaut, un seul utilisateur peut, à un moment donné, extraire une version verrouillée.

Lorsque vous extrayez un fichier, il est automatiquement converti en fichier de format approprié (par exemple, il un fichier de bibliothèque PL/SQL du format pld est converti au format .pll). Le fichier extrait d'une archive est appelé fichier de travail. Chaque fois que vous archivez une nouvelle variante d'un fichier de travail, elle devient une révision.


A propos de la création d'états d'archive

  Rubriques connexes

PVCS permet de générer des états récapitulatifs sur les sujets suivants :

•	création d'archives

•	attributs des fichiers archivés

•	révisions successives

•	libellés

•	lignes modifiées dans la dernière révision

•	description du fichier de travail


A propos des modèles de promotion

Un modèle de promotion est une suite hiérarchisée de jalons d'un cycle de développement. La promotion permet de contrôler le développement du code source, de la phase initiale à la version finale. Chaque jalon est représenté par un groupe de promotion. Exemples : Développement, Assurance qualité et Production. Un modèle de promotion est une fonction avancée, conseillée pour les sites appliquant des procédures formelles d'évolution de logiciels.

Un modèle de promotion peut avoir un ou plusieurs groupes de niveau inférieur, ou de développement. Lorsqu'un modèle de promotion est en vigueur, les utilisateur ne peuvent modifier que les révisions associées à un groupe de développement. Pour éditer une révision associée à un groupe de niveau supérieur, l'utilisateur doit l'extraire et la ré-associer à un groupe de développement lors de l'extraction, puis la faire repasser à un groupe supérieur après l'avoir ré-archivée.

Si le modèle de promotion ne comprend qu'un groupe de développement, vous ne pouvez verrouiller qu'une révision de l'archive à la fois. Pour concevoir un modèle de promotion pour un développement parallèle, vous devez inclure au moins deux groupes de développement.

Au-dessus du ou des groupes de développement, vous pouvez définir un nombre quelconque de groupes de promotion intermédiaires pour les différentes étapes de test ou d'éditions préliminaires. Au niveau le plus élevé se trouve le groupe de production qui indique généralement que les révisions sont prêtes à être commercialisées.

L'utilisation d'un modèle de promotion vous permet de :

•	Connaître rapidement l'état d'un projet. Vous pouvez exécuter un état d'archivage sur un projet pour savoir immédiatement quels sont modules qui n'ont pas atteint un jalon particulier du cycle de développement.

•	Contrôler l'accès aux révisions aux niveaux autres que celui du développement. Etant donné que les utilisateurs ne peuvent pas modifier les révisions associées à des groupes de promotion post-développement, vous êtes certain que toutes les révisions sont intégralement testées.

•	Personnaliser votre propre modèle. Vous pouvez personnaliser une structure de promotion adaptée de façon unique à chaque projet, en indiquant le nombre de jalons de votre choix dans la structure de promotion.


Création d'un répertoire d'archives

  Etape suivante	  Rubriques connexes

Pour créer un répertoire d'archives :  Remarque :

1	Choisissez Fichier [image] Administration [image] Gestion des archives et rapports pour afficher la boîte de dialogue Contrôle de source : Options.

2	S'il n'est pas déjà sélectionné, sélectionnez l'onglet Projet.

3	Indiquez le nom et l'emplacement de votre répertoire d'archives dans le champ Nouveau répertoire d'archive.

4	Cliquez sur Ajouter nouveau répertoire à liste, puis sur Fermer pour fermer la boîte de dialogue.


Vous ne pouvez ajouter des répertoires d'archive qu'après avoir défini le paramètre DEV2000_PROJECT dans le fichier oracle.ini. Sous Microsoft Windows, définissez ce paramètre de la manière suivante :

DEV2000_PROJECT=C:\PVCS\PROJECT1\PROJECT1.CFG

Pour éditer le paramètre DEV2000_PROJECT, utilisez le fichier Oracle.ini sous Windows 3.1, et la base de registres sous Windows 95/98 et NT.


Archivage d'un fichier

  Etape suivante	  Rubriques connexes

Pour archiver un fichier :

1	Choisissez Fichier [image] Administration [image] Archiver pour afficher la boîte de dialogue Contrôle de source : archivage.

2	Entrez le nom du fichier à archiver dans la boîte de texte Fichier de travail.

3	Indiquez l'emplacement de votre archive dans le champ Archive.

4	(Facultatif) Fournissez un Libellé de version, un Groupe de promotion et une Description.

5	(Facultatif) Cliquez sur la case à cocher Garder le fichier verrouillé si vous voulez qu'une copie modifiable du fichier soit disponible localement, même après son archivage. Ce type de copie permet, sans avoir à extraire le fichier, de le modifier et d'archiver les modifications ultérieures du fichier sans avoir à l'extraire.

6	Cliquez sur OK pour archiver votre fichier.

PVCS archive le fichier.


Extraction d'un fichier

  Etape suivante	  Rubriques connexes

Pour extraire un fichier :

1	Choisissez Fichier [image] Administration [image] Extraire pour afficher la boîte de dialogue Contrôle de source : extraction.

2	Indiquez l'emplacement de l'archive source dans le champ Depuis l'archive.

3	Entrez dans la boîte de texte Nom de fichier le nom du fichier que vous voulez extraire.

4	Sélectionnez une révision de fichier dans le champ Révisions.

5	(Facultatif) Indiquez la destination en entrant un chemin dans le champ Destination.

6	(Facultatif) Pour verrouiller le fichier que vous extrayez, choisissez le Groupe de promotion de niveau Développement qui sera attribué à la révision en cours d'extraction.

7	(Facultatif) Cliquez sur la case à cocher Verrouiller ce fichier Remarque :

8	(Facultatif) Cliquez sur la case à cocher Ouvrir fichier après extraction. Si cette case est déjà cochée, le fichier extrait sera ouvert dans Designer lorsqu'il aura été extrait de PVCS.

9	Cliquez sur OK pour extraire le fichier.


Si vous voulez modifier un fichier d'archives, vous devez valider la case à cocher Verrouiller ce fichier pour archiver vos modifications. Sinon, la version extraite sera la version en lecture seule.


Création d'un état d'archives

  Rubriques connexes

Pour créer un état d'archives :

1	Choisissez Fichier [image] Administration [image] Gestion des archives et rapports.

2	Cliquez sur l'onglet Etat pour afficher la page Contrôle de source : options Etat.

3	Indiquez l'emplacement de l'archive dans le champ Archive.

4	Indiquez le nom du fichier d'archive dans le champ Fichier source. Pour générer l'état, PVCS compare ce fichier et le fichier cible.

5	Indiquez le nom d'un fichier cible dans le champ Fichier cible.  Remarque

6	Sélectionnez les révisions du fichier dans les champs Révision source et Révision cible, respectivement.

7	Indiquez le nom et l'emplacement de l'état dans le champ Fichier de sortie, puis cliquez sur Exécuter état.

PVCS crée l'état. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie. Sinon, utilisez un éditeur pour ouvrir votre fichier état.


Si vous comparez deux révisions stockées dans la même archive, entrez le nom du fichier d'archive que vous avez fourni à l'étape 4. Si vous comparez des fichiers d'archive différents, indiquez un fichier d'archive différent dans le champ Fichier cible.


Boîte de dialogue Contrôle de source : Archivage

  Rubriques connexes

Permet de fusionner le fichier indiqué dans l'archive indiquée.

Cette boîte de dialogue comporte les options suivantes :

Nom de fichier	Permet d'indiquer le nom du fichier que vous allez archiver. Choisissez Parcourir pour appeler une boîte de dialogue dans laquelle vous pourrez sélectionner un fichier.
Archive	Liste déroulante de toutes les archives disponibles pour le projet en cours. Sélectionnez l'archive dans laquelle le fichier doit être enregistré.
Libellé de version	(Facultatif) Permet d'indiquer le libellé de la version du fichier.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée. Choisissez le groupe de promotion de niveau Développement qui doit être attribué à la révision à archiver.
Description	Permet de décrire les modifications apportées à cette révision. Bien que ce champ soit facultatif, il est conseillé de le remplir pour faciliter l'identification des révisions lors de leur extraction.
Garder le fichier verrouillé ?	Permet d'indiquer si une copie modifiable du fichier d'archivage est disponible localement, même après l'archivage du fichier. Ce type de copie permet, sans avoir à extraire le fichier, de le modifier et d'enregistrer les modifications ultérieures.


Boîte de dialogue Contrôle de source : Extraction

  Rubriques connexes

Permet d'extraire d'une archive le fichier que vous voulez éditer.

Cette boîte de dialogue comprend les options suivantes :

Depuis l'archive	Permet d'indiquer le nom du répertoire d'archive contenant le fichier à extraire.
Nom de fichier	Permet d'indiquer le nom du fichier à extraire du contrôle de source. Choisissez Parcourir pour appeler une boîte de dialogue dans laquelle vous pourrez sélectionner un fichier.
Révisions	Affiche les révisions disponibles ainsi que les libellés de version du fichier sélectionné dans le champ Nom de fichier.
Description	Dresse la liste des descriptions des versions disponibles énumérées dans la liste Révisions.
Répertoire cible	(Facultatif) Permet d'indiquer le répertoire de destination du fichier à extraire.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée. Si vous voulez verrouiller le fichier à extraire, choisissez le groupe de promotion de niveau Développement qui sera attribué à la révision à extraire.
Verrouiller fichier à l'extraction	Permet d'indiquer si le fichier à extraire doit être marqué verrouillé. Un fichier verrouillé est protégé contre les mises à jour par d'autres utilisateurs.
Ouvrir fichier après extraction	Si vous cochez cette case, le fichier sera ouvert dans Designer après avoir été extrait de PVCS.


Boîte de dialogue Contrôle de source : Options

  Rubriques connexes

Cette boîte de dialogue comprend trois onglets :

Options de projet

Options de fichier

Options d'état


Contrôle de source : page Options de projet

  Rubriques connexes

La page Options de projet permet d'ajouter et de supprimer des répertoires d'archives dans votre fichier de configuration de projet.

Cette page comporte les option suivantes :

Projet en cours	Nom du fichier de configuration du projet PVCS en cours. Sa valeur initiale est la valeur de DEV2000_PROJECT dans le fichier oracle.ini. Pour afficher la boîte de dialogue de fichiers de votre système d'exploitation, entrez directement un nom de fichier ou cliquez sur Parcourir.
Nouveau répertoire d'archives	Permet d'indiquer le nom du nouveau répertoire d'archives à ajouter à la liste des répertoires d'archives disponibles dans le projet en cours. Pour afficher la boîte de dialogue de fichiers de votre système d'exploitation entrez un nom de répertoire ou cliquez sur Parcourir.
Liste des répertoires d'archives	Affiche les répertoires d'archives disponibles dans le projet en cours.
Ajouter nouveau répertoire à la liste	Après avoir entré un répertoire d'archives dans la boîte de texte Nouveau répertoire d'archives, cliquez sur Ajouter nouveau répertoire à liste pour ajouter ce répertoire au projet en cours. Une fois  ajouté, le répertoire apparaîtra dans la liste.
Retirer répertoire sélectionné de la liste	Sélectionnez un répertoire d'archives de la liste, puis cliquez sur Supprimer répertoire sélectionné de la liste pour le supprimer du projet.


Contrôle de source : page Options de fichier

  Rubriques connexes

La page Options de fichier permet de verrouiller ou de déverrouiller une archive ou de générer un journal d'activités de cette archive.

Cette page comporte les options suivantes :

Archive	Liste déroulante de tous les répertoires d'archives du fichier de configuration de projet en cours.
Nom de fichier	Permet d'indiquer le fichier d'archives auquel vous voulez accéder. Vous pouvez entrer directement le nom du fichier ou en choisir un à l'aide de Parcourir. Si la configuration de votre projet PVCS prévoit d'ignorer les chemins d'accès au fichier de travail, vous pouvez indiquer soit un fichier de travail, soit un fichier d'archives. Sinon, vous ne pouvez indiquez qu'un fichier d'archives.
Révisions	Cette liste déroulante affiche toutes les révisions et tous les libellés de version du fichier sélectionné. Elle comporte aussi une entrée vide qui indique l'absence de sélection. Si vous sélectionnez une révision, elle sera verrouillée ou non verrouillée. Si vous ne sélectionnez pas de révision, le comportement du programme dépendra de la présence ou de l'absence d'une définition de modèle de promotion. Si vous n'avez pas défini de modèle, la révision sera verrouillée. Si vous avez défini un modèle, la révision attribuée au groupe de promotion indiqué sera verrouillée. En cas de sélection de Déverrouiller sans révision sélectionnée, tous les verrous que vous avez posés sur le fichier seront supprimés.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée et affiche tous les groupes de promotion de niveau Développement de votre modèle de promotion. Lorsque vous verrouillez une révision, le groupe de promotion indiqué dans cette liste lui est attribué.
Nom du fichier de journalisation	Permet d'indiquer le nom du fichier de journalisation.
Type de journalisation	Permet d'indiquer le type des mises à jour à entrer dans le fichier de journalisation indiqué lors d'un archivage ou d'une extraction.
Verrouiller révision	Permet de verrouiller le fichier indiqué dans le champ Nom de fichier, sans l'extraire du contrôle de source. Un fichier verrouillé est protégé contre les mises à jour par d'autres utilisateurs. Si vous sélectionnez une révision de la liste Révisions, elle est verrouillée. Si vous n'en sélectionnez pas, la révision (ou celle attribuée au groupe de promotion indiqué) est verrouillée. Si vous avez défini un modèle de promotion pour votre projet PVCS, le groupe de promotion indiqué est attribué à la révision verrouillée.
Déverrouiller révision	Permet de déverrouiller le fichier indiqué dans le champ Nom de fichier pour permettre à d'autres utilisateurs d'extraire et de modifier le fichier d'archives. Si vous avez sélectionné une révision de la liste Révisions, elle sera déverrouillée. Si vous n'en sélectionnez pas, tous les verrous que vous avez posés sur les révisions du fichier sont libérés.
Générer journalisation	Permet de générer un fichier de journalisation ayant le nom indiqué. Le type d'entrée dans ce fichier journalisation est déterminé par l'option Type de journalisation. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie.


Contrôle de source : page Options d'état

  Rubriques connexes

La page Options d'état permet de définir et de créer des états d'archive.

Cette page comporte les options suivantes :

Archive	Liste déroulante de tous les répertoires d'archives du fichier de configuration de projet en cours.
Fichier source	Permet d'indiquer le premier fichier à utiliser pour générer un état des différences. Vous pouvez entrer directement le nom, ou choisir un fichier en utilisant le bouton adjacent Parcourir. Si la configuration de votre projet PVCS prévoit d'ignorer les chemins d'accès au fichier de travail, vous pouvez indiquer soit un fichier de travail, soit un fichier d'archives. Sinon, vous ne pouvez indiquez qu'un fichier d'archives.
Révision source	Liste déroulante de toutes les révisions et de tous les libellés de version du fichier source.
Fichier cible	Permet d'indiquer le nom du fichier cible. Pour générer un état, PVCS compare le fichier source et le fichier cible.
Révision cible	Liste déroulante de toutes les révisions et de tous les libellés de version du fichier cible.
Fichier de sortie	Permet d'indiquer le répertoire de destination et le nom du fichier dans lequel devra être entré l'état des différences découlant de la comparaison de deux fichiers.
Exécuter état	Permet de créer un état en fonction des options indiquées. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie.


Messages d'erreur

Les messages d'erreur qui peuvent s'afficher lorsque vous utilisez les boîtes de dialogue d'interface de contrôle de source sont décrits ci-dessous.

D2SCP-001 :	Accès au fichier refusé par le système de fichiers

 Cause :	Vous n'êtes pas autorisé par le système de fichiers à lire des fichiers d'archives, à écrire des fichiers de travail ou à écrire la sortie de l'état ou la sortie journal.

 Action :	Si vous estimez que vous devez avoir accès à ces fichiers, contactez votre administrateur système.

D2SCP-002 :	Privilèges d'accès insuffisants du gestionnaire de version

 Cause :	Vous n'êtes pas autorisé par PVCS à accéder à l'archive que vous avez indiquée. Ce message apparaît également si la modification des répertoires d'archives a été désactivée dans le projet maître et que vous tentiez de les modifier dans l'onglet Options de projet de la boîte de dialogue Options.

 Action :	Si vous estimez que vous devez avoir accès à cette archive, contactez votre administrateur système.

D2SCP-003 :	Cette archive existe déjà

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous répétez l'opération, contactez le Support technique Oracle.

D2SCP-004 :	Archive spécifiée introuvable

 Cause :	Vous avez entré ou sélectionné un fichier qui n'était pas une archive, alors qu'il fallait indiquer un fichier d'archives. Ce message apparaît généralement lorsque vous sélectionnez le fichier de travail au lieu du fichier d'archives (par exemple, MONAPPLI.FMB au lieu de MONAPPLI.FMV).

 Action :	Utilisez le bouton Parcourir pour choisir un fichier d'archives.

D2SCP-005 :	Nom de fichier, unité ou chemin non valide ou menu de fichier contient des caractères non valides

 Cause :	Le nom de fichier que vous avez entré n'est pas un nom de fichier valide pour le système d'exploitation.

 Action :	Vérifiez la syntaxe du nom de fichier.

D2SCP-006 :	Fichier en cours d'utilisation par un autre processus

 Cause :	Le fichier auquel vous tentez d'accéder a été ouvert par un autre utilisateur PVCS.

 Action :	Si vous attendez un peu avant de tenter à nouveau d'exécuter l'opération, ce message ne devrait plus apparaître.

D2SCP-007 :	Echec de conversion. Le fichier de travail est en lecture seule ou n'est pas pris en charge

 Cause :	Causes possibles :

A.	Votre fichier de travail est en lecture seule. Par exemple, vous extrayez le fichier sans le verrouiller, puis vous le verrouillez dans la boîte de dialogue Options.

B.	Vous avez tenté d'archiver ou d'extraire un fichier d'un type non reconnu.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Utiliser le Gestionnaire de fichiers ou l'explorateur de Windows pour permettre l'écriture dans le fichier avant de poursuivre.

B.	Archiver ou extraire le fichier en utilisant l'interface PVCS autonome.

Notez que vous pouvez extraire n’importe quel fichier à condition qu’il soit reconnu, car Oracle Developer ne peut que déterminer s'il s'agit d'un type de fichier pris en charge à partir du fichier de travail. Lorsque vous archivez un fichier, le fichier de travail permet à Oracle Developer de tester le fichier avant de l'archiver. Lorsque vous extrayez un fichier, Developper/2000 commence par l'extraire pour obtenir un fichier de travail. Ce n'est qu'à ce stade qu'il teste le fichier. Vous pouvez donc ignorer cette erreur lors d'une extraction si vous savez que le fichier n'est pas un fichier Oracle Developer.

D2SCP-008 :	Valeurs non valides ou insuffisantes

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous répétez l'opération, contactez le Support technique Oracle.

D2SCP-010 :	Le libellé de version existe déjà

 Cause :	Vous avez indiqué dans la boîte de dialogue Archivage un libellé de version qui existe déjà pour le fichier que vous archivez. PVCS requiert que les libellés de version soient uniques.

 Action :	Changez le libellé. Pour afficher les libellés utilisés, utilisez la fonction Journal de l'onglet Options de fichiers de la boîte de dialogue Options.

D2SCP-011 :	La révision spécifiée n'existe pas

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous avez répété l'opération, contactez le Support technique Oracle.

D2SCP-012 :	Fichier de configuration spécifié non valide

 Cause :	Causes possibles :

A.	Le fichier que vous avez choisi dans l'onglet Options de projet de la boîte de dialogue Options n'est pas un fichier de configuration PVCS valide.

B.	Si cette erreur apparaît lorsque vous tentez d'accéder à la boîte de dialogue Archivage ou Extraction, le fichier de configuration indiqué dans la variable d'environnement DEV2000_PROJECT n'est pas valide.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Sélectionner un fichier valide.

B.	Modifier la variable ou utiliser l'onglet Options de projet de la boîte de dialogue Options pour définir un fichier de configuration valide.

D2SCP-013 :	Vous devez d'abord choisir un projet depuis 'Contrôle de source : Options'

 Cause :	Vous avez tenté d'accéder à la boîte de dialogue Archivage ou Extraction sans avoir indiqué de projet, en utilisant soit la variable DEV2000_PROJECT du fichier ORACLE.INI, soit l'onglet Options de projet de la boîte de dialogue Options.

 Action :	Vous devez passer à l'onglet Options de projet et sélectionner un projet avant de poursuivre.

D2SCP-014 :	Mise à jour impossible du fichier de configuration de projet

 Cause :	Vous avez tenté d'ajouter ou de supprimer des répertoires d'archives dans le fichier de configuration de projet, sans être autorisé à écrire dans le fichier ou le répertoire dans lequel se trouve le fichier.

 Action :	Consultez votre administrateur système ou PVCS si vous estimez que vous devriez avoir cette autorisation.

D2SCP-015 :	Révision non verrouillée

 Cause :	Vous avez tenté d'archiver une révision que vous n'avez pas verrouillée, ou de déverrouiller une révision que vous n'avez pas verrouillée (à partir de l'onglet Options de fichier).

 Action :	Si vous avez modifié la révision, verrouillez-la à partir de l'onglet Options de fichier avant de l'archiver.

D2SCP-016 :	Verrouillage impossible de la révision spécifiée

 Cause :	Vous avez tenté d'extraire une révision verrouillée à partir de la boîte de dialogue Extraction ou de verrouiller une révision à partir de l'onglet Options de fichiers, mais PVCS n'a pas pu vous autoriser à effectuer le verrouillage. Causes possibles :

A.	La révision est déjà verrouillée, par vous ou par quelqu'un d'autre.

B.	Votre projet ne permet pas les verrous multiples, et la révision est déjà verrouillée.

C.	Si votre projet comporte un modèle de promotion, le groupe de promotion que vous avez indiqué est peut être déjà attribué à une révision verrouillée.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Utilisez la fonction de journalisation pour connaître le propriétaire du verrou et, si vous avez déjà verrouillé la révision, extrayez-la sans demander de verrou. Si quelqu'un d'autre a verrouillé le fichier, attendez qu'il le déverrouille avant d'extraire le fichier à modifier.

B.	Attendez que la révision ou le fichier soit disponible, ou envisagez d'autoriser plusieurs verrous par fichier dans votre projet.

C.	Attendez que le groupe de promotion soit disponible (c'est-à-dire ne soit pas attribué à une révision verrouillée) ou utilisez un autre groupe de promotion de niveau Développement.

D2SCP-017 :	Le répertoire spécifié n'existe pas

 Cause :	Vous avez indiqué un répertoire qui n'existe pas. Cette erreur apparaît souvent en cas d'extraction de fichier lorsque l'emplacement dans lequel il a été archivé n'existe pas sur votre poste de travail.

 Action :	Dans ce cas, éditez le fichier Cible pour qu'il pointe sur un répertoire existant.

D2SCP-018 :	Réacheminement impossible de la sortie vers fichier

 Cause :	Le nom de fichier que vous avez indiqué pour la sortie de l'état des différences ou le journal n'est pas valide, ou bien le fichier n'a pas pu être ouvert en écriture.

 Action :	Indiquez un nom de fichier valide et pouvant être utilisé en écriture.

D2SCP-100 :	PVCS Erreur numéro - mot-clé

 Cause :	PVCS a émis une erreur que l'interface de contrôle de source n'a pas pu traiter.

Action :	Reportez-vous à votre documentation PVCS en utilisant le numéro de l'erreur ou son mot-clé, et prenez les mesures nécessaires.


Pourquoi l'interface du gestionnaire de configuration de PVCS n'affiche-t-elle pas les nouveaux fichiers ou les révisions ?

Lorsque j'archive des fichiers et attribue des libellés de version, l'interface du gestionnaire de configuration de PVCS n'affiche pas les nouveaux fichiers ou les révisions. Que faire ?

Le dossier de projet doit être mise à jour par l'utilisation des nouvelles informations figurant dans les archives (nouveaux fichiers et révisions). Pour cela, choisissez Mettre à jour dossier projet dans le menu Projet de niveau supérieur de PVCS. Les nouveaux fichiers et les révisions doivent alors être visibles dans la fenêtre "Dossiers" de PVCS.


Pourquoi les options de menu de contrôle de source ne sont-elles activées que dans un produit ?

Si j'exécute simultanément plusieurs produits, les options de menu de contrôle de source ne sont activées que dans l'un d'entre eux. Pourquoi ?

PVCS sous Windows n'est pas invariant - cela signifie qu'à un moment donné un seul programme (programme activé par PVCS comme Report Builder ou l'interface PVCS elle-même) peut accéder aux services PVCS. Vous devrez sortir du programme dont les menus sont activés, et de celui à partir duquel vous voulez accéder aux services PVCS, puis relancer celui dans lequel vous voulez accéder à PVCS.


Pourquoi le système affiche-t-il un message d'erreur indiquant que PVCS ne peut pas trouver l'archive ?

Lorsque j'ai tenté d'extraire un état, j'ai choisi le fichier .RDV (fichier d'archives), mais je reçois toujours un message indiquant que PVCS ne peut pas trouver l'archive. Que se passe-t-il ?

Même si vous avez choisi un fichier .RDV, il est possible qu'il ne s'agisse pas du fichier d'archives. Report Builder écrit ses fichiers intermédiaires (ASCII) avec le suffixe .RDV avant de les archiver. (Pour tout détail, reportez-vous à A propos de la mise en oeuvre de PVCS  Vérifiez que vous sélectionnez bien un fichier .RDV dans le répertoire d'archives, et non le répertoire de travail. Pour éviter cette confusion, vous pouvez :

•	Définir l'option du projet PVCS de suppression des fichiers de travail après l'archivage. Dans ce cas, les fichiers .RDV intermédiaires d'état ne resteront pas sur votre disque.

•	Modifier la règle relative aux suffixes pour que les fichiers .RDV archivés aient un suffixe différent, par exemple .VRD, ce qui évitera les confusions entre les fichiers .VRD et les fichiers .RDV lors de l'extraction.

•	Configurer votre projet de manière à ignorer les chemins d'accès au fichier de travail lorsque vous explorez les archives, ce qui permet d'indiquer le fichier de travail (dans ce cas, le fichier .RDF) et non le fichier d'archive, lors de l'extraction.

Ces options figurent dans l'interface utilisateur du gestionnaire de configuration PVCS, dans l'option de menu de configuration de projet.


Comment être certain d'utiliser le nom utilisateur approprié lorsque je verrouille un fichier ?

Lorsque je verrouille un fichier (ou que j'extrais un fichier verrouillé) l'ID utilisateur est défini à "UNKNOWN" pour que d'autres utilisateurs puissent archiver ou déverrouiller le fichier. Comment être certain que le nom utilisateur que j'utilise est correct ?

L'option de configuration de projet de PVCS "Login Source" de la section Réseau des options de configuration de projet de PVCS (dans l'interface du gestionnaire de versions de PVCS) évite ce type de problème, car elle permet de définir la façon dont PVCS détermine l'ID utilisateur en cours. Par exemple, avec un réseau NETWARE, vous pouvez demander à PVCS d'utiliser l'ID de connexion NETWARE en cours. Sous Windows NT, vous pouvez utiliser l'ID de connexion NT en choisissant la source de connexion "HOST". Pour plus de détails, consultez votre documentation PVCS.


Comment faire pour sélectionner les fichiers de travail à extraire ?

Y-a-t-il une procédure qui permette de sélectionner des fichiers de travail, et non des fichiers d'archives à extraire ?

Vous pouvez utiliser l'option de configuration de projet de PVCS "Ignore Workfile Path" de la section "Archive Searching" des options de configurations de projet de PVCS (dans l'interface du gestionnaire de versions de PVCS). Si vous activez cette option, vous pourrez sélectionner soit des fichiers de travail soit des fichiers d'archive dans les boîtes de dialogue Extraction et Contrôle de source : Options.


J'ai reçu un message indiquant que VCSDIR n'est pas autorisé dans le fichier de configuration de projet. Pourquoi ?

J'ai configuré mon projet maître de manière à désactiver le changement des répertoires d'archives. Dans l'interface du Gestionnaire de versions de PVCS, je ne peux pas changer les répertoires d'archives d'un sous-projet, ce qui est normal. Mais dans Oracle Developer c'est possible. Par la suite, à partir de l'interface du Gestionnaire de versions de PVCS, un message d'erreur m'a indiqué que VCSDIR n'était pas autorisé dans le fichier de configuration du projet. Que s'est-il passé ?

L'interface du Gestionnaire de versions de PVCS a recherché dans sa racine un fichier MASTER.CFG par défaut, et l'a probablement trouvé. C'est la raison pour laquelle il a généré l'erreur indiquée lorsque vous avez changé les répertoires d'archives. Pour rendre le fichier de configuration maître reconnaissable, vous devez configurer PVCS en utilisant la commande VCONFIG. Cette commande encode le nom de votre fichier de configuration maître dans les bibliothèques PVCS, et garantit que personne ne peut modifier accidentellement la liste des répertoires d'archives. Reportez-vous aux sections "Master Configuration File" et "VCONFIG Command" dans PVCS Command-Line Reference Guide INTERSOLV.


• 9


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


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.


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.4 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.


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


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
. . .


Mise à niveau vers la version 2.3 de PL/SQL à l'aide de Project Builder

  Rubriques connexes

Tous les déclencheurs, les unités de programme et les blocs PL/SQL de la version 1 de votre application Forms, de vos états, de vos écrans et de vos bibliothèques PL/SQL sont écrits à l'aide de la version 1 de PL/SQL. Les versions ultérieures de Forms et Reports Developer utilisent la version 2.3 de PL/SQL ; par conséquent, le code PL/SQL de la version 1 doit être mis à niveau vers la nouvelle version.

Pour faciliter l'automatisation du processus de mise à niveau des applications de version 1 et de versions antérieures vers Forms Developer et Reports Developer, un utilitaire de conversion PL/SQL est mis à votre disposition. Pour une efficacité optimale, exécutez cet utilitaire via Project Builder, ce qui vous permet de convertir plusieurs modèles d'un projet en même temps. (Si vous ne gérez pas vos modules via Project Builder, vous pouvez utiliser l'Assistant Projet pour créer rapidement un projet pour la conversion PL/SQL.)

Pour mettre à niveau vos modules à l'aide de Project Builder, créez une action de mise à niveau spéciale pour chaque type de document (application Forms, état, graphique, bibliothèque PL/SQL).


Applications Forms, états, écrans ou bibliothèques PL/SQL.


Préparation à la mise à niveau

  Rubriques connexes

Pour préparer vos projets à la mise à niveau vers la version 2 de PL/SQL :

1	Sauvegardez tous les fichiers à mettre à niveau. Les modules ne peuvent être mis à niveau qu'une seule fois.

2	Si vous ne gérez pas vos projets via Project Builder, utilisez l'Assistant Projet pour créer un projet et y ajouter les modules à mettre à jour. Vous pouvez regrouper toutes les applications Forms dans un même sous-projet, tous les états dans un autre, etc. Il est ainsi plus facile d'appliquer l'action de mise à niveau ou de distribution à tous les modules de même type.

3	Parcourez la liste des applications Forms, des états et des écrans à mettre à niveau, puis recherchez si des bibliothèques PL/SQL leur sont attachées. Si c'est le cas, convertissez les bibliothèques avant de convertir les modules. Reportez-vous à Rubriques connexes.

4	Recherchez les modules portant des noms identiques. Si vous en trouvez, assurez-vous que les fichiers se trouvent dans des sous-répertoires différents.

Par exemple, si vous disposez d'une application Forms appelée MAIN.FMB et d'un état appelé MAIN.RDF, les modifications apportées par l'utilitaire de conversion à ces deux éléments sont écrites dans un fichier journal appelé MAIN.PLG. Par conséquent, l'un des fichiers journaux est écrasé.


Création d'une action de mise à niveau

  Rubriques connexes

Pour créer une action de mise à niveau :

1	Préparez la mise à niveau.

2	Copiez les types à mettre à niveau du Registre global dans le Registre utilisateur. Ainsi, en cas d'erreur, vous pouvez facilement récupérer les définitions de type d'origine.

3	Dans le Registre utilisateur, sélectionnez l'un des types à mettre à niveau, puis choisissez Nouvelle action dans le menu instantané.

4	Utilisez la boîte de dialogue d'ajout d'action pour créer une action de mise à niveau pour ce type.

Par exemple, l'action de mise à niveau d'une application Forms peut correspondre à :

<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.
5	Répétez les étapes 3 et 4 pour chaque type à mettre à niveau. Reportez-vous à Rubriques connexes pour connaître la syntaxe de Reports Developer Compiler et de Graphics Builder.

6	Dans le Navigateur de projet, sélectionnez les fichiers à mettre à niveau. Tous les fichiers sélectionnés doivent être de type identique.

7	Dans le menu instantané, sélectionnez la commande de mise à niveau.

8	Examinez les fichiers journaux et apportez manuellement les corrections nécessaires.

Un fichier journal appelé module.plg est créé pour chaque module du projet.


Récapitulatif du processus de conversion, qui répertorie les éléments convertis ou non.