Apertura de un URL

El enganche global GSU_CQXE_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.

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.

Para utilizar la función de enganche global GSU_CQXE_OpenURL para abrir un URL, debe aplicar el paquete GlobalScriptUtility (GSU_CQXE) para actualizar el esquema con el código de enganche global.
  1. En ClearQuest Designer, pulse el botón derecho del ratón en la versión del esquema que desea aplicar al paquete y seleccione Paquetes > Aplicar paquete. Se abre el Asistente de paquetes.
  2. Expanda el nodo GlobalScriptUtility en la lista de paquetes y seleccione la versión 1.0. Pulse Siguiente.
  3. Seleccione los tipos de registro que donde desea aplicar el paquete. Pulse Finalizar.
El paquete GlobalScriptUtility ahora se aplica al esquema seleccionado. Para verificar la instalación del paquete, busca el nuevo script global GSU_CQXE en el esquema.

Para obtener más información sobre cómo aplicar paquetes, consulte Aplicación de paquetes.

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.

Ejemplos de Perl

sub Defect_Open_Url {
    my($result);
    my($param) = @_;
    # record type name is Defect
    
    $url="http://www.ibm.com";
    $msg="¿Quiere abrir un navegador en este URL?";
    my $session = $entity->GetSession();
GSU_CQXE_OpenURL($session,$url,$msg);
    return $result;
}

Ejemplos de 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 = "¿Quiere abrir un navegador en este URL?"	Defect_Open_Url=GSU_CQXE_OpenURL(session,url,message)
End Function

Comentarios