< Anterior | Próximo >

Usando Perl

Você pode usar o pacote de Perl da API do ClearQuest (CQPerlExt) pela execução do cqperl.exe ou ratlperl.exe.
Todos os aplicativos externos escritos em Perl deve iniciar com uma das seguintes instruções:
require CQPerlExt; 
ou
use CQPerlExt; 

Na versão 2003.06.00 e posterior, você pode usar a API do Rational ClearQuest com o cqperl.exe ou ratlperl.exe para aplicativos externos. Usar o cqperl implicitamente inclui os caminhos corretos de inclusão para o CQPerlExt.pm (o pacote do Perl que fornece a API do Rational ClearQuest). No sistema UNIX e Linux, o cqperl não pode ser usado na instrução use ou require nos scripts do Perl. Se você usar o ratlperl no sistema UNIX e Linux, você precisa configurar o caminho correto. Por exemplo, você pode usar o ratlperl binário, que está localizado no diretório /opt/rational/common, como /opt/rational/common/linux_x86/bin.

Você não pode usar o CQPerlExt.pm com o Perl padrão no lugar de ratlperl ou cqperl. Se for necessário integrar com outros módulos, você precisa construí-los para a versão enviada do ratlperl.

Convenções de notação do Perl:
  • O prefixo para objetos que a API do Rational ClearQuest pode acessar pelo pacote CQPerlExt é CQ. Por exemplo, CQEntity $CQPerlExt::CQ
  • O prefixo para constantes enumeradas do Perl é CQPerlExt::CQ. Por exemplo, $CQPerlExt::CQ_DB2 para o valor constante do DB2 DatabaseVendor.

As constantes enumeradas do Rational ClearQuest são pré-carregadas e disponíveis para uso nos ganchos de campo e scripts globais e de registro. Entretanto, para usar as constantes em um aplicativo externo, é necessário incluir as definições de constantes no programa antes de você poder usá-las no programa ou os valores não serão configurados.

Ponto de verificação da lição

Agora que você revisou alguns dos requisitos para a programação com a API do ClearQuest, você está pronto para saber sobre o objeto Session da API do ClearQuest e como começar a programar com a API.
< Anterior | Próximo >

Feedback