Numeri e precisione numerica

:::(Info)Following Release 306, Tulip is changing the way numbers are stored in Tables and Completion Records to support capturing, storing, and displaying trailing zeros.
:::

Il tipo di dati «Numero» è un numero reale (ad es. 53, 700, 506,2, 7,645). La precisione numerica di Tulip consente ai numeri di contenere zeri finali (ad es. 1,90; 7,300; 36,850; 419,38910).

Dettagli sulla precisione numerica

I dati numerici inseriti conservano gli zeri finali; i dati inseriti tramite gli Inputi numerici di Tulip mantengono gli zeri finali sia in fase di archiviazione che di visualizzazione in tutto l’ecosistema Tulip, fino a 20 cifre dopo la virgola. I valori inseriti con più di 20 cifre verranno arrotondati alla ventesima cifra più vicina; i dati delle tabelle vengono memorizzati in un nuovo tipo di dati preciso denominato "Postgres Decimal ", anziché in formato float.

**I dati dei record delle tabelle visualizzano tutte le cifre dopo la virgola.**Le tabelle visualizzano tutte le cifre dopo la virgola con dei puntini di sospensione alla larghezza della colonna. La precedente limitazione dell’interfaccia utente mostrava solo le prime 3 cifre nella vista a griglia. Per visualizzare tutte le cifre dopo la virgola, fare clic sul record della tabella.

I campi di immissione numerici e le espressioni possono controllare il numero di cifre decimali desiderate. Gli sviluppatori di app possono specificare e imporre il numero di cifre durante l’immissione e il calcolo tramite: * Una regola di convalida per i campi numerici per impostare il numero esatto di cifre decimali.

• Espressioni per la gestione delle cifre decimali degli input esterni (ad es. connettori, dispositivi, macchine, widget personalizzati) e per l’esecuzione di calcoli matematici. Queste espressioni includono ROUND() e GETDECIMALPLACES().
• Una nuova espressione, TOPLAINTEXT(), restituisce i decimali con precisione completa.

Maggiori informazioni su queste espressioni sono disponibili nella sezione seguente: Espressioni per la gestione della precisione.

Limiti e comportamento in caso di valori fuori intervallo

Valore massimo: JS MAX SAFE INT* Questo è il valore massimo standard per i dati numerici in JavaScript * Gestione dei valori fuori limite nell’API Tulip Tables: i dati in entrata superiori a questo valore genereranno un errore e non verranno memorizzati.

Numero massimo di cifre dopo la virgola: 20* Questo valore è superiore al numero di cifre nei numeri in virgola mobile (in precedenza Tulip supportava 15 cifre) e copre tutti i casi d’uso noti.* Gestione dei valori fuori intervallo nell’API Tulip Tables: i dati in entrata con più di 20 cifre verranno arrotondati alla ventesima cifra più vicina

Come funziona la precisione numerica con le altre funzionalità di Tulip?

I dati di input con zeri finali si applicano solo agli input numerici nelle app. Altri flussi di dati in Tulip gestiscono la precisione numerica in modo diverso:

Dati esterni

I dati in entrata tramite connettori, macchine, dispositivi e widget personalizzati vengono comunque inviati come stringhe o numeri in virgola mobile, a seconda del tipo di dati fornito dalla fonte. I dati numerici vengono convertiti in decimali Postgres al momento dell’archiviazione nelle tabelle Tulip e nei record di completamento.

Automazioni

Le Automation supporteranno gli zeri finali nel corso del 2025. Attualmente, le automazioni che eseguono calcoli non memorizzano gli zeri finali.

Espressioni per gestire la precisione

Gli sviluppatori di app possono gestire le cifre durante l’archiviazione dei numeri in Tulip utilizzando la seguente espressione.

ROUND()

Utilizzare ROUND() per specificare il numero desiderato di cifre decimali e aggiungere zeri finali prima di memorizzare il valore.:::(Internal) (Private notes)
insert screenshot of example expression]
:::

Gli sviluppatori di app possono gestire le cifre durante l’esecuzione di calcoli matematici, incluse medie e somme, utilizzando le seguenti espressioni.

GETDECIMALPLACES() e ROUND()

Utilizzare GETDECIMALPLACES() e/o ROUND() per gestire le cifre decimali dei risultati dei calcoli.

TOPLAINTEXT()

Utilizza TOPLAINTEXT() al posto di TOTEXT() per visualizzare tutte le cifre decimali di un valore numerico, compresi gli zeri finali. Questo perché TOTEXT() mantiene un'implementazione retrocompatibile per visualizzare i decimali precisi come numeri JavaScript (ovvero float) con una precisione massima di 16 cifre.

Dettagli tecnici

• Come parte di questo comportamento, le tabelle e i completamenti di Tulip sono passati dai "float" ai decimali precisi di Postgres, configurati per memorizzare fino a 20 cifre dopo la virgola.
• I dati numerici in entrata da tutte le fonti (ad es. app, API delle tabelle Tulip, connettori, ecc.) vengono memorizzati nelle tabelle Tulip come decimali Postgres e, al momento della memorizzazione, vengono arrotondati a un massimo di 20 cifre.

Dati storici

I dati raccolti prima della versione 306 sono stati completamente preservati, mantenendo invariati i valori numerici. Qualsiasi nuovo dato in entrata viene arrotondato a 20 cifre dopo la virgola.

Modifiche minori

Ci sono alcune modifiche relative a casi limite e avvertenze su come i numeri vengono gestiti nelle app dopo l’implementazione della precisione numerica, a causa delle differenze tra i decimali e i float:

1. Espressioni: i valori NaN e Infinity di JavaScript non esistono nei numeri decimali precisi; di conseguenza, le espressioni genereranno ora un errore in caso di errori matematici (ad es. calcolando la radice quadrata di un numero negativo o dividendo per 0). a. Ciò significa che gli sviluppatori di app potrebbero dover aggiornare qualsiasi logica per casi speciali che utilizzi i valori JS NaN e Infinity. Questi non sono supportati dall’interfaccia e sconsigliamo di utilizzarli per gestire casi limite matematici nelle vostre app.
2. Trigger: «Mostra messaggio» ora utilizza le virgolette per racchiudere i numeri a. Ciò significa che ora sarà possibile visualizzare gli zeri finali in «Mostra messaggio».
3. Tabelle: le esportazioni CSV ora mostrano i numeri completi (superiori a 1e6); in precedenza, il CSV utilizzava la notazione esponenziale per i numeri grandi (superiori a 1e6). a. Ciò significa che i vostri amministratori potrebbero dover aggiornare gli script di elaborazione dei file CSV per rimuovere eventuali casi particolari relativi all’elaborazione dei numeri esponenziali, qualora ne avessero.
4. Espressioni: TOTEXT e rappresentazione dei numeri – Se è necessario conservare gli zeri finali nella rappresentazione testuale, utilizzare la nuova espressione TOPLAINTEXT(), che racchiude i numeri tra virgolette per preservare gli zeri finali.a. Espressioni: TOTEXT() non racchiude i numeri tra virgolette e pertanto non conserva gli zeri finali. Utilizzate invece la nuova funzione TOPLAINTEXT() per visualizzare il numero completo con gli zeri finali, racchiuso tra virgolette.b. Stiamo introducendo TOPLAINTEXT() come nuova espressione per garantire la retrocompatibilità alle app che potrebbero aver utilizzato l’espressione TOTEXT().

Per qualsiasi domanda relativa alla gestione della precisione dei numeri, contatta il tuo responsabile del successo clienti Tulip oppure pubblica un post nel thread della Community.

Formattazione dei numeri e lingua

La formattazione dei numeri varia a seconda del paese, in particolare per quanto riguarda i separatori. Ad esempio, alcuni paesi (Stati Uniti, Messico, Cina) utilizzano un punto (.) come separatore decimale e una virgola (,) come separatore delle migliaia. Altri paesi (ad esempio in Europa) utilizzano una virgola (,) come separatore decimale.

In Tulip, questi formati numerici sono importanti nei seguenti contesti: 1. Quando si visualizza un numero a un utente di Tulip, il formato garantisce che gli utenti comprendano il valore corretto. 2. Quando si analizza un dato digitato da un utente, il formato garantisce che il valore corretto venga registrato nei dati di Tulip.

Il formato dei numeri è determinato dalla lingua corrente dell’utente, come definita nelle sue impostazioni personali. Se gli utenti non hanno scelto una lingua specifica, Tulip dedurrà la lingua in base alle impostazioni del browser.

Scopri come impostare la tua lingua preferita.

Formato numerico predefinito a partire dalla versione r360

All’interno della stessa lingua, potrebbero esserci discrepanze nel formato numerico utilizzato in diverse aree geografiche. Per comprendere questo comportamento, tieni presente quanto segue per la lingua desiderata:

Le seguenti lingue utilizzano di default la virgola ( , ) come separatore decimale:* Bulgaro* Ceco* Danese* Olandese* Estone* Finlandese* Francese* Tedesco* Greco* Ungherese* Indonesiano* Italiano* Lettone* Lituano* Norvegese* Polacco* Portoghese* Rumeno* Russo* Slovacco* Sloveno* Spagnolo* Svedese* Turco* Ucraino* Vietnamita

Per sovrascrivere questo comportamento, contatta l’amministratore di sistema o Tulip Support.

{{snippet.Hai trovato quello che cercavi?}}