Począwszy od wersji 10.5.1 witryny Portal for ArcGIS, możliwe jest dodawanie do portalu niestandardowych widżetów. Oznacza to, że można wybierać niestandardowe widżety w środowisku kreatora podczas tworzenia aplikacji. Aby możliwe było użycie niestandardowego widżetu, musi on być hostowany na serwerze internetowym i zarejestrowany w portalu. Ze względów bezpieczeństwa tylko administratorzy portalu mogą zarejestrować niestandardowe widżety, a w aplikacjach publicznych niestandardowy widżet nie jest wczytywany, gdy korzystają z nich użytkownicy anonimowi.
Hostowanie niestandardowego widżetu na serwerze internetowym
Hostowanie niestandardowego widżetu na serwerze internetowym nie różni się niczym od hostowania innych aplikacji internetowych. Należy zainstalować i skonfigurować serwer internetowy. Popularnymi serwerami internetowymi są IIS, OS X Server oraz Apache.
Aby hostować niestandardowe widżety na serwerze internetowym, wykonaj następujące czynności:
- Włącz dostęp anonimowy do serwera internetowego.
Lokalizacja hostowania musi być dostępna anonimowo.
- Włącz protokół HTTPS.
Włącz na serwerze internetowym dostęp z użyciem protokołu HTTPS, aby uniknąć tworzenia zasobów mieszanych. Aplikacja Web AppBuilder nie zezwala na mieszanie aktywnych zasobów wynikające z wczytywania treści HTTP w ramach połączenia HTTPS. Ponadto w celu ustanowienia połączenia HTTPS serwer powinien mieć ważny certyfikat SSL wydany przez ośrodek certyfikacji.
- Włącz udostępnianie zasobów na serwerach w różnych domenach (CORS).
Aplikacja Web AppBuilder jest uruchomiona w domenie portalu, która może różnić się od domeny serwera internetowego hostującego niestandardowy widżet. Należy włączyć mechanizm CORS na serwerze internetowym, aby zezwolić na dostęp z poziomu domeny portalu użytkownika.
- Dodaj obsługę formatu JSON na serwerze internetowym.
Każdy widżet zawiera plik manifestu JSON, który opisuje właściwości widżetu. Niektóre serwery internetowe domyślnie nie rozpoznają rozszerzenia pliku JSON. W takich przypadkach należy dodać je do serwera jako nowy typ MIME na poziomie aplikacji lub wyższym. W specyfikacji typu MIME należy umieścić rozszerzenie nazwy pliku .json oraz typ MIME application/json.
- Wdróż niestandardowy widżet na serwerze internetowym.
Możesz skopiować folder niestandardowego widżetu na serwer internetowy. Po wdrożeniu należy uzyskać ścieżkę adresu URL do pliku manifestu niestandardowego widżetu. Przykładową ścieżką adresu URL pliku manifestu jest <server.domain.com>/<my widget>/manifest.json.
Rejestracja niestandardowego widżetu
Niestandardowy widżet należy zarejestrować w portalu. W tym celu użytkownik musi być zalogowany jako administrator.
- W oknie przeglądarki zaloguj się do portalu.
- Kliknij pozycję Moje zasoby.
- Kliknij przycisk Dodaj element i wybierz opcję Aplikacja.
- Wybierz opcję Rozszerzenie aplikacji (App Builder) i podaj adres URL pliku manifestu.
Przykładową ścieżką adresu URL pliku manifestu jest <server.domain.com>/<my widget>/manifest.json.
- Kliknij pole Tytuł.
Tytuł elementu zostanie automatycznie wypełniony treścią z pliku manifestu. Można również zmodyfikować tytuł ręcznie.
- Dodaj znaczniki w polu Znaczniki.
- Kliknij przycisk Dodaj element.
Niestandardowy widżet jest teraz dostępny w obszarze Moje zasoby jako typ Rozszerzenie aplikacji App Builder.
Udostępnianie niestandardowego widżetu
Administrator może udostępnić niestandardowy widżet grupom w instytucji, które potrzebują do niego dostępu, lub całej instytucji, jeśli to konieczne.
Uwaga:
Nie zaleca się publicznego udostępniania elementu niestandardowego widżetu. Ze względów bezpieczeństwa aplikacji publiczna nie wczytuje niestandardowego widżetu, gdy korzystają z niej użytkownicy anonimowi. Ponadto aplikacja wczytuje tylko niestandardowy widżet, który został zarejestrowany w tej samej instytucji, co użytkownicy, którzy dysponują uprawnieniami dostępu do aplikacji.
W obszarze Moje zasoby znajdź niestandardowy widżet i udostępnij go grupom lub instytucji. Po otwarciu kreatora niestandardowy widżet jest wyświetlany na karcie Niestandardowe w oknie dialogowym Wybór widżetu.
Aktualizowanie niestandardowego widżetu
Co prawda nie można aktualizować niestandardowego widżetu w portalu, można jednak zaktualizować strukturę HTML i kod JavaScript hostowanego niestandardowego widżetu na serwerze internetowym.
Notatka:
Po wdrożeniu niestandardowego widżetu na serwerze internetowym i zarejestrowaniu go jako typ elementu Rozszerzenie aplikacji App Builder w portalu treść pliku manifestu zostaje zapisana w elemencie rozszerzenia. Oznacza to, że zmiany wprowadzone do pliku manifestu, który jest hostowany na serwerze internetowym, nie będą rozpoznawane przez zarejestrowane rozszerzenie. Zaleca się, aby utworzyć nowe rozszerzenie, zamiast aktualizować plik manifestu.