|
<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > JamioPlug > JamioPlug ExternalDocument > CreateFileInFolderWithParentReference |
Crea un file in una cartella individuata tramite il suo collegamento, con fallback tramite il percorso della cartella nella Configurazione di JamioPlug ExternalDocument.
Metodo
PlugExternalDocument/CreateFileInFolderWithParentReference
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 padre. |
Reference |
|
folderPath |
Path simbolico utilizzato come fallback. Il carattere "/" deve essere utilizzato come separatore tra i nodi della gerarchia. |
String |
Y |
fileName |
Nome del file. |
String |
|
file |
File sorgente. |
File/Stream Reference |
|
overwrite |
Se True richiede la sovrascrittura di un eventuale file omonimo, se False viene applicata la policy naturale del provider. |
Boolean |
|
metadataProfile |
Profilo metadati. Per Microsoft SharePoint corrisponde al ContentType. |
String |
Y |
businessMetadata |
Dato Strutturato [NomeColonna, Valore] che contiene i metadati da aggiungere alla cartella. Per Microsoft SharePoint deve essere utilizzato il nome tecnico della colonna. |
Dataset |
Y |
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Dato Strutturato che contiene i seguenti campi: •FileReference: collegamento al file creato. •WebUrl: campo di tipo testo che riporta l'URL corrente del file. •Overwrite: campo di tipo booleano che indica se è stata eseguita una sovrascrittura. •FileName: campo di tipo testo che contiene il nome effettivamente assegnato al file. •AppliedMetadata: campo di tipo booleano che indica se i metadati ricevuti sono stati applicati. •MetadataError: lista degli errori relativi all'applicazione dei metadati. •MetadataProfile: campo di tipo testo che contiene il profilo corrente del file. •BusinessMetadata: dato strutturato che riporta i metadati correnti del file. |
DataSet |
|
Commenti
La creazione del file è prioritaria rispetto all'applicazione dei metadati.
Gli errori sui metadati non annullano il file creato. Per SharePoint metadataProfile coincide con il ContentType e businessMetadata puo essere applicato in modo parziale.
Se il parametro folderReference individua una cartella, il file viene creato nella cartella e viene restituito il dato strutturato di output.
Se il parametro folderReference non individua più la cartella e folderPath individua una cartella nella configurazione ricavata dal collegamento, il file viene creato tramite fallback.
Se esiste un file omonimo e il parametro overwrite è True, viene richiesta la sovrascrittura e Overwrite viene restituito come True se completata.
Se esiste un file omonimo e il parametro overwrite è False, viene applicato il comportamento nativo del provider e in FileName viene restituito il nome effettivo.
Se i metadati sono validi, vengono applicati dopo la creazione o sovrascrittura del file.
Se i metadati non sono applicabili, il file rimane creato e viene restituito AppliedMetadata False con dettaglio in MetadataError.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore |
Se la cartella non viene individuata, viene restituito FolderNotFound. |
Autorizzazioni
Per eseguire il metodo è necessario possedere il permesso di Utilizzo sulla Configurazione del Plug ExternalDocument.