Portal for ArcGIS 10.5.1부터는 포털에 사용자 정의 위젯을 추가할 수 있습니다. 즉, 앱 생성 시 빌더 환경에서 사용자 정의 위젯을 선택할 수 있습니다. 사용자 정의 위젯을 사용하려면 먼저 사용자 정의 위젯을 웹 서버에서 호스팅하고 포털에 등록해야 합니다. 보안상의 이유로 포털 관리자만 사용자 정의 위젯을 등록할 수 있으며 공용 앱에서는 익명 사용자가 사용자 정의 위젯에 접근하는 경우 불러오지 않습니다.
웹 서버에서 사용자 정의 위젯 호스팅
웹 서버에서 사용자 정의 위젯을 호스팅하는 방법은 다른 웹 앱을 호스팅하는 방법과 같습니다. 웹 서버를 설치하고 구성해야 합니다. 일반 웹 서버에는 IIS, OS X Server, Apache가 포함됩니다.
웹 서버에서 사용자 정의 위젯을 호스팅하려면 다음 단계를 완료합니다.
- 웹 서버에 대한 익명 접근을 활성화합니다.
호스팅 위치는 익명으로 접근할 수 있어야 합니다.
- HTTPS를 활성화합니다.
웹 서버에 HTTPS 접근을 활성화하여 혼합 콘텐츠 생성을 방지합니다. Web AppBuilder를 사용하면 HTTPS 연결을 통해 HTTP를 불러옴으로써 생성되는 혼합 활성 콘텐츠가 허용되지 않습니다. 또한 HTTPS 연결을 설정하려면 인증 기관에서 발급된 올바른 SSL 인증서가 서버에 있어야 합니다.
- CORS(Cross Origin Resource Sharing) 활성화
Web AppBuilder는 포털 도메인에서 실행되는데, 이 도메인은 사용자 정의 위젯을 호스팅하는 웹 서버의 도메인과 다를 수 있습니다. 포털 도메인에서의 접근이 허용되도록 웹 서버에서 CORS를 활성화해야 합니다.
- JSON 처리기를 웹 서버에 추가합니다.
각 위젯은 위젯 등록정보를 설명하는 JSON 매니페스트 파일로 구성됩니다. 일부 웹 서버에서는 기본 설정에 따라 JSON 파일 확장자가 인식되지 않습니다. 이 경우 JSON 매니페스트 파일을 응용프로그램 이상 레벨에서 새로운 MIME 유형으로 서버에 추가해야 합니다. MIME 유형에는 .json이 파일 이름 확장자로 사용되어야 하며 application/json이 MIME 유형으로 사용됩니다.
- 사용자 정의 위젯을 웹 서버에 배포합니다.
사용자 정의 위젯 폴더를 웹 서버에 복사할 수 있습니다. 배포 후, 사용자 정의 위젯 매니페스트 파일의 URL 경로를 얻어야 합니다. 매니페스트 파일에 대한 URL 경로의 예시는 <server.domain.com>/<my widget>/manifest.json입니다.
사용자 정의 위젯 등록
포털에서 각 사용자 정의 위젯을 등록해야 합니다. 이 작업을 수행하려면 관리자로 로그인해야 합니다.
- 브라우저 창에서 포털에 로그인합니다.
- 내 콘텐츠를 클릭합니다.
- 항목 추가를 클릭하고응용프로그램을 선택합니다.
- 응용프로그램 익스텐션(앱 빌더)을 선택하고 매니페스트 파일의 URL을 제공합니다.
<server.domain.com>/<my widget>/manifest.json 등이 매니페스트 파일의 URL 경로입니다.
- 제목 상자를 클릭합니다.
항목의 제목은 매니페스트 파일을 통해 자동으로 채워집니다. 필요에 따라 제목을 수동으로 편집할 수 있습니다.
- 태그 상자에 태그를 추가합니다.
- 항목 추가를 클릭합니다.
사용자 정의 위젯이 내 콘텐츠에 앱 빌더 익스텐션 유형으로 제공됩니다.
사용자 정의 위젯 공유
관리자는 사용자 정의 위젯에 접근해야 하는 기관 그룹 또는 전체 기관(필요한 경우)과 사용자 정의 위젯을 공유할 수 있습니다.
주의:
사용자 정의 위젯을 공개적으로 공유하는 것은 권장되지 않습니다. 보안상의 이유로, 공용 앱에서는 익명 사용자 접근 시 사용자 정의 위젯을 불러오지 않습니다. 또한 앱에서는 앱 접근 권한이 있는 사용자와 동일한 기관에 등록되어 있는 사용자 정의 위젯만 불러옵니다.
내 콘텐츠에서 사용자 정의 위젯을 찾아 그룹이나 기관과 공유합니다. 빌더를 열면 위젯 선택 대화 상자의 사용자 정의 탭에 사용자 정의 위젯이 표시됩니다.
사용자 정의 위젯 업데이트
포털의 사용자 정의 위젯은 업데이트할 수 없지만 웹 서버에 있는 호스팅 사용자 정의 위젯의 HTML 구조와 JavaScript 코드를 업데이트할 수 있습니다.
참고 사항:
사용자 정의 위젯을 웹 서버에 배포한 다음, 포털에 앱 빌더 익스텐션 유형으로 등록하고 나면 매니페스트 파일의 내용이 익스텐션 항목에 저장됩니다. 즉, 웹 서버에서 호스팅되는 매니페스트 파일에 대한 변경 내용이 등록된 익스텐션에서는 인식되지 않습니다. 따라서 매니페스트 파일을 업데이트하기보다는 새 익스텐션을 생성하는 것이 좋습니다.