SetFileBusinessMetadataByReference

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

SetFileBusinessMetadataByReference

Imposta o aggiorna i metadati di business di un file individuato tramite il suo collegamento nella Configurazione di JamioPlug ExternalDocument.

 

Metodo

PlugExternalDocument/SetFileBusinessMetadataByReference

 

Input

Nome

Descrizione

Tipo

Opzionale

token

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

String

Y

fileReference

Collegamento del file.

Reference

 

folderPath

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

String

Y

fileName

Nome del file utilizzato nel fallback.

String

Y

metadataProfile

Profilo metadati; per Microsoft SharePoint è il ContentType.

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 del file; per Microsoft SharePoint corrisponde al ContentType e l'aggiornamento può essere parziale.

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

DataSet


 

Commenti

Il metodo tenta prioritariamente la lettura del file tramite il suo collegamento.

Il file deve essere individuato univocamente.

Se il parametro metadataProfile non viene specificato viene mantenuto quello corrente.

 

Il metodo si comporta come segue:

Restituisce

Condizione

Metadati aggiornati tramite fallback

Se il parametro fileReference non è più risolvibile, ma folderPath e fileName individuano il file.

Errore NotFoundMetadataProfile

Se il valore assegnato al parametro metadataProfile non esiste.

Errore InvalidMetadataProfile

Se  il parametro metadataProfile è diverso dal profilo.

Errore NotAllowedBusinessMetadata

Se un metadata presenta nome tecnico o tipo non ammesso.

Errore NotAppliedMetadata

Se il provider non riesce ad applicare metadati validi.

 

Autorizzazioni

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