API di piattaforma > JamioPlug > JamioPlug ExternalDocument

Rinomina un file individuato tramite il suo collegamento, con fallback tramite percorso della cartella e nome del file nella Configurazione di JamioPlug ExternalDocument.

Metodo

PlugExternalDocument/RenameFileByReference

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 del file.	Reference
folderPath	Percorso di fallback. Il carattere "/" deve essere utilizzato come separatore tra i nodi della gerarchia.	String	Y
fileName	Nome del file utilizzato nel fallback.	String	Y
newFileName	Nuovo nome da assegnare al file.	String
Output
Nome	Descrizione	Tipo	Opzionale
returnValue	Dato strutturato che contiene i seguenti campi: •FileReference: collegamento aggiornato del file rinominato. •WebUrl: campo di tipo testo che riporta l'URL corrente del file.	DataSet

Commenti

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

Il file deve essere individuato univocamente.

Il contenuto del file non viene modificato. Il valore assegnato al parametro newFileName deve essere valido secondo le regole del provider e di Jamio.

Il metodo si comporta come segue:

Restituisce	Condizione
Dato strutturato di output e il file viene rinominato.	Se il parametro fileReference individua il file e newFileName è valido.
Dato strutturato di output e il file viene rinominato tramite fallback.	Se il parametro fileReference non è più risolvibile, ma folderPath e fileName individuano il file.
Errore InvalidFileName.	Se il parametro newFileName non è ammesso.

Autorizzazioni

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