ArcGIS Enterprise 10.5.1부터는 포털에 사용자 정의 위젯을 추가할 수 있습니다. 즉, 앱 생성 시 빌더 환경에서 사용자 정의 위젯을 선택할 수 있습니다. 사용자 정의 위젯을 사용하려면 먼저 사용자 정의 위젯을 웹 서버에서 호스팅하고 포털에 등록해야 합니다. 보안상의 이유로, 포털 관리자만 사용자 정의 위젯을 등록할 수 있습니다. 10.6에서는 모든 사람(공개)과 공유한 사용자 정의 위젯을 익명 사용자의 접근을 위해 공용 앱에서 사용되도록 할 수 있습니다.
기존:
10.5.1의 경우에는 공용 앱에서 사용자 정의 위젯을 불러올 수 없습니다. 이 제한은 10.6에서 제거되었습니다. 이제, 모든 사람(공개)과 공유한 사용자 정의 위젯을 공용 앱에 사용하여 익명 사용자의 접근이 가능하도록 할 수 있습니다.
웹 서버에서 사용자 정의 위젯 호스팅
웹 서버에서 사용자 정의 위젯을 호스팅하는 방법은 다른 웹 앱을 호스팅하는 방법과 같습니다. 웹 서버를 설치하고 구성해야 합니다. 일반 웹 서버에는 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입니다.
사용자 정의 위젯 등록
포털에서 각 사용자 정의 위젯을 등록해야 합니다. 이 작업을 수행하려면 포털 관리자로 로그인해야 합니다.
- 브라우저 창에서 포털에 로그인합니다.
- 콘텐츠 페이지의 내 콘텐츠 탭을 클릭합니다.
- 항목 추가를 클릭한 다음 응용프로그램을 선택합니다.
- 응용프로그램 익스텐션(AppBuilder)을 선택하고 매니페스트 파일에 대한 URL을 제공합니다.
매니페스트 파일에 대한 URL 경로의 예시는 <server.domain.com>/<my widget>/manifest.json입니다.
- 제목 상자를 클릭합니다.
항목의 제목은 매니페스트 파일을 통해 자동으로 채워집니다. 필요에 따라 제목을 수동으로 편집할 수 있습니다.
- 태그 상자에 태그를 추가합니다.
- 항목 추가를 클릭합니다.
이제, 사용자 정의 위젯이 콘텐츠 페이지의 내 콘텐츠 탭에서 AppBuilder 익스텐션 유형으로 제공됩니다.
사용자 정의 위젯 공유
포털 관리자는 사용자 정의 위젯에 접근해야 하는 기관 그룹, 전체 기관 또는 모든 사람(필요한 경우)과 사용자 정의 위젯을 공유할 수 있습니다.
주의:
앱에서는 앱 접근 권한이 있는 사용자와 동일한 기관에 등록되어 있는 사용자 정의 위젯만 불러옵니다.
내 콘텐츠에서 사용자 정의 위젯을 찾아 공유합니다. 빌더를 열면 위젯 선택 대화 상자의 사용자 정의 탭에 사용자 정의 위젯이 표시됩니다.
주의:
사용자 정의 위젯을 불러올 때 404 오류가 발생하면 해당 위젯에 위젯 패키지 이름이 사용된 모듈이 필요하지 않도록 해야 합니다. 대신, 상대 경로를 사용하여 모듈을 불러옵니다.
사용자 정의 위젯 업데이트
포털의 사용자 정의 위젯은 업데이트할 수 없지만 웹 서버에 있는 호스팅 사용자 정의 위젯의 HTML 구조와 JavaScript 코드를 업데이트할 수 있습니다.
참고 사항:
사용자 정의 위젯을 웹 서버에 배포한 다음, 포털에 AppBuilder 익스텐션 유형으로 등록하고 나면 매니페스트 파일의 내용이 익스텐션 항목에 저장됩니다. 즉, 웹 서버에서 호스팅되는 매니페스트 파일에 대한 변경 내용이 등록된 익스텐션에서는 인식되지 않습니다. 따라서 매니페스트 파일을 업데이트하기보다는 새 익스텐션을 생성하는 것이 좋습니다.