funzioneScopo
Questa funzione ritorna una stringa che identifica univocamente il documento e che, quindi, può essere utilizzata come chiave di identificazione per tabelle comuni a più documenti. Se, ad esempio, si vuole utilizzare una unica tabella che contenga degli allegati ai documenti, è possibile utilizzare questa funzione per generare una chiave univoca per il campo che indica a quale documento appartiene un certo allegato.
Sintassi
string id = "" // Chiave del documento
//
id := Documento.DocID()
//
id := Documento.DocID()
Argomenti
Questa funzione non ha argomenti.Valore di ritorno
La stringa ritornata può essere calcolata in due modi diversi:
- Se per il documento è stato attivato il servizio di identificazione, allora la stringa ritornata contiene il valore del campo "DocID" del documento, campo sempre presente quando il servizio di identificazione è attivo.
- Altrimenti vengono concatenate tutte le proprietà che derivano da campi del database in chiave primaria, prefisse dal nome della classe.
Esempio di codice
// ********************************************
// Fired when the active row in a panel changes
// ********************************************
event Prodotti.Prodotto.OnChangeRow()
{
Prodotto p = null // Il prodotto selezionato
//
// Prendo il prodotto selezionato nel pannello
p := Prodotto.Document
//
// Se ce n'è uno...
if NOT(p IS Null Object)
{
// Scriviamo a video di che documento si tratta
Prodotto.Valore0.Caption := p.GetName(ZERO)
Prodotto.Valore1.Caption := p.GetName(ONE)
Prodotto.Valore2.Caption := p.GetName(C2)
Prodotto.Valore3.Caption := p.AsString()
Prodotto.Valore4.Caption := p.DocID()
}
}
// Fired when the active row in a panel changes
// ********************************************
event Prodotti.Prodotto.OnChangeRow()
{
Prodotto p = null // Il prodotto selezionato
//
// Prendo il prodotto selezionato nel pannello
p := Prodotto.Document
//
// Se ce n'è uno...
if NOT(p IS Null Object)
{
// Scriviamo a video di che documento si tratta
Prodotto.Valore0.Caption := p.GetName(ZERO)
Prodotto.Valore1.Caption := p.GetName(ONE)
Prodotto.Valore2.Caption := p.GetName(C2)
Prodotto.Valore3.Caption := p.AsString()
Prodotto.Valore4.Caption := p.DocID()
}
}
- Se è attivo il servizio di identificazione per il documento, allora la stringa ritornata è sempre lunga 20 caratteri e rappresenta un identificatore assoluto del documento.
- Altrimenti la lunghezza massima della stringa può variare in funzione del nome della classe e del numero di campi in chiave oltre che del loro contenuto. Inoltre non è garantita l'assolutezza del codice identificativo ritornato.
Ultima modifica: 23/03/2007 / Validità: da 6.5.2680