ArcGIS Survey123은 특정 컴포넌트 앱을 실행하는 링크를 사용하여 다른 앱과 통합할 수 있습니다. 예를 들어 다른 Esri 앱, 웹 맵 팝업 또는 이메일이나 웹사이트의 단순 하이퍼링크에서 Survey123 Mobile을 실행하고 열 수 있는 앱 링크를 생성할 수 있습니다. URL을 사용하여 현장조사를 자동으로 다운로드하고 열어서 Survey123 Connect에서 편집할 수 있습니다.
또한 ArcGIS QuickCapture 및 ArcGIS Field Maps 등 Survey123의 다른 앱에 연결할 수 있습니다.
팁:
Survey123 Mobile은 Survey123 Mobile, Survey123 현장 앱, QuickCapture의 세 가지 앱에 대한 링크를 엽니다. 이러한 링크를 Survey123 Mobile 내에서 실행하면(링크 사용, QR 코드 스캔 또는 현장조사나 QuickCapture 프로젝트 내의 링크를 통해) 모두 Survey123 Mobile 내에서 열립니다. 자세한 내용은 콘텐츠 열기를 참고하세요.
테이블의 URL 패턴을 사용하여 웹 브라우저 또는 다른 앱에서 접근할 수 있는 링크를 생성합니다. 포함된 예시에서는 해당 URL 패턴을 사용하여 특정 현장조사를 여는 방법을 보여줍니다.
| 실행할 항목 | 링크할 위치 | 사용할 URL 패턴 |
|---|---|---|
| Survey123 Mobile | Android iOS | Survey123 앱 링크1: 예: |
Windows Android iOS2 | 사용자 설정 URL 스키마3: 예: | |
웹 앱 | 웹 브라우저 | ID별 현장조사 양식: 예: |
현장 앱 | Android iOS | Survey123 앱 링크1: 예: |
Windows Android iOS2 | 사용자 설정 URL 스키마3: 예: | |
| Survey123 Studio | Windows | 사용자 설정 URL 스키마3: 예: |
Survey123 Connect | Windows | 사용자 설정 URL 스키마3: 예: |
다른 앱 | 현장조사 양식 | Survey123의 링크: 앱별로 다름 |
1—Survey123 앱 링크는 App Store 및 Google Play에서 설정한 요구사항을 준수하므로 더 많은 앱에 연결할 수 있으며 공유하기 쉬운 단축 링크를 지원합니다.
2—iOS 기기에서 사용자 설정 URL 스키마는 특정 앱 그룹에 대해서만 승인됩니다.
3—사용자 설정 URL 스키마 링크는 단축할 수 없으며 Android에서 열기 어려울 수 있습니다. 다음과 유사한 하이퍼링크 형태로 사용자 설정 URL 스키마 링크를 제공하는 것을 고려합니다.<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
URL 매개변수
링크 끝에 URL 매개변수를 추가하여 앱을 여는 방법을 추가로 사용자 정의할 수 있습니다. 예를 들어 지오포인트 질문의 기본 위치를 설정하거나 텍스트 질문을 채울 수 있습니다.
URL 매개변수는 ? 문자로 시작되며 & 문자로 구분됩니다. 다음 예시에서는 첫 번째 매개변수(itemID)가 ? 문자로 시작되고 각 후속 필드 매개변수(color_1 및 color_2)가 & 문자로 구분되는 사용자 설정 URL 스키마를 보여줍니다.
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue더 많은 예시 URL 및 지원되는 URL 매개변수는 Survey123 Mobile 실행, 피처 기능 | ArcGIS Arcade | Esri Developer, 웹 앱 실행, , 현장 앱 실행, 실행, Survey123 Connect 실행, Survey123에서 다른 앱 실행을 참조하세요.
비고:
Survey123 Mobile 또는 현장 앱에서 현장조사를 시작하기 위해 매개변수가 포함된 링크를 사용하기 전에 해당 앱을 기기에 설치할 것을 권장합니다. 자세한 내용은 ArcGIS Survey123 설치를 참고하세요.
URL 인코딩
일부 환경에서는 인코딩되지 않은 URL 매개변수가 작동하지만 URL 매개변수를 인코딩하는 것을 권장합니다. 인코딩은 잘못된 문자를 퍼센트 기호(%)로 대체하여 해당 16진수 값이 뒤에 나타납니다.
다음 예시는 인코딩되지 않은 매개변수로 Survey123의 특정 프로젝트로 돌아가는 호출이 사용된 QuickCapture 링크입니다.
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43다음은 인코딩된 매개변수가 사용된 동일한 URL입니다.
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43키와 해당 값 사이의 구분을 지정하는 등호는 인코딩해서는 안 됩니다.
팁:
인코딩된 매개변수를 생성하는 한 가지 방법은 ArcGIS Arcade를 사용하는 것입니다. UrlEncode 함수를 사용하면 각 매개변수를 나타내는 키 값 쌍 컬렉션을 정의하고 적절한 인코딩으로 URL을 생성할 수 있습니다.
현장조사 작성자는 기밀 데이터가 URL에 보이지 않도록 URL 매개변수를 가릴 수도 있습니다. 이 경우에는 웹 앱에 사용할 URL을 생성할 때 encodeUrlParams=true를 포함해야 합니다. 자세한 내용은 웹 앱을 열기 위한 URL 매개변수를 참고하세요.