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 sobre cómo descargar el código de enganche global, consulte Aplicación de paquetes.

Esta funcionalidad está disponible en ClearQuest Client y cliente de ClearQuest Web, versión 7.1.2 o posterior. Si un usuario intenta abrir un formulario desde un cliente más antiguo o desde el cliente ClearQuest para Windows, la API devolverá 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)

Visual Basic

GSU_CQXE_SubmitRecord(session, rcdType, saveCallback, cancelCallback, fieldNameRef, fieldValueRef)

Identificador
Descripción
$session
Sesión actual de ClearQuest.
$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 se requiere respuesta, 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 se requiere respuesta, 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.

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

Ejemplo de Visual Basic

Function Defect_SubmitChild(param)
 ' param As Variant
 ' record type name is Defect
   Dim  session
   Dim id
   Dim headline
   Dim fieldName(2)'This sets up an array of three elements with subscripts from 0 to 1
   Dim fieldValue(2)'This sets up an array of three elements with subscripts from 0 to 1

   set session = GetSession 
   id = GetFieldStringValue("id")     
   headline =  GetFieldStringValue("Headline")

   fieldName(0) = "parent" 
   fieldName(1) = "Headline" 
   fieldValue(0) = id 
   fieldValue(1) = headline 
   call GSU_CQXE_SubmitRecord(session, "Defect", "","", fieldName, fieldValue)
    
End Function

Feedback