funzioneScopo
Esporta i dati del report in formato CSV e ritorna il percorso completo del file. Se richiesto apre il file nel browser dell'utente. Questa funzione viene chiamata quando l'utente preme il bottone Esporta nella toolbar del book, con il parametro Apri File a True.
Sintassi
string csvPath = Libro.Report.exportData(apri file)
Argomenti
| apri file | Parametro opzionale booleano. Se impostato a True (default) richiede l'apertura del file CSV nel browser dell'utente. |
Valore di ritorno
Viene ritornata una stringa che contiene il percorso completo del file CSV creato.
Esempio di codice
// ****************************************************************
// Evento notificato dal book prima di eseguire un comando di book.
// ****************************************************************
event Categorie.LibroCategorie.OnCommand(
int Command // E' un numero intero che rappresenta il comando ...
inout boolean Cancel // Può essere impostato a True per cancellare il c...
boolean UserOperation // E' un valore booleano che vale True se l'evento...
)
{
// Se il comando è di navigazione
switch (Command)
{
case Navigate:
...
case Export:
// Faccio io
Cancel = true
//
// Esporto il report che mi interessa
string fn = LibroCategorie.NuovoReport.exportData(false)
//
// Se l'esportazione è riuscita apro il file CSV
if (fn != "")
{
string file = right(fn, length(fn) - length(EsempiMS.path()) - 1)
EsempiMS.openDocument(file, [nuovafinestra], [caratteristichefines
tra])
}
break
}
}
// Evento notificato dal book prima di eseguire un comando di book.
// ****************************************************************
event Categorie.LibroCategorie.OnCommand(
int Command // E' un numero intero che rappresenta il comando ...
inout boolean Cancel // Può essere impostato a True per cancellare il c...
boolean UserOperation // E' un valore booleano che vale True se l'evento...
)
{
// Se il comando è di navigazione
switch (Command)
{
case Navigate:
...
case Export:
// Faccio io
Cancel = true
//
// Esporto il report che mi interessa
string fn = LibroCategorie.NuovoReport.exportData(false)
//
// Se l'esportazione è riuscita apro il file CSV
if (fn != "")
{
string file = right(fn, length(fn) - length(EsempiMS.path()) - 1)
EsempiMS.openDocument(file, [nuovafinestra], [caratteristichefines
tra])
}
break
}
}
- Il separatore utilizzato all'interno del file CSV dipende dal valore del parametro di applicazione UseDecimalDot: se il parametro vale True viene utilizzato, come separatore, il carattere ',' (virgola); se il parametro vale False viene utilizzato il carattere ';' (punto e virgola).
- Il file CSV viene creato nella sottodirectory temp dell'applicazione web in modo che sia visibile al browser.
- Il file creato viene considerato temporaneo (usando internamente la AddTempFile) e verrà cancellato al termine della sessione web in corso.
- Come intestazione dei valori vengono usati gli alias dei campi della query del report.
- Attraverso la proprietà di pannello ExportHeader è possibile definire un'intestazione personalizzata all'inizio del file, altrimenti verrà utilizzato il nome del pannello ed il QBETip.
Ultima modifica: 23/03/2021 / Validità: da 9.0.3940