|
<< 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.