폼
폼 문제 해결과 게시 전 시험
필드 구성, 조건, 초안, 보안 링크, 중복 제출, 표 필터와 저장 대상을 게시 전에 시험하세요.
운영 폼을 바꾸기 전에는 별도 시험 조직이나 합성한 고객을 사용하세요. 실제 고객 답변을 오류 보고서나 화면 캡처에 복사하지 마세요.
시험 준비하기
- 폼을 여세요. 시험할 폼의 슬러그, Mode, Access와 활성을 기록하세요.
- 사용자 필드에서 같은 폼이 선택된 필드를 찾으세요.
- 정상 입력, 필수값 누락, 조건의 각 경로와 중복 제출에 사용할 합성값을 준비하세요.
- 제출 뒤 비교할 고객과 예약을 각각 새 탭에 여세요.
- 응답을 열어 초안과 최종 기록을 비교할 준비를 하세요.
| 시험값 묶음 | 반드시 포함할 상태 | 확인할 결과 |
|---|---|---|
| 정상 | 모든 표시 필수값이 유효함 | 한 번 제출되고 완료 문구가 나타납니다. |
| 필수값 누락 | 표시 중인 필수 필드 한 개가 비어 있음 | 해당 필드 아래에 오류가 나타납니다. |
| 조건 닫힘 | 기준 답이 후속 필드를 숨김 | 숨긴 필드 없이 제출됩니다. |
| 조건 열림 | 기준 답이 후속 필드를 표시 | 표시된 필드의 필수 규칙이 적용됩니다. |
| 중복 | 같은 제출을 빠르게 두 번 실행 | 고객 또는 예약 한 건만 변경됩니다. |
게시 전 시험하기
- 폼의 Mode, Access, Static Fields와 활성을 다시 확인하세요.
- 사용자 필드의 대상, 키, 설명, Field Group, 공개 범위, 필수와 폼을 확인하세요.
- 휴대전화와 컴퓨터 너비에서 폼을 각각 여세요.
- 이름, 이메일과 전화번호가 각각 한 번만 표시되는지 확인하세요.
- 필수 필드를 비운 채 제출하고 필드 아래의 안내를 확인하세요.
- 모든 조건을 켰다 끄면서 숨겨진 필드가 제출을 막지 않는지 확인하세요.
- 값을 입력한 뒤 새로고침하고 초안이 복원되는지 확인하세요.
- 같은 제출을 빠르게 두 번 실행해 고객이나 예약이 하나만 바뀌는지 확인하세요.
- 만료된 보안 링크와 이미 제출한 링크가 변경을 허용하지 않는지 확인하세요.
- 제출 뒤 고객과 예약에 기대한 값만 들어갔는지 확인하세요.
- 사용자 필드 열에서 제출값을 검색하거나 필터하세요.
- 자동화에 사용할 계획이라면 워크플로우에서 작은
limit의custom.<key>조회로 시험 행만 선택하세요. - AI 버튼에 연결했다면 대화에서 필수값, 조건과 제출 전 확인을 시험하세요.
- 고객 로그인을 제공한다면
/account에서 본인의 예약, 초안과 제출만 보이는지 시험하세요.
증상별 확인 항목
| 증상 | 확인할 설정 | 다음 행동 |
|---|---|---|
| 폼을 찾을 수 없음 | Active, Slug, 현재 조직과 지점 | 폼을 활성화하고 해당 조직에서 링크를 다시 복사합니다. |
| 링크를 복사하거나 만들 수 없음 | 폼 변경 권한, 활성 상태, 필드 구성 | 권한을 확인하고 구성 오류를 먼저 수정합니다. |
| 예상한 필드가 없음 | Target, Visibility, Kind, Forms | 대상과 폼 범위를 맞추고 공개 가능한 종류인지 확인합니다. |
| 필드가 모든 폼에 보임 | Forms | 공통 필드가 아니라면 사용할 폼 슬러그를 하나 이상 추가합니다. |
| 이름, 이메일 또는 전화번호가 중복됨 | 고객 사용자 필드의 Key | 기본 필드와 겹치는 사용자 필드를 삭제하거나 다른 실제 고객 속성으로 바꿉니다. |
| 예약 정보가 고객에 저장됨 | 사용자 필드의 Target | 방문마다 달라지는 필드는 Reservations로 다시 만듭니다. |
| 고객 정보가 예약에 복제됨 | 사용자 필드의 Target | 계속 유지할 고객 속성은 Customers로 한 번만 정의합니다. |
| 조건부 필드가 항상 보임 | Show When의 기준 키와 값 | 실제 선택지와 같은 기준키=값을 사용합니다. |
| 조건부 필드가 전혀 안 보임 | 기준 종류, 중복 키, 중첩 조건 | 기준을 Select 또는 Switch로 만들고 기준 자체의 조건을 지웁니다. |
| 숨겨진 필드가 제출을 막음 | 조건과 Required | 새 링크에서 다시 시험하고 잘못된 조건 구성을 수정합니다. |
| 예약 제출에서 전화번호 오류가 남 | 새 입력값과 기존 고객 전화번호 | 연락 가능한 전화번호를 예약자 정보에 입력합니다. |
| 보안 링크를 만들 수 없음 | 고객, 대상 예약, 지점, 만료 시각 | 같은 지점의 고객과 해당 고객의 예약을 선택합니다. |
| 초안이 복원되지 않음 | 주소의 resume, 만료, 최종 제출 상태 | 제출 전 재개 주소를 사용하고 만료되었다면 새 링크를 만듭니다. |
| 제출 후 값이 잘못된 기록에 있음 | Mode, 필드 Target, 링크의 고객과 예약 | 폼을 비활성화하고 올바른 소유 구조로 새 폼을 시험합니다. |
| 표에서 필드를 찾을 수 없음 | 현재 조직, 사용자 필드 대상, 열 표시 상태 | 올바른 표를 열고 보기에서 사용자 필드 열을 표시합니다. |
| Markdown이 일반 텍스트처럼 보임 | Kind와 저장값 | Kind를 Markdown으로 정하고 공개 폼과 관리자 편집에서 같은 표시를 확인합니다. |
| 파일을 공개 폼에서 열 수 없음 | Kind, Visibility, 업로드 주소 | File과 Public을 확인하고 민감하지 않은 합성 파일로 다시 시험합니다. |
| AI가 잘못된 질문이나 선택지를 사용함 | 연결한 Form, 필드 정의와 Prompt | Prompt의 중복 질문을 지우고 실제 Form과 사용자 필드를 수정합니다. |
| AI가 성공이라 했지만 응답이 없음 | 대화의 Form 목표와 응답 상태 | 완료로 처리하지 말고 대화와 응답을 함께 조사합니다. |
| 고객 로그인 제공자가 없음 | 로그인용 계정의 Platform과 Connected 상태 | 계정에서 OAuth 로그인을 연결합니다. |
| 계정에 예약 변경이 없음 | 예약 상태와 활성 Update Target 폼 | 같은 조직에 Token 예약 변경 폼을 하나 활성화합니다. |
구성 오류는 공개 입력을 중단합니다
중복 키, 기본 필드와의 충돌, 없는 기준값과 중첩 조건이 있으면 Laney는 잘못된 필드를 조건 없이 노출하지 않습니다. 링크 생성 또는 제출이 중단될 수 있습니다. 오류가 난 폼을 그대로 공유하지 마세요.
저장 무결성 확인하기
Profile Then Insert 폼을 시험했다면 고객과 예약을 나란히 확인하세요.
| 확인 위치 | 있어야 하는 값 | 없어야 하는 값 |
|---|---|---|
| 고객 | 이름, 이메일, 전화번호, 고객 대상 사용자 필드 | 이번 예약에만 해당하는 사용자 필드 |
| 예약 | 시작 시각, 메모, 예약 대상 사용자 필드, 연결된 고객 | 고객 사용자 필드의 복제본 |
| 응답 | 상태, 당시 폼 버전, 당시 필드 정의와 답변 | 다른 조직이나 지점의 값 |
결과 확인
- 정상 제출과 필수값 오류를 모두 재현했습니다.
- 기본 필드가 사용자 필드와 중복되지 않습니다.
- 조건부 필드를 보이는 상태와 숨긴 상태에서 시험했습니다.
- 새로고침 후 초안을 복원했습니다.
- 중복 제출, 만료와 재제출 제한을 확인했습니다.
- 고객과 예약의 값 소유자가 올바릅니다.
- 표 필터와 필요한 자동화 조회가 같은 사용자 필드 키를 사용합니다.
- 폼 목표 AI가 같은 필드 계약과 응답 원장을 사용합니다.
- 고객 계정에는 로그인한 고객의 기록만 표시됩니다.
이 항목 중 하나라도 확인하지 못했다면 폼을 게시하지 마세요. 이미 게시한 폼이라면 설정에서 폼을 열고 활성을 끄세요. 잘못된 설정을 수정하세요. 새 링크로 전체 시험을 다시 통과한 뒤 활성화하세요.
문제가 계속되면 전체 문제 해결에 폼 슬러그, 조직, 발생 시각과 재현 단계를 정리하세요. 실제 고객의 답변과 전체 보안 링크는 포함하지 마세요.