Portal for ArcGIS | Administrator Guide - Définition des options avancées du portail

Remarque :

Dans les versions 10.2.1 et ultérieures, l'emplacement du fichier de configuration et la méthode de modification du fichier ont changé. Pour savoir comment définir des options avancées sur le portail dans la version 10.2, consultez la documentation de la version 10.2.

Vous pouvez personnaliser le comportement de Portal for ArcGIS par le biais d'un fichier de configuration. Parmi les propriétés que vous pouvez définir, citons la possibilité d'afficher ou non certains liens et boutons du site Web, par exemple, des liens vers les réseaux sociaux ou un bouton permettant à des utilisateurs anonymes de créer des comptes de portail. Cette possibilité peut vous intéresser si vous effectuez la configuration d'un déploiement en mode déconnecté ou si vous modifiez le comportement du portail pour qu'il corresponde aux besoins de votre organisation. Par exemple, les organisations suivantes peuvent configurer leur portail de la manière suivante :

Secteur de la défense/gouvernement fédéral : configuration du portail dans son intégralité pour qu'il utilise les ressources locales, ajout de bannières de sécurité, désactivation de la fonction permettant aux utilisateurs anonymes de créer des comptes et désactivation du partage sur les réseaux sociaux.
Autorités locales : ajout de bannières de sécurité et définition du service d'étendue pour utiliser une projection locale.
Commerce : activation du partage avec les réseaux sociaux.

Le fichier de configuration se trouve dans <Portal for ArcGIS installation directory>\customizations\10.2.2\webapps\arcgis#home\js\esri\arcgisonline\config.js. Il est recommandé d'effectuer une copie de sauvegarde de ce fichier avant de le modifier.

Après avoir modifié les propriétés dans le fichier, vous devez redémarrer votre portail pour appliquer les modifications et effacer le cache de votre navigateur (y compris les cookies), afin de faire apparaître les modifications sur le site Web du portail.

Remarque :

Lorsque vous installez un correctif, effectuez une mise à jour système ou mettez à niveau votre portail vers une version plus récente, le fichier config.js est conservé dans le répertoire des personnalisations et les propriétés que vous avez modifiées dans le fichier seront conservées. A titre de précaution, conservez une copie du fichier config.js dans l'éventualité où le répertoire des personnalisations serait accidentellement supprimé par un membre de votre organisation.

Le fichier de configuration contient d'autre code que vous ne devez pas modifier. Lorsque vous ouvrez ce fichier, naviguez vers la section contenant les propriétés modifiables. Certaines des propriétés figurant dans le fichier de configuration du portail sont explicites, mais certaines propriétés sélectionnées sont décrites par le détail ci-après. Les propriétés sont répertoriées par ordre alphabétique.

Propriétés incluses dans le fichier de configuration

addContentSecurityText : si cette option n'est pas null, le texte spécifié s'affiche dans la boîte de dialogue Rechercher des couches à ajouter lors de la recherche d'un serveur SIG pour ajouter des couches à la carte. La boîte de dialogue s'affiche chaque fois que l'utilisateur effectue une recherche sur un serveur SIG. Le texte peut avertir les utilisateurs des contraintes de sécurité liées au contenu, telles que Destiné exclusivement à un usage interne ; ne pas distribuer. La valeur par défaut est null.
bitlyUrl : si cette option n'est pas null, des URL courtes seront affichées dans la boîte de dialogue Détails des éléments pour Facebook, Twitter, ainsi que des liens vers des cartes sous forme d'URL. Si cette option est null, les liens vers Twitter et Facebook ne sont pas disponibles. Pour pouvoir utiliser cette propriété, vous devez préciser l'identifiant URL Bitly et l'apiKey, par exemple http://api.bit.ly/v3/shorten?login=<identifiant>&apiKey=<clé>. La valeur par défaut est null.
bitlyUrlSSL : si l'authentification SSL est requise, spécifiez l'identifiant URL Bitly et la clé apiKey dans cette propriété, par exemple http://api.bit.ly/v3/shorten?login=<identifiant>&apiKey=<clé>. La valeur par défaut est null.

classificationBanner : Indique si une bannière de sécurité s'affichera en haut et en bas de chaque page de l'application. La valeur par défaut est false. Pour afficher une bannière de sécurité, remplacez la ligne classificationBanner:false par le code qui définit votre bannière. En voici un exemple :

classificationBanner : {
    "text" : "TOP SECRET",
    "color":[
      255,
      255,
      255,
      255
    ],
    "font":{
      "decoration":"none",
      "family":"Portable User Interface",
      "size":16,
      "style":"normal",
      "weight":"bold"
    },
    "height" : 5,
    "backgroundColor":[
      155,
      0,
      0,
      255
    ]
  },

extentService : Service permettant de mettre à jour ou de définir l'étendue d'un élément de carte Web dans la boîte de dialogue Définir l'étendue du site Web du portail. Le service doit utiliser le système de coordonnées géographiques WGS 1984 avec l'ID connu (WKID) 4326. La valeur par défaut est http://serveur.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer.

footerLinks : Cette propriété permet de définir les liens affichés dans les pieds de page de toutes les pages. L'exemple ci-après utilise les types contactUs et reportAbuse pour ouvrir une fenêtre de courrier électronique. Vous pouvez également modifier le texte de l'exemple dans les fichiers de localisation dojo (/js/esri/nls/arcgisonline.js et ses sous-répertoires), plus particulièrement dans les paramètres NLS_contactUsSubject, NLS_contactUsBody, NLS_reportAbuseSubject et NLS_reportAbuseBody. Les titres tels que ${NLS_termsOfUse} font référence au paramètre de localisation NLS_termsOfUse. Si vous ajoutez un nouveau nom de paramètre de localisation, veillez à l'ajouter aussi à chaque fichier de langue que vous souhaitez prendre en charge.

footerLinks: [{
      title: "My Organization",
      url: "http://www.myorganiz.com"
    }, {
      title: "${NLS_termsOfUse}",
      url: "http://www.myorganiz.com/legal/licensing/termsofuse.html"                        
    }, {
      title: "${NLS_privacy}",
      url: "http://www.myorganiz.com/legal/privacy.html"                                     
    }, {
      title: "${NLS_contactUs}",
      email: "feedback@myorganiz.com",
      type: "contactUs"
    }, {
      title: "${NLS_reportAbuse}",
      email: "feedback@myorganiz.com",
      type: "reportAbuse"
    }],

gcsBasemapService : Service à utiliser comme fond de carte pour les services OGC WMS ne prenant pas en charge le système de coordonnées Web Mercator. La valeur par défaut est http://services.arcgisonline.com/ArcGIS/rest/services/ESRI_Imagery_World_2D/MapServer.
longTokenExpiration : lorsqu'un utilisateur se connecte au site Web du portail et sélectionne Rester connecté, un jeton est généré avec un délai d'expiration par défaut de 20 160 minutes (14 jours). Si l'utilisateur ne sélectionne pas l'option Rester connecté lorsqu'il se connecte, le délai tokenExpiration remplace le délai défini dans cette propriété.
restrictOrganizationPageToAdmin : indique si la page Mon organisation est visible pour des membres dotés de privilèges d'utilisateur et d'éditeur sur le site Web du portail. La valeur par défaut est false, ce qui signifie que la page Mon organisation est visible pour tous les membres du portail. Pour masquer la page Mon organisation pour des utilisateurs et des éditeurs, affectez la valeur true à ce paramètre.
showSignUp : Détermine si le bouton Créer un compte et si la page de création de compte (signup.html) s'affichent dans le site Web du portail. La valeur par défaut est true, ce qui signifie que les utilisateurs anonymes ont la possibilité de créer des comptes d'utilisateurs dans le portail. Pour désactiver la page de création de compte, définissez cette propriété sur false.
showSocialMediaLinks : Indique si les liens Facebook et Twitter sont affichés dans la boîte de dialogue Détails des éléments. La valeur par défaut est false, ce qui signifie que les liens ne s'affichent pas. Pour activer ces liens, définissez cette propriété sur true et définissez les propriétés bitlyURL et bitlyURLSSL avec l'identifiant d'URL Bitly et la clé apiKey. Par exemple, http://api.bit.ly/v3/shorten?login=<identifiant>&apiKey=<clé>.
signInHelp : Cette propriété permet de remplacer la page ouverte par le lien Besoin d'aide pour vous connecter ? figurant sur la page de connexion (connexion.html). La valeur par défaut est null, ce qui signifie que la page par défaut (troubleshoot.html) est affichée par le lien. Pour spécifier votre propre page, définissez l'URL de la page que le lien ouvrira, par exemple signInHelp: "http://machine.domain.com/mysignin.html",.
tokenExpiration : lorsqu'un utilisateur se connecte au site Web du portail, un jeton est généré avec un délai d'expiration par défaut de 120 minutes (2 heures). Si l'utilisateur sélectionne l'option Rester connecté lorsqu'il se connecte, le délai longTokenExpiration remplace le délai défini dans cette propriété.
webSearchEnabled : Indique si les recherches sur le Web (par exemple, les recherches Google) sont autorisées dans le contenu de votre portail. La valeur par défaut est true. Pour désactiver les recherches Web sur le contenu de votre portail, définissez cette option sur false.

5/10/2014