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
.
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
.
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.
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.
Entrez dans ce champ un des éléments suivants :
{call PROCEDURENAME [(?,?,?,...)] } pour les procédures
{?= call FUNCTIONNAME[(?,?,?,...)] } pour les fonctions
Où les crochets indiquent que la liste des paramètres est facultative.
execute procedure PROCEDURENAME ?,?,?
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.
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
.
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.
Spécifie comment les données sont chargées dans le ProcedureDataSet. Les données peuvent être chargées comme suit :
JdbTable
;Pour plus d'informations sur ces options, voir com.borland.dx.sql.dataset.Load
.
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
.
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.