<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > JamioPlug > JamioPlug Elastic Storage > CreateFromDatasetList |
Salva i Dataset o i collegamenti estesi presenti in una lista, in un indice del plug Elastic Storage.
La struttura dei singoli Dataset o collegamenti estesi può essere anche differente. Gli elementi che non riesce a salvare vengono restituiti opzionalmente in una lista di Dataset scartati.
Metodo
PlugElasticStorage/CreateFromDatasetList
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
token |
Il 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 Elastic Storage da utilizzare. E' possibile specificare un collegamento con valorizzata solo la proprietà Name pari al Nickname di una configurazione esistente. |
Reference
|
|
inputDataSetList |
Lista di dati strutturati o collegamenti estesi contenenti i valori da inserire in corrispettivi Dataset nell'indice del plug Elastic Storage. I valori vengono inseriti nell'indice solo al primo livello. Una descrizione generale della gestione dei diversi tipi di dati in un indice del plug Elastic Storage è consultabile qui Tra i campi di inputDataSetList è possibile specificare un campo identificativo secondo le logiche qui riportate. La lista non può contenere più di 2000 elementi. |
List of Dataset or List of Extended reference |
|
idFields |
Lista dei nomi dei campi con cui deve essere calcolato l'identificativo del Dataset dell'indice del plug Elastic Storage. I nomi devono riferirsi a campi di primo livello, non annidati. Il parametro è obbligatorio, ma viene ignorato se tra i campi del dato strutturato o collegamento esteso esiste un campo denominato "_id" o "Id", secondo le logiche qui riportate. Se inputDatasetList è di tipo collegamento esteso ed idFields è valorizzato con {id} l'identificativo del Dataset dell'indice del Plug Elastic Storage è valorizzato con l'id della risorsa a cui fa riferimento l'i-esimo collegamento esteso. |
List of String |
|
commonFields |
Dato strutturato che riporta un insieme di campi comuni, il cui valore deve essere riportato nei dati strutturati o nei collegamenti estesi della lista InputDataSetList. I campi devono essere di primo livello, non annidati. Se il campo specificato in CommonFields, non è presente nella struttura del dato strutturato o del collegamento esteso della lista InputDataSetList esso viene accodato, altrimenti viene sovrascritto. |
Dataset |
Y |
referenceField |
Se inputDatasetList è di tipo lista di collegamenti estesi, specifica in quale campo dell'indice del plug Elastic Storage deve essere riportato il collegamento alla risorsa a cui fa riferimento lìi-esimo collegamento esteso. Il campo deve essere al primo livello, non annidato. Se il campo è già presente nell'indice del plug Elastic Storage esso viene aggiornato, altrimenti accodato ai campi esistenti. Se inputDataset è una lista di dati strutturati il parametro viene ignorato. |
String |
Y |
skipErrors |
Indica se proseguire o meno quando un dato strutturato della lista inputDataSetList contiene campi che non sono del tipo ammesso. |
Boolean |
Y |
Output |
|||
Name |
Description |
Type |
Optional |
returnValue |
Dato strutturato con i seguenti campi: •IndexedItems: Numero di elementi inseriti; •ScrappedItems: lista dei dati strutturati che non è stato possibile indicizzare. |
Dataset |
|
Commenti
Durante l'elaborazione della lista InputDataSetList se:
•SkipErrors è uguale a false al primo controllo fallito, la procedura deve essere interrotta e deve essere restituita un'eccezione.
•SkipErrors è uguale a true tutti i Dataset che non è stato possibile convertire vengono accodati nella risposta alla lista ScrappedItems. Ad ogni Dateset della lista ScrappedItems viene aggiunto un campo ##Error## di tipo Error il cui valore è Error.Code = Plug_CreateFromDataSetList, Error.Description ="", Error.Message = la descrizione dell'errore.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore |
Se InputDataSetList contiene un campo che si chiama "_id" e un campo che si chiama "Id" |
Errore |
Se InputDataSetList contiene un campo che si chiama "_id" e questo è di tipo diverso da testo breve e numerico intero. |
Errore |
Se InputDataSetList contiene un campo che si chiama "Id" e questo è di tipo diverso da testo breve e numerico intero |
Errore |
Se i campi di IdFields non esistono in InputDataSetList. |
Errore |
Se i campi di IdFields sono diversi da testo breve e numerico intero, o si riferiscono a campi non di primo livello. |
Errore |
Se i campi di InputDataset non sono del tipo ammesso (testo breve, testo lungo, numerico intero, numerico a virgola mobile, numerico decimale, data e data/ora, booleano, collegamento). |
Errore |
Se CommonFields contiene campi del tipo non ammesso (testo breve, testo lungo, numerico intero, numerico a virgola mobile, numerico decimale, data e data/ora, booleano, collegamento). |
Errore |
Se il nome del campo referenceField è uguale al nome di un campo del dato strutturato o collegamento esteso riportato in InputDatasetList. |
Errore |
Se il nome del campo referenceField è uguale al nome di un campo di CommonFields. |
Autorizzazioni
Per eseguire il metodo è necessario possedere il permesso di Utilizzo sull'indice del Plug Elastic Storage.