Apertura de un URL

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.

Ejemplos

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.

Para utilizar este ejemplo realice los cambios siguientes en su esquema:
  1. Cree un script de registro llamado Open_Url, usando el ejemplo de Perl o VBScript.
  2. Añada una pestaña nueva llamada OpenURL al formulario Defect_Base en el tipo de registro Defect.
  3. En la pestaña OpenURL, añada un nuevo control de Button llamado OpenIBM y asócielo al script de registro Open_Url.

Perl examples

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

VBScript examples

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