Boundary layers configureren

1                  Hoe Boundary layers te configureren

Esri stelt lagen beschikbaar die grens- (boundary) en demografische informatie bevatten voor verschillende delen van de wereld. Deze lagen, zoals bijvoorbeeld staat, provincie en postcodegebieden, bevatten gerelateerde, lokale informatie die gebruikers van Portal for ArcGIS kunnen gebruiken in hun kaarten, scenes, apps, analyze tools en Insights for ArcGIS.

Wanneer Insights for ArcGIS geïnstalleerd is, of als het portaal geen toegang heeft tot de ArcGIS Living Atlas of the World content van ArcGIS Online, dan kan worden overwogen de boundary layers te publiceren naar het eigen portaal.

Als Portal administrator, kunnen de service definition files (.sd) van de boundary layers gedownload worden vanuit My Esri en vervolgens kan de publishboundarylayers-tool gebruikt worden om hosted feature layers van deze files te publiceren.

Aantekening:
Indien één van de tools die in dit topic beschreven worden gebruikt wordt, dient een built-in portal administrator account gebruikt te worden. De URL die gebruikt wordt voor deze tools hangt af van de inrichting van ArcGIS Enterprise.

• Als deze tools gebruikt worden op een on-premise ArcGIS Enterprise deployment, dan is Portal te benaderen via port 7443 in plaats van via een web adaptor of load balancer.
• Als deze tools gebruikt worden op een ArcGIS Enterprise deployment in de cloud, dan is Portal te benaderen via een web adaptor of load balancer; gebruik nu niet port 7443.

Publiceren kan met een folder die alle informatie bevat, individuele bestanden of een lijst van bestanden in text file formaat. Zorg ervoor dat het account dat gebruikt wordt om de Portal for ArcGIS service te draaien schrijfrechten (read access) op deze folder heeft.

Publiceren van deze boundary service definition (.sd) files naar het portaal resulteert in het volgende:

• Elke .sd is toegevoegd als een service definition item in het portaal. Deze bestanden moeten in het portaal aanwezig blijven als de wens bestaat om deze te kunnen updaten op het moment dat nieuwere content beschikbaar is.
• Er wordt een hosted feature layer gemaakt voor elke .sd file die gepubliceerd wordt. Elke hosted feature layer bevat meerdere lagen.
• Zowel de service definition items als de hosted feature layers worden beheerd door een intern lid van het portaal genaamd esri_boundaries. Verander dit niet naar een andere eigenaar.
• Standaard hebben alle leden van het portaal toegang tot de boundary hosted feature layers in het portaal. Leden van het portaal kunnen de boundary layers als volgt benaderen:
  • Zoek de boundary layer items op vanuit het My Organization tabblad op de Content pagina.
  • Voeg individuele boundary layers toe aan de feature analysis tools in de Map Viewer vanuit de Choose Analysis Layer dialog box.
  • Voeg boundary layers toe aan de Scene Viewer vanuit het Content panel.

2                  Publiceren van boundary layers

Deze layers zijn gelicenseerd onder het Esri Master License Agreement. Lees de samenvatting en de gebruikesovereenkomst voor er gepubliceerd gaat worden (summary en terms of use).

Belangrijke vereisten bij gebruik

• Deze lagen zijn gelicenseerd voor intern gebruik binnen ArcGIS Enterprise, dus inclusief Portal for ArcGIS, Insights for ArcGIS, en andere verbonden ArcGIS apps.
  • Users mogen er geen gebruik van maken buiten de ArcGIS Enterprise producten of exporteren van data voor disconnected gebruik in ArcGIS of andere applicaties.
  • Users mogen de layer niet delen (publicly of privately) voor extern gebruik van leden of andere organisaties of publiek zonder schriftelijke toestemming van Esri.
• Deze lagen zijn gelicenseerd voor 2 jaar gebruik na de download vanuit Esri. De laatste up-to-date data mag dus elk jaar gedownload worden om de licentie te verlengen.

Volg deze stappen om een boundary file te krijgen en te hosten als feature layer in het portaal:

1. Download de .sd bestanden vanaf My Esri.
        1. Log in op My Esri.
        2. Ga naar My Organizations > Downloads > Data and Content.
        3. Typ Boundary in het zoekveld om te filteren op boundary layers.
        4. Klik Download voor de gewenste bestanden.
2. Pak de gedownloade bestanden uit en plaats ze in een folder op de Portal for ArcGIS machine.

Bestandsnamen hebben een 3-letter code om aan te geven op welke regio ze betrekking hebben en een jaartal aan het eind. Voorbeeld: USA_Boundaries_2015 bevat grenzen van de VS zoals ze er waren in het jaar 2015.

Verwijder alle bestanden die niet ge-upload en gepubliceerd moeten worden naar het portaal. Als alternatief kan er een text bestand gemaakt worden met daarin een lijst van een subset van bestanden die ge-upload en gepubliceerd zijn. Richt dit zo in dat er een bestandsnaam per regel is; als voorbeeld, als de grenzen van de VS en van de wereld ge-upload moeten worden dan ziet het text bestand er uit als:

        1.   USA_Boundaries_2015
        2.   WOR_Boundaries_2015

3. Open een command prompt op de Portal for ArcGIS machine.
4. Change directories naar de locatie van de tool.
5. Run de publishboundarylayers tool.

De tool is geinstalleerd in <Portal installation directory>\tools\publishboundarylayers. Syntax voor de tool is als volgt: 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>]

Wanneer er geen wachtwoord gespecificeerd wordt als de tool gedraaid wordt, dan wordt er gevraagd om het wachtwoord van de portal administrator te geven. Deze user moet lid zijn van de default administrator role in het portaal.

As de --files operation gebruikt wordt, specificeer dan een comma separated lijst van service definition files. Als de --file options gebruikt wordt, specificeer dan de locatie en naam van een text bestand die een lijst met boundary files bevat die gepubliceerd moeten worden.

In dit voorbeeld worden alle bestanden in de directory boundaryfiles gepubliceerd naar een on-premises portaal:

publishboundarylayers --folder d:\data\boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

In dit voorbeeld staan de bestanden in dezelfde directory (boundaryfiles), maar er worden maar twee bestanden gepubliceerd:

publishboundarylayers --folder d:\data\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

In dit voorbeeld is er een text bestand (boundarysubset.txt) gemaakt in de boundaryfiles directory. De tool leest de lijst vanuit het text bestand om een subset van de boundary files te publiceren .

publishboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundarysubset.txt --url https://portal.domain.com:7443/arcgis --username portaladmin

Wanneer het publiceren afgerond is, zijn een service definition item en een hosted feature layer voor iedere .sd file die gepubliceerd is aangemaakt.

Om te bevestigen dat het item bestaat, kan er in het portal gezocht worden naar alle items die beheerd worden door een intern portaal lid genaamd esri_boundaries. Typ owner:esri_boundaries in het zoekveld van het portaal en gebruik Search All Content.

3                  Update van de boundary layers

In de meeste gevallen worden updates van de boundary layers aangeboden als een nieuwe service definition file, die gepubliceerd kan worden naar het portaal door gebruik te maken van de publishboundarylayers utility. Dit stelt je in staat om de layers onafhankelijk te gebruiken en de twee versies van de data te analyseren. Voorbeeld: Er kan een 2015 en een 2017 versie zijn van de world boundaries file. In zeldzame gevallen wordt de service definition file echter gebruikt om eventuele foutjes uit de content te halen op My Esri. In deze gevallen, kunnen de updates gedownload en gepubliceerd worden door gebruik te maken van de updateboundarylayers tool. Door deze te gebruiken wordt de bestaande hosted feature layer overschreven in het portaal.

Zoals eerder aangegeven, kunnen boundary layers alleen ge-update worden als het service definition item van de layer nog bestaat in het portal.

Volg de volgende stappen om de boundary feature layers te updaten in het portaal:

1. Download de .sd bestanden vanaf My Esri.
2. Extract de bestanden en plaats deze in een folder op de Portal for ArcGIS machine.

Verwijder alle bestanden die niet ge-upload en gepubliceerd moeten worden naar het portaal. Als alternatief kan er een text bestand gemaakt worden met daarin een lijst van een subset van bestanden die ge-upload en gepubliceerd moeten worden. Richt dit zo in dat er een bestandsnaam per regel is; bijvoorbeeld, als de grenzen van de VS en van de wereld ge-upload moeten worden dan ziet het text bestand eruit als:

        1.   USA_Boundaries_2015
        2.   WOR_Boundaries_2015

3. Open een command prompt op de Portal for ArcGIS machine.
4. Change directories naar de locatie van de tool.
5. Run de updateboundarylayers tool.

De tool is geinstalleerd in <Portal installation directory>\tools\publishboundarylayers. De syntax voor de tool is als volgt: 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>]

Als er geen wachtwoord gespecificeert is als de tool gedraaid wordt, dan wordt er gevraagd het wachtwoord van de portal administrator te geven. Deze user moet lid zijn van de default administrator role in het portaal.

Als de --files operation gebruikt wordt, specificeer dan een comma separated list van service definition files. Als de --file options gebruikt worden, specificeer dan de locatie en de naam van een text bestand die een lijst met boundary files bevat die gepubliceerd moeten worden.

In dit voorbeeld publiceert de updateboundarylayers tool alle bestanden in de directory boundaryfiles en overschrijft de bestaande layers:

updateboundarylayers --folder d:\data\boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

In dit voorbeeld staan de bestanden in dezelfde directory (boundaryfiles), maar wordt er maar één bestand opnieuw gepubliceerd:

updateboundarylayers --folder d:\data\boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

In dit voorbeeld wordt er een text bestand gemaakt (boundaryupdatesubset.txt) in de boundaryfiles directory. De tool leest de bestandslijst vanuit het text bestand om een subset van de boundary layers opnieuw te publiceren

updateboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundaryupdatesubset.txt --url https://portal.domain.com:7443/arcgis --username portaladmin

Wanneer het publiceren afgerond is, bevatten de bestaande hosted feature layers updates van de data of de metadata.

4                  Verwijder boundary layers

Mocht er besloten worden dat een boundary layer niet nodig is in het portaal, dan kan deze verwijderd worden. Zoek in de website van het portaal naar de layer om deze daar te verwijderen of maak gebruik van de deleteboundarylayers tool. Mocht er meerdere boundary layers verwijderd moeten worden, gebruik dan de deleteboundarylayers tool.

De deleteboundarylayers tool verwijdert geen layers die delete protection ingeschakeld hebben.

Let op:

Als er een boundary layer verwijdert wordt die in een kaart of scene gebruikt wordt, dan zal de layer niet langer zichtbaar zijn in de kaart, app of scene. Opnieuw publiceren zal de layer niet vervangen in de kaart, app of scene, omdat opnieuw publiceren een nieuw item aanmaakt met een nieuwe ID in het portaal.

Er kan een comma-separated lijst van de layers gebruikt worden om deze te verwijderen door de --files operation te gebruiken, of een text bestand met daarin een lijst met layers om te verwijderen, door gebruik te maken van de --file operation.

De syntax voor het gebruiken van een comma-separated lijst van layers is als volgt: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Voorbeeld: om de layers USA_Boundaries_2015 en WOR_Boundaries_2015 te verwijderen uit het portaal https://portal.domain.com:7443/arcgis met een portal administrator genaamd portaladmin, typ het volgende:

deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

De syntax voor het gebruiken van een text bestand met daarin een lijst van layers die verwijderd moeten worden is als volgt: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Voorbeeld: Om dezelfde layers te verwijderen gebruik makend van een bestand, creëer dan een text bestand met daarin een layer naam per regel (zoals hieronder) en geef de locatie en de naam van het text bestand mee als de tool gebruikt wordt:

        1.   USA_Boundaries_2015
        2.   WOR_Boundaries_2015

In het volgende voorbeeld staat het boundarylist.txt bestand in c:\data\boundaries. Dit bestand bevat een lijst van layers die verwijderd moeten worden uit het portaal https://portal.domain.com:7443/arcgis.

deleteboundarylayers --file c:\data\boundaries\boundarylist.txt --url https://portal.domain.com:7443/arcgis --username portaladmin