On this page
eye-slash
Hidden
Hidden 필드는 응답자에게 표시되지 않는 값을 저장합니다 — 컨텍스트를 전달하거나, 데이터를 미리 채우거나, 중간 결과를 저장하는 데 사용됩니다.
hidden 필드는 응답자에게 표시되지 않는 값을 저장합니다. 값을 계산하는 calculate와 달리, hidden은 외부에서 제공된 값을 전달하는 데 사용됩니다 — 예를 들어 작업 ID, 다른 시스템에서 전달된 가구 ID, 또는 양식이 시작될 때 삽입되는 조사원 코드.
기본 XLSForm 사양
| type | name | label |
|---|---|---|
| hidden | household_id |
Hidden 필드는 화면에 아무것도 렌더링되지 않으므로 레이블이 필요하지 않습니다.
용도
Hidden 필드는 일반적으로 다음 용도로 사용됩니다:
- 설문 관리 시스템에서 미리 할당된 ID 전달 (예: 가구 ID, 사례 번호, 작업 코드)
- 양식 버전 또는 배포 메타데이터 저장
- 양식 시작 시 조사원별 구성 삽입
- 연결된 워크플로에서 부모 양식에서 자식 양식으로 데이터 전달
- 양식이 웹 링크를 통해 열릴 때 URL 매개변수에서 파생된 값 저장
기본값 설정
가장 일반적인 패턴은 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} 가구 설문에 오신 것을 환영합니다 |
미리 채우기 / URL 매개변수와 함께 hidden 사용
URL을 통해 웹 양식을 실행할 때 hidden 필드를 채우는 매개변수를 전달할 수 있습니다. 이를 통해 조사원이 직접 입력하지 않고도 가구 ID 또는 작업 코드를 미리 로드할 수 있습니다:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
household_id라는 필드가 자동으로 H00123으로 채워집니다.
모범 사례
- 값이 외부에서 삽입되고 재계산되어서는 안 될 때는
calculate대신hidden을 사용합니다. - 값이 양식의 다른 필드에서 파생될 때는
calculate를 사용합니다. - hidden 필드가 값을 가져야 하는 경우 항상
default를 설정합니다 — 기본값이 없는 hidden 필드는 비어 있습니다. - 구별을 위해 hidden 필드의 이름을 명확하게 지정합니다 (예:
_hidden_접두사 사용 또는 일관된 명명 규칙 사용).
제한 사항
- Hidden 필드는 다른 필드와 마찬가지로 내보낸 데이터에 포함됩니다.
- 조건부로 표시할 수 없습니다 — 항상 존재하지만 보이지 않습니다.
- 동적으로 계산되는 필드가 필요한 경우
calculate를 대신 사용합니다.
이 페이지가 도움이 되었나요?