Revert

Descrizione

Elimina qualsiasi modifica effettuata all'oggetto Entity.

Utilizzare questo metodo per uscire dalla transazione che ha consentito la modifica del record. È necessario richiamare questo metodo se si è tentato di modificare un record e se il metodo Validate ha restituito una stringa di errore.

È possibile richiamare questo metodo solo se l'oggetto Entity è editabile. Per rendere un oggetto Entity esistente modificabile, richiamare il metodo EditEntity dell'oggetto Session. Se si richiama questo metodo su un oggetto Entity appena creato, dopo che è stato creato con il metodo BuildEntity, questo metodo cancella l'inoltro del record.

Questo metodo ripristina i campi dell'oggetto Entity con i valori memorizzati nel database. Dopo aver eseguito l'operazione, l'oggetto Entity non è più modificabile, quindi è necessario richiamare nuovamente il metodo EditEntity per eseguire nuove modifiche.

Sintassi

VBScript

entity.Revert 

Perl

$entity->Revert(); 
Identificativo
Descrizione
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
Valore di ritorno
Nessuno.

Esempi

VBScript

Dim entityToEdit
set sessionObj = GetSession
set entityToEdit = sessionObj.GetEntity ("Defect", "SAMPL00000002")
sessionObj.EditEntity entityToEdit, "modify"
' ...make modifications to the entity object
' Revert the changes to the record
entityToEdit.Revert 

Perl

# Get the current session
$sessionobj = $entity->GetSession();

# Select an entity to modify
$entityobj = $session->GetEntity("defect","BUGID00000042");
# Take the modify action on the entity object
$sessionobj->EditEntity($entityobj,"modify");
# ...make modifications to the entity object
# Revert the changes
$entityobj->Revert();
# At this point, the entity object is no longer modifiable 

Feedback