Aby utworzyć własny szablon niestandardowej aplikacji internetowej, możesz pobrać i zmodyfikować jeden z istniejących szablonów, zaktualizować istniejącą aplikację internetową pod kątem pracy z zasobami z własnego portalu lub utworzyć nową aplikację internetową za pomocą wybranego interfejsu ArcGIS Web API. Niezależnie od tego, w jaki sposób utworzysz szablon, będziesz pracować z parametrami URL i mapami. Możesz pracować z grupami, jeśli tworzysz szablon grupy, a także rozważyć wprowadzenie dodatkowych wymagań dotyczących pracy z mapami bazowymi Map Bing, uzyskiwania dostępu do niepublicznych map i pracy z zasobami, które wymagają serwera proxy lub udostępniania zasobów cross-origin (CORS).
Po utworzeniu szablonu aplikacji internetowej możesz dodać element aplikacji do portalu. Jeśli instytucja planuje wykorzystać Twój szablon w jednej ze swoich galerii aplikacji, możesz go także udostępnić jednej z grup szablonów instytucji. Aby zezwolić użytkownikom na dostosowywanie wyglądu i zachowania Twojej niestandardowej aplikacji internetowej, możesz .ustawić ją jako konfigurowalną.
Witryna Portal for ArcGIS zawiera interfejs ArcGIS API 3.15 for JavaScript. Nie jest konieczne hostowanie własnego interfejsu API i przekierowywanie portalu na wersję lokalną dla nowo utworzonych szablonów aplikacji; szablony aplikacji internetowych automatycznie odwołują się do zainstalowanych interfejsów API. Lokalnie zainstalowany interfejs API zazwyczaj jest dostępny pod adresem https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi.
Uwaga:
Nie należy modyfikować plików szablonu aplikacji internetowej dostępnych w Portal for ArcGIS, ponieważ pliki te są zarządzane przez portal i jakiekolwiek wprowadzone zmiany mogą być następnie zastąpione przez portal. Jeśli chcesz dostosować szablony, postępuj zgodnie z poniższymi wskazówkami:
- Utwórz kopię istniejącego pliku szablonu, który chcesz dostosować.
- Umieść kopię w innej lokalizacji na dysku.
- Dostosuj kopię szablonu.
- Dodaj ją do portalu jako nowy szablon.
W tym temacie zamieszczono informacje dotyczące tworzenia szablonu aplikacji internetowej. Przyjęto w nim założenie, że posiadasz uprawnienia do tworzenia zasobów oraz udostępniania ich w grupach instytucji.
Mapy internetowe
Szablony aplikacji służą do pracy z mapą aktualnie wyświetlaną w przeglądarce Map Viewer. Zazwyczaj szablony umożliwiają utworzenie mapy na podstawie mapy internetowej określonej w parametrze URL mapy internetowej. Każdy internetowy interfejs API jest wyposażony w metodę pomocniczą, która umożliwia utworzenie mapy z użyciem informacji znajdujących się w identyfikatorze mapy internetowej.
Na przykład można użyć metody ArcGIS API for JavaScript esri.arcgis.utils.createMap, aby utworzyć mapę na podstawie identyfikatora wejściowego. Można również dodać funkcję wywoływaną zwrotnie wykonywaną po zakończeniu synchronicznego żądania esri.arcgis.utils.createMap.esri.arcgis.utils.createMap(webmap,"map",{
mapOptions:{
slider:false
},
bingMapsKey:bingMapsKey
}).then(function(response){
map = response.map;
});
Notatka:
Jeśli mapa internetowa zawiera mapę bazową z Bing Maps, podczas korzystania z metody createMap należy podać klucz Bing Maps. Można także określić kilka innych opcji mapy, takich jak wyświetlanie suwaka, nawigacji, atrybutów itd.
Funkcja callback zapewnia dostęp do obiektu odpowiedzi, który z kolei umożliwia uzyskanie dostępu do obiektu, warstw lub innych elementów mapy.
Rejestracja szablonu aplikacji
W przypadku pracy z bezpiecznymi elementami w szablonie aplikacji najpierw należy je zarejestrować na platformie. Aby to zrobić, dodaj nowy element aplikacji map internetowych i podaj adres URL szablonu aplikacji hostowanego na serwerze internetowym.
Po dodaniu elementów musisz zarejestrować aplikację. Ponieważ jest to aplikacja internetowa, typ powinien mieć wartość Browser, natomiast adres Redirect URI powinien być adresem URL szablonu aplikacji.
Po zarejestrowaniu aplikacji powinien zostać przydzielony unikalny identyfikator aplikacji.
Praca z menedżerem tożsamości pozwalająca na rozpoznawanie zarejestrowanego identyfikatora aplikacji. Więcej informacji zawierają zawarte w interfejsie ArcGIS API for JavaScript przykłady OAuth Basic i OAuth Popup.
Grupa
W szablonach grupy wyświetlana jest zawartość określonej grupy w formie aplikacji.
Interfejs ArcGIS REST API zapewnia dostęp do zasobów portalu. Można go używać do pobierania zasobów grupy na podstawie jej identyfikatora wejściowego.
W tym przykładzie wykonujesz wyszukiwanie w celu znalezienia grupy z identyfikatorem wejściowym.
var portal = new esri.arcgis.Portal('https://webadaptorhost.domain.com/webadaptorname/');
dojo.connect(portal, 'onLoad',function(){
portal.queryGroup(groupid).then(function(response){
var group = response.results[0];
});
});Po znalezieniu grupy można ją przeszukać w celu uzyskania elementów. W tym przykładzie grupa jest przeszukiwana w celu znalezienia pięciu elementów typu Web Map lub Web Mapping Application.var queryParams = {
q: 'type:"Web Map" -type:"Web Mapping Application"',
num: 5
};
group.queryItems(queryParams).then(function(response){
var groupItems = response.results;
});
Dodatkowe wskazówki
Zazwyczaj aplikacje internetowe służą do pracy z wieloma różnymi typami zawartości, więc w celu obsługi map z mapami bazowymi Bing Maps, zawartością prywatną itd. wymagane może być skonfigurowanie szablonu. Poniżej podano szczegółowe wskazówki.
Klucz Bing Maps
Jeśli mapa internetowa, którą chcesz wyświetlić, korzysta z mapy bazowej usługi Bing Maps, należy umieścić w aplikacji klucz Bing Maps. Klucz Bing Maps jest podawany jako parametr dla metody createMap.
Obsługa serwera proxy i CORS
Jeśli aplikacja będzie wysyłać żądania międzydomenowe, należy włączyć udostępnianie CORS lub dodać serwer proxy do aplikacji.
Dodawanie szablonu do portalu
Po utworzeniu szablonu i umieszczeniu go na serwerze internetowym dodaj szablon do portalu jako element aplikacji internetowej i określ adres URL aplikacji. Jako przeznaczenie wskaż opcję Konfigurowalne. Jako interfejs API wskaż opcję JavaScript.
Pamiętaj, aby umieścić opisowy tytuł i podsumowanie, ponieważ te informacje są wyświetlane po umieszczeniu kursora na elemencie szablonu w galerii szablonów. Można także utworzyć plik ZIP zawierający pliki aplikacji i dołączyć go do elementu, aby umożliwić jego pobieranie.
Używanie szablonu w galerii aplikacji instytucji
Jeśli chcesz używać szablonu w galerii aplikacji przeglądarki map Map Viewer swojej instytucji lub galerii aplikacji grupowych, udostępnij ten element grupie zastosowanej do tej galerii. Wówczas administrator instytucji może skonfigurować mapę lub skonfigurować grupy, aby użyć danej grupy zawierającej Twój szablon.