Począwszy od wersji 10.5.1 witryny ArcGIS Enterprise, 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ą rejestrować widżety niestandardowe. W wersji 10.6 widżety niestandardowe udostępniane wszystkim użytkownikom (publicznie) mogą być używane w aplikacjach publicznych i dostępne dla użytkowników anonimowych.
Wcześniejsze:
W wersji 10.5.1 w aplikacjach publicznych nie można wczytywać widżetów niestandardowych. To ograniczenie zostało usunięte w wersji 10.6. Teraz widżety niestandardowe udostępniane publicznie mogą być używane w aplikacjach publicznych i dostępne dla użytkowników anonimowych.
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 portalu.
- W oknie przeglądarki zaloguj się do portalu.
- Kliknij kartę Moje zasoby na stronie zasobów.
- Kliknij przycisk Dodaj element i wybierz opcję Aplikacja.
- Wybierz opcję Rozszerzenie aplikacji (AppBuilder) 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.
Widżet niestandardowy jest teraz dostępny na karcie Moje zasoby na stronie zasobów jako typ Rozszerzenie aplikacji AppBuilder.
Udostępnianie niestandardowego widżetu
Administrator portalu może udostępnić niestandardowy widżet grupom w instytucji, które potrzebują do niego dostępu, całej instytucji lub publicznie, jeśli to konieczne.
Uwaga:
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.
Na karcie Moje zasoby znajdź niestandardowy widżet i udostępnij go. Po otwarciu kreatora niestandardowy widżet jest wyświetlany na karcie Niestandardowe w oknie dialogowym Wybór widżetu.
Uwaga:
Jeśli podczas wczytywania widżetu niestandardowego zostanie wyświetlony błąd 404, upewnij się, że widżet nie wymaga modułów określanych przy użyciu nazwy pakietu widżetów. Zamiast tej nazwy do wczytywania modułów użyj ścieżki względnej.
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 elementu typu Rozszerzenie aplikacji AppBuilder 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.