Services d’entités et applications client

Vous pouvez utiliser divers clients ArcGIS pour mettre à jour ou afficher les entités d’un service d’entités, comme des clients Web ou ArcGIS Pro.

Clients Web ArcGIS prêts à l’emploi

Map Viewer et les modèles disponibles dans ArcGIS Online et ArcGIS Enterprise fournissent des fonctions de base prêtes à l’emploi pour la mise à jour des services d’entités. Sans aucune programmation, vous pouvez rapidement créer une application de mise à jour Web permettant aux utilisateurs d’ajouter, de mettre à jour et de supprimer des entités géographiques dans une base de données.

Ainsi, lors de l’utilisation des applications prêtes à l’emploi, vous pouvez effectuer les opérations suivantes :

• Mettre à jour des couches.
• Effectuer le suivi des mises à jour.
• Contrôler l’accès aux entités à l’aide du contrôle d’accès en fonction de la propriété.
• Empêcher les utilisateurs de mettre à jour la géométrie de l’entité.

Vous pouvez ajouter des services d’entités à Map Viewer à l’aide de l’URL du répertoire de services d’ArcGIS Server. Après avoir créé et enregistré une carte contenant un service d’entités, vous pouvez la partager avec d’autres personnes de votre organisation, l’incorporer dans un site Web ou encore coller un lien (URL) vers l’application dans un e-mail, un blog ou un site Web. Vous pouvez également déployer les cartes que vous créez à l’aide de modèles d’application disponibles dans votre organisation. Ces modèles sont entièrement personnalisables.

Vous pouvez également ajouter des services d’entités en tant qu’éléments dans une organisation ArcGIS Enterprise ou ArcGIS Online, et partager les éléments avec d’autres membres de cette organisation.

Clients ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for JavaScript fournit les fonctions de mise à jour Web et les options de personnalisation les plus avancées. Si vous maîtrisez la programmation à l’aide de cette API, vous pouvez adapter l’expérience de mise à jour à un objectif particulier ou à une stratégie organisationnelle bien précise. Par exemple, avec ArcGIS Maps SDK for JavaScript, vous pouvez effectuer les tâches suivantes :

• Mettre à jour des couches en sélection seule.
• Effectuer le suivi des mises à jour.
• Contrôler l’accès aux entités à l’aide du contrôle d’accès en fonction de la propriété.
• Empêcher les utilisateurs de mettre à jour la géométrie de l’entité.
• Créer, supprimer et modifier les versions de la géodatabase référencée à la volée.
• Mettre à jour des représentations cartographiques.

Obtention de l’extrémité REST d’un service d’entités

Vous pouvez obtenir l’extrémité REST, ou URL, d’un service d’entités en accédant au service dans le répertoire de services d’ArcGIS Server. Par exemple, l’URL d’accès par défaut à un service d’entités dans le répertoire de services est https://gisserver.example.com:6443/arcgis/rest/services/folder_name/service_name/FeatureServer.

Pour accéder à une couche spécifique dans le service d’entités, ajoutez un entier supérieur ou égal à zéro à l’URL. Par exemple, si vous ajoutez /0 à l’URL, vous fournissez l’accès à la première couche du service ; si vous ajoutez /1 à l’URL, vous fournissez l’accès à la seconde couche du service.

Utilisation des services d’entités dans ArcGIS Pro

Vous pouvez ajouter des services d’entités dans ArcGIS Pro pour afficher et mettre à jour les données qu’ils contiennent.

Le processus de mise à jour utilisé dans ArcGIS Pro est fondamentalement différent de celui appliqué pour mettre à jour un service d’entités par l’intermédiaire d’une application web. Pour en savoir plus, reportez-vous à la rubrique Mettre à jour des services d’entités dans l’aide ArcGIS Pro.

Utilisation de la synchronisation avec les services d’entités

Les services d’entités contiennent des opérations qui prennent en charge les workflows de mise à jour en mode déconnecté. Dans un environnement déconnecté, le client (par exemple, un environnement d’exécution ou un appareil mobile) peut effectuer des mises à jour en local, puis synchroniser les modifications avec le site ArcGIS Server, une fois reconnecté au service d’entités. Cette fonctionnalité, appelée synchronisation, est disponible via ArcGIS REST API.

Pour plus d’informations sur l’utilisation de la synchronisation avec des services d’entités, reportez-vous à la section correspondante dans l’aide ArcGIS REST API.

Amélioration des performances d’affichage des services d’entités

Lorsque les clients envoient des demandes de service d’entités à ArcGIS Server, la réponse du serveur est généralement mise en cache par le navigateur et réutilisée pendant un certain temps. Toutefois, selon la manière dont votre service d’entités et les données qui lui sont associées sont utilisés dans les applications, vous pouvez envisager d’ajuster la durée pendant laquelle le navigateur utilisera une réponse figurant dans son cache. Pour cela, vous devez ajouter une propriété nommée cacheControlMaxAge dans le fichier JSON (JavaScript Object Notation) du service.

Utilisation de la propriété cacheControlMaxAge

Les réponses des services d’entités d’ArcGIS Server incluent un en-tête de balise d’entité (ETag) et Cache-Control. La valeur de l’en-tête ETag identifie de façon unique la réponse. L’en-tête Cache-Control possède une valeur d’âge maximal qui informe le navigateur de la durée maximale pendant laquelle il peut réutiliser une réponse à partir du cache du navigateur. Cette valeur est contrôlée par la propriété cacheControlMaxAge.

Lorsqu’une demande précédente est répétée et que l’âge maximal du cache n’a pas encore expiré, le navigateur utilise la réponse mise en cache sans envoyer la demande au serveur. Si l’âge maximal a expiré, le navigateur doit envoyer la demande au serveur et définir un en-tête IF-NONE-MATCH avec une valeur ETag associée correspondant à la réponse présente dans son cache. ArcGIS Server évalue la demande et utilise la valeur ETag pour vérifier si la réponse a changé. Si la réponse du serveur diffère de la copie stockée dans le navigateur, le serveur envoie une nouvelle réponse au navigateur. Si la réponse est identique à la copie du navigateur, le serveur avertit le navigateur de continuer à utiliser la réponse présente dans son cache.

Définir la valeur de la propriété cacheControlMaxAge

Pour spécifier la durée pendant laquelle un navigateur est autorisé à utiliser une réponse mise en cache, définissez la propriété cacheControlMaxAge. Cette propriété peut être définie pour chaque cache de service. Le fait de réduire les éventualités où ArcGIS Server doit envoyer une réponse complète permet d’améliorer l’efficacité du cache du navigateur Web, de favoriser l’optimisation des applications et d’économiser la bande passante du réseau.

Pour les services d’entités, la valeur par défaut est zéro. Cela signifie que le navigateur renvoie toujours une demande et qu’ArcGIS Server traite cette demande, puis envoie une réponse complète au navigateur si le contenu a changé. Cette valeur fonctionne correctement pour la plupart des applications.

Pour les services d’entités dans lesquels les données ne changent pas fréquemment, il est recommandé d’augmenter la valeur par défaut à 30 jours (2 592 000 secondes) ou plus pour réduire au maximum le trafic réseau.

Pour ajouter la propriété cacheControlMaxAge à un service d’entités et spécifier sa valeur par défaut, procédez comme suit :

1. Dans un navigateur Web, ouvrez le répertoire administrateur ArcGIS Server et connectez-vous en tant qu’utilisateur doté des privilèges d’administrateur.

   L’URL est au format https://gisserver.example.com:6443/arcgis/admin.

2. Cliquez sur services et sélectionnez le service d’entités à modifier dans la liste Services.

   Si votre service n’apparaît pas dans cette liste, il est peut-être dans un répertoire sous le dossier Root (Racine).

3. Faites défiler la page du service d’entités cible vers le bas et cliquez sur edit (mettre à jour).

   La boîte de dialogue Service Properties (Propriétés du service) s’ouvre.

4. Insérez la propriété cacheControlMaxAge dans le fichier JSON.

   L’emplacement auquel vous insérez la propriété dépend du type de service d’entités : soit il référence des données inscrites, soit il s’agit d’un service d’entités hébergé.

   • Dans le cas d’un service d’entités qui référence une source de données inscrite, localisez la section "extensions" dans le fichier JSON. Recherchez la sous-section contenant le texte "typeName": "FeatureServer" et insérez la propriété cacheControlMaxAge dans le paramètre properties de cette sous-section.
   • Dans le cas d’un service d’entités hébergé, localisez la section "jsonProperties" dans Service Properties (Propriétés du service) du fichier JSON. Ajoutez la propriété cacheControlMaxAge à cette section.
5. Définissez la propriété cacheControlMaxAge sur la valeur souhaitée (en secondes).

   L’exemple suivant indique comment définir la propriété cacheControlMaxAge sur 30 jours (2 592 000 secondes) pour un service d’entités qui référence un data store inscrit :

     {
      "typeName": "FeatureServer",
      "capabilities": "Query,Create,Update,Delete,Uploads,Editing",
      "enabled": "true",
      "maxUploadFileSize": 0,
      "allowedUploadFileTypes": "",
      "properties": {
       "cacheControlMaxAge": "2592000",}
   }

   L’exemple suivant indique comment définir la propriété cacheControlMaxAge sur 30 jours (2 592 000 secondes) pour un service d’entités hébergé.

   "jsonProperties": {**
     "currentVersion": 11.5,
     "serviceDescription": "",
     "maxRecordCount": 2000,
     "cacheControlMaxAge": "2592000",
   }

6. Cliquez sur Enregistrer les mises à jour.

Sur la page du service d’entités dans ArcGIS Server Administrator Directory, vérifiez que la propriété cacheControlMaxAge et la valeur spécifiée correspondante s’affichent dans la section Properties (Propriétés).

Saisie de code HTML dans des champs de texte

Lors de la mise à jour d’un service d’entités dans une application cliente, vous pouvez utiliser des entités et des attributs HTML dans des champs de texte. Par exemple, lorsque vous mettez à jour une entité dans un client web, vous pouvez saisir du texte HTML formaté dans un champ de commentaires.

Remarque :

Par défaut, seuls les attributs et les entités HTML répertoriés dans le tableau ci-dessous peuvent être utilisés dans des champs de texte de services d’entités. L’ajout d’une entité ou d’un attribut non pris en charge entraîne une erreur.

Si le processus requiert des attributs et des entités HTML non pris en charge, vous devez désactiver la propriété Filter web content (Filtrer le contenu Web) dans le service d’entités. Cette propriété est accessible dans la boîte de dialogue Advanced Options (Options avancées) du service d’entités d’ArcGIS Server Manager. Pour plus d’informations, reportez-vous à la rubrique Mettre à jour les propriétés d’un service dans Server Manager.

Entité HTML	Attribut HTML (le cas échéant)
<a>	href, target, style
<b>
<br>
<div>	style, align
<em>
<police>	size, color, style, face
protocole http, https	src, href
<i>
<img>	src, width, height, alt, border, style
<li>
protocole mailto:	src, href
<ol>
<span>	style
<strong>
<table>	width, height, cellpadding, cellspacing, border, style
<tbody>
<td>	height, width, valign, align, colspan, rowspan, nowrap, style
<tr>	height, valign, align, style
<u>
<ul>