CreateDirectories

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug ExternalDocument >

CreateDirectories

Crea in una sola operazione una o più strutture gerarchiche di cartelle in una Configurazione di JamioPlug ExternalDocument, riutilizzando i nodi già esistenti.

 

Metodo

PlugExternalDocument/CreateDirectories

 

Input

Nome

Descrizione

Tipo

Opzionale

token

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

String

Y

configurationReference

Collegamento alla risorsa di tipo configurazione del Plug ExternalDocument che determina la root operativa.

E' possibile specificare un collegamento in cui è valorizzata solo la proprietà Name con il Nickname di una configurazione esistente.

Reference

 

directories

Lista di percorsi relativi da costruire rispetto alla root operativa della configurazione Plug ExternalDocument.

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

List of String

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Lista di Dati strutturati (uno per ciascun nodo elaborato) che contengono i seguenti campi:

•InputDirectory: testo che contiene il nome della directory di input a cui appartiene il nodo;

•Path: testo che indica il percorso relativo del nodo elaborato;

•ReusedFolder: valore booleano che indica se il nodo esisteva già. True per un nodo preesistente e False per un nodo creato;

•WebUrl: testo che riporta l'URL della cartella restituito dal provider;

•FolderReference: collegamento alla cartella elaborata.

List of Dataset


 

Commenti

I nodi mancanti vengono creati, mentre i nodi già presenti vengono riutilizzati senza errore.

I nomi dei nuovi nodi vengono normalizzati secondo le regole Jamio. Il metodo non applica metadati alle cartelle create.

 

Il metodo si comporta come segue:

Restituisce

Condizione

DataSet

Se directories contiene "A/B/C" e nessun nodo esiste, vengono create A, A/B e A/B/C. Per ciascun nodo ReusedFolder è false e vengono restituiti FolderReference e WebUrl.

DataSet

Se il parametro directories contiene "A/B/C" e A e A/B esistono già, A e A/B vengono riutilizzati, A/B/C viene creato, ReusedFolder è true per A e A/B e false per A/B/C.

DataSet

Se il parametro directories contiene più path, vengono elaborati tutti i nodi necessari e ogni elemento di output indica InputDirectory e Path.

DataSet

Se un nodo contiene un nome non valido, il nome viene normalizzato secondo le regole Jamio prima della creazione.

Errore

Se la root o un nodo necessario non può essere utilizzato, viene restituito l'errore specifico di creazione.

Errore

Se si verificano accesso negato, destinazione inesistente, limiti di gerarchia/path o ProviderError.

 

 

Autorizzazioni

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