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