ReadFileByFolderReference

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

ReadFileByFolderReference

Legge un file a partire dal  suo nome e dal collegamento della cartella, usando il percorso della cartella come fallback nella Configurazione di JamioPlug ExternalDocument.

 

Metodo

PlugExternalDocument/ReadFileByFolderReference

 

Input

Nome

Descrizione

Tipo

Opzionale

token

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

String

Y

folderReference

Collegamento della cartella contenente il file.

Reference

 

folderPath

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

String

Y

fileName

Nome del file.

String

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

•FileReference: Collegamento del file.

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

•MetadataProfile: campo di tipo testo che contiene il profilo corrente del file; per Microsoft SharePoint corrisponde al ContentType.

•BusinessMetadata: dato strutturato che riporta i metadati correnti del file, esclusi i valori nulli.

DataSet


 

Commenti

Il metodo tenta prioritariamente l'individuazione del file tramite il collegamento della cartella.

Il parametro folderPath viene utilizzato come fallback quando folderReference non è più risolvibile.

Il file deve essere individuato univocamente.

Il metodo crea un allegato di processo e restituisce il Collegamento corrente del file.

 

Il metodo si comporta come segue:

Restituisce

Condizione

Un allegato di processo e il returnValue di output.

Se i parametri folderReference e fileName individuano un file, viene creato un attachment e viene restituito il dataset di output.

Un allegato di processo e il returnValue di output.

Se il parametro folderReference non è più risolvibile e folderPath e fileName individuano un solo file, il file viene letto tramite fallback.

Errore FileNotFound.

Se nessun file viene individuato.

Errore MultipleFilesFound.

Se vengono individuati più file.

 

Autorizzazioni

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