Esri 는 전 세계 여러 지역에 대한 경계 및 인구 통계 정보가 포함되어 있는 레이어를 제공합니다. 시, 도, 인구 조사 영역, 우편 번호 경계 등의 이러한 레이어에는 포털 구성원들이 맵, 앱, 분석 도구, Insights for ArcGIS에서 사용할 수 있는 관련 지역 정보가 포함되어 있습니다.
Insights for ArcGIS가 설치되어 있거나 포털에 Living Atlas of the World에서 ArcGIS Online 콘텐츠에 접근하는 권한이 없는 경우에는 이러한 레이어를 포털에 발행할 수 있습니다.
포털 관리자는 My Esri에서 원하는 경계 레이어 서비스 정의(.sd)를 다운로드한 다음 publishboundarylayers 도구를 사용하여 파일에서 호스팅 피처 레이어를 발행할 수 있습니다.
참고 사항:
이 항목에 설명된 도구를 실행할 때는 빌트인 포털 관리자 계정을 사용해야 하며 Web Adaptor 또는 로드 밸런서가 아니라 포트 7443을 통해 포털에 접근해야 합니다.
원하는 모든 파일이 포함된 폴더에서 발행하거나, 개별 파일을 발행하거나, 텍스트 파일 형식으로 파일 목록을 제공할 수 있습니다. Portal for ArcGIS 서비스를 실행하는 데 사용하는 계정에 이 폴더에 대한 읽기 권한이 있는지 확인합니다.
이러한 경계 서비스 정의(.sd) 파일을 포털에 발행하는 경우의 결과는 다음과 같습니다.
- 각 .sd이(가) 포털의 서비스 정의 항목으로 추가됩니다. 업데이트된 콘텐츠를 사용할 수 있을 때 경계 레이어를 업데이트하려면 이러한 파일을 포털에 유지해야 합니다.
- 발행하는 각 .sd 파일에 대해 호스팅 피처 레이어가 생성됩니다. 각 호스팅 피처 레이어에는 여러 레이어가 포함됩니다.
- 내부 포털 구성원 esri_boundaries가 서비스 정의 항목과 호스팅 피처 레이어를 모두 소유합니다. 이러한 항목의 소유권을 다른 사용자로 변경하지 마세요.
- 기본 설정에 따라 포털 기관의 모든 구성원에게는 포털의 경계 호스팅 피처 레이어 접근 권한이 있습니다.
경계 레이어 발행
이러한 레이어에는 Esri 마스터 라이선스 동의서에 따른 라이선스가 부여되었습니다. 발행에 앞서 요약 및 사용 약관을 읽어 보세요.
사용에 따른 주요 요구 사항
- 이러한 레이어는 Portal for ArcGIS, Insights for ArcGIS, 연결된 기타 ArcGIS 앱을 비롯하여 ArcGIS Enterprise에서 내부용으로 사용하도록 라이선스가 부여되었습니다.
- 사용자는 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 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 --folder c:\temp\boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서도 파일이 같은 디렉터리(boundaryfiles)에 있지만 2개 파일이 발행됩니다.
publishboundarylayers --folder c:\temp\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서는 boundarysubset.txt 디렉터리에 텍스트 파일(boundaryfiles)이 생성되었습니다. 도구는 텍스트 파일의 파일 목록을 읽어 경계 레이어 일부분을 발행합니다.
publishboundarylayers --folder c:\temp\boundaryfiles --file boundarysubset.txt --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 옵션을 사용하는 경우에는 발행할 경계 파일 목록이 포함된 텍스트 파일의 이름을 지정합니다.
이 예시에서는 boundaryfiles 디렉터리의 모든 파일이 포털에 발행되어 기존 레이어를 덮어씁니다.
updateboundarylayers --folder c:\temp\boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서도 파일이 같은 디렉터리(boundaryfiles)에 있지만 1개 파일만 다시 발행됩니다.
updateboundarylayers --folder c:\temp\boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin이 예시에서는 boundaryupdatesubset.txt 디렉터리에 텍스트 파일(boundaryfiles)이 생성되었습니다. 도구는 텍스트 파일의 파일 목록을 읽어 경계 레이어 일부분을 다시 발행합니다.
updateboundarylayers --folder c:\temp\boundaryfiles --file boundaryupdatesubset.txt --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 --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.txt 파일은 c:\data\boundaries에 있습니다. 이 파일에는 포털 https://portal.domain.com:7443/arcgis에서 삭제할 레이어 목록이 포함되어 있습니다.
deleteboundarylayers --file c:\data\boundaries\boundarylist.txt --url https://portal.domain.com:7443/arcgis --username portaladmin