Création de requêtes

La création d'une requête implique la création d'au moins trois objets distincts : un objet QueryDef, un objet QueryFilterNode et un objet ResultSet. Les requêtes plus complexes peuvent également nécessiter la création d'objets QueryFilterNode supplémentaires.

Pour créer une requête, procédez comme suit :

  1. Créez un objet QueryDef et complétez-le avec les paramètres de recherche.

    Pour créer cet objet, utilisez la méthode BuildQuery de l'objet Session.

    Remarque : Pour générer une requête, utilisez la méthode BuildQuery et non pas la méthode BuildSQLQuery. La méthode BuildSQLQuery génère un objet ResultSet directement à partir d'une chaîne de requête SQL.
  2. Utilisez les méthodes de QueryDef pour ajouter des critères de recherche et préciser les zones de chaque enregistrement que la requête doit renvoyer.
  3. Créez un objet ResultSet pour contenir les données renvoyées.

    Pour créer cet objet, appelez la méthode BuildResultSet de l'objet Session. L'objet ResultSet crée alors un ensemble de structures de données internes à l'aide des informations de l'objet QueryDef en tant que modèle. Lorsque la requête est exécutée, l'objet ResultSet complète ses structures de données par des données provenant de la requête.

  4. Exécutez la requête en appelant la méthode Execute de l'objet ResultSet.
  5. Accédez aux données à l'aide d'autres méthodes de cet objet. (Pour plus d'informations, voir "Navigation dans l'ensemble de résultats".)
Remarque : Si vous utilisez la méthode BuildSQLQuery pour créer une requête basée sur la syntaxe SQL, votre chaîne de requête doit contenir tous les paramètres de recherche souhaités. La méthode BuildSQLQuery renvoie directement un objet ResultSet plutôt que de renvoyer un objet QueryDef.

Commentaires en retour