funzioneScopo
Questa funzione salva il documento in formato XML o JSON.
Sintassi
string result = "" // Risultato della funzione
//
result := Documento.SaveToXML(salva su file, nome file, numero livelli, formato, cross language)
//
result := Documento.SaveToXML(salva su file, nome file, numero livelli, formato, cross language)
Argomenti
| Salva su File | Parametro booleano che indica al sistema se occorre salvare su file (e restituire il percorso del file creato) o in memoria (e restituire il testo XML o JSON). |
| Nome File | Parametro opzionale stringa che indica il nome del file da utilizzare qualora il documento debba essere salvato su file (vedi parametro precedente). Se il parametro SalvaSuFile è False questo parametro non viene utilizzato. Se il parametro SalvaSuFile è True e questo parametro non viene specificato, il sistema crea un nuovo file con un nome casuale. |
| Numero Livelli | Parametro intero opzionale che specifica quali sottodocumenti devono essere salvati. Per default TUTTI i sottodocumenti modificati vengono salvati. |
| Formato | Formato in cui salvare: XML o JSON (parametro introdotto nella versione 13.0). |
| Cross Language | È un parametro booleano opzionale che indica se deve essere attivata la modalità di compatibilità del formato tra C#, Java e JavaScript (parametro introdotto nella versione 13.0). |
| Save Nulls | È un parametro booleano opzionale che indica se devono essere salvati anche i valori nulli e le collection vuote. Default: false. (parametro introdotto nella versione 18.0). |
Valore di ritorno
Viene restituita una stringa il cui significato dipende dal valore del parametro SalvaSuFile. Se il parametro vale True allora la funzione restituisce il percorso completo del file, se il parametro è False la funzione restituisce il testo XML o JSON.
Esempio di codice
// ************************************************************
// Describe what this procedure is used for
// ************************************************************
public void DOCategories.SaveToXML()
{
Categories cat = null //
//
cat := Categories.Document
XML.Text := cat.SaveToXML(False, ??, ??)
}
// Describe what this procedure is used for
// ************************************************************
public void DOCategories.SaveToXML()
{
Categories cat = null //
//
cat := Categories.Document
XML.Text := cat.SaveToXML(False, ??, ??)
}
- N.B.: Il sistema utilizza il Nome senza spazi per la classe ed il Codice per le proprietà.
- Se il parametro SalvaSuFile è False il parametro NomeFile non viene utilizzato dal sistema.
- Il parametro CrossLanguage determina il formato dei dati usato come riportato nella tabella seguente:
Tipo di dato / CrossLanguage true false boolean -1/0 True/False in C#
true/false in Java e JSdatetime yyyy-mm-dd hh:nn:ss formato della sessione utente senza secondi time hh:nn:ss formato della sessione utente senza secondi date yyyy-mm-dd formato della sessione utente DocID GUID DocID BLOB formato web
(es. data:image/png;base64,...)base64
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680