또한 사용자는 그리기 또는 애노테이트 모양이 있는 이미지 질문을 통해 빈 캔버스에 스케치를 그리거나 맵의 이미지 또는 스냅샷을 애노테이트할 수 있습니다. ArcGIS Survey123 현장 앱에는 화살표, 일반 마커 심볼, 텍스트 레이블을 포함한 8가지 도구의 기본 그리기 도구 팔레트가 포함되어 있습니다. 기본 팔레트에 대한 자세한 내용은 그리기 모드를 참고하세요.
기본 그리기 도구 외에도 그리기 및 애노테이션 도구를 구성하기 위한 사용자 설정 팔레트를 생성할 수 있습니다. 예를 들어, 유틸리티 기관에는 전기 또는 가스 작업과 관련된 특정 심볼 및 라인 스타일이 있을 수 있습니다.
비고:
사용자 설정 팔레트는 ArcGIS Survey123 웹 앱에서 지원되지 않습니다.
사용자 설정 팔레트를 생성하려면 다음을 완료합니다.
- 새 XLSPalette 템플릿 및 XLSPalette 변환 도구를 실행할 수 있도록 ArcGIS Survey123 Connect에서 Python 환경을 구성합니다.
- XLSPalette 사양을 사용하여 사용자 설정 팔레트를 준비합니다.
- XLSPalette 템플릿 및 관련 파일이 현장조사의 미디어 폴더에 있는지 확인합니다.
- Survey123 Connect의 미디어 탭에서 XLSPalette 변환 도구를 실행하여 XLSPalette 템플릿을 .palette 파일로 변환합니다.
- 현장조사용 XLSForm에서 palette=<palette_name>을 지정하여 기본 팔레트 대신 사용자 설정 팔레트를 사용하도록 그리기 또는 애노테이트 모양이 있는 이미지 질문에 대한 body::esri:style 열을 설정합니다.
사용자 설정 팔레트는 먼저 XLSPalette 템플릿에서 구성됩니다. 그런 다음 XLSPalette 템플릿을 .palette 파일로 변환해야 현장조사에 추가할 수 있습니다. XLSPalette 템플릿은 Survey123 Connect의 미디어 탭에 있는 도구로 변환됩니다.
사용자 설정 팔레트 준비
사용자 설정 팔레트는 현장조사에 사용할 수 있는 .palette 파일로 변환될 워크시트가 포함된 .xlsx 파일인 XLSPalette에서 구성됩니다.
사용자 설정 팔레트 디자인을 시작하려면 XLSPalette 템플릿이 필요합니다. Survey123 Connect에는 빈 템플릿을 생성하기 위한 새로운 XLSPalette 템플릿 도구가 포함되어 있습니다. 도구를 실행하려면 Survey123 Connect에서 Python 환경을 구성해야 합니다. 자세한 내용은 Python 구성을 참고하세요.
Survey123 Connect에서 현장조사를 엽니다. XLSPalette 템플릿을 생성하려면 도구를 클릭한 다음 새 XLSPalette 템플릿을 클릭합니다. 템플릿 파일은 myXLSPalette1.xlsx라는 미디어 폴더에 생성됩니다. 또는 ArcGIS Online에서 Survey123 XLSPalette 템플릿 사본을 다운로드할 수 있습니다.
XLSPalette 템플릿의 각 워크시트는 도구집합으로, 사용자 설정 팔레트의 도구 그룹입니다. 각 도구집합 워크시트의 행은 도구집합의 애노테이션 도구를 정의합니다. 다음 예시에서는 두 개의 라인 도구 및 하나의 마커 도구를 포함하는 가스 파이프라인 검사를 위한 세 가지 애노테이션 도구에 대한 XLSPalette 구성을 보여줍니다.
| 유형 | 레이블 | 도구 | 심볼 | textSymbol |
|---|---|---|---|---|
라인 | 가스관(신규) | 라인 | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
라인 | 가스관(기존) | 라인 | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
표시 | 미터(신규) | meter.svg |
사용자 설정 팔레트를 디자인하는 데 사용할 수 있는 구문 및 매개변수에 대한 자세한 내용은 XLSPalette 사양을 참고하세요. 또한 전체 구문이 XLSPalette 템플릿의 레퍼런스 워크시트에 설명되어 있습니다.
XLSPalette 템플릿과 SVG 마커 심볼 또는 도구집합 아이콘과 같이 팔레트에서 사용하는 모든 이미지 파일이 현장조사의 미디어 폴더에 있는지 확인합니다. 이제 XLSPalette 템플릿을 .palette 파일로 변환해야 현장조사에 추가할 수 있습니다.
팔레트 변환
XLSPalette 변환 도구를 실행하려면 Survey123 Connect에서 Python 환경을 구성해야 합니다. 자세한 내용은 Python 구성을 참고하세요.
Survey123 Connect에서 현장조사를 열고 미디어 탭으로 이동합니다. 미디어 탭에 현장조사의 미디어 폴더 콘텐츠가 나열됩니다. 변환 버튼은 .xlsx 파일 옆에 있습니다. 변환 버튼을 클릭하여 XLSPalette 변환 도구를 실행한 다음 XLSPalette 템플릿을 현장조사에 사용할 수 있는 .palette 파일로 변환합니다.
변환이 완료되면 .palette 파일이 미디어 폴더에 저장되고 미디어 탭에 나타납니다.
팁:
.palette 파일의 이름은 원본 .xlsx 파일과 같습니다. 이 이름은 XLSForm 매개변수로 사용되므로 파일 이름에 공백이 없는지 확인합니다.
현장조사에 팔레트 추가
사용자 설정 팔레트를 생성하고 변환한 후에는 XLSForm에 추가할 수 있습니다. 현장조사에 사용자 설정 팔레트를 원하는 만큼 추가할 수 있지만, 각 그리기 또는 애노테이트 질문에는 하나의 팔레트만 사용할 수 있습니다.
그리기 또는 애노테이트 모양이 있는 이미지 질문의 경우 body::esri:style 열에 palette=<palette_name>을 입력합니다. 여기서 <palette_name>은 .palette 확장자가 없는 팔레트 파일의 이름입니다(예시: palette=Electrical).
이제 이미지 질문에 기본 팔레트 대신 사용자 설정 팔레트가 사용됩니다.
사용자 설정 팔레트를 업데이트하려면 .xlsx 파일을 필요에 따라 변경하고 미디어 탭에서 XLSPalette 변환 도구를 다시 실행합니다. 그러면 미디어 폴더의 .palette 파일이 바뀌며 양식 미리 보기가 업데이트되면 Survey123 Connect에 변경 사항이 표시됩니다. Survey123 현장 앱에서 변경 사항을 확인하려면 현장조사를 다시 발행합니다.
XLSPalette 사양
XLSPalette 사양은 Survey123에서 그리기 및 애노테이션 도구를 생성하기 위해 특별히 디자인되었습니다. 사용자 설정 팔레트는 XLSPalette 구문을 사용하여 .xlsx 파일에서 구성됩니다. XLSPalette 템플릿은 다음으로 구성됩니다.
- 유형, 도구, 심볼, textSymbol 열을 포함하는 하나 이상의 도구집합 워크시트 도구집합은 팔레트의 도구 그룹입니다. 팔레트는 필요한 만큼 도구집합을 포함할 수 있습니다. 각 도구집합 워크시트의 이름은 Survey123 현장 앱에서 사용자 설정 팔레트의 각 도구집합 탭 이름으로 표시됩니다.
- 팔레트를 디자인하는 데 사용할 수 있는 구문 및 매개변수에 대한 가이드를 제공하는 레퍼런스 워크시트
- XLSPalette 템플릿이 마지막으로 업데이트된 시점에 대한 정보를 제공하는 버전 워크시트
- 도구집합 워크시트의 데이터 유효성 검사를 위한 조회 테이블이 포함된 목록 워크시트 이 워크시트의 콘텐츠를 수정하지 마세요.
도구집합 워크시트는 필요에 따라 추가하거나 제거할 수 있습니다. 새 도구집합 워크시트를 추가하려면 기존 도구집합 워크시트의 복사본을 만들어 서식 및 데이터 유효성 검사가 유지되도록 합니다. XLSPalette가 .palette 파일로 변환되면 머리글 행 이외의 행이 포함되지 않은 도구집합 워크시트는 무시됩니다.
도구 등록정보 작업 시에는 다음 사항을 검토합니다.
- 대부분의 심볼 등록정보는 name=value 쌍으로 지정되고 앰퍼샌드로 구분됩니다.
- 색상은 표준 HTML 색상 이름 또는 16진수 색상 코드로 지정할 수 있습니다. 8자의 16진수 색상 코드를 사용하여 불투명도를 설정할 수 있습니다.
- 너비 및 크기는 픽셀 단위입니다.
- 라인 심볼은 사용자 설정 대시 패턴을 지원합니다.
- 도구 유형이 텍스트인 경우 textSymbol 열의 항목이 필요합니다. 기타 모든 유형의 경우 textSymbol 값은 선택 사항입니다.
유형 및 도구
팔레트는 도구 유형의 모든 조합을 포함할 수 있습니다. 지원되는 유형은 라인, 영역, 마커, 텍스트이며 각 도구집합 워크시트의 유형 열에 입력해야 합니다.
라인, 영역, 텍스트 유형은 해당 유형의 그리기 스타일을 결정하는 다양한 도구를 지원합니다. 각 도구집합 워크시트의 도구 열에서 도구를 지정할 수 있습니다. 마커 및 텍스트 유형에 대한 도구는 지정할 필요가 없습니다.
지원되는 도구의 전체 목록은 XLSPalette 템플릿의 레퍼런스 워크시트를 참고하세요.
심볼
각 도구는 각 도구집합 워크시트의 심볼 열에 지정할 수 있는 다양한 심볼 등록정보를 지원합니다.
라인의 경우 [n,n...] 형식의 실선 공간 쌍을 하나 이상 사용하여 사용자 설정 대시 패턴을 지정할 수 있습니다. 여기서 n은 상대 세그먼트 길이입니다(예시: [4,3,2,3]).
마커 심볼의 경우 첫 번째 값은 Esri 단순 마커 심볼 이름 또는 파일 확장자가 있는 이미지 파일 이름일 수 있습니다. 지원되는 이미지 형식은 SVG, PNG, JPG입니다. 단순 마커 심볼은 원형, 십자가, 마름모, 사각형, 삼각형, x입니다.
지원되는 심볼 및 등록정보의 전체 목록은 XLSPalette 템플릿의 레퍼런스 워크시트를 참고하세요.
텍스트
각 도구에는 텍스트 레이블이 첨부될 수 있습니다. 또한 텍스트 유형을 사용하여 레이블을 자체적으로 지정할 수 있습니다. 텍스트 서식은 각 도구집합 워크시트의 textSymbol 열에 지정됩니다.
alignment 등록정보의 경우 쉼표로 구분된 여러 정렬 값을 지정할 수 있습니다(예시: alignment=left,middle).
anchor 등록정보는 라인, 영역, 마커 유형에만 적용되며 그래픽 요소를 기준으로 텍스트 레이블을 배치할 위치를 지정합니다.
지원되는 스타일 및 등록정보의 전체 목록은 XLSPalette 템플릿의 레퍼런스 워크시트를 참고하세요.
도구집합 아이콘
도구집합 아이콘은 팔레트에 도구집합 이름과 함께 표시됩니다. 기본 설정에 따라 도구집합의 모든 도구가 동일한 도구를 사용하는 경우 아이콘은 해당 도구와 일치하도록 자동 설정됩니다. 도구집합에 대한 아이콘을 지정하려면 워크시트 이름에 &icon=를 추가한 다음 Esri Calcite UI 아이콘 라이브러리의 아이콘 이름 또는 미디어 폴더에 저장된 이미지 파일을 추가합니다. 지원되는 이미지 형식은 SVG, PNG, JPG입니다.
팁:
최상의 결과를 위해 도구집합 아이콘의 투명한 배경에 단일 색상을 사용합니다. 도구집합 아이콘은 팔레트에서 회색조로 렌더링됩니다.
워크시트 이름은 31자로 제한되며 공백을 포함할 수 있습니다(예시: New Works&icon=electric.svg).