SetFolderBusinessMetadataByReference

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

SetFolderBusinessMetadataByReference

Aggiorna i metadati di business di una cartella identificata tramite il suo collegamento, con fallback sul percorso simbolico nella Configurazione di JamioPlug ExternalDocument.

 

Metodo

PlugExternalDocument/SetFolderBusinessMetadataByReference

 

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 relativo alla configurazione contenuta nel collegamento. Il carattere "/" deve essere utilizzato come separatore tra i nodi della gerarchia.

String

Y

metadataProfile

Profilo metadati; ContentType per SharePoint.

String

Y

businessMetadata

Dato strutturato [NomeColonna, Valore] che contiene i metadati da aggiornare.

DataSet

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

•MetadataProfile: campo di tipo testo che contiene il profilo corrente della cartella dopo l'aggiornamento.

•BusinessMetadata: dato strutturato che riporta i metadati correnti della cartella, esclusi i valori nulli.

DataSet


 

Commenti

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

Il fallback mediante il parametro folderPath viene eseguito solo se il collegamento non individua più la cartella e utilizza la configurazione identificata dal Nickname contenuto nel collegamento.

Il valore assegnato al parametro metadataProfile, quando valorizzato, deve esistere e coincidere con il ContentType corrente. Se il parametro metadataProfile non viene valorizzato, viene mantenuto il ContentType corrente e la validazione avviene sulle colonne della Library.

E' possibile l'aggiornamento parziale dei soli campi ricevuti.

 

Il metodo si comporta come segue:

Restituisce

Condizione

Metadati vengono applicati alla cartella individuata simbolicamente.

Se il parametro folderReference non individua più la cartella, ma folderPath individua la cartella nella configurazione del collegamento, i metadati vengono applicati alla cartella individuata simbolicamente.

Errore FolderNotFound

Se i parametri folderReference e folderPath non consentono di individuare la cartella.

Errore NotFoundMetadataProfile

Se il parametro metadataProfile non esiste nella Library.

Errore InvalidMetadataProfile

Se il valore assegnato al parametro metadataProfile non coincide con il ContentType corrente.

Errore NotAllowedBusinessMetadata

Se  il parametro businessMetadata contiene un nome o un tipo non consentito.

Errore NotAppliedMetadata

Se il provider rifiuta l'aggiornamento.

 

Autorizzazioni

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