Apertura di un modulo prepopolato con l'API GSU_CQXE_SubmitRecord

Descrizione

Utilizzare il programma di utilità script globale GSU_CQXE_SubmitRecord per aprire un modulo prepopolato da un hook. Quest'API fornisce la stessa funzionalità dell'hook GSU_CQXE_OpenSubmitForm, ma fornisce prestazioni migliori in quanto non crea un oggetto temporaneo per l'API che richiede un ID database.

Per utilizzare la funzione hook globale GSU_CQXE_SubmitRecord, è necessario applicare il package GlobalScriptUtility (GSU_CQXE) per aggiornare lo schema con il codice hook globale. Per istruzioni sul download del codice hook globale, consultare Applicazione dei package.

Questa funzionalità è disponibile sui client ClearQuest e ClearQuest Web, Versione 7.1.2 o successiva. Se un utente tenta di aprire un modulo da un client obsoleto o dal client ClearQuest per Windows, l'API restituisce un messaggio informativo. Per visualizzare all'utente questo messaggio, richiamare la funzione die.

Se il client supporta questa funzione, l'API emette un'eccezione e il codice dopo la chiamata dell'API non verrà eseguito. Utilizzare gli hook di callback nello script per eseguire l'eventuale ulteriore codice dopo la chiamata dell'API.

Nota: per esempi di codice che illustrano come aprire i moduli prepopolati, consultare Apertura di un modulo prepopolato.

Sintassi

Perl

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

Visual Basic

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

Identificativo
Descrizione
$session
Sessione ClearQuest corrente.
$rcdType
Il tipo di record che si desidera aprire.
$saveCallback
Lo script di record allegato al record originale. Questo script viene eseguito al momento del salvataggio del modulo di inoltro. Se non è previsto alcun callback, specificare un valore vuoto ("").
$cancelCallback
Lo script di record allegato al record originale. Questo script viene eseguito quando il modulo di inoltro viene annullato. Se non è previsto alcun callback, specificare un valore vuoto ("").
$fieldNameRef
Riferimento all'array che contiene i nomi dei campi da popolare sul modulo ClearQuest. I campi sono impostati nell'ordine fornito in questo elenco. L'ordine potrebbe essere importante per la convalida se vi sono campi elenco di selezioni dipendenti.
$fieldValueRef:
Riferimento all'array che contiene i valori utilizzati per popolare il modulo ClearQuest. La lunghezza del valore deve essere uguale a quella di $fieldNameArrayRef, altrimenti, la chiamata restituisce una stringa di errore.

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

Esempio 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