ReadFolderMetadataByReference

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

ReadFolderMetadataByReference

Legge i dati di puntamento e i metadati di business di una cartella identificata tramite il suo collegamento nella Configurazione di JamioPlug ExternalDocument.

 

Metodo

PlugExternalDocument/ReadFolderMetadataByReference

 

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 ExternalDocument della cartella.

Reference

 

folderPath

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

String

Y

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

•FolderReference: collegamento corrente della cartella individuata.

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

•MetadataProfile: campo di tipo testo che contiene il profilo metadati 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 la lettura della cartella tramite il suo collegamento.

Il fallback mediante folderPath viene eseguito solo se il collegamento non individua più la cartella e utilizza la configurazione contenuta nel collegamento.

 

Il metodo si comporta come segue:

Restituisce

Condizione

•FolderReference: valorizzato.

•WebUrl: valorizzato.

•MetadataProfile: valorizzato.

•BusinessMetadata: valorizzato.

Se il parametro folderReference individua la cartella.

•FolderReference: valorizzato con contiene gli identificativi correnti.

•WebUrl: valorizzato con i riferimenti della cartella individuata simbolicamente.

•MetadataProfile: valorizzato con i dati della cartella individuata simbolicamente.

•BusinessMetadata: valorizzato con i dati della cartella individuata simbolicamente.

Se il parametro folderReference non individua più la cartella e il parametro folderPath individua la cartella nella configurazione del collegamento

Errore  FolderNotFound.

Se folderReference non individua la cartella e folderPath non è valorizzato o non individua la cartella.

 

Autorizzazioni

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