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