Condizioni di notifica
Questo evento viene notificato al documento durante il salvataggio in XML.
Utilizzo consigliato
Normalmente questo evento viene gestito quando occorre personalizzare il salvataggio del documento in XML. Può essere utile farlo, per esempio, se è richiesto un formato particolare dell'XML, diverso da quello che avrebbe l'XML se fosse generato dal sistema. L'evento permette infatti, dato il nome della classe, di indicare al sistema quale nome deve avere il corrispondente nodo XML che lo descrive.
Argomenti
Nome Interno | Parametro stringa. Rappresenta il nome della classe la cui istanza sta per essere salvata su XML. |
Tag Esterno | Parametro di output stringa. Rappresenta il nome che il sistema deve utilizzare per il nodo XML che descrive il documento. |
Esempio di codice
// ****************************************************
// Fired when a children document is being saved to XML
// ****************************************************
event Categorie.OnSaveXMLEntity(
string InternalName // Internal children document name (class name)
inout string ExternalTag // External XML name used to tag this entity
)
{
if CategorieDO.XML.Traduci = True
{
// Traduco l'XML in inglese
if InternalName = Categorie
{
ExternalTag := Categories
}
}
}
// Fired when a children document is being saved to XML
// ****************************************************
event Categorie.OnSaveXMLEntity(
string InternalName // Internal children document name (class name)
inout string ExternalTag // External XML name used to tag this entity
)
{
if CategorieDO.XML.Traduci = True
{
// Traduco l'XML in inglese
if InternalName = Categorie
{
ExternalTag := Categories
}
}
}
- Il sistema notifica questo evento per rispondere alla seguente domanda: "La classe NOMECLASSE in quale nodo XML deve essere scritta?". Normalmente il sistema assegna al nodo un nome uguale al nome della classe (senza spazi). Se, però, è richiesto un nome particolare per il nodo è possibile, tramite questo evento, indicare al sistema il nome del nodo XML che rappresenta il documento.
- Questo evento viene notificato anche per tutti i documenti figli di quello su cui è stata chiamata la procedura SaveToXML.
- Impostando il parametro TagEsterno a stringa vuota il documento non verrà inserito nel file XML.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680