Firma Esri dostarcza warstwy zawierające informacje o granicach oraz informacje demograficzne dla różnych części świata. Warstwy te — takie jak granice stanów, województw, obszarów spisowych oraz kodów pocztowych — zawierają powiązane informacje lokalne, których członkowie portalu mogą używać na swoich mapach, w scenach, aplikacjach, narzędziach analizy obiektowej oraz w aplikacji ArcGIS Insights.
Rozważ opublikowanie tych warstw w swoim portalu, jeśli masz zainstalowaną aplikację ArcGIS Insights lub jeśli portal nie ma dostępu do zasobów atlasu ArcGIS Living Atlas of the World z usługi ArcGIS Online.
Administrator portalu może pobrać pliki definicji usługi warstw granic (.sd) z witryny My Esri i użyć narzędzia publishboundarylayers w celu opublikowania hostowanych warstw obiektowych z tych plików.
Notatka:
Gdy uruchamiasz dowolne z narzędzi opisanych w tym temacie, musisz używać wbudowanego konta administratora portalu. Adres URL używany na potrzeby tych narzędzi zależy od miejsca wdrożenia oprogramowania ArcGIS Enterprise.
- Gdy te narzędzia są uruchamiane w lokalnym wdrożeniu oprogramowania ArcGIS Enterprise, dostęp do portalu należy uzyskać za pomocą portu 7443, a nie za pomocą adaptera internetowego lub modułu równoważenia obciążenia.
- Gdy te narzędzia są uruchamiane we wdrożeniu oprogramowania ArcGIS Enterprise w chmurze, dostęp do portalu należy uzyskać za pomocą adaptera internetowego (web adaptor) lub modułu równoważenia obciążenia. W tym przypadku nie należy używać portu 7443.
Można opublikować folder zawierający wszystkie pożądane pliki, opublikować poszczególne pliki lub podać listę plików w formacie pliku tekstowego. Upewnij się, że konto użyte do instalacji oprogramowania Portal for ArcGIS ma uprawnienie do odczytu tego katalogu.
Opublikowanie tych plików definicji usługi granic (.sd) w portalu ma następujące konsekwencje:
- Każdy plik .sd zostaje dodany jako element definicji usługi w portalu. Te pliki muszą pozostać w portalu, aby można było zaktualizować warstwy granic, gdy zostaną udostępnione zaktualizowane zasoby.
- Dla każdego opublikowanego pliku .sd jest tworzona hostowana warstwa obiektowa. Każda hostowana warstwa obiektowa zawiera wiele warstw.
- Zarówno elementy definicji usług, jak i hostowane warstwy obiektowe są własnością wewnętrznego członka portalu o nazwie esri_boundaries. Nie należy przekazywać praw własności do tych elementów innemu użytkownikowi.
- Domyślnie wszyscy członkowie instytucji portalu mają dostęp do hostowanych warstw obiektowych granic w portalu. Członkowie portalu mogą uzyskać dostęp do warstw granic w następujący sposób:
- Wyszukaj elementy warstwy granic w portalu na karcie Moja instytucja na stronie Zasoby.
- Dodaj poszczególne warstwy granic do narzędzi analizy obiektowej w przeglądarce map Map Viewer Classic z okna dialogowego Wybierz warstwę analizy.
- Dodaj warstwy granic do przeglądarki scen Scene Viewer z panelu Zasoby.
Publikowanie warstw granic
Warstwy te są chronione Ramową umową licencyjną firmy Esri. Przed opublikowaniem przeczytaj podsumowanie oraz warunki użytkowania.
Ważne wymagania związane z użytkowaniem
- Warstwy są licencjonowane do użytku wewnętrznego w oprogramowaniu ArcGIS Enterprise, włącznie z oprogramowaniem Portal for ArcGIS, ArcGIS Insights i innymi podłączonymi aplikacjami ArcGIS.
- Niedozwolone jest ich użycie poza rodziną produktów ArcGIS Enterprise oraz eksportowanie danych do użytku w trybie offline w systemie ArcGIS lub innych aplikacjach.
- Użytkownicy nie mają uprawnień do udostępnienia warstwy (publicznie lub prywatnie) do użytku zewnętrznego przez członków innych instytucji lub publicznego bez uzyskania pisemnej zgody od firmy Esri.
- Licencja na użytkowanie tych warstw trwa dwa (2) lata od momentu pobrania ich z firmy Esri. Aby przedłużyć licencję, można co roku pobrać najnowsze dane.
- Każde wyświetlenie tych warstw musi łączyć się z wyświetleniem na każdej warstwie pola Źródło danych (atrybucja).
Postępuj zgodnie z poniższą instrukcją, aby uzyskać pliki granic i hostować je jako warstwy obiektowe w portalu.
- Pobierz skompresowane pliki zawierające definicje usług (.sd) z witryny My Esri.
- Rozpakuj pobrane pliki do folderu na komputerze z oprogramowaniem Portal for ArcGIS.
W nazwach plików jest używany trzyliterowy kod do wskazania regionów, których dotyczą. Na końcu nazwy jest dodany rok, którego dotyczą dane. Na przykład plik USA_Boundaries_2015 zawiera granice dla Stanów Zjednoczonych Ameryki z roku 2015.
Usuń pliki, których nie chcesz przesyłać i publikować w portalu. Alternatywnie utwórz plik tekstowy zawierający listę z podzbiorem plików, które chcesz przesłać i opublikować. Sformatuj plik tekstowy, aby w każdym wierszu znajdowała się jedna nazwa pliku, na przykład do przesłania granic Stanów Zjednoczonych Ameryki lub granic światowych plik tekstowy powinien zawierać następujące informacje:
USA_Boundaries_2015 WOR_Boundaries_2015
- Otwórz terminal poleceń na komputerze z oprogramowaniem Portal for ArcGIS.
- Przejdź do katalogu, w którym znajduje się narzędzie.
- Uruchom narzędzie publishboundarylayers.
Narzędzie jest zainstalowane w katalogu <Portal installation directory>/tools/publishboundarylayers. Składnia narzędzia jest następująca: publishboundarylayers --folder <location of sd files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]
Jeśli podczas uruchamiania narzędzia nie zostanie podane hasło, zostanie wyświetlona zachęta do wprowadzenia hasła administratora portalu. Ten użytkownik musi być członkiem domyślnej roli administratora w portalu.
Jeśli jest używana operacja --files, należy podać listę rozdzielanych przecinkami plików definicji usług. Jeśli jest używana opcja --file, należy podać lokalizację i nazwę pliku tekstowego zawierającego listę plików granic, które mają zostać opublikowane.
W tym przykładzie wszystkie pliki w katalogu boundaryfiles są publikowane w portalu lokalnym:
./publishboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladminW tym przykładzie pliki znajdują się w tym samym katalogu (boundaryfiles), ale publikowane są dwa pliki:
./publishboundarylayers --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladminW tym przykładzie plik tekstowy (boundarysubset.vi) został utworzony w katalogu boundaryfiles. Narzędzie odczytuje listę plików z pliku tekstowego w celu opublikowania podzbioru warstw granic.
./publishboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin
Po zakończeniu publikowania dla każdego opublikowanego pliku .sd będą istnieć element definicji usługi i hostowana warstwa obiektowa.
Aby potwierdzić istnienie tych elementów, można wyszukać w portalu wszystkie elementy należące do wewnętrznego członka portalu o nazwie esri_boundaries. Wpisz owner:esri_boundaries w polu wyszukiwania portalu i kliknij opcję Wyszukaj wszystkie zasoby.
Aktualizacja warstw granic
W większości przypadków aktualizacje warstwy granic są udostępniane jako nowy plik definicji usługi publikowany w portalu za pomocą narzędzia publishboundarylayers. Dzięki temu można użyć warstw niezależnie i analizować dwie wersje danych. Mogą na przykład istnieć wersje 2015 i 2017 pliku granic na świecie. Od czasu do czasu pliki definicji usług udostępniane w witrynie My Esri są aktualizowane w celu poprawienia pewnych zasobów. W takich przypadkach można pobrać plik aktualizacji i opublikować za pomocą narzędzia updateboundarylayers. Ta czynność powoduje zastąpienie istniejącej hostowanej warstwy obiektowej w portalu.
Jak wspomniano we wprowadzeniu, warstwy granic można zaktualizować tylko wówczas, gdy element definicji usługi warstwy nadal istnieje w portalu.
Postępuj zgodnie z poniższą instrukcją, aby zaktualizować warstwy obiektowe granic w portalu:
- Pobierz skompresowane pliki zawierające zaktualizowane pliki definicji usług (.sd) z witryny My Esri.
- Rozpakuj pliki do folderu na komputerze z oprogramowaniem Portal for ArcGIS.
Usuń pliki, których nie chcesz przesyłać i publikować w portalu. Alternatywnie utwórz plik tekstowy zawierający listę z podzbiorem plików, które chcesz przesłać i opublikować. Sformatuj plik tekstowy, aby w każdym wierszu znajdowała się jedna nazwa pliku, na przykład, aby przesłać granice Stanów Zjednoczonych Ameryki i granice na świecie, plik tekstowy powinien zawierać następujące informacje:
USA_Boundaries_2015 WOR_Boundaries_2015
- Otwórz terminal poleceń na komputerze z oprogramowaniem Portal for ArcGIS.
- Przejdź do katalogu, w którym znajduje się narzędzie.
- Uruchom narzędzie updateboundarylayers.
Narzędzie jest zainstalowane w katalogu <Portal installation directory>/tools/publishboundarylayers. Składnia narzędzia jest następująca: updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]
Jeśli podczas uruchamiania narzędzia nie zostanie podane hasło, zostanie wyświetlona zachęta do wprowadzenia hasła administratora portalu. Ten użytkownik musi być członkiem domyślnej roli administratora w portalu.
Jeśli jest używana operacja --files, należy podać listę rozdzielanych przecinkami plików definicji usług. Jeśli jest używana opcja --file, należy podać nazwę pliku tekstowego zawierającego listę plików granic, które mają zostać opublikowane.
W tym przykładzie narzędzie updateboundarylayers publikuje wszystkie pliki w katalogu boundaryfiles, zastępując istniejące warstwy:
./updateboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladminW tym przykładzie pliki znajdują się w tym samym katalogu (boundaryfiles), ale ponownie publikowany jest tylko jeden plik:
./updateboundarylayers --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladminW tym przykładzie plik tekstowy (boundaryupdatesubset.vi) został utworzony w katalogu boundaryfiles. Narzędzie odczytuje listę plików z pliku tekstowego w celu ponownego opublikowania podzbioru warstw granic.
./updateboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin
Po zakończeniu publikowania istniejące hostowane warstwy obiektowe będą zawierać zaktualizowane dane lub metadane.
Usuwanie warstw granic
Po podjęciu decyzji o tym, że warstwa granic nie jest potrzebna w portalu, można ją usunąć. Warstwę można wyszukać w witrynie portalu i tam usunąć, albo można uruchomić narzędzie deleteboundarylayers. Aby usunąć wiele warstw granic, użyj narzędzia deleteboundarylayers.
Narzędzie deleteboundarylayers nie usuwa warstw z włączoną ochroną przed usunięciem.
Uwaga:
Jeśli zostanie usunięta warstwa granic, która jest obecnie używana na mapie, w aplikacji lub w scenie, warstwa ta przestanie być widoczna na mapie, w aplikacji lub w scenie. Ponowne opublikowanie nie spowoduje zastąpienia warstwy na mapie, w aplikacji czy w scenie, ponieważ operacja ta tworzy w portalu nowy element o nowym identyfikatorze.
Można podać listę rozdzielanych przecinkami warstw do usunięcia przy użyciu operacji --files lub plik tekstowy zawierający listę warstw do usunięcia za pomocą operacji --file.
Listę warstw rozdzielanych przecinkami należy podawać, stosując następującą składnię: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]
Aby na przykład usunąć warstwy USA_Boundaries_2015 i WOR_Boundaries_2015 z portalu https://portal.domain.com:7443/arcgis, jako administrator portalu o nazwie portaladmin wpisz:
./deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin
Składnia polecenia dodawania pliku tekstowego zawierającego listę warstw do usunięcia jest następująca: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]
Aby na przykład usunąć te same warstwy, korzystając z pliku, utwórz plik tekstowy zawierający po jednej nazwie warstwy w wierszu (jak pokazano tutaj) i podaj lokalizację oraz nazwę pliku tekstowego w momencie uruchamiania narzędzia:
USA_Boundaries_2015 WOR_Boundaries_2015
W poniższym przykładzie plik boundarylist znajduje się w katalogu /usr/data/boundaries. Zawiera listę warstw do usunięcia z portalu, https://webadaptorhost.domain.com/webadaptorname.
./deleteboundarylayers --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin