Administratorkonfiguration

Als Administrator können Sie Einstellungen in ArcGIS Online und ArcGIS Enterprise oder über die Konfigurationsdatei konfigurieren, damit ArcGIS Earth die Nutzungsanforderungen Ihrer Organisation erfüllt. Sie können zur Seite ArcGIS Earth-Beispielkonfigurationsdatei navigieren und die Beispieldatei herunterladen. Nach der Installation befindet sich die Konfigurationsdatei im Anwendungsinstallationsverzeichnis, das sich normalerweise im Ordner C:\Program Files\ArcGIS\ArcGIS Earth\bin befindet.

Beachten Sie bei der Konfiguration der Anwendungseinstellungen mit einer Konfigurationsdatei Folgendes:

  • Während der Installation können Sie die Konfigurationsparameter voreinstellen und die modifizierte config.xml-Datei importieren.
  • Die Konfigurationsdatei ist eine .xml-Datei, die nach Bedarf modifiziert werden kann. Verwenden Sie beispielsweise beim Bearbeiten der Datei & anstelle von &, um ein Escape-Zeichen anzugeben. Stellen Sie sicher, dass die Konfigurationsdatei nach der Bearbeitung weiterhin UTF-8 codiert bleibt.
  • Konfigurationen, die vom Administrator voreingestellt wurden, werden automatisch geladen, wenn Sie die Anwendung zum ersten Mal starten.
  • Sie können vom Administrator konfigurierte Parameter im Ordner "bin" übernehmen, indem Sie in der Anwendung unter Einstellungen auf Zurücksetzen klicken.
  • Bei einer Pro-Benutzer-Installation von ArcGIS Earth können Sie die Konfigurationsdatei zudem im Anwendungsinstallationsverzeichnis, z. B. unter C:\Users\username\AppData\Roaming\ESRI\ArcGISEarth bearbeiten.

Organisationskonfigurationen

Für einige Einstellungen in ArcGIS Earth werden die Organisationskonfigurationen Ihres ArcGIS Online- oder ArcGIS Enterprise-Portalkontos verwendet. Zu diesen Einstellungen zählen die Grundkarte, der Höhenservice und der Geokodierungsservice, die von ArcGIS Earth verwendet werden. Weitere Informationen zur Verbindung mit ArcGIS Enterprise finden Sie unter Festlegen der Grundkarten-Galerie und Standardgrundkarte, Utility-Services und Geokodierung. Weitere Informationen zur Verbindung mit ArcGIS Online finden Sie unter Erste Schritte mit der Verwaltung.

Konfigurierbare Anwendungsparameter

Administratoren können Einstellungen in der Konfigurationsdatei ändern, ohne die Anwendung neu zu kompilieren. Sie können zudem Richtlinien festlegen, die sich darauf auswirken, wie ArcGIS Earth auf Ihrem Computer ausgeführt wird. Administratoren können auf die Datei config.xml im Installationsverzeichnis zugreifen und die entsprechenden Attributwerte angeben, um eine bevorzugte Starteinstellung anzupassen, indem sie die konfigurierbaren Parameter ändern.

Die konfigurierbaren Anwendungsparameter sind in den folgenden Tabellen beschrieben.

Allgemeine Anwendungsparameter

ParameterBeschreibung

workspace

Gibt das Verzeichnis des Workspace an und ob der aktuelle Workspace beim Beenden automatisch gespeichert werden soll.

startupView

Erlaubt das Anpassen der Startansicht (Custom) oder das Starten an derselben Stelle, an der Sie aufgehört haben (History).

spatialReference

Legt den von ArcGIS Earth verwendeten Raumbezug als Web Mercator oder WGS84 fest. Die Standardeinstellung ist Web Mercator.

Hinweis:
  • In ArcGIS Earth wird die standardmäßige GDAL-Projection-Engine verwendet, die sich in der Regel im Installationsverzeichnis der Anwendung im Ordner C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\pedata befindet.
  • Das herunterladbare Paket mit der Projection-Engine-Datenerweiterung finden Sie auf der ArcGIS Developer-Website unter "Projection Engine Data".
  • Extrahieren Sie den heruntergeladenen Inhalt in das Verzeichnis der ArcGIS Earth-Projection-Engine, und starten Sie ArcGIS Earth neu. Dann wird die richtige Projection Engine verwendet. Wenn eine Warnung zu einer doppelten Datei angezeigt wird, können Sie die Option zum Überspringen oder zum Ersetzen auswählen, um fortzufahren.
  • Die Projection-Engine-Daten sind nicht verfügbar, wenn ArcGIS Earth direkt aus dem Microsoft Store installiert wird.

isAutoFitWindow

Legen Sie diese Einstellung auf True fest, wenn Sie möchten, dass die Größe des Pop-up-Fensters automatisch an den Inhalt angepasst wird. Die Standardeinstellung ist False.

isShowInExternalBrowser

Zeigt HTML-Links im Pop-up-Fenster mit einem externen Browser an. Die Standardeinstellung ist False.

isShowStartupTips

Zeigt beim Starten der Anwendung Tipps zum Programmstart an. Die Standardeinstellung ist True.

Tipp:

Administratoren können den Inhalt der Tipps zum Programmstart anpassen, indem sie die HTML-Dateien im Tipps-Ordner im Anwendungsinstallationsverzeichnis aktualisieren.

language

Legt die Anzeigesprache für die ArcGIS Earth-Bedienoberfläche fest. Der Standardwert ist System.

Wenn der Wert System lautet, entspricht ArcGIS Earth der Spracheinstellung der Windows-Anzeige.

flyto

Legt die Zoomgeschwindigkeit zwischen 0 und 100 fest. Die Standardeinstellung ist 50.

Ermöglicht das automatische Zoomen auf einen neuen Layer. Die Standardeinstellung ist True.

Legt den Winkel beim Zoomen auf den Layer auf Default oder None fest. Die Standardeinstellung ist Default.

mouseWheel

Legt die Geschwindigkeit des Mausrads zwischen 0 und 100 und die Zoomrichtung auf Forward oder Backward fest. Die Standardeinstellung ist Forward.

navigatorMode

Legt den Betriebsmodus des Bildschirm-Navigators auf Default, Expanded oder Collapsed fest. Die Standardeinstellung ist Default.

continuousPanning

Aktiviert das kontinuierliche Schwenken (True) oder deaktiviert es (False). Die Standardeinstellung ist True.

nonMouseController

Aktiviert das Navigieren durch ArcGIS Earth mit einer anderen Steuerung als mit einer Maus.

atmosphere

Wechselt die Atmosphäre zu None, Horizon Only oder Realistic. Die Standardeinstellung ist Horizon Only.

elevationExaggeration

Legt den Überhöhungswert für Terrain fest. Der Standardwert ist 1.

elevationExaggerationMin

Legt den minimal zulässigen Wert für die Überhöhung von Höhen fest. Die Standardeinstellung ist 0.

elevationExaggerationMax

Legt den maximal zulässigen Wert für die Überhöhung von Höhen fest. Die Standardeinstellung ist 100. Ein Wert über 1000 wird auf 1000 begrenzt.

Hinweis:

Der Maximalwert für die Überhöhung wird in der Bedienoberfläche aktualisiert, sobald ein neuer Wert für elevationExaggerationMax angewendet wird.

undergroundNavigation

Ermöglicht die Navigation durch Untergrunddaten. Die Standardeinstellung ist Off.

groundTransparency

Stellt die Transparenz des Bodens ein. Die Standardeinstellung ist 0.

grid

Gibt den Gitternetztyp und sein Liniensymbol und den Beschriftungs-Style an.

location

Gibt die Standardpositionseinheit an. Die Standardeinstellung ist DMS.

distance

Gibt die Standardentfernungseinheit an. Die Standardeinstellung ist Meters.

elevation

Gibt die Standardhöheneinheit an. Die Standardeinstellung ist Meters.

area

Gibt die Standardflächeneinheit an. Die Standardeinstellung ist SquareMeters.

heading

Legt den Notationstyp des Richtungswinkels fest: 0 bis 360 Winkel oder –180 bis +180 Winkel. Die Standardeinstellung ist 360.

isLongitudeFront

Dreht beim Suchen und Anzeigen die Längengrad-Breitengrad-Reihenfolge der Koordinaten um. Die Standardeinstellung ist True.

proxy

Legt die Verwendung eines Proxys fest (boleescher Wert; optional) Die Standardeinstellung ist False.

historicalImagery

Legt benutzerdefinierte Quellen-URLs für Bilddaten im Explorer "Historische Bilddaten" fest. Wenn das ausgewählte Attribut auf "True" festgelegt ist, wird die Quelle in der Liste ausgewählt und im Werkzeug "Historische Bilddaten" verwendet.

Beispiel:


 <historicalImagery> 
  <customImagerySources> 
    <source selected="True">yourImageServerURL</source> 
  </customImagerySources>                                             
 </historicalImagery

Administrator-Anwendungsparameter

ParameterBeschreibung

autoUpdate

Wenn dieser Parameter auf False festgelegt ist, sieht der Benutzer keine Informationen zum Aktualisierungsprogramm in ArcGIS Earth. CheckOnStartup wird in diesem Parameter verwendet, um beim Starten der Anwendung auf ArcGIS Earth-Aktualisierungen zu überprüfen. Die Standardeinstellung ist True.

Beispiel:


<autoUpdate enable="True">
      <checkOnStartup>True</checkOnStartup>
</autoUpdate>

isDefaultKmlViewer

Legt ArcGIS Earth als Standard-KML-Viewer fest. Die Standardeinstellung ist False.

isDefaultMspkViewer

Legt ArcGIS Earth als Standard-Viewer für mobile Szenen-Layer-Pakete fest. Die Standardeinstellung ist True.

enableHtmlWindow

Damit wird das HTML-Fenster aktiviert. Die Standardeinstellung ist False.

enableTableDataExport

Ermöglicht das Exportieren von Feature-Layer-Daten als KMZ-Daten in die Attributtabelle. Die Standardeinstellung ist True.

blockArcGISOnline

Blockiert beim Starten von ArcGIS Earth Anforderungs- und Portal-Verbindungen zu ArcGIS Online. Die Standardeinstellung ist False.

findInTOC

Ermöglicht die Steuerung, ob ausgewählte KML-Dateien in der Szene automatisch im Inhaltsverzeichnis hervorgehoben werden sollen.

survey123APIUrl

Standardmäßig priorisiert ArcGIS Earth anhand der im Portal konfigurierten Survey-URL. Wenn im Portal keine bestimmte URL festgelegt ist, verwendet ArcGIS Earth die URL: https://survey123.arcgis.com/api/jsapi.

Benutzer, die ihre eigene Survey123-API bereitgestellt haben oder die Beta-Version von Survey123 verwenden, können eine benutzerdefinierte API-URL in der ArcGIS Earth-Konfigurationsdatei angeben. Wenn eine benutzerdefinierte Survey-URL in der Konfigurationsdatei definiert ist, setzt ArcGIS Earth die Standardeinstellungen außer Kraft, und es wird stattdessen die vom Benutzer angegebene URL verwendet.

portals

Legt die URLs der Portale fest, zu denen ArcGIS Earth eine Verbindung herstellt.

Tipp:

Wenn der Administrator mehrere Portal-URLs in der Konfigurationsdatei aufführt, verwendet ArcGIS Earth nach der Installation das erste Portal als aktives Portal.

disableAddPortal

Blockiert das Hinzufügen neuer Portal- oder Online-Verbindungen im Portal-Manager. Die Standardeinstellung ist False.

Tipp:

Wurde der Parameter auf True festgelegt, ist die Schaltfläche Portal hinzufügen im Fenster Portal-Manager nicht verfügbar, und dem Benutzer ist das Hinzufügen einer neuen Portal-/Online-Verbindung über den Portal-Manager​ nicht möglich. Der Benutzer kann zwischen Portal-Verbindungen für vorkonfigurierte Portale, die im Portal-Manager angezeigt werden, wechseln.

fonts

Gibt zur Beschriftung des Darstellungselements die Schriftart an.

Hinweis:

Verwenden Sie den Schriftartnamen in der Schriftartdatei als Elementwert, und vergewissern Sie sich, dass die angegebene Schriftartdatei auf Ihrem Betriebssystem installiert ist.

log

Erfasst die Protokollinformationen im Ordner ESRI\ArcGISEarth\logs im AppData-Verzeichnis eines Benutzers, wie z. B. C:\Users\username\AppData\Roaming.

Der Maximalwert für die Größe jedes Protokolls ist 10.000, und die maximale Anzahl an zu speichernden Protokolldateien ist 1.000.

startupLayers

Richtet die Programmstart-Layer im Inhaltsverzeichnis ein, konfiguriert den Namen, die URL, den Typ und die Sichtbarkeit und organisiert die Programmstart-Layer in hierarchische Gruppen.

Tipp:
  • Programmstart-Layer unterstützen Datentypen wie z. B. ArcGIS-Services, KML und KMZ, WMS und seine Sublayer, WFS und seine Sublayer, GeoJSON, Shapefile, Raster, Kachelpaket, Szenen-Layer-Paket, mobiles Szenen-Paket, Webszene und Webkarte.
  • Die Konfigurationsdatei ist eine .xml-Datei, die nach Bedarf angepasst werden kann. Sie muss der XML-Spezifikation entsprechen. Wenn Sie beispielsweise URLs in einem URL-Tag angeben, müssen Sonderzeichen wie & gemäß den XML-Syntaxregeln ordnungsgemäß mit dem Escape-Zeichen &amp; versehen werden. Stellen Sie nach dem Vornehmen von Änderungen sicher, dass die Datei mit UTF-8-Encodierung gespeichert wird.
  • Bei der Konfiguration von WMS-Sublayern müssen der Wert für den Namen und der Wert für den Titel genau mit dem entsprechenden Layer-Namen und -Titel übereinstimmen, die im Dokument "WMS Service Capabilities" definiert sind. Diese Werte dienen als eindeutige Kennungen und müssen mit der Service-Konfiguration übereinstimmen.
  • Sublayer müssen tatsächliche Layer, nicht jedoch Ordnerknoten, referenzieren. Mit anderen Worten: Sie sollten auf Blattknoten verweisen, die zeichenbare Layer repräsentieren, nicht jedoch auf Container, die zusätzliche Layer enthalten.
  • Das Warnsymbol weist darauf hin, dass der Pfad fehlt oder dass Daten fehlerhaft sind bzw. dass nicht auf sie zugegriffen werden kann.
  • Programmstart-Layer mit dem Status "Unsichtbar" können erst geladen werden, wenn sie im Inhaltsverzeichnis aktiviert werden.

organizationalBasemaps

Legt die Grundkarten für Ihre Organisation fest.

Tipp:

Organisationseigene Grundkarten-Layer unterstützen Datentypen wie z. B. KML und KMZ, WMS, Raster, Kachelpaket, Szenen-Layer-Paket und ArcGIS-Services.

Innerhalb jedes <basemap>-Elements können Sie mit den Knoten <baseLayers> oder <referenceLayers> einen oder mehrere Layer festlegen. Beispiel:


    <basemap name="basemap_wms_with_desired_layers">
      <baseLayers>
        <layer type="WMS" url="http://myservername.esri.com/someservice/servicename/MapServer/WMSServer">
          <layer name="wms_layer_name_1(required)" title="wms_layer_title_1(required)"/>
          <layer name="wms_layer_name_2(required)" title="wms_layer_title_2(required)"/>
        </layer>
      </baseLayers> 
    </basemap>

organizationalTerrains

Legt Terrains für Ihre Organisation fest.

Tipp:

Organisationseigene Terrain-Layer unterstützen Datentypen wie z. B. das lokale Raster und den Höhen-Image-Service. Weitere Informationen finden Sie unter Grundkarte und Terrain.

positionServiceUrl

Ermöglicht es dem Administrator, eine URL mit einigen codierten Werten einzugeben, die von ArcGIS Earth erkannt werden und in welche die Positionsinformationen eingetragen werden. Durch Drücken der Strg-Taste und gleichzeitiges Klicken mit der rechten Maustaste auf den Globus wird die URL aufgerufen, und der Längengrad, der Breitengrad und die Höhe des Punkts, auf den geklickt wird, wird an diese URL weitergegeben. Solange die URL eine gültige .kml-Datei zurückgibt, wird die .kml-Datei im Ansichtsfenster angezeigt.

Lesen Sie ein Beispiel im ArcGIS Blog: Point Based Service access with ArcGIS Earth.

  • urlwithpos: Legt das Schlüsselattribut des Elements add im Element ServiceURL fest, um dieses Feature zu aktivieren.
  • urlwithoutpos: Legt die Informationen fest, die ArcGIS Earth lesen wird. Bei den Informationen handelt es sich um eine .kml-Datei, die im Rahmen des Serviceaufrufs zurückgegeben wird, ohne dass sie auf der Festplatte gespeichert wird.

localKmlIcons

Ermöglicht den Zugriff auf den nativen Ordner mit KML-Symbolen oder weist auf einen Ordner mit benutzerdefinierten Symbolen hin.

Tipp:
  • Bei False verwendet ArcGIS Earth KML-Symbole aus google.com.
  • Bei True verwendet ArcGIS Earth lokale KML-Symbole.
    • Wird der Wert für directory leer gelassen, verwendet ArcGIS Earth lokale KML-Symbole aus dem Ordner \resources\symbols\kml im Installationsverzeichnis, in der Regel C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\.
    • Wenn Sie auf einen benutzerdefinierten KML-Symbolordner verweisen müssen, weil sich z. B. die benutzerdefinierten KML-Symbole im Ordner C:\myIcons\kml befinden, sollte der Wert für directory als C:\myIcons festgelegt werden, damit der Ordner kml miteinbezogen wird.

directoryStyleLink

Aktiviert die URL-Adresse zu den Wörterbuch-Style-Dateien von Esri oder passt die URL und den Anzeigetext auf der Bedienoberfläche an. Die Hyperlink-URL ist standardmäßig deaktiviert.

Tipp:

Für Benutzer hinter einer Firewall kann der Administrator die Wörterbuchdateien von Esri Styles herunterladen und in einem freigegebenen Verzeichnis speichern, den Hyperlink aktivieren und die URL-Adresse zum lokalen Verzeichnis aktualisieren, damit Benutzer in Ihrer Organisation darauf zugreifen können.

acknowledgement

Gibt den Anzeigetext und die URL-Adresse für Beiträge von Drittanbietern an.

help

Gibt den Anzeigetext und die URL-Adresse der Hilfe an.

submitFeedback

Gibt den Anzeigetext und die URL-Adresse zum Senden von Feedback an.

bannerSettings

Gibt den Anzeigetext, den Text-Style, den Schriftschnitt und die Ausrichtung des Banners an.

automationAPI

Legt die Einstellung für die Automatisierungs-API in ArcGIS Earth fest.

  • autoStart: Aktiviert die ArcGIS Earth-Automatisierungs-API beim Starten von ArcGIS Earth. Die Standardeinstellung ist False.

Hinweis:
  • Das Format der Konfigurationsdatei wird ab Version 1.10 aktualisiert. Die vorherige Version von config.xml ist aufwärtskompatibel. Sie wird jedoch nicht mehr im Rahmen der Produktversionen gepflegt oder aktualisiert.
  • Wenn Benutzerparameter über die ArcGIS Earth-Bedienoberfläche Einstellungen geändert werden, liest die App diese Parameter aus der Konfigurationsdatei in C:\Users\<username>\AppData\Roaming\Esri\ArcGISEarth. Obwohl die Administratorparameter weiterhin im Installationsverzeichnis oder einem bestimmten Verzeichnis gespeichert sind, das über den Konfigurations-Manager unter Erweitert in den Einstellungen festgelegt wird, liest die App Administratorparameter aus diesen Speicherorten.