Création de services d'entités
Le processus de création implique la configuration d'un document ArcMap pour définir les données et la symbologie exposés par le service. Si vous projetez d'effectuer des mises à jour, 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 exposées par le service. Les éléments suivants décrivent les conditions requises pour les données du service 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.
- Les autorisations en écriture pour les données ArcSDE sont requises si vous projetez d'effectuer des mises à jour des données. Remarque : Si vous utilisez l'authentification du système d'exploitation, ces autorisations doivent être accordées à l'utilisateur ArcGISSOC.
- 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 couches qui font partie de types non simples, tels que les réseaux géométriques et les topologies, 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 couche topologique 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 fois la couche et/ou la table d'origine et de destination ne sont pas comprises dans le document ArcMap, la relation est ignorée par le service d'entité.
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 (couches opérationnelles). 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.
Il est important de noter également que la mise à jour est limitée pour certains types de couche dans les services d'entités. Par défaut, les entités dotées de valeurs z ne peuvent pas être mises à jour au moyen d'un service d'entités. Toutefois, ces entités peuvent être modifiées via un service d'entités, en activant cette fonctionnalité dans les propriétés du service d'entités, une fois le service créé. Pour plus d'informations sur la mise à jour des entités comportant des valeurs z, à l'aide d'un service d'entités, 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, mais la géométrie ne peut pas être modifiée. Les valeurs m de toutes les nouvelles entités sont définies sur NaN quand elles sont insérées au moyen des extrémités 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 ArcGIS Desktop (voir ci-dessous), assurez-vous d'inclure une seule couche par classe d'entités lors de la création du document ArcMap.
Configuration du document ArcMap
La prochaine étape après l'ajout des données à publier dans le document ArcMap 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 sont basés sur la symbologie des couches dans le document ArcMap (.mxd). Chaque symbole dans chaque couche est désigné en tant que type. Par exemple, une couche symbolisée avec une représentation simple (un symbole) a un type. Si une représentation par valeurs uniques est utilisée, un type est renvoyé pour chaque valeur unique dans la représentation.
Les services d'entités prennent en charge un sous-ensemble de représentations d'ArcMap. Si vous utilisez une représentation non prise en charge, le service échoue lors du démarrage. Le journal de serveur permet dans ce cas de déterminer les couches ayant des représentations non prises en charge.
Les types de rendu pris en charge sont les suivants :
- représentations simples,
- représentations par valeurs uniques,
- représentations par borne de classe.
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 rétrograde en symboles ligne simple. Par exemple, un symbole ligne cartographique dans le document ArcMap peut être dessiné en tant que trait plein simple dans un client du service d'entités. Par ailleurs, si un symbole ligne a plusieurs couches, le service d'entités prend en compte uniquement la couche supérieure.
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 la carte présente des couches symbolisées par des représentations cartographiques, ces symboles ne sont pas disponibles dans le service d'entités et des symboles par défaut sont alors affectés.
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 vous permet de numériser une nouvelle entité avec des attributs correctement définis par défaut. Si les modèles n'existent pas encore, un modèle par défaut est créé par type lorsque vous démarrez une session de mise à jour ou publiez le service. 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é. 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 ponctuel appelé "Point en fin de ligne", non pris en charge par les services d'entités. Pour plus d'informations sur les modèles, reportez-vous à la rubrique suivante : 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é. 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 exposées par l'intermédiaire du service d'entités ; elles comprennent les alias de champ, la visibilité de champ et la propriété de lecture seule d'un champ. Les champs en lecture seule comprennent les champs gérés par le système tels qu'ObjectId et GlobalID, ainsi que les champs configurés pour être 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 (remarque : si les 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 exposés pour chaque couche dans le service d'entités à titre de description de couche et d'informations de copyright.
Pièces jointes
Les services d'entités vous permettent également 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. Pour plus d'informations, reportez-vous à la rubrique Activation des pièces jointes pour une classe d'entités. 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.
Fiches HTML
Les services d'entités prennent également en charge la configuration de fiches HTML dans ArcMap. Les fiches HTML sont une méthode puissante et facile pour le partage d'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 concernant la procédure de configuration de fiches HTML dans ArcMap, reportez-vous à la rubrique suivante : Définition de propriétés de fiche HTML pour des couches d'entités
Prise en charge du temps
Les données temporelles sont prises en charge et peuvent être visualisées par l'intermédiaire des services d'entités. Les données temporelles sont des données qui représentent un état dans le temps. 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. Les données temporelles peuvent être exposées par l'intermédiaire du service d'entités en activant les propriétés de temps dans l'onglet Temps des propriétés de la couche. Pour plus d'informations sur la procédure d'activation des propriétés de temps pour un jeu de données, reportez-vous à la rubrique : Activation des propriétés de temps des 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é à l'aide d'un système de coordonnées différent du système de coordonnées de la couche, elle est convertie vers le 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 vous guide tout au long d'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 exposée par l'intermédiaire d'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 médiatiques tels que les photographies, les fichiers audio et les 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.
Dans ce cas, les données restent non versionnées car elles ne doivent pas nécessairement être versionnées pour ce workflow.
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 dans le document ArcMap (.mxd). Chaque symbole dans chaque couche est désigné en tant que type. Dans cet exemple, par défaut, la couche des observations ornithologiques est symbolisée avec une représentation simple (un symbole).
Toutefois, dans cette situation, vous souhaitez symboliser la couche d'observations ornithologiques selon le type d'observation. Pour cela, une représentation unique peut être utilisée. 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 la représentation a été sélectionnée, la prochaine étape consiste à sélectionner les symboles qui représentent chaque type d'observation. Dans ce cas, un symbole d'oiseau a été sélectionné à partir du sélecteur de symboles ESRI. Les couleurs d'arrière-plan et de premier plan ont été 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é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. Cette opération affiche l'assistant Modèles permettant de créer des modèles. Choisissez de créer des modèles pour tous les types différents d'observation ornithologique. Dès lors que les modèles ont été créés, vous pouvez copier des modè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 Copie. Dans ce cas, une copie du modèle d'observation d'oiseau rare a été créée afin de permettre leur personnalisation pour 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 des 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 de champ par défaut.
Le modèle pour les observations d'oiseaux rares menacés présente un type d'observation défini sur oiseaux rares et une description 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, donc l'attribut de suivi peut être défini sur Oui par défaut. Aucun suivi n'est nécessaire pour les observations d'oiseaux rares hors saison, donc l'attribut de suivi peut ê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 pour les utilisateurs finals car ils doivent simplement sélectionner le type d'entité et 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. Pour plus d'informations sur la publication d'un service d'entités, reportez-vous à la rubrique Publication de services d'entités. Après sa publication, les utilisateurs finals peuvent accéder au service par l'intermédiaire de clients Web ou d'ArcGIS Desktop pour l'interrogation et la mise à jour.