Hidden

hiddenフィールドは回答者に表示されない値を格納します。calculate（値を計算する）とは異なり、hiddenは外部から提供された値を保持するために使用されます。たとえば、タスクID、別のシステムから渡された世帯ID、フォームが起動されたときに注入された調査員コードなどです。

基本XLSForm仕様 link

ラベルは、画面に何もレンダリングされないため、hiddenフィールドには必要ありません。

用途 link

Hiddenフィールドは一般的に以下に使用されます：

1. 調査管理システムからの事前割り当てIDの引き渡し（例：世帯ID、ケース番号、タスクコード）
2. フォームバージョンまたはデプロイメントメタデータの保存
3. フォーム起動時の調査員固有の設定の注入
4. リンクされたワークフローで親フォームから子フォームへのデータの引き渡し
5. フォームがWebリンク経由で開かれたときのURLパラメーターから取得した値の保存

デフォルト値の設定 link

最も一般的なパターンは、フォームが開いたときに値が設定されるようにdefault式と共にhiddenを使用することです：

計算でのhiddenフィールドの参照 link

Hidden値は${fieldname}を使用して他のフィールドと同様に参照できます：

prefill / URLパラメーターでのhiddenの使用 link

URLを介してWebフォームを起動する際に、hiddenフィールドに値を渡すパラメーターを指定できます。これにより、調査員が入力せずに世帯IDやタスクコードを事前入力できます：

  https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
  

household_idという名前のフィールドは自動的にH00123に設定されます。

ベストプラクティス link

1. 値が外部から注入される場合（再計算されるべきでない場合）はcalculateではなくhiddenを使用してください。
2. 値がフォーム内の他のフィールドから導出される場合はcalculateを使用してください。
3. hiddenフィールドに値が必要な場合は必ずdefaultを設定してください。デフォルトのないhiddenフィールドは空になります。
4. hiddenフィールドを区別するために明確な名前を付けてください（例：_hidden_プレフィックスまたは一貫した命名規則の使用）。

制限事項 link

• Hiddenフィールドは他のフィールドと同様に、エクスポートされたデータに含まれます。
• 条件付きで表示することはできません — 常に存在しますが非表示です。
• 動的に計算するフィールドが必要な場合は、代わりにcalculateを使用してください。