Création de services d'entités

Le processus de création de services d'entités implique la configuration d'un document ArcMap pour définir les données et la symbologie qui seront proposées par le service. Si vous projetez d'autoriser les mises à jour sur le service, vous pouvez également définir l'environnement de mise à jour.

Définition des données

Les couches et tables ajoutées au document ArcMap sont proposées par le service. Les éléments suivants décrivent les conditions requises pour les données des services d'entités :

• Toutes les données doivent provenir d'une seule géodatabase ArcSDE.
• Toutes les données doivent être inscrites dans la géodatabase.
• Vous devez accorder des autorisations en écriture sur les données ArcSDE 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.
• Les données versionnées et non versionnées sont prises en charge ; toutefois, le versionnement est requis si vous projetez d'effectuer des mises à jour de types non simples (par exemple, tronçons de réseau) avec le service.

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

• Annotations
• Dimensions
• MNT
• Jeux de données raster
• Couches et tables basées sur des vues SDE

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 rencontrera des erreurs.

Remarque :

Les services de carte prennent en charge les vues SDE. Si vous souhaitez effectuer des requêtes au niveau des entités avec des couches et des tables provenant de vues SDE, utilisez un service de carte.

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 des 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 doit toutes deux figurer dans le document ArcMap publié. Si la couche ou la table d'origine et/ou de destination n'est pas comprise dans le document ArcMap, la relation est ignorée par le service d'entités.

Si vous projetez d'utiliser le service d'entités pour la mise à jour, il est recommandé d'ajouter des données uniquement à la carte que vous souhaitez mettre à jour. Les données que vous ne souhaitez pas mettre à jour, telles que les couches de fond de carte, doivent être publiées 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 service ArcGIS Online qui peut être utilisé en tant que fond de carte. 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 et supprimer 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'effectuer des mises à jour à l'aide du service d'entités dans ArcMap (voir ci-dessous), veillez à inclure une seule couche par classe d'entités lors de la création du document ArcMap.

Remarque :

Les couches virtuelles, telles que les événements d'itinéraire, les événements x,y et les ateliers cadastraux, sont en lecture seule dans le service d'entités.

Configuration du document ArcMap

La prochaine étape après l'ajout des données dans le document ArcMap à publier consiste à définir des propriétés sur les couches et les tables. Ces propriétés définissent l'affichage des données et les opérations autorisées sur les données pour le client.

Définition de 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 par 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 prises en charge.

Remarque :

Les symboles proportionnels, ainsi que moteurs de rendu par valeurs uniques basés sur plusieurs champs ne sont pas pris en charge par les services d'entités.

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 est démarré, 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.

Remarque :

Il est recommandé d'utiliser des couleurs RVB dans les symboles ; sinon, des changements mineurs peuvent se produire lorsque les couleurs sont converties au format de couleur RVB.

Définition de sous-types et de domaines attributaires

Pour améliorer l'utilisation du service d'entités et empêcher les erreurs de saisie des données, configurez vos jeux de données pour qu'ils utilisent des sous-types et des domaines attributaires lorsque cela est approprié. Cela permet de classer les données et de s'assurer que les valeurs appropriées sont saisies au moment de la mise à jour des données. Les services d'entités peuvent détecter et utiliser les sous-types et les domaines. Par exemple, si vous avez un domaine qui limite la couleur d'une bouche d'incendie au rouge, au jaune ou au bleu, une liste déroulante apparaît dans l'application Web, laquelle vous permet de ne sélectionner qu'une de ces trois couleurs.

Définition des modèles d'entité

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.

Dans ArcMap, vous pouvez également créer des nouveaux modèles ou modifier des modèles existants afin de personnaliser la mise à jour par l'intermédiaire du service d'entités. Cela comprend la définition d'un outil de construction par défaut utilisé pour créer ce type d'entité. Si vous supprimez un modèle pour un type d'entité en particulier, un modèle par défaut est créé lorsque vous publiez le service.

Il existe différents types d'outils de construction disponibles selon le type d'entité créé par le modèle. Par exemple, si vous disposez d'un modèle de ligne, vous pouvez uniquement sélectionner des outils permettant de créer des entités linéaires. L'outil de construction enregistré avec les modèles est disponible par l'intermédiaire du service d'entités. La seule exception est l'outil Point appelé Point en fin de ligne qui n'est pas pris en charge par les services d'entités. Pour plus d'informations sur les modèles, reportez-vous à la rubrique Définition des propriétés de modèle d'entité.

Lors de l'enregistrement du document ArcMap, les modèles sont enregistrés avec les couches dans la carte. Lorsque le document ArcMap est publié, ces modèles sont disponibles pour les clients du service d'entités. Dès lors que les couches, types et modèles sont définis dans votre document ArcMap, vous êtes prêt à publier le service. La section Publication de services d'entités décrit la procédure de publication d'un service d'entités.

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'IdObjet, GlobalID, des champs de suivi de l'éditeur, 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.

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.

Pièces jointes

Les services d'entités vous permettent d'interroger et de mettre à jour des pièces jointes. Une pièce jointe est un fichier médiatique associé à une entité ou à un objet. Par exemple, avec les pièces jointes, les photographies et vidéos peuvent être ajoutées à une observation ornithologique et affichées lorsque le point d'observation est sélectionné. Pour utiliser cette fonctionnalité, les jeux de données d'une géodatabase doivent au préalable être configurés pour la prise en charge des pièces jointes. Lorsque ces jeux de données sont ajoutés à un document ArcMap et publiés, les clients peuvent interroger, insérer et supprimer les pièces jointes par l'intermédiaire du service d'entités.

La taille et les types de fichier que vous pouvez joindre à un service d'entités sont limités. Pour en savoir plus sur ces limites et sur la façon de modifier les paramètres de pièces jointes, reportez-vous à la rubrique Téléchargements de l'aide de l'API REST d'ArcGIS.

Pour plus d'informations sur la procédure de configuration d'un jeu de données pour la prise en charge de pièces jointes, reportez-vous à la rubrique Activation des pièces jointes pour une classe d'entités.

Fiches 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. Ils présentent un fonctionnement semblable à l'outil Identifier, mais l'affichage d'informations peut 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 allez travailler avec un service d'entités sur le Web et que vous souhaitez pouvoir utiliser des fenêtres contextuelles, 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 de temps 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.

Exemple de workflow : service d'entités d'observation ornithologique

La section suivante présente un exemple de procédure détaillant la configuration d'un document ArcMap, la définition des données et la définition de la symbologie qui seront proposés via un service d'entités d'observation ornithologique. Le service d'entités permet à la communauté des ornithologues de publier directement leurs observations ornithologiques sur la carte et de joindre des fichiers multimédia, tels que des photographies, des fichiers audio et des fichiers vidéo aux points d'observation spécifiques.

Définition des données

La première étape pour la 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, vous démarrez avec une classe d'entités appelée Bird_Sightings dans une géodatabase ArcSDE. Pour disposer de pièces jointes associées à cette classe d'entités, elles doivent être ajoutées dans ArcCatalog. Pour cela, connectez-vous à ArcSDE, cliquez avec le bouton droit de la souris sur la classe d'entités, puis sélectionnez Pièces jointes et 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és à 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.

Remarque :

Certains types de données nécessitent un versionnement pour pouvoir être modifiés dans une géodatabase. Cette condition s'applique également à la mise à jour de services d'entités. Pour plus d'informations, reportez-vous à la rubrique Présentation rapide du versionnement.

Définition de la symbologie

Avec les données définies dans une géodatabase ArcSDE, 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.

Résultats d'un type de rendu simple pour la couche Bird_Sightings

Trois types de résultats de rendu à valeur unique pour la couche Bird_Sightings

Maintenant que le moteur de rendu a été 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.

Utilisation de symboles ponctuels de type caractère pour symboliser les différents types d'observation ornithologique

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éfinition de 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és 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èles 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, vous pouvez les copier 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.

Propriétés de modèle pour les observations d'oiseaux menacés qui nécessitent un suivi et les observations d'oiseaux hors saison qui ne nécessitent aucun suivi

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'interrogation et la mise à jour.

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