Survey123 웹 앱은 현장 앱과 동일한 형식의 매개변수를 사용할 수 있습니다. 주의해야 할 한 가지 차이점은 현장조사의 항목 ID가 현장조사를 열기 위해 사용하는 다른 링크와 같이 URL 매개변수가 아닌 URL 경로의 일부라는 점입니다. 이 URL에 매개변수를 추가하는 경우 물음표를 사용하여 첫 번째 매개변수에서 경로의 현장조사 항목 ID를 구분한 다음 앰퍼샌드를 사용하여 후속 매개변수를 구분해야 합니다. 다음의 URL 예시는 성 및 좌표 매개변수를 Survey123 웹 앱의 현장조사에 전달합니다.
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783또한 Survey123 웹 앱은 Survey123 현장 앱에서 지원되지 않는 여러 매개변수를 지원합니다. 이러한 매개변수는 브라우저의 현장조사를 나타내는 것과 관련된 매개변수입니다. 웹 앱을 여는 방법을 사용자 정의하는 URL 매개변수 및 예시는 다음 테이블을 참조하세요.
비고:
매개변수 값에 공백, 더하기 기호(+), 기타 특수 문자가 포함된 경우에는 이러한 문자를 퍼센트 인코딩해야 합니다. 자세한 내용은 URL 인코딩을 참고하세요.
웹 앱 실행을 위한 URL 매개변수
| 매개변수 | 설명 | 유형 |
|---|---|---|
signIn | 공개 조사의 경우 로그인 버튼을 표시하거나 사용자에게 로그인하도록 합니다. 기본 설정에 따라 웹 앱은 사용자가 공개 조사에 로그인하는 방법을 제공하지 않지만 공개 조사에는 사용자가 로그인한 경우에만 작동하는 기능이 포함될 수 있습니다. 예를 들어 계산을 사용하여 로그인한 사용자의 이메일 주소를 추출합니다. 유효한 값은 웹 앱 상단의 탐색 모음에 로그인 버튼을 표시하는 show 및 사용자가 로그인 페이지로 리디렉션하여 로그인해야 하는 require입니다. 예: | 문자열 |
isOrgSignIn | 기관별 로그인 페이지를 사용합니다. 기본 설정에 따라 Survey123은 기관별 로그인 페이지를 사용하지만, 현장조사를 두 개 이상의 기관에 공유하는 경우 ArcGIS Online 로그인 페이지를 사용하는 것이 좋을 수 있습니다. ArcGIS Online 로그인 페이지를 사용하려면 이 매개변수를 false로 설정하세요. 예: | 불린 |
center | 맵의 중심을 알려진 위도, 경도, 고도(선택 사항)에 맞춥니다. 예: | 문자열 |
field:fieldname | 현장조사 질문을 필드 값으로 채웁니다. 예: | 문자열 |
portalUrl | 현장조사 항목이 호스팅되는 포털의 URL을 지정합니다. 예: | 문자열 |
| open | 현장조사를 여는 데 사용되는 앱을 지정합니다. 유효한 값은 web(현장조사가 웹 앱에 열림, 기본값), native(현장 앱이 설치된 경우 현장조사가 현장 앱에 열림), menu(현장조사가 열릴 앱을 지정하기 위한 웹페이지가 열림)입니다. 예: | 문자열 |
| hide |
웹 앱의 현장조사 요소를 숨깁니다. 이 매개변수에는 쉼표로 구분된 여러 값을 사용할 수 있습니다. 유효한 값은 navbar(로그인, 로그아웃, 언어 변경 옵션을 비롯한 현장조사 상단의 표시줄), header, description, footer, submit, theme, leaveDialog(페이지를 이동하거나 닫을 때 표시되는 경고 메시지)입니다. 또한 field:fieldName 매개변수를 사용할 때 fieldName 대신 이름을 입력하여 특정 질문, 그룹, 페이지 또는 반복을 숨길 수 있습니다. 반복 내의 질문은 개별적으로 숨길 수 없습니다. 예: | 문자열 |
| locale | 현장조사의 언어를 전환합니다. 이 매개변수는 현장조사에 여러 언어가 포함된 경우에만 사용할 수 있습니다. 예: | 문자열 |
| mode | 웹 앱의 모드를 설정합니다. 유효한 값은 현장조사 항목을 생성하는 대신 기존 항목을 편집하도록 설정하는 edit과 기존 항목을 읽기 전용 모드로 여는 view, 지정된 항목의 콘텐츠로 채워진 현장조사를 만드는 copy입니다. 이 매개변수를 사용할 경우 globalId 매개변수도 입력해야 합니다. 예: | 문자열 |
| globalId | 양식에 불러오는 현장조사 레코드를 지정합니다. 유효한 값은 기존 현장조사 레코드의 Global ID입니다. 해당 매개변수의 이름은 대/소문자를 구분합니다. 예: | 문자열 |
recalculate | mode=edit으로만 사용할 수 있습니다. 이 재계산 버튼을 사용하지 않고 현장조사를 불러올 때 지정된 질문을 강제로 재계산합니다. 예: | 문자열 |
| version | 사용할 웹 앱의 버전을 설정합니다. latest 값만 사용할 수 있으며 이 경우 버전이 잠긴 현장조사더라도 최신 버전의 웹 앱이 사용됩니다. 예: | 문자열 |
| token | 현장조사에 사용할 유효한 토큰을 전달합니다. 이 매개변수를 사용하면 응답자가 ArcGIS 계정이 필요한 현장조사에 로그인하지 않고 접속하여 응답할 수 있습니다. 예: | 문자열 |
autoReload | 제출 후 현장조사를 다시 불러옵니다. 현장조사를 다시 불러올 때까지의 지연 시간(초)을 지정합니다. 이전에는 autoRefresh라고 했습니다. autoRefresh 매개변수는 이전 버전과의 호환성을 위해 지원됩니다. 예: | 정수(Integer) |
| encodeUrlParams | URL 매개변수를 가립니다. 결과 URL은 인코딩된 모든 매개변수를 나타내는 code 매개변수를 대신 포함하며, 이 code 매개변수 외부에 포함된 매개변수는 무시됩니다. 예: | 불린 |
width | 픽셀 또는 화면 너비의 일부로 현장조사의 너비를 설정합니다. 1보다 큰 값은 너비를 픽셀 단위로 설정합니다. 픽셀 값이 화면의 너비보다 작은 경우 화면 너비가 사용됩니다. 0과 1 사이의 값은 양식의 너비를 화면 너비의 일부로 설정합니다. 이는 텍스트 상자와 같은 현장조사의 다른 컨트롤에도 영향을 주며, 웹 앱이 고정 또는 동적 격자를 표시하는 방식을 개선하는 데 도움이 될 수 있습니다. 예: | 문자열 |
비고:
field:fieldname 매개변수에는 웹 앱의 지오포인트, 지오추적, 지오쉐이프 질문이 지원됩니다. 지오포인트(geopoint) 질문의 경우 경도, 위도, 고도(선택)를 공백으로 구분하여 지정합니다. 지오추적 및 지오쉐이프 질문의 경우에는 각 버텍스에 대해 경도와 위도를 공백으로 구분하고 각 좌표 쌍은 세미콜론으로 구분하여 지정합니다. 다음 예시는 지오쉐이프 질문에 사용됩니다.
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766