L'hook globale GSU_CQXE_OpenURL apre una finestra browser Web in un URL specificato. La funzione apre prima una finestra di conferma, di cui è possibile personalizzare il messaggio. Se l'utente fa clic su OK nella finestra, il browser si apre, se fa clic su Annulla, la finestra si chiude e viene nuovamente attivato il modulo record.
Questa funzionalità è disponibile sui client ClearQuest e ClearQuest Web. Se un utente tenta di aprire un modulo URL da un client obsoleto o dal client ClearQuest per Windows, l'API restituisce un messaggio informativo. Per visualizzare all'utente questo messaggio, richiamare la funzione die.
Per ulteriori informazioni sull'applicazione dei package, consultare Applicazione dei package.
Gli esempi che seguono rappresentano uno script record che è possibile utilizzare con gli hook globali per aprire un URL. In tali esempi, facendo clic sul pulsante OpenIBM si apre una finestra in cui viene richiesto se l'utente desidera aprire un browser all'URL specificato. Se l'utente fa clic su OK si apre una finestra browser a www.ibm.com, se fa clic su Annulla, la finestra si chiude.
sub Defect_Open_Url {
my($result);
my($param) = @_;
# record type name is Defect
$url="http://www.ibm.com";
$msg="Do you want to open a browser to this URL?";
my $session = $entity->GetSession();
GSU_CQXE_OpenURL($session,$url,$msg);
return $result;
}
Function Defect_Open_Url(param)
' param As Variant
' record type name is Defect
REM add your hook code here
Dim url
Dim message
set session = GetSession
url = "http://www.ibm.com"
message = "Do you want to open a browser to this URL?"
Defect_Open_Url=GSU_CQXE_OpenURL(session,url,message)
End Function