proceduraScopo
Apre un documento residente sul server web. Questa procedura può essere usata per aprire un sito tramite una speciale query string, un'altra applicazione web, un documento prodotto dall'applicazione e così via.
Sintassi
Applicazione.OpenDocument(documento, nuova finestra, caratteristiche finestra)
Argomenti
| Documento | Percorso completo del documento da aprire. Deve essere un documento raggiungibile dal browser via web. |
| Nuova finestra | Parametro booleano; se impostato a True (default) il documento verrà aperto in una nuova finestra browser. Si consiglia di non modificare l'impostazione predefinita. |
| Caratteristiche finestra | Caratteristiche della finestra da aprire. Consultare la documentazione della funzione javascript window.open, parametro windowFeatures. E' possibile usare il valore "save" per indicare al browser di scaricare un file su disco. E' anche possibile utilizzare il valore "system" per indicare, alla shell nativa, che occorre utilizzare il browser del dispositivo invece della shell. Nel caso si utilizzino le opzioni windowFeatures viene aperta una nuova finestra e non una nuova tab. |
Esempio di codice
// ************************************
// Apre il file selezionato nell'albero
// ************************************
public void FileSystem.Apri()
{
OggettoFS oggetto = null //
string NomeCompleto = "" //
//
oggetto := OggettoFS.Cast(FSTree.ActiveDocument)
NomeCompleto := oggetto.GetNamedPropertyValue(NomeCompleto)
//
EsempiMS.OpenDocument(Right(NomeCompleto, Length(NomeCompleto) - Length(Path()) - ONE), ??, ??)
}
// *********************************
// Forza l'utente a scaricare il CSV
// *********************************
public void FileSystem.ScaricaCSV()
{
// Fornisco all'utente il file forzandone il salvataggio su disco
FileSystem.openDocument("ordini.csv", true, "save")
}
// Apre il file selezionato nell'albero
// ************************************
public void FileSystem.Apri()
{
OggettoFS oggetto = null //
string NomeCompleto = "" //
//
oggetto := OggettoFS.Cast(FSTree.ActiveDocument)
NomeCompleto := oggetto.GetNamedPropertyValue(NomeCompleto)
//
EsempiMS.OpenDocument(Right(NomeCompleto, Length(NomeCompleto) - Length(Path()) - ONE), ??, ??)
}
// *********************************
// Forza l'utente a scaricare il CSV
// *********************************
public void FileSystem.ScaricaCSV()
{
// Fornisco all'utente il file forzandone il salvataggio su disco
FileSystem.openDocument("ordini.csv", true, "save")
}
- Il documento da aprire deve essere pubblico perchè deve essere apribile dal browser dell'utente.
- Più chiamate in sequenza di questa procedura all'interno della stessa richiesta hanno l'effetto di aprire solo l'ultimo documento.
- ATTENZIONE: se si attiva la funzionalità DeleteAfterDownload, l'applicazione cancella tutti i file aperti tramite questo metodo. Se il file mostrato all'utente non deve essere cancellato, è necessario utilizzare il metodo CopyFile per mostrare la copia e non l'originale.
-
Dalla versione 10.5 è possibile utilizzare la OpenDocument per servire un file all'utente forzandone lo scaricamento su disco. Per ottenere questo comportamento è sufficiente utilizzare come caratteristiche finestra la stringa "save" (Case Insensitive). Questo comportamento è stato implementato solo in RD3 e forza il browser a chiedere all'utente dove salvare il file.
Questo comportamento richiede che l'URL della OpenDocument si riferisca ad un File . - Il valore save del parametro Caratteristiche finestra è supportato dalla versione 10.5.
- Il valore system del parametro Caratteristiche finestra è supportato dalla versione 22.0.
- Se vengono impostate le opzioni windowFeatures il browser Chrome apre una nuova finestra ma non gestisce poi i parametri passati (per esempio le dimensioni della finestra).
- Per aprire i PDF remoti da un'applicazione offline è consigliato l'uso dell'opzione system per far gestire il flusso applicativo direttamente al browser predefinito.
Ultima modifica: 07/06/2024 / Validità: da 7.0.3200