On this page
code
デフォルト値
rtSurveyのデフォルト値は、回答者が初めて質問に直面したときに質問を事前入力できます。この機能は一般的に選択されている初期値または期待される入力の例を提供することで、調査効率とデータ品質を大幅に向上させることができます。
基本的な使い方
デフォルト値を設定するには、XLSFormのdefault列を使用します:
| type | name | label | default |
|---------|-------------|-------------------------------|------------|
| date | survey_date | 調査日 | 2024-07-04 |
| decimal | weight | 回答者の体重?(kg) | 51.3 |
この例では、調査日は2024年7月4日で事前入力され、体重フィールドは51.3 kgで始まります。
動的デフォルト値
rtSurveyは関数を使った動的デフォルト値をサポートします:
| type | name | label | default |
|------|------|------------------------------------| ---------|
| date | d | イベントが発生した日付を入力してください? | today() |
ここでは、today()関数が自動的に今日の日付をデフォルトに設定します。
rtSurvey固有の機能
コンテキスト認識デフォルト
rtSurveyはコンテキスト認識デフォルトでデフォルト機能を拡張します:
| type | name | label | default |
|---------|----------|-----------------|---------------------|
| text | location | 現在地| ${current_location} |
これはデバイスのGPSに基づいて位置を事前入力するためにrtSurveyの${current_location}変数を使用します。
カスケードデフォルト
rtSurveyは以前の回答に基づくデフォルトを許可します:
| type | name | label | default |
|---------|----------|-----------------|-----------------|
| text | city | 市区町村 | |
| text | district | 地区 | ${city}-district|
ここでは、地区フィールドが入力された市区町村に基づいて事前入力されます。
繰り返し内のデフォルト
繰り返しグループ内の質問では、繰り返しが追加されたときにデフォルトが計算されます:
| type | name | label | default |
|--------------|-----------|--------------|------------------------|
| begin repeat | visits | クリニック受診| |
| date | visit_date| 受診日 | ${previous_visit_date} |
| end repeat | | | |
これにより受診日のデフォルトが前回の受診日に設定されます。
デフォルト使用のベストプラクティス
- 控えめに使用する:効率やデータ品質を大幅に向上させる場合にのみデフォルトを使用する。
- 正確性を確保する:静的デフォルト値を定期的にレビューして更新する。
- 徹底的にテストする:特に動的または計算されたデフォルトを使用する場合。
- ユーザーエクスペリエンスを考慮する:デフォルトが回答者を誤解させたりバイアスを導入しないことを確認する。
- 明確に文書化する:すべてのチームメンバーがデフォルト値の背後にある根拠を理解していることを確認する。
高度なデフォルトテクニック
ランダム化されたデフォルト
rtSurveyは特定の質問タイプのランダム化されたデフォルトをサポートします:
| type | name | label | default |
|-------------------|---------|--------------|-------------------|
| select_one options| choice | 1つ選択: | random(options) |
これにより’options’リストからデフォルトオプションがランダムに選択されます。
条件付きデフォルト
relevanceを使って条件付きデフォルトを設定する:
| type | name | label | default | relevant |
|---------|----------|----------|---------|-----------------|
| text | other | 指定する | N/A | ${q1} = 'other' |
ここでは、前の質問で’other’が選択された場合のみ’N/A’がデフォルトになります。
データ管理の考慮事項
- デフォルト値はデータエクスポートに含まれ、通常はデフォルト値であることを示すフラグが付きます。
- rtSurveyの監査証跡機能はデフォルト値が回答者によって変更されたときを追跡します。
モバイルアプリの動作
- rtSurveyモバイルアプリは動的およびコンテキスト認識デフォルトを含むすべてのデフォルト機能をサポートする。
- オフラインモードはリアルタイムデータに依存する一部の動的デフォルトに影響する場合がある。
既知の制限
- 複雑な計算されたデフォルトはフォームの読み込み時間に影響する場合がある(特に低スペックのデバイスで)。
- 一部の動的デフォルトはプレビューモードで期待通りに機能しない場合がある。
デフォルト値のトラブルシューティング
- デフォルトが表示されない:デフォルト式の構文エラーを確認する。
- 予期しない値:計算ロジックを確認してさまざまなシナリオでテストする。
- パフォーマンスの問題:複雑なデフォルト計算を最適化するか代替アプローチを検討する。
このページは役に立ちましたか?