Apertura di un URL

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 utilizzare la funzione hook globale GSU_CQXE_OpenURL per aprire un URL, è necessario applicare il package GlobalScriptUtility (GSU_CQXE) per aggiornare lo schema con il codice hook globale.
  1. In ClearQuest Designer, fare clic con il tasto destro del mouse sulla versione dello schema in cui si desidera applicare il package e selezionare Package > Applica package. Viene visualizzata la Procedura guidata package.
  2. Espandere il nodo GlobalScriptUtility nell'elenco dei package e selezionare la versione 1.0. Fare clic su Successivo.
  3. Selezionare i tipi di record in cui si desidera applicare il package. Fare clic su Fine.
Il package GlobalScriptUtility viene ora applicato allo schema selezionato. Per verificare l'installazione del package, cercare il nuovo script globale GSU_CQXE nello schema.

Per ulteriori informazioni sull'applicazione dei package, consultare Applicazione dei package.

Esempi

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.

Per utilizzare questo esempio, apportare le seguenti modifiche allo schema:
  1. Creare uno script record denominato Open_Url, utilizzando l'esempio Perl o VBScript.
  2. Aggiungere una nuova scheda denominata OpenURL al modulo Defect_Base nel tipo di record difetto.
  3. Sulla scheda OpenURL, aggiungere un nuovo controllo Pulsante denominato OpenIBM e associarlo allo script record Open_Url.

Esempi Perl

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;
}

Esempi VBScript

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

Feedback