Differenze

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

--- apireference:struttura [2024/04/08 10:15] – marcomerlino
+++ apireference:struttura [2024/04/08 10:41] (versione attuale) – marcomerlino
@@ Linea 96: / Linea 96: @@
 Le funzioni di set andranno a sostituire il valore ove applicabile.
+**//langtext, langlongtext//**
+Saranno equivalenti ai campi "text" e "longtext" come caratteristiche, ma da un punto di vista di comunicazione JSON richiederanno che il dato venga suddiviso per locale, quindi, invece che avere una rappresentazione "campo":"valore" avranno una rappresentazione "campo":{"locale":"valore"}, le
+limitazioni si applicheranno al valore del singolo locale, sarà responsabilità del microservizio mapparli eventualmente su un repository monodimensionale
+Le funzioni di ricerca per questo campo saranno analoghe a quelle del tipo campo "text" e "longtext" con la possibilità, nel contesto di ricerca, di poter essere applicate:
+  * a tutti i locale
+  * solo al locale corrente
+  * solo al locale corrente o, in assenza di un valore nello stesso, a un locale di fallback specificato
+Le funzioni di set andranno a sostituire il valore del locale specificato 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.
+**//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)

API Reference Microservizi

Strumenti Utente

Strumenti Sito

Differenze

Strumenti Pagina