Ouverture d'une adresse URL

Le point d'ancrage global GSU_CQXE_OpenURL ouvre une fenêtre de navigateur Web à une adresse URL spécifiée. La fonction ouvre d'abord une boîte de dialogue de confirmation dont vous pouvez personnaliser le message. Si l'utilisateur clique sur OK dans la boîte de dialogue, le navigateur s'ouvre ; s'il clique sur Annuler, la boîte de dialogue se ferme et le focus retourne sur le formulaire de l'enregistrement.

Cette fonctionnalité est disponible dans le client ClearQuest et dans le client Web ClearQuest. Si un utilisateur tente d'ouvrir un formulaire URL dans un client antérieur ou dans le client ClearQuest for Windows, l'API renvoie un message d'information. Pour afficher ce message pour l'utilisateur, appelez la fonction die.

Pour utiliser la fonction du point d'ancrage global GSU_CQXE_OpenURL pour ouvrir une adresse URL, vous devez appliquer le package GlobalScriptUtility (GSU_CQXE) afin de mettre à jour votre schéma avec code du point d'ancrage global
  1. Dans ClearQuest Designer, cliquez avec le bouton droit de la souris sur la version du schéma dans laquelle vous souhaitez appliquer le package, puis sélectionnez Packages > Application du package. L'Assistant de packages s'ouvre.
  2. Développez le noeud GlobalScriptUtility dans la liste des packages et sélectionnez la version 1.0. Cliquez sur Next.
  3. Sélectionnez les types d'enregistrement où vous souhaitez appliquer le package. Cliquez sur Finish.
Le package GlobalScriptUtility est à présent appliqué au schéma que vous avez sélectionné. Pour vérifier l'installation du package, recherchez le nouveau script global GSU_CQXE dans le schéma.

Pour plus d'informations sur l'application de packages, voir Application de packages.

Exemples

Les exemples suivants vous montrent un script d'enregistrement que vous pouvez utiliser avec les points d'ancrage globaux pour ouvrir une adresse URL. Dans ces exemples, le fait de cliquer sur le bouton OpenIBM ouvre une boîte de dialogue qui demande à l'utilisateur s'il souhaite ouvrir un navigateur à l'adresse URL spécifiée. Si l'utilisateur clique sur OK, une fenêtre de navigateur s'ouvre à l'adresse www.ibm.com ; s'il clique sur Annuler, la boîte de dialogue se ferme.

Pour utiliser cet exemple, apportez les changements suivants à votre schéma:
  1. Créez un script d'enregistrement nommé Open_Url à l'aide de l'exemple en Perl ou en VBScript.
  2. Ajoutez un nouvel onglet nommé OpenURL au formulaire Defect_Base dans le type d'enregistrement Defect.
  3. Dans l'onglet OpenURL, ajoutez un nouveau contrôle Bouton nommé OpenIBM, puis associez-le au script d'enregistrement Open_Url.

Exemple de langage Perl

sub Defect_Open_Url {
    my($result);
    my($param) = @_;
    # le nom du type d'enregistrement est Défaut
    
    $url="http://www.ibm.com";
    $msg="Souhaitez-vous ouvrir un navigateur à cette adresse URL ?";
    my $session = $entity->GetSession(); 
    GSU_CQXE_OpenURL($session,$url,$msg);
    return $result;
}

Exemple de langage VBScript

Function Defect_Open_Url(param)
  ' param As Variant
  ' le nom tu type d'enregistrement est Defect
    REM add your hook code here
	Dim url
	Dim message
	set session = GetSession
	url = "http://www.ibm.com"
	message = "Souhaitez-vous ouvrir un navigateur à cette adresse URL ?"
	Defect_Open_Url=GSU_CQXE_OpenURL(session,url,message)
End Function

Feedback