Vous devez ouvrir un catalogue QBIC pour pouvoir y effectuer des modifications, par exemple, ajouter une caractéristique.
Pour ouvrir un catalogue QBIC, utilisez l'appel d'API QbOpenCatalog ou la commande OPEN QBIC CATALOG.
Lors de l'ouverture d'un catalogue QBIC, vous devez :
Ouverture préalable d'un catalogue : Vous ne pouvez pas ouvrir un catalogue en mise à jour s'il est déjà ouvert dans le même but dans une autre session. Lorsque vous ouvrez un catalogue QBIC, l'extension Image ferme les catalogues QBIC ouverts dans la session en cours.
Utilisation de l'interface API : Lors de l'utilisation de l'API QbOpenCatalog, vous indiquez explicitement le mode d'ouverture du catalogue. Spécifiez :
QbiRead et QbiUpdate sont des constantes définies dans le fichier (en-tête) d'inclusion pour QBIC, dmbqbapi.h.
Vous devez également pointer sur le descripteur du catalogue. Ce descripteur comporte un type de données propre à QBIC, QbCatalogHandle. Ce type de données est également défini dans dmbqbapi.h. L'extension Image renvoie la valeur du descripteur du catalogue en tant que sortie de l'API.
Par exemple, l'appel d'API ci-dessous ouvre un catalogue QBIC en lecture :
mode SQLINTEGER; QbCatalogHandle *CatHdl; mode=qbiRead; /* ouverture du catalogue */ /* opérations de lecture */ rc=QbOpenCatalog( "Employés", /* table utilisateur */ "photo", /* colonne image */ mode, /* mode d'ouverture du catalogue */ &CatHdl); /* descripteur du catalogue */
Utilisation de la ligne de commande : Lorsque vous lancez la commande OPEN QBIC CATALOG, l'extension Image tente d'ouvrir le catalogue en mise à jour. Si celui-ci est en cours de mise à jour dans une autre session, l'extension Image l'ouvre en lecture.
Par exemple, la commande ci-dessous ouvre un catalogue QBIC ; l'extension Image tente de l'ouvrir en mise à jour :
OPEN QBIC CATALOG Employés photo
Fermeture du catalogue après les opérations QBIC : Lors de l'ouverture d'un catalogue QBIC, l'extension Image lui affecte des ressources telles que de la mémoire. Fermez le catalogue lorsque vous avez terminé les activités relatives à QBIC, ce qui permet de libérer les ressources allouées.