Skip to main content

Configurer ArcGIS Documentation Center (administrateurs informatiques)

Après l’installation d’ArcGIS Documentation Center, l’étape suivante consiste à configurer l’application. Les administrateurs informatiques peuvent configurer l’application pour plusieurs utilisateurs en déployant un fichier appSettings.json sur la machine de chaque utilisateur. Ce fichier est utilisé par l’application pour stocker des paramètres modifiables par l’utilisateur. Le fichier se trouve dans le dossier %LocalAppData%\ESRI\ArcGISDocCenter de l’utilisateur.

Important :

Les utilisateurs peuvent remplacer la plupart de ces paramètres en les modifiant dans l’application, sous Menu > Settings (Paramètres) .

Les étapes générales pour configurer l’application pour plusieurs utilisateurs sont les suivantes :

  1. Créez un fichier appSettings.json.

  2. Déployez le fichier sur %LocalAppData%\ESRI\ArcGISDocCenter sur le système de chaque utilisateur.

Important :

Le fichier 'appSettings.json' peut déjà exister sur le système de l’utilisateur. Le fichier n’est pas automatiquement supprimé lors de la désinstallation, afin d’enregistrer les paramètres utilisateur pour une installation ultérieure. Il peut aussi être créé par l’utilisateur lors de la première ouverture de l’application. Vous pouvez supprimer le fichier existant ou le remplacer par votre fichier personnalisé.

Créer un fichier appSettings.json

Créez le fichier pour gérer les paramètres du centre de documentation en procédant comme suit :

  1. Créez un fichier nommé appSettings.json.

  2. Copiez et collez ce qui suit dans le fichier :

    {
  "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. Changez le dossier racine en modifiant rootFolder sous webServer comme suit :

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

    Par exemple, un serveur nommé Polaris possède un dossier racine partagé arcgis_documentation, où seront stockés les kits de documentation :

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

    Cet exemple utilise un dossier racine partagé, mais vous pouvez également spécifier un chemin d’accès local pour le dossier racine, comme un emplacement par défaut standard C:\\Users\\<username>\\Documents\\ArcGIS\\DocCenter\\rootFolder, où <username> est le nom d’utilisateur Windows.

  4. Vous pouvez éventuellement définir des ports statiques pour le serveur Web d’aide local en modifiant portPreferences sous webServer comme suit :

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

    Où port est le numéro de port disponible, et order est la séquence à partir de zéro dans laquelle ils sont utilisés. L’exemple suivant définit les trois ports avec des numéros de port personnalisés :

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

    Les numéros de port par défaut figurent dans cet ordre : 13774, 13322 et 14357.

    Si tous les numéros de port sont identiques, l’application n’essaie que ce numéro de port, puis trouve automatiquement un port disponible si celui-ci ne l’est pas. Vous pouvez limiter le port de secours à un seul port en limitant la plage à un seul numéro également. Pour plus d’informations à ce sujet, consultez la référence appSettings.json.

Exemple appSettings.json

Un exemple du fichier appSettings.json est présenté ci-dessous. Les numéros de port par défaut sont utilisés, mais un dossier racine personnalisé est ajouté. Pour plus d’informations sur la liste complète des paramètres, consultez la référence appSettings.json.

{
  "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"
}