Πίνακες και πεδία
Οι στήλες ενός πίνακα είναι ένα κλειστό σύνολο έξι τύπων, καθένας με μετατροπή κατά την εισαγωγή, μαζί με τα ευρετήρια που κάνουν μια γραμμή εύκολα ανιχνεύσιμη.
Ένας πίνακας ορίζεται μία φορά, στο Xuda Studio, και κάθε σημείο που εμφανίζει τα δεδομένα του, το πλέγμα του Studio, η καρτέλα Δεδομένα του πίνακα ελέγχου, ένα πρόγραμμα Λήψη δεδομένων ή μια άμεση κλήση API, διαβάζει τους ίδιους ορισμούς πεδίων.
Αυτή η σελίδα καλύπτει τα πεδία όπως τα συναντάτε όταν φτιάχνετε και περιηγείστε σε έναν πίνακα. Για την πλήρη λίστα ιδιοτήτων, τα ευρετήρια, και πώς ένα πρόγραμμα Λήψη δεδομένων ή Ορισμός δεδομένων δείχνει σε έναν πίνακα, δείτε το Πίνακας στα Δομικά στοιχεία.
Έξι τύποι πεδίων, τίποτα άλλο
Κάθε πεδίο ενός πίνακα είναι ακριβώς ένας από έξι τύπους. Το Studio δείχνει τον καθένα με το δικό του εικονίδιο στην
επικεφαλίδα του πλέγματος αντί για κείμενο, αφού μια στήλη είναι στενή και ένα αναγνωριστικό πεδίου όπως ORD_Total
πιάνει ήδη το μεγαλύτερο μέρος του πλάτους:
Δεν υπάρχει έβδομος τύπος, ούτε τρόπος να προσθέσετε δικό σας. Ένα πεδίο που δεν ταιριάζει σε αυτούς τους έξι,
ένα μπλοκ εμπλουτισμένου κειμένου, ένα αρχείο, μια σχέση με άλλον πίνακα, μοντελοποιείται ως string (ένα αναγνωριστικό,
μια διαδρομή, ένα κωδικοποιημένο σε JSON αντικείμενο) ή ως array/object από αυτά. Δεν υπάρχει ξεχωριστός πρωτεύων
τύπος στήλης για κανένα από αυτά σε έναν πίνακα.
Τι κάνει πραγματικά κάθε τύπος με μια τιμή
Τόσο το dbs_create όσο και το dbs_update μετατρέπουν την τιμή που στέλνετε μέσω του δηλωμένου τύπου του πεδίου
πριν αποθηκευτεί, οπότε αξίζει να γνωρίζετε ακριβώς τι κάνει κάθε μετατροπή αντί να υποθέτετε μια
οικεία σημασία:
string
Οτιδήποτε δεν είναι ήδη string μετατρέπεται με απλή μετατροπή σε string. Μια κενή ή
απούσα τιμή αποθηκεύεται ως "".
number
Αποθηκεύεται το Number(value). Μια τιμή που δεν αναλύεται σε πεπερασμένο αριθμό επανέρχεται στο 0
αντί να απορρίψει την εγγραφή. Μια κενή ή απούσα τιμή αποθηκεύεται επίσης ως 0.
boolean
Μόνο μια σταθερή λίστα τιμών διαβάζεται ως true (Y, 1, true, TRUE, ON, YES), και μια άλλη
σταθερή λίστα ως false (N, 0, false, FALSE, OFF, NO). Οτιδήποτε άλλο, συμπεριλαμβανομένης μιας κενής
τιμής, αποθηκεύεται ως false.
object
Ένα string αναλύεται ως JSON5. Μια τιμή που έχει ήδη μορφή αντικειμένου αποθηκεύεται ως έχει. Μια κενή ή
απούσα τιμή, ή ένα string που δεν αναλύεται, αποθηκεύεται ως {}.
array
Ένα string αναλύεται πρώτα ως JSON5, και αν αποτύχει, αξιολογείται ως κυριολεκτικό JavaScript. Μια τιμή που
έχει ήδη μορφή πίνακα αποθηκεύεται ως έχει. Μια κενή ή απούσα τιμή, ή ένα string που καμία
ανάλυση δεν χειρίζεται, αποθηκεύεται ως [].
date
Δεν υπάρχει ειδικός χειρισμός ημερομηνίας κατά την εισαγωγή: όποιο string στείλετε αποθηκεύεται ακριβώς όπως
στάλθηκε. Επιλέξτε μία μορφή, το ISO 8601 (2026-09-25T00:00:00.000Z) είναι η ασφαλέστερη προεπιλογή, αφού τίποτα
στην πλατφόρμα δεν ομαλοποιεί ένα πεδίο ημερομηνίας για εσάς, και ένας πίνακας με μικτές μορφές ταξινομείται και φιλτράρεται
ασυνεπώς.
Η αποστολή μιας τιμής που δεν μπορεί να γίνει έγκυρος αριθμός για ένα πεδίο number δεν αποτυγχάνει την κλήση, αλλά
αποθηκεύει σιωπηλά 0. Επικυρώστε μόνοι σας μια αριθμητική τιμή πριν την εγγράψετε, αν το 0 θα ήταν λάθος.
Ονομασία πεδίων
Δεν υπάρχει επιβεβλημένος κανόνας ονομασίας πέρα από το ότι τα αναγνωριστικά πεδίων πρέπει να είναι μοναδικά στον πίνακα, αλλά κάθε πίνακας
που υπάρχει ήδη σε ένα project Xuda ακολουθεί μια σύμβαση: βάζετε σε κάθε πεδίο πρόθεμα με έναν σύντομο κωδικό για
τον ίδιο τον πίνακα, έτσι το ORD - Orders δίνει ORD_Id, ORD_Total, ORD_Status. Κρατά τα ονόματα πεδίων
σαφή όταν ένα ερώτημα, μια έκφραση ή ένα αρχείο εισαγωγής πρέπει να αναφερθεί σε πολλούς πίνακες
ταυτόχρονα.
Σήμανση ενός πεδίου ως υποχρεωτικού
Ένα πεδίο φέρει μια σημαία υποχρεωτικού που ορίζετε όταν το καθορίζετε, μαζί με τον τύπο και το σχόλιό του, για να καταγράψετε ότι μια γραμμή δεν προορίζεται να αποθηκευτεί χωρίς τιμή εκεί.
Οι πίνακες έχουν τη δική τους κατάσταση ενεργού/αρχειοθετημένου
Ξεχωριστά από το να αρχειοθετηθεί μια μεμονωμένη γραμμή (soft delete, δείτε Ερωτήματα δεδομένων μέσω του API), ένας ίδιος ο πίνακας μπορεί να είναι ενεργός ή αρχειοθετημένος ως κόμβος του Studio. Η καρτέλα Δεδομένα του πίνακα ελέγχου εμφανίζει τους πίνακες ενός project ως κάρτες, με δυνατότητα εναλλαγής μεταξύ Ενεργό και Αρχειοθετήθηκε, κάθε κάρτα δείχνοντας το όνομα του πίνακα και τον τρέχοντα αριθμό γραμμών του. Η αρχειοθέτηση ενός πίνακα εδώ είναι ενέργεια του Studio στον κόμβο, και είναι διαφορετική λειτουργία από την αρχειοθέτηση γραμμών μέσα σε αυτόν.