Skip to main content

Konfigurieren von ArcGIS Documentation Center (IT-Administratoren)

Nach dem Installieren von ArcGIS Documentation Center wird die App als Nächstes konfiguriert. IT-Administratoren können die App für mehrere Benutzer konfigurieren, indem Sie für die Computer der einzelnen Benutzer eine appSettings.json-Datei bereitstellen. Diese Datei wird von der App verwendet, um Parameter zu speichern, die von Benutzern geändert werden können. Die Datei befindet sich im Ordner %LocalAppData%\ESRI\ArcGISDocCenter des Benutzers.

Wichtig

Benutzer können viele dieser Einstellungen überschreiben, indem sie sie in der App unter Menü  > Einstellungen ändern.

Zum Konfigurieren der App für mehrere Benutzer werden die folgenden allgemeinen Schritte ausgeführt:

  1. Erstellen Sie eine appSettings.json-Datei.

  2. Stellen Sie die Datei auf dem System jedes Benutzers in %LocalAppData%\ESRI\ArcGISDocCenter bereit.

Wichtig

Die 'appSettings.json'-Datei ist möglicherweise bereits auf dem System des Benutzers vorhanden. Die Datei wird während der Deinstallation nicht automatisch gelöscht, damit die Benutzereinstellungen für eine spätere Installation erhalten bleiben. Sie kann auch vom Benutzer beim ersten Öffnen der App erstellt werden. Sie können die vorhandene Datei löschen oder durch Ihre eigene Datei überschreiben.

Erstellen der appSettings.json-Datei

Erstellen Sie die Datei, um die Einstellungen für Documentation Center zu verwalten. Gehen Sie hierzu wie folgt vor:

  1. Erstellen Sie eine Datei mit dem Namen appSettings.json.

  2. Kopieren Sie den folgenden Code, und fügen Sie ihn in die Datei ein:

    {
  "init": true,
  "allowedHosts": "*",
  "endpoints": {
    "documentationSets": {
      "url": "https://doc.esri.com/offline-help/packages/all"
    },
    "webHelp": {
      "url": "https://doc.esri.com/en/arcgis-doc-center/"
    },
    "softwareUpdate": {
      "url": "https://doc.esri.com/offline-help/installer/"
    }
  },
  "webServer": {
    "defaultFileNames": [
      "index.html",
      "default.html"
    ],
    "portPreferences": [
      {
        "order": 0,
        "port": 13774
      },
      {
        "order": 1,
        "port": 13322
      },
      {
        "order": 2,
        "port": 14357
      }
    ],
    "portScan": {
      "minValue": 20000,
      "maxValue": 60000,
      "limit": 10
    },
    "rootFolder": "\\\\<server_name>\\<folder_path>"
  },
  "language": "en",
  "theme": "Theme.Auto"
}

  3. Ändern Sie den Stammordner, indem Sie rootFolder unter webServer wie folgt ändern:

    "rootFolder": "\\\\<server_name>\\<folder_path>"

    Auf einem Server mit dem Namen Polaris befindet sich beispielsweise der freigegebene Stammordner arcgis_documentation, in dem Dokumentationspakete gespeichert werden:

    "rootFolder": "\\\\Polaris\\arcgis_documentation"

    In diesem Beispiel wird ein freigegebener Stammordner verwendet. Sie können jedoch auch einen lokalen Pfad für den Stammordner angeben, beispielsweise ein typisches Standardverzeichnis: C:\\Users\\<username>\\Documents\\ArcGIS\\DocCenter\\rootFolder, wobei <username> der Windows-Benutzername ist.

  4. Legen Sie optional statische Ports für den lokalen Webserver der Hilfe fest, indem Sie portPreferences unter webServer wie folgt ändern:

     "portPreferences": [
   {
     "order": 0,
     "port": <first_port_number>
   },
   {
     "order": 1,
     "port": <second_port_number>
   },
   {
     "order": 2,
     "port": <third_port_number>
   }
 ],

    port ist die verfügbare Portnummer, und order ist die nullbasierte Sequenz, in der die Portnummern verwendet werden. Im folgenden Beispiel werden alle drei Ports mit benutzerdefinierten Portnummern festgelegt:

     "portPreferences": [
   {
     "order": 0,
     "port": 13445
   },
   {
     "order": 1,
     "port": 13447
   },
   {
     "order": 2,
     "port": 13449
   }
 ],
    Hinweis:

    Die Standard-Portnummern lauten: 13774, 13322 und 14357, und zwar in dieser Reihenfolge.

    Wenn alle Portnummern identisch sind, probiert die App nur diese eine Portnummer aus und sucht dann automatisch nach einem verfügbaren Port, falls dieser nicht verfügbar ist. Sie können den Fallback-Port auf einen einzelnen Port begrenzen, indem Sie den Bereich ebenfalls auf nur eine Nummer begrenzen. Weitere Informationen hierzu finden Sie in der Referenz zur "appSettings.json"-Datei.

Beispiel für die appSettings.json-Datei

Im Folgenden ist ein Beispiel für die "appSettings.json"-Datei dargestellt. Hier werden zwar die Standard-Portnummern verwendet, es wurde jedoch ein benutzerdefinierter Stammordner hinzugefügt. Informationen zur vollständigen Liste der Einstellungen finden Sie in der Referenz zur "appSettings.json"-Datei.

{
  "init": true,
  "allowedHosts": "*",
  "endpoints": {
    "documentationSets": {
      "url": "https://doc.esri.com/offline-help/packages/all"
    },
    "webHelp": {
      "url": "https://doc.esri.com/en/arcgis-doc-center/"
    },
    "softwareUpdate": {
      "url": "https://doc.esri.com/offline-help/installer/"
    }
  },
  "webServer": {
    "defaultFileNames": [
      "index.html",
      "default.html"
    ],
    "portPreferences": [
      {
        "order": 0,
        "port": 13774
      },
      {
        "order": 1,
        "port": 13322
      },
      {
        "order": 2,
        "port": 14357
      }
    ],
    "portScan": {
      "minValue": 20000,
      "maxValue": 60000,
      "limit": 10
    },
    "rootFolder": "\\\\Tycho\\doc_share\\arcgis_docsets"
  },
  "language": "en",
  "theme": "Theme.Auto"
}