Editeur de la propriété Procedure

Fonctionnalité de JBuilder Professionnel et Entreprise.

Utilisez l'éditeur de la propriété Procedure pour définir les propriétés associées à un composant ProcedureDataSet ou un composant ProcedureProvider. En les combinant avec un composant Database, elles permettent l'exécution d'une procédure stockée.

Pour afficher cet éditeur de propriété, choisissez la propriété procedure dans l'inspecteur lorsqu'un composant ProcedureDataSet est sélectionné dans le volet structure. Les valeurs des propriétés référencées dans cette boîte de dialogue sont enregistrées dans l'objet ProcedureDescriptor.

Cet éditeur de propriété contient deux pages :

Pour plus d'informations sur les procédures stockées, reportez-vous à la section A propos consacrée au composant ProcedureDataSet dans la Référence des composants DataExpress. Pour avoir un tutoriel sur l'accès aux données en utilisant des procédures stockées, voir la rubrique Obtention des données via une procédure stockée dans Guide du développeur d'applications de bases de données.



Page Procédure

Utilisez la page Procédure pour définir des propriétés de procédure et associer la procédure à une Database particulière. Les propriétés référencées dans cette page de l'éditeur de propriété sont stockées dans l'objet ProcedureDescriptor.

Base de données

Affiche les noms de tous les objets Database instanciés auxquels ce ProcedureDataSet peut être lié. Cette propriété doit être définie pour que la procédure stockée soit exécutée.

La sélection d'un objet Database active le bouton Parcourir les procédures.

Parcourir les procédures

Affiche la boîte de dialogue Procédures disponibles qui vous permet de parcourir la base de données pour rechercher les procédures existantes. Le dialogue Procédures disponibles affiche une boîte liste contenant les noms des procédures disponibles et le bouton Coller la procédure. Cliquez sur le bouton pour coller la procédure dans le champ Instruction SQL ou Escape de procédure stockée de l'éditeur de propriété.

Ce bouton est estompé et inaccessible lorsque le champ Base de données affiche la valeur "<aucun>". Sélectionnez un objet Database dans le champ Base de données pour activer le bouton.

Instruction SQL ou Escape de procédure stockée

Entrez dans ce champ un des éléments suivants :

Dans les deux cas, les marqueurs de l'emplacement d'un paramètre (les signes "?") peuvent être remplacés par des paramètres nommés sous la forme :ParameterName.

Exécuter la requête dès l'ouverture

Détermine si la procédure stockée est automatiquement exécutée lorsque le ProcedureDataSet est ouvert. Cette option est cochée par défaut, ce qui permet au concepteur d'interface utilisateur d'afficher les données réelles lorsque le ProcedureDataSet est lié à un contrôle orienté données. Cette option s'affiche uniquement lorsque l'accès à cette boîte de dialogue s'effectue via la propriété procedure du composant ProcedureDataSet ou du composant ProcedureProvider.

Placer le texte SQL dans l'ensemble de ressources

Sélectionnez cette option pour placer l'instruction SQL dans un fichier ResourceBundle. Si vous fermez la boîte de dialogue en utilisant le bouton OK alors que cette option est sélectionnée, la boîte de dialogue Création ResourceBundle apparaît pour vous permettre de spécifier le nom du bundle de ressource.

Options de chargement

Spécifie comment les données sont chargées dans le ProcedureDataSet. Les données peuvent être chargées comme suit :

Pour plus d'informations sur ces options, voir com.borland.dx.sql.dataset.Load.

Tester la procédure

Teste la valeur du champ Instruction SQL ou Escape de procédure stockée et les autres propriétés de la boîte de dialogue pour la Database spécifiée. Le résultat ("Succès" ou "Echec") est affiché sous le bouton Tester la procédure. Cette option s'affiche uniquement lorsque l'accès à ce dialogue s'effectue via la propriété procedure du composant ProcedureDataSet ou du composant ProcedureProvider.



Page Paramètres

Utilisez la page Paramètres pour spécifier les paramètres de votre instruction de procédure.

Les valeurs de ces paramètres sont précisées à l'aide d'un objet ReadWriteRow instancié (ou à l'aide d'une instance d'une quelconque de ses sous-classes), par exemple, un objet DataSet. Tout ReadWriteRow, tel un ParameterRow, un DataSet et un DataRow peut être utilisé comme paramètres de requête ou de procédure. Dans un ParameterRow, les colonnes sont simplement configurées avec les méthodes addColumns et setColumns. Les DataSet et DataRow ne doivent être utilisés que s'ils contiennent déjà les colonnes avec les données voulues.

Sélectionnez dans la liste déroulante l'objet ReadWriteRow (ou la sous-classe ReadWriteRow) qui contient les valeurs des paramètres de votre procédure.