Skip To Content

쿼리 위젯

쿼리 위젯을 사용하여 미리 정의된 쿼리를 실행함으로써 원본 데이터에서 정보를 검색할 수 있습니다. 데이터 원본은 다음 중 하나일 수 있습니다.

  • 현재 맵의 피처 레이어
  • 포털 내의 항목인 피처 레이어
  • ArcGIS Server REST 서비스의 피처 레이어
    팁:

    피처 레이어의 출처는 맵 서비스 또는 피처 서비스일 수 있습니다.

  • 이미지 서비스의 이미지 레이어
  • 독립 테이블

쿼리 위젯은 구성 중에 쿼리 빌더 역할을 하므로 사용자는 원본 데이터, 필터, 쿼리 결과의 표시 필드를 지정하여 쿼리를 정의할 수 있습니다. 각 쿼리는 단일 레이어에서 작동합니다. 그러나 단일 앱에 대한 여러 쿼리를 정의할 수 있으며, 데이터 레이어의 출처는 여러 원본일 수 있습니다.

쿼리 위젯 구성

이 위젯은 앱이 시작될 때 자동으로 열리도록 설정할 수 있습니다. 이 기능을 활성화하려면 위젯에서 앱을 시작할 때 이 위젯을 자동으로 열기 버튼 앱을 시작할 때 이 위젯을 자동으로 열기을 클릭하여 어두운 초록색으로 바꿉니다.

다음 단계에서는 쿼리를 구성하는 방법을 설명합니다. 여러 쿼리를 정의해야 하는 경우 이러한 단계를 반복하세요.

  1. 쿼리 위젯 위에 마우스를 놓고 편집 버튼 편집을 클릭합니다.

    이 위젯에 대한 구성 창이 나타납니다.

  2. 필요에 따라, 이 위젯의 기본 아이콘을 바꾸려면 위젯 아이콘 변경을 클릭합니다.

    파일 탐색기 창이 나타나므로 위젯 아이콘으로 사용할 로컬 이미지 파일을 찾을 수 있습니다.

  3. + 새 쿼리를 클릭합니다.

    데이터 원본 설정 창이 나타납니다. 기본 설정에 따라 맵에서 선택이 선택되며, 현재 맵의 모든 피처 레이어가 아래에 나열됩니다.

    또는 포털에서 선택 선택하거나 서비스 URL을 추가할 수 있습니다. 레이어뿐 아니라 릴레이트 테이블도 쿼리할 수 있습니다.

  4. 데이터 원본 옆의 라디오 버튼을 클릭합니다.
  5. 목록에서 레이어를 선택합니다.
  6. 확인을 클릭하여 데이터 원본 설정 창을 닫고 쿼리 구성 창으로 돌아갑니다.

    기본 설정에 따라 정보 탭이 활성화되어 있습니다.

  7. 쿼리 작업의 제목과 아이콘을 지정합니다.
  8. 필터 탭을 클릭합니다.
  9. 속성 기준 아래의 설정 설정을 클릭하여 쿼리의 where 절을 정의합니다.
    1. 필터 식 추가를 클릭하여 식 만들기를 표시합니다.

      필터 식은 값 기반 연산이거나 두 필드 간의 연산일 수 있습니다.

    2. 쿼리 필드(식)를 선택하고 텍스트 상자에 값을 입력합니다. 다음과 같은 3가지 옵션이 있습니다.
      • - 특정 값을 기준으로 하는 필터입니다. 미리 정의된 값을 설정할 수도 있고, 값 요청을 선택하여 최종 사용자에게 새 값을 대화형으로 요청할 수도 있습니다. 값 요청을 활성화하는 경우 프롬프트 필드에 값 정보를 입력하고 힌트 필드에 힌트를 입력합니다. 그러면 최종 사용자가 쿼리 값을 더욱 쉽게 입력할 수 있습니다.
      • 필드 - 특정 필드의 값을 다른 필드의 값과 비교합니다.
      • 고유값 - 레이어에서 선택한 필드의 고유 값 목록을 기준으로 하는 필터입니다. 이 필터는 최종 사용자가 목록에서 값을 대화형으로 선택할 수 있도록 값 요청과 함께 사용되는 경우가 많습니다. 이 목록에는 모든 고유 값 집합이 포함될 수도 있고, 이전 식 또는 기타 모든 식(순서는 관계없음)을 기준으로 하는 동적 고유 값 집합이 포함될 수도 있습니다. 값 요청을 활성화하는 경우 프롬프트 필드에 값 정보를 입력하고 힌트 필드에 힌트를 입력한 다음 값을 나열할 방법을 선택합니다.
        주의:

        이전 식으로 필터링된 값 또는 다른 모든 식으로 필터링된 값을 선택할 때 코딩된 값에 대한 설명을 나타내려면 서비스가 통계 기준 쿼리 기능을 지원해야 합니다.

    3. 또한 식 집합 추가를 사용하여 두 개의 필터를 정의해 단일 쿼리에 적용할 수 있습니다. 이 집합의 식 모두 또는 임의의 식이 true인 경우 집합의 모든 식을 충족하는 레코드 또는 집합의 임의 식을 충족하는 레코드가 결과로 반환됩니다.
    4. 확인을 클릭하여 대화 상자를 닫습니다.
  10. 필요에 따라, 위젯에서 SQL 식을 나타내려면 최종 사용자에 대한 SQL 식 나타내기를 선택합니다.
  11. 공간 필터 섹션을 사용하여 최종 사용자가 사용할 수 있는 공간 필터를 선택할 수 있습니다. 다음 필터를 하나 이상 선택하고 기본으로 설정을 클릭하여 이 중 하나를 기본으로 설정합니다.
    • 현재 맵 범위 내에 있는 피처만 반환 - 현재 맵 범위 내에 있는 피처만 반환합니다.
    • 맵에 그려진 모양과 교차하는 피처만 반환 - 아이콘을 클릭하여 위젯에 나타나는 그리기 도구를 선택합니다. 필요에 따라, 최종 사용자를 위해 버퍼 설정을 추가하려면 버퍼 옵션 활성화를 선택합니다.
    • 다른 레이어에서 피처와 공간 관계가 있는 피처만 반환 - 설정 설정을 클릭하여 공간 관계 설정에서 공간 관계 규칙을 선택합니다. 레이블 필드를 더블 클릭하여 각 관계에 대해 사용자에게 친숙한 레이블을 지정할 수 있습니다. 필요에 따라, 최종 사용자를 위해 버퍼 설정을 추가하려면 버퍼 옵션 활성화를 선택합니다. 다음 공간 관계가 지원됩니다.
      • 교차 - 레이어 1의 피처 일부가 레이어 2의 피처에 포함됩니다.
      • 포함 - 레이어 1의 피처 일부 또는 모두가 레이어 2의 피처에 전부 포함됩니다.
      • 횡단 - 레이어 1의 피처가 레이어 2의 피처를 횡단합니다.
      • Envelope 교차 - 레이어 1의 Envelope이 레이어 2의 Envelope과 교차됩니다.
      • 색인 교차 - 쿼리 레이어의 Envelope이 대상 레이어의 색인 항목과 교차됩니다.
      • 중첩 - 레이어 1의 피처가 레이어 2의 피처와 중첩됩니다.
      • 겹침 - 레이어 1의 피처가 레이어 2의 피처 경계와 겹칩니다.
      • 범위 내 - 레이어 1의 피처가 레이어 2의 피처로 완전히 둘러싸여 있습니다.
    • 맵의 전체 범위 내에 있는 피처 반환 - 맵의 전체 범위 내에 있는 피처를 반환합니다.
    참고 사항:
    공간 필터를 쿼리에 적용하지 않으려면 모든 옵션을 선택 취소합니다.
  12. 결과 탭을 클릭하여 쿼리 결과에 대해 나타나는 콘텐츠와 심볼을 구성합니다.
  13. 필요에 따라, 웹 맵에서 레이어의 팝업 구성으로 정의된 동일한 콘텐츠를 나타내려면 웹 맵에서 레이어의 팝업 구성 사용을 선택합니다.
  14. 필요에 따라, 사용자 정의 콘텐츠를 나타내려면 사용자 정의 콘텐츠 구성을 선택합니다.
    1. 각 결과 항목 제목 텍스트 상자 옆의 추가 아이콘을 클릭합니다.

      레이어의 필드 목록이 나타납니다. 필드는 한 번에 하나씩 선택할 수 있습니다. 선택한 필드의 값이 텍스트 상자에 표시되고 쿼리 결과 제목으로 사용됩니다. 이 단계를 반복하여 필드를 더 추가합니다. 여러 필드를 추가한 경우 필드 값이 연결되어 결과 제목으로 사용됩니다.

    2. 다음 필드 속성이 나타납니다. 텍스트 상자 옆의 연필 아이콘을 클릭하여 디스플레이 필드 설정 대화 상자를 엽니다. 결과에 표시할 필드를 선택합니다. 개별 필드의 경우 특별 유형 열을 통해 이미지로 나타낼 수 있습니다. 또한 작업 열에서 위쪽 또는 아래쪽 화살표를 클릭하여 필드 순서를 조정할 수 있습니다.
  15. 결과 항목 정렬 옆의 연필 아이콘을 클릭하면 쿼리 결과 정렬에 사용되는 필드를 구성할 수 있습니다.

    쿼리 결과에 대한 페이지 매김 또는 정렬이 서비스에서 지원되어야 합니다.

  16. 필요에 따라, 레이어의 기본 심볼을 사용하려면 레이어가 정의한 심볼 사용 옵션을 선택합니다.
  17. 필요에 따라 사용자 정의 심볼 사용 옵션을 선택하고 심볼 아이콘을 클릭하여 사용자 정의 심볼을 설정합니다.

    미리 보기 창이 나타나므로 결과 강조 표시 심볼의 색상과 스타일을 선택할 수 있습니다.

  18. 심볼 미리 보기 창 외부의 아무 곳이나 클릭하여 창을 닫습니다.
  19. 필요에 따라, 실행할 때 결과 피처의 심볼을 대화형으로 변경하려면 런타임에 심볼을 변경하도록 허용을 선택합니다.
  20. 쿼리 결과를 내보낼 수 있는지 여부와 쿼리 작업이 레이어를 생성하는 방법을 지정하려면 옵션 탭을 클릭합니다.
  21. 3~20단계를 반복하여 쿼리 작업을 더 추가합니다.
  22. 기존 쿼리 작업의 순서를 변경하려면 작업 위에 마우스를 놓고 위 화살표와 아래 화살표를 클릭합니다.
  23. 확인을 클릭하여 쿼리 작업을 저장하고 쿼리 창을 닫습니다.

쿼리 위젯 사용

아래 단계에서는 쿼리 위젯을 사용하는 방법을 설명합니다.

  1. 쿼리 위젯을 클릭하여 엽니다. 쿼리를 둘 이상 구성한 경우 쿼리 목록이 작업 탭에 나타납니다.
    쿼리 목록

    위젯에 하나의 쿼리만 있으며 최종 사용자에게 입력을 요청하지 않는 경우 위젯을 클릭하면 쿼리가 실행되고 즉시 결과가 표시됩니다.

    위젯에 하나의 쿼리만 있으며 최종 사용자에게 입력을 요청하는 경우 위젯을 클릭하면 사용자 입력과 함께 쿼리가 표시됩니다.

    참고 사항:

    최종 사용자의 입력에는 속성 기준, 하나 이상의 공간 필터 또는 이 두 개의 조합이 포함될 수 있습니다.

  2. 쿼리 중 하나를 클릭합니다. 쿼리는 구성에 따라 다르게 실행될 수 있습니다.
    1. 쿼리가 입력을 요청하지 않는 경우 결과가 결과 탭에 나타나며 결과 피처는 구성하는 동안 지정한 심볼과 함께 맵에 나타납니다.
    2. 구성 시 값 요청을 선택한 경우 매개변수의 새 값을 입력하라는 텍스트 상자가 나타납니다. 처음에는 기본 값이 상자에 나타납니다. 고유 값이 설정된 경우 텍스트 상자에 그 값이 모두 나열됩니다.
    3. 공간 필터를 하나 이상 사용할 수 있습니다.
      • 현재 맵 범위 내에 있는 피처만 반환 - 현재 맵 범위 내에 있는 피처만 반환합니다.
      • 맵에 그려진 모양과 교차하는 피처만 반환 - 그리기 도구 집합을 사용하여 영역을 정의하도록 맵에 모양을 그릴 수 있습니다. 필요에 따라 검색 거리가 모양에 적용될 수 있습니다.
        맵에 그리기
      • 다른 레이어에서 피처와 공간 관계가 있는 피처만 반환 - 결과는 쿼리 레이어의 피처 및 릴레이트된 레이어의 피처 간 공간 관계를 기반으로 합니다. 필요에 따라 검색 거리가 릴레이트된 레이어의 피처 지오메트리에 적용될 수 있습니다.
        다른 레이어에서 피처와 공간 관계가 있음
      • 맵의 전체 범위 내에 있는 피처 반환 - 맵의 전체 범위 내에 있는 피처를 반환합니다.
    4. 실행을 클릭하여 쿼리를 실행합니다.

      쿼리에서 발생한 피처가 구성 시간에 지정된 심볼과 함께 맵에서 강조됩니다. 레이어에 릴레이트된 데이터가 있는 경우 릴레이트된 레코드도 결과에 포함됩니다.

  3. 줄임표()를 클릭하여 결과 집합에 대한 작업(예시: 통계 실행, 결과를 로컬로 내보내거나 ArcGIS Online 또는 ArcGIS Enterprise 콘텐츠 페이지의 내 콘텐츠에 내보내기 또는 피처 심볼 변경 등)을 선택합니다.
    팁:

    쿼리에서 반환될 수 있는 최대 피처 수는 서비스에 설정된 maxRecordCount 등록정보에 따라 다릅니다. 기본값은 1,000입니다. 예를 들어 기본값을 사용하며 1,300개의 피처가 쿼리에서 반환되도록 하려는 경우 처음에는 쿼리 결과 패널에 1,000개의 피처가 나타납니다. 패널을 아래로 스크롤하면 나머지 300개의 피처를 볼 수 있습니다.

    또는 릴레이트 테이블에 대해 쿼리를 수행하는 경우 맵에서 릴레이트된 피처가 모두 강조 표시되고 쿼리패널에 나열됩니다.