eventoCondizioni di notifica
Questo evento viene notificato dal framework quando viene richiesto di memorizzare uno dei commenti di un documento. Solitamente viene generato a seguito della chiamata da codice della procedura SetComment del documento.
Utilizzo consigliato
L'evento deve memorizzare il commento su un database o una qualsiasi fonte dati a scelta e quindi restituire al chiamante l'identificativo del commento.
Argomenti
| Doc | Oggetto di tipo IDDocument che rappresenta il documento che ha richiesto il salvataggio di un proprio commento. |
| Comment Type | Stringa che rappresenta il tipo del commento, così come passata dalla funzione SetComment. Può essere vuota. |
| Language | Stringa che rappresenta la lingua del commento, così come passata dalla funzione SetComment. Può essere vuota. |
| Text | Stringa che rappresenta il testo del commento, così come passata dalla funzione SetComment. |
| Code | Stringa che rappresenta il codice identificativo del commento, così come passata dalla funzione SetComment. Può essere vuota. |
| Result | Parametro di output di tipo stringa. Può essere impostato sull'identificativo del commento. |
Esempio di codice
// ****************************************************************************
// Evento notificato dal framework quando viene richiesto di memorizzare un
// commento per il documento
// ****************************************************************************
event MyDocumentHelper.SetComment(
IDDocument Doc // Oggetto di tipo IDDocument che rappresenta il doc...
string CommentType // Stringa che rappresenta il tipo del commento, cos...
string Language // Stringa che rappresenta la lingua del commento, c...
string Text // Stringa che rappresenta il testo del commento, co...
string Code // Stringa che rappresenta il codice identificativo ...
inout string Result // Parametro di output di tipo stringa. Può essere i...
)
{
Commento c = new() // Creo il nuovo commento
c.init()
c.Code = Code
c.Language = Language
c.Type = CommentType
c.Text = Text
c.IDDoc = Doc.docID()
//
// Salvo il nuovo commento
try
{
c.saveToDB(...)
Result = c.ID
}
}
// Evento notificato dal framework quando viene richiesto di memorizzare un
// commento per il documento
// ****************************************************************************
event MyDocumentHelper.SetComment(
IDDocument Doc // Oggetto di tipo IDDocument che rappresenta il doc...
string CommentType // Stringa che rappresenta il tipo del commento, cos...
string Language // Stringa che rappresenta la lingua del commento, c...
string Text // Stringa che rappresenta il testo del commento, co...
string Code // Stringa che rappresenta il codice identificativo ...
inout string Result // Parametro di output di tipo stringa. Può essere i...
)
{
Commento c = new() // Creo il nuovo commento
c.init()
c.Code = Code
c.Language = Language
c.Type = CommentType
c.Text = Text
c.IDDoc = Doc.docID()
//
// Salvo il nuovo commento
try
{
c.saveToDB(...)
Result = c.ID
}
}
Si ricorda che il framework non stabilisce come devono essere memorizzati i commenti, ma solo la canalizzazione degli eventi ad essi relativi.
Ultima modifica: 25/10/2016 / Validità: da 11.5.5000