Esri 는 전 세계 여러 지역에 대한 경계 및 인구 통계 정보가 포함되어 있는 레이어를 제공합니다. 시, 도, 인구 조사 영역, 우편 번호 경계 등의 이러한 레이어에는 포털 구성원들이 맵, 씬, 앱, 피처 분석 도구 및 Insights for ArcGIS에서 사용할 수 있는 관련 지역 정보가 포함되어 있습니다.
Insights for ArcGIS가 설치되어 있거나 포털에 ArcGIS Living Atlas of the World에서 ArcGIS Online 콘텐츠에 접근하는 권한이 없는 경우에는 이러한 레이어를 포털에 발행할 수 있습니다.
포털 관리자는 My Esri에서 원하는 경계 레이어 서비스 정의(.sd)를 다운로드한 다음 publishboundarylayers 도구를 사용하여 파일에서 호스팅 피처 레이어를 발행할 수 있습니다.
비고:
이 항목에서 설명된 도구를 실행하는 경우 빌트인 포털 관리자 계정을 사용해야 합니다. 이러한 도구에 사용하는 URL은 ArcGIS Enterprise를 배포하는 위치에 따라 다릅니다.
- 도구를 온프레미스 ArcGIS Enterprise 배포에서 실행하는 경우에는 웹 어댑터나 로드 밸런서 대신 포트 7443을 통해 포털에 접근해야 합니다.
- 이러한 도구를 클라우드의 ArcGIS Enterprise 배포에서 실행하는 경우에는 웹 어댑터나 로드 밸런서를 통해 포털에 접근해야 합니다. 포트 7443을 사용하지 마세요.
원하는 모든 파일이 포함된 폴더에서 발행하거나, 개별 파일을 발행하거나, 텍스트 파일 형식으로 파일 목록을 제공할 수 있습니다. Portal for ArcGIS를 설치하는 데 사용하는 계정에 이 디렉터리에 대한 읽기 권한이 있는지 확인합니다.
이러한 경계 서비스 정의(.sd) 파일을 포털에 발행하는 경우의 결과는 다음과 같습니다.
- 각 .sd이(가) 포털의 서비스 정의 항목으로 추가됩니다. 업데이트된 콘텐츠를 사용할 수 있을 때 경계 레이어를 업데이트하려면 이러한 파일을 포털에 유지해야 합니다.
- 발행하는 각 .sd 파일에 대해 호스팅 피처 레이어가 생성됩니다. 각 호스팅 피처 레이어에는 여러 레이어가 포함됩니다.
- 내부 포털 구성원 esri_boundaries가 서비스 정의 항목과 호스팅 피처 레이어를 모두 소유합니다. 이러한 항목의 소유권을 다른 사용자로 변경하지 마세요.
- 기본 설정에 따라 포털 기관의 모든 구성원에게는 포털의 경계 호스팅 피처 레이어 접근 권한이 있습니다. 포털 구성원은 다음과 같은 방법을 사용하여 경계 레이어에 접근할 수 있습니다.
- 포털의 콘텐츠 페이지에 있는 내 기관 탭에서 경계 레이어 항목을 검색합니다.
- Analysis Layer 선택 대화 상자에서 Map Viewer의 피처 분석 도구에 개별 경계 레이어를 추가합니다.
- 콘텐츠 패널에서 Scene Viewer에 경계 레이어를 추가합니다.
경계 레이어 발행
이러한 레이어에는 Esri 마스터 라이선스 동의서에 따른 라이선스가 부여되었습니다. 발행에 앞서 요약 및 사용 약관을 읽어 보세요.
사용에 따른 주요 요구 사항
- 이러한 레이어는 Portal for ArcGIS, ArcGIS Enterprise, 연결된 기타 ArcGIS 앱을 비롯하여 Insights for ArcGIS에서 내부용으로 사용하도록 라이선스가 부여되었습니다.
- 사용자는 ArcGIS Enterprise 제품군을 외부용 ArcGIS 또는 기타 응용프로그램에서의 오프라인 용도로 데이터를 내보낼 수 없습니다.
- 또한 Esri의 별도 서면 허가 없이, 다른 기관 구성원이나 모든 사용자의 외부 사용을 위해 레이어를 공유(공개적으로든 비공개적으로든)하는 것은 허용되지 않습니다.
- 이러한 레이어는 Esri에서 다운로드한 후 2년 동안 사용할 수 있도록 라이선스가 부여되었습니다. 매년 최신 데이터를 다운로드하여 라이선스를 연장할 수 있습니다.
- 이러한 레이어의 표시에는 각 레이어에 발행된 크레딧(귀속)이 포함되어야 합니다.
다음 단계에 따라 경계 파일을 가져온 다음 포털에서 피처 레이어로 호스팅합니다.
- 서비스 정의가 포함된 압축 파일(.sd)을 My Esri에서 다운로드합니다.
- My Esri에 로그인합니다.
- 내 기관 > 다운로드 > 데이터 및 콘텐츠로 이동합니다.
- 검색 필드에 경계를 입력하여 경계 레이어가 표시되도록 필터링합니다.
- 원하는 파일에 대해 다운로드를 클릭합니다.
- 다운로드한 파일을 추출한 다음 Portal for ArcGIS 머신의 폴더에 저장합니다.
파일 이름에는 적용되는 지역을 나타내는 세 자리 문자 코드가 사용되며, 데이터가 적용되는 연도가 이름 끝에 추가됩니다. 예를 들어 USA_Boundaries_2015는 2015년에 나타난 미국의 경계를 포함합니다.
포털에 업로드하지 않고 발행하지 않을 파일을 제거합니다. 업로드 및 발행할 파일 일부분의 목록이 포함된 텍스트 파일을 생성할 수도 있습니다. 파일 이름이 한 줄에 하나씩 포함되도록 텍스트 파일 서식을 지정합니다. 예를 들어 미국 또는 세계의 경계를 업로드하려는 경우 텍스트 파일에 다음 항목을 포함합니다.
USA_Boundaries_2015 WOR_Boundaries_2015
- Portal for ArcGIS 머신에서 명령 터미널을 엽니다.
- 도구 위치로 디렉터리를 변경합니다.
- publishboundarylayers 도구를 실행합니다.
도구는 <Portal installation directory>/tools/publishboundarylayers에 설치되어 있습니다. 도구의 구문은 다음과 같습니다. publishboundarylayers --folder <location of sd files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]
비밀번호를 지정하지 않으면 도구를 실행할 때 포털 관리자의 비밀번호를 입력하라는 메시지가 표시됩니다. 이 사용자는 포털의 기본 관리자 역할 구성원이어야 합니다.
--files 작업을 사용하는 경우에는 서비스 정의 파일의 쉼표로 구분된 목록을 지정합니다. --file 옵션을 사용하는 경우에는 발행할 경계 파일 목록이 포함된 텍스트 파일의 위치 및 이름을 지정합니다.
이 예시에서는 boundaryfiles 디렉터리의 모든 파일이 온-프레미스 포털에 발행됩니다.
./publishboundarylayers.sh --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서도 파일이 같은 디렉터리(boundaryfiles)에 있지만 2개 파일이 발행됩니다.
./publishboundarylayers.sh --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서는 boundarysubset.vi 디렉터리에 텍스트 파일(boundaryfiles)이 생성되었습니다. 도구는 텍스트 파일의 파일 목록을 읽어 경계 레이어 일부분을 발행합니다.
./publishboundarylayers.sh --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin
발행이 완료되면 발행한 각 .sd 파일에 대해 서비스 정의 항목 및 호스팅 피처 레이어가 생성됩니다.
파일이 있는지 확인하려는 경우 포털에서 내부 포털 구성원 esri_boundaries가 소유한 모든 항목을 검색할 수 있습니다. 포털 검색 필드에 owner:esri_boundaries를 입력하고 모든 콘텐츠를 검색합니다.
경계 레이어 업데이트
대부분의 경우 경계 레이어의 업데이트는 publishboundarylayers 유틸리티를 사용하여 포털에 발행하는 새 서비스 정의 파일로 제공됩니다. 이를 통해 레이어를 독립적으로 사용하고 두 가지 버전의 데이터를 분석할 수 있습니다. 예를 들어 2015 버전과 2017 버전의 세계 경계 파일이 있을 수 있습니다. 극히 드문 경우이지만, My Esri에서 제공된 서비스 정의 파일이 올바른 콘텐츠로 업데이트되는 경우도 있습니다. 이 경우 updateboundarylayers 도구를 사용하여 업데이트 파일을 다운로드한 다음 발행할 수 있습니다. 이렇게 하면 포털의 기존 호스팅 피처 레이어를 덮어씁니다.
소개 부분에서 설명한 것처럼 경계 레이어의 서비스 정의 항목이 포털에 계속 있어야 해당 레이어를 업데이트할 수 있습니다.
다음 단계에 따라 포털에서 경계 피처 레이어를 업데이트합니다.
- 업데이트된 서비스 정의 파일(.sd)이 포함된 압축 파일을 My Esri에서 다운로드합니다.
- 파일을 추출한 다음 Portal for ArcGIS 머신의 폴더에 저장합니다.
포털에 업로드하지 않고 발행하지 않을 파일을 제거합니다. 업로드 및 발행할 파일 일부분의 목록이 포함된 텍스트 파일을 생성할 수도 있습니다. 파일 이름이 한 줄에 하나씩 포함되도록 텍스트 파일 서식을 지정합니다. 예를 들어 미국 및 세계의 경계를 업로드하려는 경우 텍스트 파일에 다음 항목을 포함합니다.
USA_Boundaries_2015 WOR_Boundaries_2015
- Portal for ArcGIS 머신에서 명령 터미널을 엽니다.
- 도구 위치로 디렉터리를 변경합니다.
- updateboundarylayers 도구를 실행합니다.
도구는 <Portal installation directory>/tools/publishboundarylayers에 설치되어 있습니다. 도구의 구문은 다음과 같습니다. updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]
비밀번호를 지정하지 않으면 도구를 실행할 때 포털 관리자의 비밀번호를 입력하라는 메시지가 표시됩니다. 이 사용자는 포털의 기본 관리자 역할 구성원이어야 합니다.
--files 작업을 사용하는 경우에는 서비스 정의 파일의 쉼표로 구분된 목록을 지정합니다. --file 옵션을 사용하는 경우에는 발행할 경계 파일 목록이 포함된 텍스트 파일의 이름을 지정합니다.
이 예시에서 updateboundarylayers 도구는 boundaryfiles 디렉터리의 모든 파일을 발행하고 기존 레이어를 덮어씁니다.
./updateboundarylayers.sh --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서도 파일이 같은 디렉터리(boundaryfiles)에 있지만 1개 파일만 다시 발행됩니다.
./updateboundarylayers.sh --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서는 boundaryupdatesubset.vi 디렉터리에 텍스트 파일(boundaryfiles)이 생성되었습니다. 도구는 텍스트 파일의 파일 목록을 읽어 경계 레이어 일부분을 재발행합니다.
./updateboundarylayers.sh --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin
발행이 완료되면 기존 호스팅 피처 레이어에 업데이트된 데이터 또는 메타데이터가 포함됩니다.
경계 레이어 삭제
포털에 필요하지 않다고 결정한 경계 레이어는 삭제할 수 있습니다. 포털 웹사이트에서 레이어를 검색하여 삭제하거나 deleteboundarylayers 도구를 실행할 수 있습니다. 여러 경계 레이어를 삭제하려면 deleteboundarylayers 도구를 사용합니다.
deleteboundarylayers 도구는 삭제 방지가 활성화된 레이어를 삭제하지 않습니다.
주의:
현재 맵, 앱 또는 씬에서 사용하고 있는 경계 레이어를 삭제하면 맵, 앱 또는 씬에 해당 레이어가 더 이상 나타나지 않습니다. 레이어를 다시 발행하면 포털에서 새 ID가 지정된 새 항목이 생성되므로 맵, 앱 또는 씬에서 레이어가 바뀌지는 않습니다.
--files 작업을 사용하여 삭제하려는 레이어의 쉼표로 구분된 목록을 제공할 수도 있고, --file 작업을 사용하여 삭제하려는 레이어 목록이 포함된 텍스트 파일을 제공할 수도 있습니다.
쉼표로 구분된 레이어 목록을 제공하는 구문은 다음과 같습니다. deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]
예를 들어 포털 관리자 portaladmin으로 포털 https://portal.domain.com:7443/arcgis에서 USA_Boundaries_2015 및 WOR_Boundaries_2015 레이어를 삭제하려면 다음을 입력합니다.
./deleteboundarylayers.sh --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin
삭제하려는 레이어 목록이 포함된 텍스트 파일을 제공하는 구문은 다음과 같습니다. deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]
예를 들어 파일을 사용하여 동일한 레이어를 삭제하려면 아래에 나와 있는 것처럼 레이어 이름이 한 줄에 하나씩 포함된 텍스트 파일을 생성한 다음 도구를 실행할 때 텍스트 파일의 이름과 위치를 제공합니다.
USA_Boundaries_2015 WOR_Boundaries_2015
다음 예시에서 boundarylist 파일은 /usr/data/boundaries에 있습니다. 이 파일에는 포털 https://webadaptorhost.domain.com/webadaptorname에서 삭제할 레이어 목록이 포함되어 있습니다.
./deleteboundarylayers.sh --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin