Exigences communes aux géodatabases et bases de données

Les données doivent être définies par une référence spatiale valide. Si ce n'est pas le cas, spécifiez-en une dans ArcMap avant d'effectuer la publication. Si aucune référence spatiale n'est définie, vous ne pouvez pas publier les données.

Si vous projetez d'utiliser le service d'entités pour la mise à jour, il est recommandé d'ajouter des données uniquement au document ArcMap que vous souhaitez mettre à jour. Publiez les données que vous ne souhaitez pas mettre à jour, telles que les couches de fond de carte, dans un service distinct. Pour plus d'informations sur la planification de vos services opérationnels et de fond de carte, reportez-vous à la rubrique Planification des services de carte. Une autre alternative consiste à utiliser un fond de carte ArcGIS Online. Pour plus d'informations sur la conception d'une carte pour superposer des cartes et des services en ligne, reportez-vous à la rubrique Conception d'une carte pour superposer ArcGIS Online, Google Maps et Bing Maps.

Vous pouvez modifier des entités comportant des valeurs z. Pour plus d'informations, reportez-vous à la rubrique Mise à jour d'entités dotées de valeurs z dans des services d'entités.

Si certaines données comportent des valeurs m, ces entités peuvent être supprimées, de nouvelles entités peuvent être insérées et les attributs des entités existantes peuvent être mis à jour, ce qui n'est pas le cas de la géométrie. Les valeurs m de toutes les nouvelles entités sont définies sur NaN quand elles sont insérées au moyen des points de terminaison SOAP et REST. Si les entités dotées de valeurs m sont mises à jour via le service d'entités dans ArcMap, à l'aide des commandes de mise à jour locales, toutes les opérations de mise à jour sont alors prises en charge.

Par ailleurs, si vous projetez d'ajouter le service d'entités dans ArcMap pour le mettre à jour, incluez une seule couche par classe d'entité lors de la création du document ArcMap.

Exigences propres aux géodatabases d'entreprise ou de groupe de travail

Vous trouverez ci-dessous la configuration requise pour les données du service d'entités stockées dans une géodatabase d'entreprise ou de groupe de travail :

• Toutes les données doivent provenir d'une seule géodatabase.
• Toutes les données doivent être inscrites dans la géodatabase. Par exemple, si votre base de données contient une géodatabase d'entreprise, vous ne pouvez pas publier à partir de la base de données une table spatiale qui n'est pas inscrite auprès de la géodatabase.
• Vous devez accorder des autorisations en écriture sur les données pour autoriser la mise à jour des données. Si vous utilisez l'authentification du système d'exploitation, ces autorisations doivent être accordées au compte ArcGIS Server.
• Si vous autorisez les mises à jour sur le service d'entités et que ce dernier contient des classes d'entités faisant partie d'un réseau géométrique, les données de la classe d'entités doivent être dans la même projection et dans le même système de référence de coordonnées que ceux utilisés par l'application cliente de mise à jour. Par exemple, si vous pensez ajouter le service d'entités dans la visionneuse de carte ArcGIS Online ou Portal for ArcGIS pour la mise à jour, les données doivent être enregistrées en WGS 1984 Web Mercator (Sphère auxiliaire). Notez que vous ne pouvez pas simplement changer la projection dans ArcMap ou une carte ArcGIS Pro avant de procéder à la publication ; les données doivent utiliser la même projection et le même système de référence de coordonnées que le client de mise à jour.
• Les données de géodatabases versionnées et non versionnées sont prises en charge. Esri vous recommande d'utiliser des données non versionnées dans les services d'entités, car elles s'adaptent mieux pour les mises à jour. Il existe des types de données non simples (par exemple, des tronçons de réseau). Toutefois, ces données doivent être versionnées pour que vous puissiez les mettre à jour via un service d'entités.

Les types de données suivants ne sont pas pris en charge dans les services d'entités :

• Annotations
• Dimensions
• Groupes de couches
• Couches et tables basées sur des vues
• Couches de requête contenant des colonnes virtuelles, des clauses WHERE ou des jointures
• Jeux de données raster
• MNT

Si ces couches sont présentes dans votre document ArcMap lorsque vous essayez de publier un service de carte et que l'accès aux entités est activé, l'analyseur rencontre des erreurs.

Les couches qui font partie de types non simples, tels que les réseaux géométriques, les topologies et les jeux de données réseau, sont prises en charge, mais les types eux-mêmes ne sont pas renvoyés par le service. Par exemple, vous pouvez interroger les couches faisant partie d'une topologie, mais vous ne pouvez pas interroger la topologie elle-même.

Les services d'entités permettent également d'effectuer des requêtes sur les données reliées. Par exemple, un document ArcMap publié peut disposer de couches et de tables reliées par l'intermédiaire de classes de relations de géodatabase. Dans ce cas, le service d'entités permet aux requêtes sur une couche de renvoyer des objets de la couche ou de la table reliée. Notez que pour la prise en charge de requêtes qui renvoient des objets reliés, la table et la couche impliquées dans la classe de relations doivent toutes deux figurer dans le document ArcMap publié. Si la couche ou la table d'origine ou de destination n'est pas comprise dans le document ArcMap, le service d'entités ignore la relation.

Exigences propres aux bases de données

Vous trouverez ci-dessous la configuration requise pour les données du service d'entités qui sont stockées dans une base de données :

• Toutes les données doivent provenir d'une seule base de données.
• Vous devez accorder des autorisations en écriture sur les données pour autoriser la mise à jour des données. Si vous utilisez l'authentification du système d'exploitation, accordez ces autorisations au compte ArcGIS server.
• Lorsque vous ajoutez des données de base de données à ArcMap, une couche de requête est créée. Si vous modifiez la définition de la couche de requête, veillez à ce que la requête ne contienne qu'une seule table, qu'elle ne comprenne pas de colonnes en double et qu'elle ne comporte pas de jointures, de clauses WHERE ou de colonnes virtuelles ou fusionnées.
• Les données publiées sont déterminées par la couche de requête définie pour la table dans ArcMap. Par exemple, les tables qui contiennent des types de données non pris en charge par ArcGIS peuvent être publiées, mais les types de données non pris en charge ne sont pas accessibles dans ArcGIS ou le service d'entités. Reportez-vous à la rubrique Afficher des données de base de données dans ArcGIS pour plus d'informations sur la définition initiale de la couche de requête lorsqu'une table de base de données est ajoutée à ArcMap.
• La table doit contenir une colonne d'entiers uniques gérés par la base de données. Si vous créez des tables et chargez les données dans la base de données à l'aide d'ArcGIS for Desktop, un ObjectID d'entier unique géré par la base de données est ajouté automatiquement. Si vous créez des données en-dehors d'ArcGIS, veillez à inclure dans la table une colonne d'entiers uniques de valeur non Null gérés par la base de données. Si cette colonne n'existe pas, vous ne pouvez pas publier de service d'entités. Vous pouvez utiliser l'outil de géotraitement Ajouter un champ d’ID d’incrémentation pour ajouter une colonne d'entiers gérés par la base de données dans votre table s'il s'agit d'une base de données ALTIBASE, DB2, SQL Server, Oracle ou PostgreSQL. Pour toutes les autres bases de données, utilisez les outils SGBD ou SQL pour créer la colonne ID.

Définir la symbologie

Un service d'entités vous permet d'interroger des entités et d'obtenir leur symbologie. Les clients peuvent utiliser ces informations pour dessiner les entités avec une symbologie cohérente avec celle définie sur le service.

Les symboles renvoyés par le service reposent sur la symbologie des couches dans le document ArcMap. Chaque symbole dans chaque couche est désigné en tant que type. Par exemple, une couche symbolisée avec un moteur de rendu simple (un symbole) a un type. Si un moteur de rendu à valeurs uniques est utilisé, un type est renvoyé pour chaque valeur unique du moteur de rendu.

Les services d'entités prennent en charge des moteurs de rendu par bornes de classes, par valeurs uniques et simples, et de représentation cartographique. Si vous utilisez un moteur de rendu non pris en charge, le service ne peut pas démarrer. Le journal de serveur permet dans ce cas de déterminer les couches ayant des moteurs de rendu non pris en charge.

La plupart des types de symbole peuvent être utilisés avec un service d'entités ; toutefois, dans certains cas, les symboles peuvent être rétrogradés.

Pour les couches de lignes, les symboles ligne simple sont pris en charge. Si d'autres symboles sont utilisés, le service d'entités les convertit en symbole ligne simple qui représente le mieux le symbole d'origine. Par exemple, un symbole linéaire cartographique dans le document ArcMap peut être dessiné en tant que trait plein simple dans un client du service d'entités. Si un symbole ligne est complexe ou possède plusieurs couches, le service d'entités rétrograde la ligne de manière à représenter le mieux le symbole ligne d'origine.

Pour les couches de polygones, les symboles de remplissage simple et de remplissage par image sont pris en charge. Si d'autres symboles sont utilisés, le service d'entités les rétrograde en symboles de remplissage simple. Pour les symboles de remplissage multi-couches, le service d'entités prend en compte uniquement la couche supérieure. Par ailleurs, le symbole de contour d'un symbole de remplissage présente le même niveau de prise en charge que celui décrit ci-dessus pour les couches de lignes.

Pour les couches de points, les symboles ponctuels simples et les symboles ponctuels de type image sont pris en charge. Si d'autres symboles sont utilisés, le service d'entités les rétrograde en symboles ponctuels de type image. Les symboles ponctuels multi-couches sont également rétrogradés en symboles ponctuels de type image où les couches sont fusionnées en une seule. Les propriétés de masque, permettant de définir un halo pour un symbole ponctuel, ne sont pas prises en charge.

Lorsqu'un service de carte disposant de l'accès aux entités démarre, les symboles sont vérifiés et rétrogradés si nécessaire. Le cas échéant, un avertissement est ajouté au journal de serveur pour décrire les symboles rétrogradés.

Il est également important de noter que si le document ArcMap présente des couches utilisant des moteurs de rendu de représentation cartographique, ces moteurs de rendu sont indiqués comme étant des moteurs de rendu par valeurs uniques lorsque les clients accèdent au service via REST.

Définir des modèles d'entités

L'insertion de nouvelles entités par l'intermédiaire d'un service d'entités est réalisée à l'aide des modèles d'entité du document ArcMap. Un modèle permet de numériser une nouvelle entité et d'avoir les valeurs par défaut de l'attribut définies en conséquence. Les services d'entités nécessitent qu'un modèle soit présent pour chaque type d'entité. Lorsque vous démarrez une session de mise à jour ou publiez le service, un modèle par défaut est créé par type.

Les modèles par défaut sont toujours utilisés pour les données de base de données. Vous pouvez créer des modèles personnalisés à utiliser avec les données de géodatabase. Pour plus d'informations, reportez-vous à la section Modèles d'entités personnalisés.

Définir une plage d'échelle

Les services d'entités affichent par défaut 1 000 entités uniquement. Lorsque vous publiez une couche d'entités hébergée sur Portal for ArcGIS, seulement 2 000 entités sont affichées. Vous devez définir la plage d'échelle des couches d'entités sur la carte que vous publiez de façon que la couche ne s'affiche pas à une échelle à laquelle le nombre d'entités qui apparaîtrait serait supérieur au nombre maximum d'entités autorisées.

Pour attribuer une plage d'échelle à une couche d'entités, cliquez avec le bouton droit sur la couche dans la table des matières d'ArcMap, puis sélectionnez Propriétés. Définissez la plage d'échelle sur l'onglet Général de la boîte de dialogue Propriétés de la couche.

Propriétés du champ

Les propriétés du champ définies dans ArcMap sont disponibles via le service d'entités ; elles comprennent les alias de champ, la visibilité des champs et la propriété de lecture seule d'un champ. Les champs en lecture seule comprennent des champs gérés par le système, tels qu'ObjectID, GlobalID, des champs de suivi de l'éditeur (géodatabase uniquement), ainsi que des champs définis en lecture seule dans le document ArcMap.

Lors de l'application d'une mise à jour, si une valeur est définie pour un champ en lecture seule, le service d'entités ignore la valeur. Lors de l'application d'une insertion, les valeurs par défaut sont appliquées pour les champs en lecture seule et les champs invisibles Si des valeurs par défaut n'ont pas été définies, des valeurs Nul sont appliquées. Si le champ ne peut pas stocker de valeurs Null, l'insertion échoue.

Description de couche et informations de copyright

Les descriptions de couche et les crédits (copyright) spécifiés dans le document ArcMap sont également disponibles pour chaque couche du service d'entités sous la forme de description de couche et d'informations de copyright, respectivement.

Fenêtres contextuelles HTML

Les services d'entités prennent également en charge la configuration de fiches HTML dans ArcMap. Les fiches HTML représentent une méthode puissante et facile pour partager des informations au format HTML concernant les entités. Elles présentent un fonctionnement semblable à l'outil Identifier, mais les informations affichées peuvent correspondre à un format HTML personnalisé. Pour plus d'informations sur la procédure de configuration de fenêtres contextuelles HTML dans ArcMap, reportez-vous à la rubrique Définition de propriétés contextuelles HTML pour des couches d'entités

Si vous utilisez votre service d'entités sur le Web et que vous voulez rendre des fenêtres contextuelles accessibles, définissez-les plutôt dans la ArcGIS.com, visionneuse de carte. Sinon, les développeurs peuvent utiliser l'API client, telle qu'ArcGIS API for JavaScript, pour définir des styles de fenêtres contextuelles.

Prise en charge du temps

Les données temporelles, qui représentent un état dans le temps, sont prises en charge et vous pouvez les afficher via des services d'entités. Les informations temporelles sont stockées dans un ou plusieurs champs attributaires et permettent de visualiser des données à des moments particuliers ou par intervalles de temps. Vous pouvez afficher des données temporelles via le service d'entités en activant l'heure dans l'onglet Heure de la boîte de dialogue Propriétés de la couche. Pour plus d'informations sur la procédure d'activation des propriétés temporelles pour un jeu de données, reportez-vous à la rubrique Activation des propriétés de temps sur vos données.

Systèmes de coordonnées

Les services d'entités prennent en charge les situations dans lesquelles les couches du document ArcMap présentent des systèmes de coordonnées différents. Les conversions de système de coordonnées sont effectuées si nécessaire lors de l'utilisation du service d'entités. Par exemple, si un client insère une entité par l'intermédiaire d'un service d'entités à l'aide d'un système de coordonnées différent de celui de la couche, elle est convertie au système de coordonnées de la couche avant d'être stockée. Les requêtes spatiales qui impliquent des géométries sont également converties vers le système de coordonnées de la couche avant d'être appliquées, afin de renvoyer les résultats corrects.

Les transformations géographiques (datum) sont également utilisées si nécessaire. Par exemple, si la couche est stockée en NAD27 et qu'une entité est insérée par l'intermédiaire du service avec un système de coordonnées WGS 1984, une transformation de datum WGS 1984 vers NAD27 est effectuée avant le stockage de l'entité. Vous pouvez contrôler la méthode de transformation en configurant des transformations dans les propriétés du bloc de données du document ArcMap avant la publication. Une transformation par défaut est effectuée en l'absence de transformation définie dans la carte.

Fonctionnalités de géodatabase supplémentaires

Si vos données sont stockées dans une géodatabase, vous pouvez utiliser certaines fonctionnalités supplémentaires. Configurez ces fonctionnalités avant de publier un service d'entités.

Définir les données

La première étape de création d'un service d'entités consiste à définir les données qui sont disponibles par l'intermédiaire du service. Dans cet exemple, démarrez avec une classe d'entité appelée Bird_Sightings dans une géodatabase. Pour associer des pièces jointes à cette classe d'entités, elles doivent être ajoutées dans ArcCatalog ou dans la fenêtre Catalogue d'ArcMap. Pour cela, connectez-vous à la base de données, cliquez avec le bouton droit de la souris sur la classe d'entité, puis sélectionnez Gérer > Créer des pièces jointes. Cette opération crée une table qui stocke les pièces jointes et une classe de relations qui relie la classe d'entité à la table de pièces jointes. Pour plus d'informations sur la procédure d'ajout de pièces jointes à une classe d'entités, reportez-vous à la rubrique Activation des pièces jointes pour une classe d'entités.

Définir la symbologie

Une fois les données définies, la prochaine étape consiste à ajouter les données à ArcMap et à définir la symbologie. Les symboles renvoyés par le service d'entités sont basés sur la symbologie des couches du document ArcMap. Chaque symbole dans chaque couche est désigné en tant que type. Dans cet exemple, par défaut, la couche Bird_Sightings est symbolisée avec un moteur de rendu simple (un symbole).

Toutefois, dans cette situation, vous souhaitez symboliser la couche d'observations ornithologiques selon le type d'observation. Pour cela, un moteur de rendu unique peut être utilisé. Pour modifier l'affichage d'une couche, cliquez avec le bouton droit de la souris sur la couche et sélectionnez les propriétés. Dans la boîte de dialogue des propriétés, cliquez sur l'onglet Symbologie et, sous Catégories, sélectionnez Valeurs uniques. Vous pouvez ensuite sélectionner le champ à utiliser pour symboliser la couche. Dans ce cas, il existe trois types uniques d'observation (observation d'oiseau, observation de nid et observation d'oiseau rare), donc trois types (un pour chaque type d'observation) sont renvoyés par le service.

Maintenant que le moteur de rendu est sélectionné, la prochaine étape consiste à sélectionner les symboles qui représentent chaque type d'observation. Dans ce cas, un symbole d'oiseau est sélectionné à partir du sélecteur de symboles Esri. Les couleurs d'arrière-plan et de premier plan sont définies différemment pour chaque type d'observation afin de les distinguer facilement dans le service d'entités. Lorsque le document ArcMap est publié, les symboles sont convertis en graphiques PNG, renvoyés au client.

Dès lors que la symbologie est configurée, la prochaine étape consiste à définir l'environnement de mise à jour qui sera disponible par l'intermédiaire du service d'entité.

Définir l'environnement de mise à jour

Ce service d'entités est destiné à permettre aux passionnés des oiseaux de saisir des observations ornithologiques, ainsi que les informations pertinentes sur une carte. La mise à jour par l'intermédiaire d'un service d'entités est effectuée à l'aide des modèles d'entités issus du document ArcMap. Si vous ne créez pas de modèles, un modèle par défaut est créé par type lorsque vous publiez le service. Toutefois, vous pouvez également créer des nouveaux modèles ou modifier des modèles existants pour personnaliser la mise à jour.

Dans cet exemple, vous souhaitez créer des modèles pour ce service d'entités. Pour cela, cliquez avec le bouton droit de la souris sur la classe d'entité, et sélectionnez Modifier les entités, puis Organiser les modèles d'entité. Sous Couches, sélectionnez la couche et cliquez sur Nouveaux modèles. L'assistant Modèle qui s'affiche vous permet de créer des modèles. Choisissez de créer des modèles pour les différents types d'observation ornithologique. Une fois les modèles créés, copiez-les pour créer des modèles supplémentaires.

Pour ce service d'entités, vous souhaitez ajouter un modèle supplémentaire pour le type d'observation d'oiseau rare. Les observations d'oiseaux rares peuvent être des oiseaux qui sont menacés ou hors saison dans la zone. Pour créer une copie d'un modèle, sélectionnez le modèle à copier et cliquez sur Copier. Dans ce cas, une copie du modèle d'observation d'oiseau rare est créée pour permettre la personnalisation de chaque exemplaire en vue de représenter les deux types d'observations d'oiseaux rares. Pour personnaliser un modèle, double-cliquez sur le modèle dans la fenêtre Organiser les modèles d'entité. Cette opération affiche les propriétés de modèle, permettant de modifier le nom du modèle ainsi que les valeurs par défaut des champs.

Le modèle pour les observations d'oiseaux rares menacés présente un type d'observation défini sur Oiseaux rares et la description est définie sur Menacé. Le modèle pour les observations d'oiseaux rares hors saison présente un type d'observation défini sur Oiseaux rares et une description définie sur Hors saison.

Le reste des attributs peut également être défini sur des valeurs par défaut appropriées au sein de chaque modèle. Dans cette situation, les observations d'oiseaux rares menacés nécessitent une étude de suivi. L'attribut Suivi peut donc être défini sur Oui par défaut. Aucun suivi n'est nécessaire pour les observations d'oiseaux rares hors saison. L'attribut Suivi peut donc être défini sur Non.

La définition de certains attributs sur des valeurs par défaut dans les modèles permet de simplifier la mise à jour car il suffit aux utilisateurs de sélectionner le type d'entité et de le numériser. Dès lors que les couches, types et modèles sont définis dans votre document ArcMap, vous êtes prêt à publier le service. Après sa publication, les utilisateurs peuvent accéder au service par l'intermédiaire de clients Web ou d'ArcGIS for Desktop pour l'interroger et le mettre à jour.

Pour plus d'informations sur la publication d'un service d'entités, reportez-vous à la rubrique Publication de services d'entités.

Géodatabase d'entreprise

Si vos données sont stockées dans une géodatabase d'entreprise, suivez les didacticiels correspondants :

Didacticiel : exécuter des mises à jour Web à l'aide de données d'une géodatabase d'entreprise

Didacticiel : exécution de mises à jour Web à l'aide de données répliquées d'une géodatabase d'entreprise

Didacticiel : configurer les données d'un service d'entités pour une utilisation hors connexion

Base de données

Si vos données sont stockées dans une base de données, suivez le didacticiel correspondant :

Didacticiel : exécuter des mises à jour Web à l'aide des données d'une base de données