CreateFromDatasetList

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