On this page
text_fields
Text
rtSurvey의 자유 텍스트 응답 질문 유형
text 질문 유형은 자유 텍스트 응답 — 모든 문자열을 수집합니다. 가장 유연한 입력 유형으로, 이름, 주소, 설명, 코드, 그리고 더 구체적인 유형에 맞지 않는 모든 것에 사용됩니다.
rtSurvey는 또한 시계 선택기로 정확한 시간 입력을 허용하는 시간 입력 위젯으로 text를 확장합니다.
기본 XLSForm 사양
| type | name | label |
|---|---|---|
| text | respondent_name | 응답자 전체 이름 |
| text | address | 집 주소 |
표준 XLSForm text 유형에 대한 자세한 내용은 XLSForm 사양을 참조하세요.
용도
Text 질문은 다음 용도로 사용됩니다:
- 이름, 주소, 자유 설명
- 개방형 의견 또는 피드백
- integer/decimal에 맞지 않는 코드, ID 또는 참조 번호
- rtSurvey의 시간 입력 확장을 사용하여 시간 값 수집
- 자동 완성 텍스트 필드 (
search-autocomplete-noedit-v2()사용)
표준 appearance 옵션
| Appearance | 설명 |
|---|---|
| (없음) | 단일 행 텍스트 입력 |
multiline | 여러 행 텍스트 영역 — 웹에서 더 긴 자유 텍스트에 적합 |
rtSurvey 시간 입력 확장
rtSurvey는 시간 값 수집을 위한 시계 선택기 위젯으로 text를 확장합니다. 이 appearance 옵션은 조사원이 탭하여 시, 분, 초 또는 밀리초를 선택할 수 있는 시계 아이콘을 표시합니다.
Appearance 변형
| Appearance | 설명 |
|---|---|
inline | 필드 옆에 시계 아이콘 표시 |
inline colors("RRGGBB") | 사용자 정의 16진수 색상의 시계 아이콘 |
inline-1line | 컴팩트 단일 행 형식의 시계 |
inline-1line-RRGGBB | 사용자 정의 아이콘 색상의 단일 행 (16진수, # 없이) |
inline-1line colors("RRGGBB","RRGGBB") | 두 가지 색상의 단일 행 |
inline-onlyresult | 선택 후 시계 아이콘이 사라지고 값만 표시 |
inline-onlyresult colors("RRGGBB") | 동일하지만 사용자 정의 아이콘 색상 |
시간 형식 토큰
표시할 시간 구성 요소를 제어하려면 괄호 안에 형식 문자열을 추가합니다:
| 형식 문자열 | 표시 |
|---|---|
inline-[%H:%M] | 시 및 분 (24시간) |
inline-[%h:%M] | 시 및 분 (12시간) |
inline-[%H:%M:%S] | 시, 분, 초 (24시간) |
inline-[%h:%M:%S] | 시, 분, 초 (12시간) |
inline-[%H:%M:%3] | 시, 분, 밀리초 |
inline-[%M:%S] | 분 및 초만 |
inline-[%M:%3] | 분 및 밀리초만 |
inline-[%S] | 초만 |
inline-[%3] | 밀리초만 |
inline-[%H] | 시만 (24시간) |
inline-[%h] | 시만 (12시간) |
예시: 분 및 초로 작업 시간 기록
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | 작업 완료에 걸린 시간 | inline-[%M:%S] |
예시: 사용자 정의 색상의 24시간 형식으로 이벤트 시간 기록
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | 이벤트 시간 | inline-1line colors("0099FF") |
데이터 형식
텍스트 데이터는 일반 문자열로 저장 및 내보내집니다. 인라인 시계 위젯을 사용하는 시간 기반 입력의 경우 선택한 형식 문자열과 일치하는 형식으로 값이 저장됩니다 (예: %H:%M의 경우 14:32).
제약 조건 및 유효성 검사
형식, 길이 또는 패턴을 강제하기 위해 제약 조건을 적용합니다:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | 전체 이름 | string-length(.) >= 2 | 이름은 최소 2자 이상이어야 합니다 |
| text | code | 참조 코드 | regex(., '^[A-Z]{2}[0-9]{4}$') | 대문자 2자 다음에 숫자 4자를 입력하세요 |
| text | phone | 전화번호 | regex(., '^[0-9]{9,15}$') | 유효한 전화번호를 입력하세요 |
모범 사례
- 데이터에 알려진 구조가 있을 때는 더 구체적인 유형 (
integer,decimal,date)을 사용합니다 — 잘못된 항목을 방지하고 분석을 단순화합니다. - 코드 또는 ID를 유효성 검사하기 위해
string-length()또는regex()가 있는constraint를 추가합니다. - 응답자가 여러 문장을 쓸 수 있는 개방형 질문에는
multilineappearance를 사용합니다. - 시간 수집의 경우 분석에 필요한 정밀도와 일치하는 시간 형식 토큰을 선택합니다 — 분만 필요할 때 밀리초를 수집하면 조사원의 노력이 낭비됩니다.
플랫폼 지원
text 질문 유형 및 모든 시간 입력 appearance는 iOS, Android 및 웹 플랫폼에서 지원됩니다.
제한 사항
- 텍스트 응답은 자유 형식입니다 — regex 패턴 외에는 내장된 맞춤법 검사나 어휘 제약이 없습니다.
- 인라인 시간 위젯은 rtSurvey 확장이며 표준 XLSForm 사양의 일부가 아닙니다.
이 페이지가 도움이 되었나요?