Apertura de un formulario rellenado previamente con la API GSU_CQXE_SubmitRecord

Descripción

Utilice el programa de utilidad del script global GSU_CQXE_SubmitRecord para abrir un formulario rellenado previamente desde un enganche. Esta API proporciona la misma funcionalidad que el enganche GSU_CQXE_OpenSubmitForm, aunque ofrece un mejor rendimiento porque no crea un objeto temp para la API que requiere un ID de base de datos.

Para utilizar la función de enganche global GSU_CQXE_SubmitRecord, debe aplicar el paquete GlobalScriptUtility (GSU_CQXE) para actualizar el esquema con el código de enganche global. Para obtener instrucciones para descargar el código de enganche global, consulte Aplicación de paquetes

Esta funcionalidad está disponible en los clientes de ClearQuest para Eclipse en la Web, Versión 7.1.2 o posterior. Si un usuario intenta abrir un formulario desde otro cliente, o desde el cliente de ClearQuest para Windows, la API devuelve un mensaje informativo. Para mostrar este mensaje al usuario, invoque la función die.

Si el cliente soporta esta función, el API lanzará una excepción y no se ejecutará ningún código después de la invocación del API. Utilice los enganches de devolución de llamada del script para ejecutar código adicional después de la invocación del API.

Nota: Para obtener ejemplos de código que ilustran cómo abrir formularios rellenados previamente, consulte Apertura de un formulario rellenado previamente.

Sintaxis

Perl

GSU_CQXE_SubmitRecord($session, $rcdType, $saveCallback, $cancelCallback, $fieldNameRef, $fieldValueRef)
Identificador
Descripción
$session
Sesión ClearQuest actual.
$rcdType
El tipo de registro que desea abrir.
$saveCallback
El script de registro adjuntado al registro original. Este script se ejecuta cuando el formulario de envío se guarda. Si no está prevista una devolución de llamada, especifique un valor vacío ("").
$cancelCallback
El script de registro adjuntado al registro original. Este script se ejecuta cuando se cancela el formulario de envío. Si no está prevista una devolución de llamada, especifique un valor vacío ("").
$fieldNameRef
Referencia a la matriz que contiene nombres de campos que se deben rellenar en el formulario ClearQuest. Los campos se establecen en el orden en el que aparecen en la lista. El orden puede ser importante para la validación si hay campos de lista de opciones dependiente.
$fieldValueRef:
Referencia a la matriz que contiene los valores utilizados para rellenar el formulario ClearQuest. El valor debe tener la misma longitud que $fieldNameArrayRef, de lo contrario la llamada devuelve una serie de error.

Ejemplos de Perl

sub Defect_SubmitChild {
    my($result);
    my($param) = @_;
    # record type name is Defect
    
    $session= $entity->GetSession();	
    my $id = $entity->GetFieldStringValue("id");   
    my $headline = $entity->GetFieldStringValue("Headline");

    my $fieldName = ["parent", "Headline"];
    my $fieldValue = [$id, $headline];
    $returnValue = GSU_CQXE_SubmitRecord($session, "Defect", "", "", $fieldName, $fieldValue);

    return $result;
}

Comentarios