Survey123 Connect는 XLSForm 사양을 사용하여 디자인된 양식을 Survey123에서 사용될 XForm으로 변환하고 ArcGIS Online 또는 ArcGIS Enterprise에 발행합니다. 이 프로세스 중에 몇 가지 문제가 발생할 수 있습니다.
팁:
현장조사 분석 도구는 현장조사의 XLSForm에 일반적인 문제가 있는지 확인하고 현장조사 디자인의 모범 사례에 대한 권장 사항을 제공합니다.양식 변환 오류
Survey123 Connect에서 현장조사를 작성하는 경우 스프레드시트를 사용하여 양식을 디자인하는 XLSForm 사양이 사용됩니다. Survey123 Connect는 스프레드시트를 XForm으로 변환하여 현장조사를 Survey123에 보이는 그대로 미리 볼 수 있도록 만듭니다.
다음 작업을 수행한 후 변환됩니다.
- 스프레드시트의 변경 내용을 저장합니다.
- Survey123 Connect에서 업데이트 버튼을 클릭합니다.
현장조사에 문제가 발행하면 양식 변환 서비스에서 보낸 오류 메시지가 나타납니다. 다음 예시의 오류 메시지에는 성이라는 이름 항목에 발생한 문제가 나와 있습니다. 이 경우에는 항목에 공백이 포함되어 있는 경우입니다. 공백을 제거하거나 밑줄 또는 대시로 바꾸어야 합니다.
다음 테이블에는 몇 가지 일반적인 양식 오류가 나와 있습니다.
| 오류 설명 | 진단 |
|---|---|
XLSForm 변환 오류 | 위의 오류 예시는 성이라는 질문을 강조합니다. 이 경우 오류는 이름 열에 있는 공백입니다. 현장조사 또는 선택 항목 워크시트의 이름 열에 비 ASCII 문자가 사용된 경우에도 이 오류 메시지가 나타납니다. ASCII 문자는 레이블 열에 사용할 수 있지만 이름 열에는 사용할 수 없습니다. |
[행 : 2] 목록 이름이 선택 항목 시트에 없음: [JobType] | 이 오류는 단답형 또는 선다형 질문 중 하나에서 참조하는 목록이 선택 항목 워크시트에 없음을 나타냅니다. 이 예시의 경우 괄호를 제거해야 합니다. |
이 질문에 대한 선택 항목이 존재해야 합니다. | 이 오류는 or_other 매개변수 유형이 추가로 지정된 단답형 또는 선다형 질문 중 하나에 선택 항목 필터도 정의되어 있음을 나타냅니다. Other 값을 입력하는 옵션이 포함된 선택 질문은 계단식 선택에 사용할 수 없습니다. |
네트워크 오류
양식 변환 서비스에 접근할 수 없는 경우 다음과 유사한 오류 메시지가 나타납니다.
다음 테이블에는 몇 가지 일반적인 네트워크 오류가 나와 있습니다.
| 오류 번호 | 오류 설명 | 진단 |
|---|---|---|
-1 | C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx를 열 수 없음 | Excel에서 이 파일이 잠겨져 있는 것일 수 있습니다. 다른 응용프로그램이나 다른 사용자도 이 현장조사를 열 수 없는지 확인하세요. |
3 | survey123.arcgis.com 호스팅을 찾을 수 없음 | 이전 버전의 Survey123 Connect를 실행하고 있습니다. 최신 버전으로 업그레이드합니다. |
6 | SSL handshake 실패 | SSL handshake 실패로 이어질 수 있는 여러 가지 문제가 있습니다.
SSL Labs와 같은 온라인 테스트를 사용하여 웹 서버에서 사용되는 SSL 인증서를 테스트할 수 있습니다. |
99 | 연결 시간 초과 | 초대형 현장조사를 사용할 때 가끔 발생합니다. 다시 시도하세요. |
202 | https://survey123.esri.com/api/xls2xform 다운로드 오류 - 서버 응답: 사용할 수 없음 | 메시지에 esri.com이 포함되어 있는 오류는 이전 서버를 가리킵니다. 최신 버전으로 업그레이드합니다. |
203 | https://survey123.esri.com/api/xls2xform 다운로드 오류 - 서버 응답: 찾을 수 없음 | 메시지에 esri.com이 포함되어 있는 오류는 이전 서버를 가리킵니다. 최신 버전으로 업그레이드합니다. |
401 | https://survey123.arcgis.com/api/xls2xform 다운로드 오류 - 서버 응답: 내부 서버 오류 | 이 오류는 일반적으로 관련성 또는 계산 열의 식에 의해 트리거됩니다. 문의 첫 자에 $ 심볼을 포함하고 중괄호를 사용합니다. |
403 | https://survey123.esri.com/api/xls2xform 다운로드 오류 - 서버 응답: 서비스를 일시적으로 사용할 수 없음 | 이 문제는 Esri에 즉시 보고해주세요. |
498 | 잘못된 토큰 | Survey123 Connect가 ArcGIS에 전달하려는 토큰이 승인되지 않았습니다. 이 문제는 토큰을 공개 피처 레이어에 전달하려는 제출 URL에 의해 주로 발생합니다. |
499 | https://survey123.arcgis.com/api/xls2xform 전송 오류 - 서버 응답: 프록시 오류 | Survey123 API를 사용할 수 없거나 시간이 초과되었습니다. 잠시 후 다시 시도하세요. 문제가 계속되는 경우 자세한 내용은 Survey123 Esri 커뮤니티를 참조하세요. |
오류 대화 상자에서는 오류를 캡처하여 Esri에 보낼 수 있습니다. 문제를 디버깅하는 데 도움이 될 수 있는 추가 정보를 이메일에 추가하세요.
발행 오류
이 오류는 주로 ArcGIS의 현장조사의 항목을 생성하는 문제에서 발생합니다.
다음 테이블에는 일반적인 발행 오류가 나와 있습니다.
| 오류 | 진단 |
|---|---|
제출 URL이 호환되지 않음(필드를 찾을 수 없음) | 이름 정의된 필드가 제출 URL에서 지정한 피처 레이어에 없습니다. 즉, 현장조사의 응답이 현장조사와 맞지 않습니다. 제출 URL을 할당 해제하고 새 제출 URL을 생성하거나 제출 URL이 올바른 피처 레이어에 연결되도록 합니다. 이 오류는 단답형 또는 선다형 질문에 대한 or_other 옵션을 사용할 때 생성된 추가 필드에 의해 주로 발생합니다. 자세한 내용은 선다형 질문 유형을 참고하세요. |
제출 URL이 호환되지 않음(요청 오류) | Survey123 Connect에 로그인한 사용자에게 피처 레이어 접근 권한이 있는지 확인하세요. |
SurveyName에 상위 repeat_1의 하위 키 필드가 없음 | 이 오류는 제출하려는 피처 레이어가 현장조사에 없는 global ID 상위 키를 사용하는 경우에 발생합니다. 발행 옵션 창에서 반복 릴레이션십에 Global ID 상위 키 사용을 true로 설정하세요. |
표 ‘y’의 열 ‘x’가 최대 개수인 1,024개를 초과하여 표 생성에 실패함 | 발행하려는 현장조사에 ArcGIS 기관의 피처 레이어에서 허용하는 필드(1,024개)보다 더 많은 필드가 있습니다. 1,024개보다 적게 필드 수를 줄이고 현장조사를 다시 발행하세요. 이러한 제한 사항에 대한 자세한 내용은 ArcGIS Online 도움말에서 문제 해결을 참고하세요. |
사용자 정의 피처 서비스 제출 URL이 이 현장조사와 호환되지 않음(피처 서비스가 supportsApplyEditsWithGlobalIds 반복이 있는 현장조사에 대한 요구 사항을 충족하지 않음) | supportsApplyEditsWithGlobalIds 등록정보가 false로 설정되어 있으나 이 값은 true로 설정되어야 합니다. 피처 레이어를 발행할 때 동기화를 활성화하여 이 작업을 쉽게 수행할 수 있습니다. |
사용자 정의 피처 서비스 제출 URL이 해당 현장조사와 호환되지 않음(테이블의 목적지 릴레이션십을 찾을 수 없음) | 현장조사의 반복이 피처 레이어의 릴레이트 테이블과 잘못 연결되었거나 해당 테이블이 존재하지 않습니다. 반복 이름이 목적지 릴레이트 테이블의 이름과 같은지 확인하세요. |
포털 오류
ArcGIS Enterprise에 발행된 현장조사에는 아래에 나열된 제한 사항이 있습니다. 이러한 제한 사항은 현장조사가 ArcGIS Online에 발행된 경우와는 다릅니다.
- end과(와) 같은 예약된 특정 키워드를 필드 이름으로 사용하는 현장조사는 ArcGIS Enterprise에 발행할 수 없습니다(endSurvey과(와) 같이 키워드와 같지 않은 필드 이름 필드 이름은 사용할 수 있음). 예약된 키워드는 Survey123 XLSForm 템플릿의 예약된 워크시트에 나열됩니다.
- ArcGIS Enterprise로 발행할 때는 모든 필드 이름이 소문자여야 합니다.
- 포털에 발행하는 피처 레이어가 포함할 수 있는 열의 최대 수는 엔터프라이즈 지오데이터베이스에 따라 다릅니다. 크기 한도를 결정하려면 데이터베이스 관리 시스템 설명서를 참고하세요. 현장조사의 질문 개수가 엔터프라이즈 지오데이터베이스의 열 제한을 초과하는 경우, 이러한 문제는 반복을 포함하고 repeat_count를 1로 설정하여 현장조사를 여러 테이블에 걸쳐 확장함으로써 해결할 수 있습니다.
- 현장조사 워크시트 내의 질문 이름은 32자 미만이어야 합니다.
- ArcGIS Data Store를 사용하지 않는 경우 Survey123 콘텐츠를 ArcGIS Enterprise 또는 Portal for ArcGIS에 업로드할 수 없습니다.
- ArcGIS Enterprise가 오프라인 환경에 배포된 경우에는 현장조사 템플릿, 샘플, ArcGIS Online 피처 레이어에 대한 제출 URL을 사용할 수 없습니다.
- 제출 URL은 페더레이션되지 않은 ArcGIS Server 피처 레이어와 함께 바로 사용할 수 없습니다. 이 문제는 서비스를 ArcGIS Online 또는 ArcGIS Enterprise에 등록하여 해결할 수 있습니다.
- 다중 사용자 지오데이터베이스를 사용하는 경우 레이어는 분기 버전 등록을 사용할 수 있지만 기존 버전 등록은 사용할 수 없습니다. Survey123은 분기 버전 등록된 지오데이터베이스를 사용할 때 기본 버전을 대상으로 합니다. 자세한 내용은 버전 관리 유형을 참고하세요.
- esriFieldTypeDateOnly, esriFieldTypeTimeOnly, esriFieldTypeTimestampOffset, esriFieldBigInteger은(는) ArcGIS Online에서만 사용할 수 있습니다. 해당 필드 유형은 ArcGIS Enterprise 11.2 이후 버전에서 사용할 수 있습니다.
진단 로깅 활성화
이 항목에 나와 있지 않은 오류 메시지나 기타 예기치 않은 동작이 발생하면 Survey123 Connect에서 정보 로그를 기록하여 Esri 지원 등과 공유하는 것이 문제 해결에 도움이 될 수 있습니다.
로깅을 활성화하려면 앱의 홈페이지에서 메뉴를 연 다음 설정을 클릭하고 진단 탭을 클릭합니다.
메시지를 파일에 캡처하려면 로깅 토글 버튼을 클릭하여 로깅을 활성화합니다. 로그 결과 위치 텍스트 상자는 기본 로그 파일 위치에 자동으로 채워집니다. 이 파일 경로는 편집할 수 있습니다. 메시지를 syslog 호환 콘솔에 온라인 방식으로 캡처하려면 로그 결과 위치 텍스트 상자에 로그 파일 위치 대신 해당 URL을 입력합니다.
로그 파일은 이메일로 전송하거나 공유할 수 있습니다. 앱에서 이메일로 로그를 전송하도록 선택하는 경우 앱 버전 번호, 운영 체제 이름, 시스템 로캘은 이메일 본문에 포함되며 로그는 첨부 파일로 포함됩니다.
비고:
실시간 로깅의 경우 진단 탭에는 네트워크에 현재 열려 있는 AppStudio 콘솔의 인스턴스가 표시됩니다. 실행 중인 AppStudio 콘솔이 발견될 때까지, 검색 중임을 나타내는 원형 심볼이 진단 탭에 나타납니다. AppStudio 콘솔을 먼저 선택한 다음, 로깅 토글 버튼을 클릭하면 로깅 정보가 해당 콘솔에 나타납니다. 자세한 내용은 ArcGIS AppStudio 도움말의 콘솔 결과 캡처를 참고하세요.