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 własny 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 Bing, uzyskiwania dostępu do prywatnych map i pracy z zasobami, które wymagają serwera proxy lub udostępniania zasobów cross-origin (CORS). Możesz także dodać element do własnego portalu, a jeśli instytucja planuje wykorzystać Twój szablon w galerii szablonów, udostępnić go razem z wybraną grupą szablonów instytucji.
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. Po utworzeniu szablonu można zmodyfikować go tak, aby był konfigurowalny. Konfigurowalne szablony pozwalają użytkownikom personalizować wygląd i działanie aplikacji.
Mapy internetowe
Szablony aplikacji służą do pracy z mapą aktualnie wyświetlaną w przeglądarce map. 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 zarejestrować go w platformie. Aby to zrobić, dodaj nowy element aplikacji map internetowych i podaj adres URL szablonu aplikacji hostowanego na serwerze internetowym.
Po dodaniu elementu 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 znajduje się w zawartych w interfejsie API ArcGIS for JavaScipt przykładach OAuth 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 cross-domain, należy włączyć udostępnianie zasobów cross-origin (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 swojej instytucji lub galerii aplikacji grupowych, udostępnij ten element grupie zastosowanej do tej galerii. Then the administrator of your organization can configure the map viewer or configure groups to use the group that includes your template.