Strumenti Utente

Strumenti Sito


apireference:struttura

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

Entrambe le parti precedenti la revisioneRevisione precedente
Prossima revisione
Revisione precedente
apireference:struttura [2024/04/08 10:21] marcomerlinoapireference:struttura [2024/04/08 10:41] (versione attuale) marcomerlino
Linea 117: Linea 117:
 override del valore di step per i campi date override del valore di step per i campi date
 Le funzioni di set andranno a sostituire il valore ove applicabile. Le funzioni di set andranno a sostituire il valore ove applicabile.
 +
 +**//date, datetime, time, timerange//**
 +Rappresentano unità di tempo, rappresentate in forma numerica nel seguente formato:
 +
 +  * "datetime": conterrà il numero di millisecondi (e non di secondi) dallo Unix Epoch (UnixEpoch)
 +  * "date": conterrà il numero di giorni dallo Unix Epoch
 +  * "time": conterrà il numero di millisecondi dalla mezzanotte
 +  * "timerange": conterrà il numero di millisecondi
 +
 +In tutto e per tutto gli stessi saranno trattati come dei campi "integer", non sarà possibile effettuare gli override del valore di step per i campi date
 +
 +Le funzioni di set andranno a sostituire il valore ove applicabile.
 +
 +**//boolean//**
 +Rappresenterà un campo booleano.
 +
 +Lo stesso in JSON sarà rappresentabile come boolean
 +
 +A livello di repository è possibile implementarlo in una serie di formati (BOOLEAN; BIT, CHAR(1), TINYINT, ...), ma è responsabilità del microservizio garantire la corretta conversione da/verso 
 +
 +l'interfaccia JSON
 +
 +Le funzioni di ricerca per questo tipo di campo sono quelle di uguaglianza ("eq"), diversità ("neq") esistenza ("isnotnull"), non esistenza ("isnull"), rispetto a un valore specificato.
 +
 +Le funzioni di set andranno a sostituire il valore ove applicabile.
 +
 +**//uuid[]//**
 +Rappresenta una relazione multipla tra oggetti
 +
 +la stessa sarà rappresentata in json tramite un array di descrittori
 +
 +la stessa sarà soggetta alla limitazione "multiuuid_max", se fosse bisogno supportare relazioni con molteplicità superiore occorrerà prevedete un sotto-modello di transizione
 +
 +la stessa sarà assunta come NON-ordinata.
 +
 +Le funzioni di ricerca per questo tipo di campo saranno: contiene ("has", considerato non a livello stringa ma a livello di contiene questo identificativo)
 +
 +Le funzioni di set andranno a sostituire il valore ove applicabile. In una successiva revisione di questa specifica sarà possibile estenderle con funzioni integrative di aggiornamento differenziale.
 +
 +=== Note aggiuntive sui tipi di campo ===
 +
 +Non sono previsti in questa specifica campi per rappresentare liste ordinate o alberi, che potranno essere descritti tramite sottomodelli di servizio in revisioni successive.
 +
 +Non sono previsti campi composti in questa specifica, ma potranno esser definiti in specifiche successive tipologie di campi che estendano le verifiche sui campi già esistenti (ad esempio: un campo tipo "prezzo" può porre in automatico uno step di 2 cifre su un campo positivenumber, un campo tipo "codicefiscale" può imporre delle verifiche di congruità su un campo text e un limite di 16 caratteri)
 +
 +
 +
apireference/struttura.1712571689.txt.gz · Ultima modifica: 2024/04/08 10:21 da marcomerlino