< Précédent | Suivant >

Utilisation de Perl

Vous pouvez utiliser le package Perl (CQPerlExt) de l'API ClearQuest en exécutant cqperl.exe ou ratlperl.exe.
Toutes les applications externes écrites dans Perl doivent commencer par l'une des instructions suivantes :
require CQPerlExt; 
ou
use CQPerlExt; 

Dans la version 2003.06.00 et les versions ultérieures, vous pouvez utiliser l'API Rational ClearQuest avec cqperl.exe ou ratlperl.exe pour les applications externes. cqperl vous permet d'ajouter implicitement les chemins d'inclusion corrects à CQPerlExt.pm (package Perl qui fournit l'API Rational ClearQuest). Sous UNIX et Linux, cqperl ne peut être utilisé dans l'instruction use ou require des scripts Perl. Si vous utilisez ratlperl sur un système UNIX ou Linux, vous devez définir le chemin d'accès approprié. Par exemple, vous pouvez utiliser ratlperl (binaire), situé dans le répertoire /opt/rational/common, tel que /opt/rational/common/linux_x86/bin.

Vous ne pouvez pas utiliser CQPerlExt.pm avec le langage Perl standard à la place de ratlperl ou cqperl. Pour intégrer d'autres modules, vous devez les générer pour la version actuelle de ratlperl.

Conventions de notation pour Perl :
  • Le préfixe pour les objets auxquels l'API Rational ClearQuest peut accéder via son package CQPerlExt est CQ. Par exemple, CQEntity $CQPerlExt::CQ
  • Le préfixe pour les constantes énumératives Perl est CQPerlExt::CQ. Par exemple, $CQPerlExt::CQ_DB2 pour la valeur constante du fournisseur de base de données DB2.

Les constantes énumératives Rational ClearQuest sont préchargées et disponibles pour être utilisées dans les points d'ancrage de zone ainsi que dans les scripts globaux et d'enregistrement. Toutefois, pour utiliser les constantes dans une application externe, vous devez ajouter les définitions de constante à votre programme pour pouvoir les utiliser dans le programme, faute de quoi les valeurs ne seront pas définies.

Point de contrôle de la leçon

Maintenant que vous avez revu certaines exigences relatives à la programmation avec l'API ClearQuest, vous pouvez apprendre à utiliser l'objet de session de l'API ClearQuest et à effectuer une programmation avec l'API.
< Précédent | Suivant >

Commentaire