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

inputDataset

Dato strutturato o collegamento esteso contenente i valori da inserire in un 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 inputDataSet è possibile specificare un campo identificativo, secondo le logiche qui riportate.

Dataset or Extended reference

idFields

Lista dei nomi dei campi con cui deve essere calcolato l'identificativo del Dataset da inserire nell'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 dati del dato strutturato o collegamento esiste un campo denominato "_id" o "Id", secondo le logiche qui riportate.

Se inputDataset è 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 il collegamento esteso.

List of String

referenceField

Se inputDataset è di tipo collegamento esteso, specifica in quale campo dell'indice del plug Elastic Storage deve essere riportato il collegamento alla risorsa a cui fa riferimento il 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 è un dato strutturato il parametro viene ignorato.

String

Y

Output

Name

Description

Type

Optional

returnValue

Collegamento al Dataset inserito nell'indice del plug Elastic Storage.

Le proprietà del collegamento sono così valorizzate:

•name: identificativo del Dataset;

•type: Dataset;

•url: /{repositoryId}/Plugs/{plugname}/{configuration}/Dataset/{id}.

Reference

Restituisce

Condizione

Errore

Se InputDataSet contiene un campo che si chiama "_id" e un campo che si chiama "Id"

Errore

Se InputDataSet contiene un campo che si chiama "_id" o "Id" e questo è di tipo diverso da testo breve e numerico intero.

Errore

Se i campi di IdFields non esistono in InputDataSet.

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 il campo identificativo generato con la concatenazione dei campi della lista di idFields supera il limite di 150 caratteri.

Errore

Se referenceField riporta il nome di un campo non presente nel collegamento esteso.

Errore

Se il nome del campo referenceField è uguale al nome di un campo del dato strutturato o collegamento esteso riportato in InputDataset.