El enganche global OpenURL abre una ventana de navegador web en un URL específico. La función primero abre un diálogo de confirmación, cuyo mensaje puede personalizar. Si el usuario pulsa Aceptar en el diálogo, se abre el navegador; si el usuario pulsa Cancelar el diálogo se cierra y se vuelve a enfocar el formulario de registro.
Para obtener las instrucciones de descarga del código de enganche global, consulte la note técnica 1432968 en http://www.ibm.com/support/docview.wss?&rs=939&uid=swg21432968.
Esta funcionalidad está disponible en los clientes de ClearQuest para Eclipse y la web. Si un usuario intenta abrir un URL desde un cliente más antiguo o desde el cliente ClearQuest para Windows, la API devuelve un mensaje informativo. Para mostrar este mensaje al usuario, invoque la función die.
Los ejemplos siguientes muestran un script de registro que puede utilizar con los ganchos globales para abrir un URL. En estos ejemplos, al pulsar un botón OpenIBM se abre un diálogo que pregunta si el usuario quiere abrir un navegador o el URL específico. Si el usuario pulsa Aceptar, se abre una ventana en www.ibm.com; si el usuario pulsa Cancelar, se cierra el diálogo.
sub Defect_OpenURL { 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_OpenURL(param) ' param As Variant ' record type name is Defect Dim url Dim message set session = GetSession url = "http://www.ibm.com" message = "Do you want to open a browser to this URL?" Defect_OpenURL=GSU_CQXE_OpenURL(session, url,message) End Function