맨 위로 이동

현장 앱 실행

본 항목

  1. Windows용 웹 브라우저에서 링크 열기
  2. iOS 또는 Android용 다른 앱에서 링크 열기
  3. 현장 앱 실행을 위한 URL 매개변수

다른 앱, 웹 맵 팝업 또는 이메일이나 웹사이트의 하이퍼링크에서 Survey123 현장 앱을 열 수 있는 앱 링크를 생성할 수 있습니다. 사용자 설정 URL 스키마를 사용하여 웹 브라우저에서 앱을 실행하거나 Survey123 앱 링크를 사용하여 Android 또는 iOS용 앱에서 실행합니다. URL 매개변수를 사용하여 특정 현장조사 불러오기, 기본 맵 위치에 대한 좌표 설정, 사전 결정된 값으로 질문에 대한 답변 채우기, 웹 맵 팝업에서 데이터 속성 전달 등 현장 앱이 열리는 방식을 사용자 정의합니다.

Windows용 웹 브라우저에서 링크 열기

현장 앱을 여는 링크를 생성하여 다른 앱에 임베드할 수 있습니다. 테스트를 위해 동일한 링크를 웹브라우저에 입력할 수도 있습니다.

비고:

링크를 생성하고 나면 arcgis-survey123://을(를) https://survey123.arcgis.app(으)로 바꾸어 iOS 또는 Android에서 Survey123 링크로 사용할 수 있습니다.

다음 단계에서는 사용자 설정 URL 스키마를 생성하여 데스크톱 웹브라우저에 사용하는 방법을 설명합니다.

  1. 브라우저에 arcgis-survey123://을 입력합니다.

    Survey123 현장 앱이 열립니다(또는 이 앱을 열라는 메시지가 나타남).

    비고:

    특정 포털에서 현장조사를 시작하고 다운로드하려면 arcgis-survey123://?portalUrl=host.domain.com/webadaptor(여기서 host, domain, webadaptor은(는) 포털 정보로 대체됨)과(와) 같이 포털 URL 매개변수를 포함해야 합니다.

  2. 다음과 같이 현장조사에 대한 고유 참조를 추가하여 이 URL에 추가합니다.
    1. 열려는 현장조사의 항목 ID를 식별합니다.
      비고:

      이 항목 ID는 ArcGIS Online에서 현장조사를 고유하게 식별하는 데 사용되는 문자열로, ArcGIS Online의 양식 항목에 대한 URL에서 찾을 수 있습니다. 예를 들어 현장조사의 URL이 https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19인 경우 양식의 항목 ID는 36ff9e8c13e042a58cfce4ad87f55d19입니다.

    2. ?itemID= 및 양식의 항목 ID를 URL 끝에 추가하여 URL에 현장조사를 포함합니다.
    이 경우 URL은 다음과 같습니다.
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    URL을 테스트하는 경우 이제 Survey123 현장 앱이 열린 다음 현장조사도 즉시 열려야 합니다.

    비고:

    현장조사가 기기에 아직 없다면 다운로드됩니다.

  3. XLSForm(해당 레이블이 아님)에 할당된 이름을 통해 필드에 URL의 참조를 추가하여 질문에 사전 결정된 답변을 포함합니다. 예를 들어 성 필드를 채우려면 &field:Surname= 및 해당 값을 입력합니다.

    &는 매개변수 구분 기호이며 field:는 채워질 질문 이름을 나타냅니다.

    이 경우 URL은 다음과 같습니다.
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    이제 이 URL을 사용하여 Survey123 현장 앱과 현장조사를 열고 지정된 질문을 정의된 답변으로 작성할 수 있습니다. 하나의 현장조사 URL에 여러 질문을 채울 수 있습니다. 필드 이름은 대소문자를 구분합니다.

  4. URL에 좌표를 추가하여 현장조사의 지오포인트 질문에 대한 위치를 정의합니다.
    • &center=와 좌표를 입력합니다.
    • 십진도수(DD) 단위의 좌표 값을 위도 좌표, 쉼표, 경도 좌표 형태와 같이 쉼표로 구분하여 차례대로 입력합니다.
    • 필요한 경우 십진 미터 단위의 고도를 하나의 쉼표로 구분하여 세 번째 값으로 추가합니다.

    최종적으로 다음과 같은 URL이 됩니다.

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    이 URL은 Survey123 현장 앱과 선택한 현장조사를 열고, 텍스트 질문을 채우고, 지오포인트 질문에 대한 새로운 기본 위치를 제공합니다.

    ArcGIS 웹 맵의 팝업에서 Survey123으로 필드 속성을 전달하여 웹 맵의 팝업을 사용하는 다른 Esri 앱과 통합할 수도 있습니다. 이 기능은 중괄호 안에 속성 이름을 제공하여 설정값 대신 피처 속성의 값으로 Survey123의 필드를 채우는 데 사용될 수 있습니다.

  5. 웹 맵을 열고 레이어 중 하나에 대해 팝업을 선택합니다. 선택 콘텐츠 추가 및 텍스트를 차례로 선택합니다. 링크에 대해 표시할 텍스트를 제공하고 링크 버튼을 클릭하여 링크 URL 값을 입력합니다.

    팝업에서 URL 스키마에 대한 링크를 설정합니다.

    다음 URL에서는 설정값 대신 선택한 피처의 이름 속성 콘텐츠로 성 필드를 채웁니다.

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

    다음 URL에서는 선택된 소화전의 Global ID로 hydrantGlobalID 필드를 채웁니다.

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

    비고:

    기본 설정에 따라, 선택 항목의 이름과 레이블이 동일한 경우에만 웹 맵의 팝업을 통해 단답형 또는 선다형 질문에 값을 전달할 수 있습니다. 선택 목록의 이름과 레이블이 다른 경우 팝업의 ArcGIS Arcade 식에서 DomainCode 또는 UrlEncode 함수를 사용하여 원하는 값을 전달할 수 있습니다.

    반복의 질문은 채울 수 없습니다.

iOS 또는 Android용 다른 앱에서 링크 열기

ArcGIS apps에서 사용할 링크를 생성하여 Survey123을 열고 현장조사의 데이터를 취득할 수 있습니다. 아래 단계에서는 Survey123 앱 링크를 생성하여 웹 맵 팝업에 사용하는 방법을 설명합니다. 이 링크는 ArcGIS 기관의 웹 맵에 대한 팝업에 입력됩니다. 위의 섹션과 유사한 단계를 사용하여 iOS 또는 Android 기기의 웹 브라우저에서 링크를 테스트할 수 있습니다.

  1. 기기에서 볼 웹 맵을 열고 레이어 중 하나에 대해 팝업을 선택합니다.
  2. 콘텐츠 추가를 클릭하고 텍스트를 선택합니다.
  3. Survey123 실행을 입력하고 이 텍스트를 강조한 후 링크 버튼을 클릭하여 링크 URL을 입력합니다. https://survey123.arcgis.app을 입력하고 확인을 클릭합니다.
    1. 브라우저 또는 ArcGIS app의 모바일 기기에서 웹 맵을 엽니다.
    2. 피처를 선택한 다음 팝업에서 Survey123 시작 링크를 클릭하면 Survey123이 열립니다.
  4. URL에 현장조사를 포함하려면 ?itemID= 및 양식의 항목 ID를 URL의 끝에 추가합니다.
    이 경우 URL은 다음과 같습니다.
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    URL을 테스트하는 경우 이제 Survey123 현장 앱이 열린 다음 현장조사도 즉시 열려야 합니다.

    비고:

    현장조사가 기기에 아직 없다면 다운로드됩니다.

  5. XLSForm(해당 레이블이 아님)에 할당된 이름을 통해 필드에 URL의 참조를 추가하여 질문에 사전 결정된 답변을 포함합니다. 예를 들어 성 필드를 채우려면 &field:Surname= 및 해당 값을 입력합니다.

    &는 매개변수 구분 기호이며 field:는 채워질 질문 이름을 나타냅니다.

    이 경우 URL은 다음과 같습니다.
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    이제 이 URL을 사용하여 Survey123 현장 앱과 현장조사를 열고 지정된 질문을 정의된 답변으로 작성할 수 있습니다. 하나의 현장조사 URL에 여러 질문을 채울 수 있습니다. 필드 이름은 대소문자를 구분합니다.

  6. URL에 좌표를 추가하여 현장조사의 지오포인트 질문에 대한 위치를 정의합니다.
    • &center=와 좌표를 입력합니다.
    • 십진도수(DD) 단위의 좌표 값을 위도 좌표, 쉼표, 경도 좌표 형태와 같이 쉼표로 구분하여 차례대로 입력합니다.
    • 필요한 경우 십진 미터 단위의 고도를 하나의 쉼표로 구분하여 세 번째 값으로 추가합니다.

    최종적으로 다음과 같은 URL이 됩니다.

    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    완성된 이 URL은 Survey123 현장 앱과 선택한 현장조사를 열고, 텍스트 질문을 채우고, 지오포인트 질문에 대한 새로운 기본 위치를 제공합니다.

현장 앱 실행을 위한 URL 매개변수

다음 매개변수를 사용하여 현장 앱을 여는 방법을 사용자 지정할 수 있습니다.

매개변수설명유형

center

맵의 중심을 알려진 위도, 경도, 고도(선택 사항)에 맞춥니다.

예:

center=37.8199,-122.4783,20

문자열

field:fieldname

현장조사 질문을 필드 값으로 채웁니다.

예:

field:surname=Klauser

문자열

portalUrl

현장조사 항목이 호스팅되는 포털의 URL입니다.

예:

portalUrl=https://myorg.arcgis.com

문자열

itemID

열려는 양식입니다.

예:

itemID=36ff9e8c13e042a58cfce4ad87f55d19

UUID

download

기기가 온라인 상태일 때 현장조사를 자동으로 다운로드합니다. 기본값은 true입니다.

예:

download=false

불린

action

현장조사가 열리는 방식을 지정합니다. 지원되는 값은 collect(기본값), edit, view, copy입니다.

예:

action=edit

문자열

folder

현장조사가 열릴 때 표시할 폴더를 지정합니다. 지원되는 값은 inbox, drafts, outbox, sent, *(오버뷰 폴더)입니다.

지정된 폴더의 현장조사를 필터링하려면 URL에 filter 매개변수를 추가합니다. 모든 폴더의 현장조사를 필터링하고 오버뷰 폴더에 표시하려면 folder=* 및 filter 매개변수를 지정합니다.

예:

folder=inbox
folder=*&filter=lake

문자열

callback

양식 작업(예시: 제출, 임시 저장 폴더로 이동, 취소 또는 종료)이 완료되었을 때 반환될 URL입니다.

예:

callback=https://quickcapture.arcgis.app

URL

callback:status

호출이 활성화되었을 때 현장조사의 상태를 지정합니다. 상태에 지원되는 값은 cancel, draft, submit, close입니다. close 상태는 action=view인 경우에만 사용할 수 있습니다.

예:

callback:draft=https://quickcapture.arcgis.app

문자열

filter

인스턴스 이름 또는 특정 필드에 있는 문자열과 일치하는, 기기의 기존 현장조사를 필터링합니다. 기본 설정에 따라 수신함을 필터링합니다. 지정된 폴더의 현장조사를 필터링하려면 URL에 folder 매개변수를 추가합니다.

인스턴스 이름이 정의되면 전체 인스턴스 이름 또는 인스턴스 이름의 하위 문자열을 나타내는 문자열을 제공합니다. 다음 예시에서는 전체 인스턴스 이름이 Klauser인 모든 레코드 또는 인스턴스 이름 내에 lake라는 단어가 포함된 임시 저장의 모든 레코드를 필터링하는 방법을 보여줍니다.

예:

filter=Klauser
filter=lake&folder=drafts

인스턴스 이름이 정의되어 있지 않거나 인스턴스 이름의 일부가 아닌 필드로 필터링하는 경우 필드 이름 및 필드 값을 모두 filter=field:fieldname:fieldvalue 형식으로 포함합니다. 전체 필드 값만 필드를 사용하여 필터링할 수 있습니다. 다음 예시에서는 수역 유형이 River이거나 전체 스테이션 번호가 5171인 레코드를 필터링하는 방법을 보여줍니다.

예:

filter=field:waterbodytype:River
filter=field:ws_stationnumber:5171

문자열

update

folder=inbox 매개변수와 함께 사용할 때 수신함 폴더를 새로고침합니다. URL에 update 및 filter가 모두 포함되어 있는 경우 필터는 업데이트 후에 적용됩니다. 기본값은 false입니다.

예:

update=true&folder=inbox

불린

q:queryparameter

기존 레코드에 대해 피처 레이어를 쿼리합니다. 이는 아직 기기에 없는 콘텐츠를 검색하는 데 사용됩니다.

예:

q:where=ws_stationnumber=5171
q:where=waterbodytype='Lake'
q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

문자열

이 항목에 대한 피드백을 제공하시겠습니까?

본 항목
  1. Windows용 웹 브라우저에서 링크 열기
  2. iOS 또는 Android용 다른 앱에서 링크 열기
  3. 현장 앱 실행을 위한 URL 매개변수