API di piattaforma > JamioPlug > JamioPlug Elastic Storage

Salva i dati presenti in una lista, in un indice del plug Elastic Storage.

Metodo

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
inputList	Lista contenente i valori dei Dataset da creare nell'indice del plug Elastic Storage. La lista non può essere vuota o nulla. La lista può contenere solo i tipi supportati. Il tipo del campo creato è assunto pari al primo elemento della lista che viene indicizzato. Tra i campi di inputList è possibile specificare un campo identificativo secondo le logiche qui riportate. La lista non può contenere più di 2000 elementi.	List
fieldName	Nome del campo che caratterizza il campo del Dataset nell'indice del plug Elastic Storage.	String
idField	Parametro utile a determinare l'identificativo nell'indice del Plug Elastic Storage. Deve riferirsi a campi di primo livello, non annidati. A seconda del tipo di lista, per assegnare all'identificativo il valore del singolo campo, il parametro idField deve essere valorizzato con: •{itemValue} se il parametro inputList contiene una lista di stringhe o numerici; •{id} se il parametro inputList contiene una lista di collegamenti a risorse Jamio. In questo caso l'identificativo sarà il valore dell'id del collegamento.	String	Y
commonFields	Dato strutturato che riporta un insieme di campi comuni, il cui valore deve essere riportato nella lista inputList. I campi devono essere di primo livello, non annidati. Se il campo specificato in CommonFields, non è presente nella lista InputList esso viene accodato, altrimenti viene sovrascritto.	Dataset	Y
skipErrors	Indica se proseguire o meno quando un Dataset della lista inputList 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 che non è stato possibile indicizzare.	Dataset

Commenti

I tipi di lista supportati sono del tipo descritto in Definizioni e logiche.

Si sconsiglia di inserire come idFields {itemValue} dei campi di tipo testo lungo.

Se si utilizza come idFields {itemValue} e nella lista di input è presente una riga vuota, questa non viene riportata nell'indice.

Durante l'elaborazione della lista InputList 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 alla lista ScrappedItems in output. Ad ogni Dateset della lista ScrappedItems viene aggiunto un campo ##Error## di tipo Error il cui valore è Error.Code = Plug_CreateFromList, Error.Description ="", Error.Message = la descrizione dell'errore.

Il metodo si comporta come segue:

Restituisce	Condizione
Errore	Se IdFields contiene {itemValue} e la lista di input non è di tipo testo breve o numerico intero.
Errore	Se la lista passata al parametro InputList è vuota o nulla.
Errore	Se i valori in InputList 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
Errore	Se IdFields contiene {id} e InputList contiene una lista diversa da una lista di collegamenti.
Errore	Se IdFields contiene {id} e InputList contiene una lista di collegamenti esterni.

Autorizzazioni

Per eseguire il metodo è necessario possedere il permesso di Utilizzo sull'indice del Plug Elastic Storage.