Release Lock

funzione copia link

Scopo

Questa funzione rilascia il lock sul documento. Se il documento non possedeva lock la funzione non ha alcun effetto.

Sintassi

boolean b = 0 // Il documento è stato sbloccato?
//
Documento := p.ReleaseLock(numero livelli)

Argomenti

Numero Livelli

Parametro opzionale intero con valore di default 9999. Indica di quanti livelli è possibile risalire la catena dei documenti padre se questo documento non gestisce il locking. E' opportuno non valorizzare questo parametro.

Valore di ritorno

Viene ritornato True se il lock è effettivamente stato rilasciato, False altrimenti. Normalmente il valore di ritorno di questa funzione non viene considerato.

Note

I pannelli DO rilasciano gli eventuali lock presi quando l'utente ha modificato i dati nei seguenti momenti:

L'utente salva i dati nel pannello.
L'utente annulla le modifiche ai dati del pannello.
L'utente chiude la videata.
L'utente chiude la sessione web, o comunque la sessione web scade o viene annullata.
Un progetto di esempio è disponibile a questo link.

Esempio di codice

// ****************************
// Called when a form is loaded
// ****************************
event Prodotto2.Load()
{
  Prodotto p = new() // What data will you store here?
  //
  // Carico il prodotto...
  p.Id := ONE
  p.LoadFromDB(??)
  //
  // Se posso modificare il prodotto...
  if p.GetLock(??, ??, ??)
  {
    p.BeginTransaction()
    //
    ... Eseguo le modifiche sul prodotto ...
    {
    }
    //
    // Concludo e salvo
    p.EndTransaction()
    p.SaveToDB(??, ??)
    //
    // E rilascio il lock
    p.ReleaseLock(??)
  }
}

Nell'esempio di codice viene esemplificata la procedura di modifica di un documento che tiene conto del locking. Al termine delle modifiche, dopo il salvataggio, è opportuno rilasciare il lock.

Ultima modifica: 20/09/2021 / Validità: da 6.5.2680