Gizli
Gizli alanlar, yanıtlayıcıya hiçbir zaman gösterilmeyen değerleri saklar — bağlam iletmek, verileri önceden doldurmak veya ara sonuçları saklamak için kullanılır.
Bir hidden alan, yanıtlayıcıya hiçbir zaman gösterilmeyen bir değer saklar. Bir değeri hesaplayan calculate‘in aksine, hidden dışarıdan sağlanan bir değeri taşımak için kullanılır — örneğin, form başlatıldığında enjekte edilen bir görev kimliği, başka bir sistemden iletilen bir hane kimliği veya bir sayımcı kodu.
Temel XLSForm Tanımı
| type | name | label |
|---|---|---|
| hidden | household_id |
Ekranda hiçbir şey görüntülenmediğinden gizli alanlar için etiketler zorunlu değildir.
Kullanım Alanları
Gizli alanlar yaygın olarak şunlar için kullanılır:
- Anket yönetim sisteminden önceden atanmış bir kimlik iletme (örn. hane kimliği, vaka numarası, görev kodu)
- Form sürümünü veya dağıtım meta verilerini saklama
- Form başlatıldığında sayımcıya özgü yapılandırma enjekte etme
- Bağlantılı iş akışlarında üst formdan alt forma veri taşıma
- Form bir web bağlantısı aracılığıyla açıldığında URL parametrelerinden türetilen bir değeri saklama
Varsayılan değer ayarlama
En yaygın kalıp, form açıldığında değerin ayarlanması için hidden ile default ifadesi kullanmaktır:
| type | name | default |
|---|---|---|
| hidden | deployment_code | ‘ZONE_A_2024’ |
| hidden | form_version | ‘3.1’ |
Hesaplamalarda gizli alana başvurma
Gizli değerlere ${fieldname} kullanılarak diğer alanlar gibi başvurulabilir:
| type | name | label | calculation |
|---|---|---|---|
| hidden | zone_code | ||
| calculate | label_prefix | concat(’[’, ${zone_code}, ‘] ‘) | |
| note | intro | ${label_prefix} Hane anketine hoş geldiniz |
Gizli ile ön doldurma / URL parametrelerini kullanma
Bir web formunu URL aracılığıyla başlatırken, gizli alanları dolduran parametreler iletebilirsiniz. Bu, sayımcının yazmadan bir hane kimliği veya görev kodunu önceden yüklemenizi sağlar:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
household_id adlı alan otomatik olarak H00123 ile doldurulur.
En İyi Uygulamalar
- Değer dışarıdan enjekte edildiğinde ve yeniden hesaplanmaması gerektiğinde
calculatedeğilhiddenkullanın. - Değer formdaki diğer alanlardan türetildiğinde
calculatekullanın. - Gizli alanın bir değere sahip olması gerekiyorsa her zaman
defaultayarlayın — varsayılanı olmayan bir gizli alan boş kalır. - Gizli alanları ayırt etmek için açık adlandırın (örn.
_hidden_öneki ekleyin veya tutarlı bir adlandırma kuralı kullanın).
Sınırlamalar
- Gizli alanlar dışa aktarılan verilere diğer alanlar gibi dahil edilir.
- Koşullu olarak gösterilemezler — her zaman mevcuttur (ancak görünmez).
- Dinamik olarak hesaplanan bir alana ihtiyaç duyuyorsanız
calculatekullanın.