UpdateFileByReference

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

UpdateFileByReference

Sostituisce il contenuto di un file individuato tramite il suo collegamento, usando il percorso della cartella e il nome del file come fallback nella Configurazione di JamioPlug ExternalDocument.

 

Metodo

PlugExternalDocument/UpdateFileByReference

 

Input

Nome

Descrizione

Tipo

Opzionale

token

Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto).

String

Y

fileReference

Collegamento al file da aggiornare.

Reference

 

folderPath

Percorso utilizzato nel fallback. Il carattere "/" deve essere utilizzato come separatore tra i nodi della gerarchia.

String

Y

fileName

Nome del file utilizzato nel fallback.

String

Y

newFile

Nuovo contenuto del file.

File/Stream Reference

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

•FileReference: collegamento al file corrente dopo l'aggiornamento.

•WebUrl: campo di tipo testo che riporta l'URL corrente.

DataSet


 

Commenti

Il metodo tenta prioritariamente la lettura del file tramite il suo collegamento.

Il contenuto viene sostituito mantenendo l'identità documentale, ove supportato.

 

Il metodo si comporta come segue:

Restituisce

Condizione

Viene aggiornato il file individuato tramite fallback.

Se il parametro fileReference non è più risolvibile e folderPath e fileName individuano un file.

Errore InvalidFileInput

Se newFile non identifica uno stream valido.

Errore FileNotFound

Se il file non viene individuato viene restituito.

Errore MultipleFilesFound

Se il fallback individua più file viene restituito.

 

Autorizzazioni

Per eseguire il metodo e necessario possedere il permesso di Utilizzo sulla Configurazione del Plug ExternalDocument.