Hidden
Τα πεδία hidden αποθηκεύουν τιμές που δεν εμφανίζονται ποτέ στον ερωτώμενο — χρησιμοποιούνται για μεταφορά πλαισίου, προσυμπλήρωση δεδομένων ή αποθήκευση ενδιάμεσων αποτελεσμάτων.
Ένα πεδίο hidden αποθηκεύει μια τιμή που δεν εμφανίζεται ποτέ στον ερωτώμενο. Σε αντίθεση με το calculate (που υπολογίζει μια τιμή), το hidden χρησιμοποιείται για τη φόρτωση μιας εξωτερικά παρεχόμενης τιμής — για παράδειγμα, αναγνωριστικό εργασίας, αναγνωριστικό νοικοκυριού που περνά από άλλο σύστημα ή κωδικός απογραφέα που εισάγεται κατά την εκκίνηση της φόρμας.
Βασική προδιαγραφή XLSForm
| type | name | label |
|---|---|---|
| hidden | household_id |
Οι ετικέτες δεν απαιτούνται για πεδία hidden καθώς τίποτα δεν αποδίδεται στην οθόνη.
Χρήσεις
Τα πεδία hidden χρησιμοποιούνται συνήθως για:
- Μεταφορά προ-ανατεθειμένου αναγνωριστικού από το σύστημα διαχείρισης ερευνών (π.χ. αναγνωριστικό νοικοκυριού, αριθμός υπόθεσης, κωδικός εργασίας)
- Αποθήκευση έκδοσης φόρμας ή μεταδεδομένων ανάπτυξης
- Εισαγωγή συγκεκριμένης διαμόρφωσης απογραφέα κατά την εκκίνηση φόρμας
- Μεταφορά δεδομένων από γονική φόρμα σε θυγατρική σε συνδεδεμένες ροές εργασίας
- Αποθήκευση τιμής που προέρχεται από παραμέτρους URL κατά το άνοιγμα της φόρμας μέσω web link
Ορισμός προεπιλεγμένης τιμής
Το πιο κοινό πρότυπο είναι η χρήση hidden με έκφραση default ώστε η τιμή να οριστεί κατά το άνοιγμα της φόρμας:
| type | name | default |
|---|---|---|
| hidden | deployment_code | ‘ZONE_A_2024’ |
| hidden | form_version | ‘3.1’ |
Αναφορά πεδίου hidden σε υπολογισμούς
Οι τιμές hidden μπορούν να αναφερθούν όπως οποιοδήποτε άλλο πεδίο χρησιμοποιώντας ${fieldname}:
| type | name | label | calculation |
|---|---|---|---|
| hidden | zone_code | ||
| calculate | label_prefix | concat(’[’, ${zone_code}, ‘] ‘) | |
| note | intro | ${label_prefix} Καλώς ορίσατε στην έρευνα νοικοκυριού |
Χρήση hidden με προσυμπλήρωση / παραμέτρους URL
Κατά την εκκίνηση web φόρμας μέσω URL, μπορείτε να περάσετε παραμέτρους που συμπληρώνουν πεδία hidden. Αυτό σας επιτρέπει να προ-φορτώσετε αναγνωριστικό νοικοκυριού ή κωδικό εργασίας χωρίς ο απογραφέας να το πληκτρολογήσει:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
Το πεδίο με όνομα household_id θα συμπληρωθεί αυτόματα με H00123.
Βέλτιστες πρακτικές
- Χρησιμοποιήστε
hidden(όχιcalculate) όταν η τιμή εισάγεται εξωτερικά και δεν πρέπει να επανυπολογίζεται. - Χρησιμοποιήστε
calculateόταν η τιμή προκύπτει από άλλα πεδία της φόρμας. - Πάντα ορίζετε
defaultεάν το πεδίο hidden πρέπει να έχει τιμή — ένα πεδίο hidden χωρίς προεπιλογή θα είναι κενό. - Ονομάζετε τα πεδία hidden με σαφήνεια για να τα διακρίνετε (π.χ. πρόθεμα με
_hidden_ή χρησιμοποιήστε συνεπή σύμβαση ονοματολογίας).
Περιορισμοί
- Τα πεδία hidden συμπεριλαμβάνονται στα εξαγόμενα δεδομένα όπως οποιοδήποτε άλλο πεδίο.
- Δεν μπορούν να εμφανιστούν υπό συνθήκη — είναι πάντα παρόντα (αλλά αόρατα).
- Εάν χρειάζεστε πεδίο που υπολογίζεται δυναμικά, χρησιμοποιήστε
calculate.