< Anterior | Siguiente >

Utilización de Perl

Ejecute cqperl.exe o ratlperl.exe para utilizar el paquete Perl (CQPerlExt) de la API de ClearQuest.
Todas las aplicaciones externas escritas en Perl deben empezar con una de las sentencias siguientes:
require CQPerlExt; 
o
use CQPerlExt; 

En la versión 2003.06.00 y posteriores, puede utilizar la API de Rational ClearQuest con cqperl.exe o ratlperl.exe para aplicaciones externas. Si utiliza cqperl, se añaden implícitamente las vías de acceso de inclusión correctas a CQPerlExt.pm (el paquete Perl que proporciona la API de Rational ClearQuest). En el sistema UNIX y Linux, cqperl no se puede utilizar en la sentencia use o require de los scripts Perl. Si utiliza ratlperl en el sistema UNIX y en Linux, debe establecer la vía de acceso correcta. Por ejemplo, puede utilizar el archivo binario ratlperl, que se encuentra en el directorio /opt/rational/common, como por ejemplo /opt/rational/common/linux_x86/bin.

No puede utilizar CQPerlExt.pm con Perl estándar en lugar de ratlperl o cqperl. Si necesita efectuar la integración con otros módulos, debe compilarlos para la versión suministrada de ratlperl.

Convenios de notación para Perl:
  • El prefijo para objetos a los que la API de Rational ClearQuest puede acceder a través de su paquete CQPerlExt es CQ. Por ejemplo, CQEntity $CQPerlExt::CQ
  • El prefijo para las constantes enumeradas de Perl es CQPerlExt::CQ. Por ejemplo, $CQPerlExt::CQ_DB2 para el valor de constante DatabaseVendor de DB2.

Las constantes enumeradas de Rational ClearQuest se cargan previamente y están disponibles para utilizarse en enganches de campo y scripts globales. Sin embargo, para utilizar las constantes en una aplicación externa, debe añadir las definiciones de constante al programa antes de poder utilizarlas en el programa, o los valores no se establecerán.

Punto de comprobación de la lección

Ahora que ha revisado algunos de los requisitos de programación con la API de ClearQuest, está preparado para obtener más información sobre el objeto Session de la API de ClearQuest y cómo empezar a programar con la API.
< Anterior | Siguiente >

Comentarios