Lorsque vous créez un catalogue, vous indiquez si vous souhaitez que l'extension Image catalogue automatiquement une image lors de son stockage dans une table utilisateur. A défaut, vous devez la cataloguer manuellement après son stockage dans la table utilisateur. Vous pouvez cataloguer manuellement une image ou une colonne d'images complète.
Utilisez l'API QbCatalogImage pour cataloguer manuellement une image. Vous ne pouvez pas cataloguer une image par une commande, car il est impossible d'identifier une image sur la ligne de commande. Lorsque vous utilisez l'API, indiquez le descripteur du catalogue et celui de l'image (vous pouvez extraire ce dernier de la table utilisateur). Le catalogue QBIC doit être ouvert en mise à jour avant le catalogage manuel d'une image.
Par exemple, les instructions ci-dessous extraient le descripteur d'une image dans une table utilisateur, puis cataloguent l'image :
/* Extraction du descripteur de l'image */ EXEC SQL BEGIN DECLARE SECTION; char Img_hdl[251]; EXEC SQL END DECLARE SECTION; QbCatalogHandle CatHdl; EXEC SQL SELECT PICTURE INTO :Img_hdl FROM EMPLOYEE WHERE NAME='Anne Dupont'; /* Catalogage de l'image*/ rc=QbCatalogImage( CatHdl, /* descripteur du catalogue */ Img_hdl); /* descripteur de l'image */
Utilisez l'API QbCatalogColumn ou la commande CATALOG QBIC COLUMN
pour cataloguer manuellement une colonne d'images. L'extension Image catalogue uniquement les images ajoutées, mises à jour ou supprimées depuis le dernier catalogage de la colonne. Elle les catalogue pour toutes les caractéristiques du catalogue. Le catalogue QBIC doit être ouvert en mise à jour avant le catalogage manuel d'une colonne d'images.
Utilisation de l'interface API : Lors de l'utilisation de l'API QbCatalogColumn, précisez le descripteur du catalogue. L'extension Image utilise les images de la colonne de la table utilisateur associée au catalogue spécifié.
Par exemple, l'appel d'API suivant catalogue les images non cataloguées d'une colonne d'une table utilisateur associée au catalogue indiqué. Les images sont cataloguées pour toutes les caractéristiques du catalogue :
QbCatalogHandle CatHdl; rc=QbCatalogColumn( CatHdl); /* descripteur du catalogue */
Utilisation de la ligne de commande : Lancez la commande CATALOG QBIC COLUMN pour cataloguer manuellement une colonne d'images. Vous pouvez également l'utiliser pour recataloguer des images (reportez-vous à la section Recatalogage d'images). Spécifiez les paramètres FOR et NEW (qui sont les paramètres par défaut).
Dans l'exemple ci-après, cette commande sert à cataloguer les images décataloguées de la colonne de la table associée au catalogue ouvert. Les images sont cataloguées pour toutes les caractéristiques du catalogue :
CATALOG QBIC COLUMN FOR NEW