Lorsque vous créez une carte à publier en tant que service d’entités, vous devez considérer l’objectif de ce service d’entités et l’emplacement auquel ses données sont stockées, car ces aspects affectent la manière dont vous créez, gérez et utilisez le service d’entités.
Cette rubrique couvre la création d’un service d’entités à publier sur un site ArcGIS GIS Server autonome ou fédéré et le référencement par le service d’entités des données dans une géodatabase ou base de données que vous avez inscrite auprès du site GIS Server.
Avant de créer votre carte, préparez les données afin de répondre aux exigences du service d’entités et inscrivez vos répertoires de données auprès du site GIS Server. Une fois vos données prêtes, créez et configurez une carte qui contient les données à publier, définissez la symbologie et d’autres propriétés de données dans la carte et définissez un modèle d’entité pour l’environnement de modification (si vous souhaitez que le service d’entités soit modifiable).
Configurer une carte
Une fois les données préparées et inscrites, ajoutez-les à un document ArcMap et définissez 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.
Configurer un document dans ArcMap
Une fois les données définies, ajoutez-les à un document ArcMap que vous voulez publier, puis définissez 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.
La configuration du document ArcMap est identique pour les données de base de données et de géodatabase. Toutefois, si votre document ArcMap contient des données de géodatabase, vous pouvez configurer votre carte pour bénéficier des fonctionnalités supplémentaires disponibles uniquement dans les géodatabases avant de procéder à la publication.
Définir le nom des couches
Quand vous ajoutez une classe d’entités ou une table à une carte, le nom par défaut est le nom complet de la table au sein de la base de données. Au minimum, vous devez modifier le nom de la couche, de sorte qu’il ne contienne pas la base de données ni le nom d’utilisateur. Cliquez avec le bouton droit de la souris sur chaque couche de la table des matières, puis sélectionnez Properties (Propriétés). Sous l’onglet General (Général), saisissez un nom représentant le contenu de la couche, sans y inclure le nom de la base de données ni le nom d’utilisateur.
Par exemple, si vous ajoutez la classe d’entités Rivières à la carte à partir d’une géodatabase d’entreprise nommée mygdb, et que la classe d’entités est la propriété de l’utilisateur gdbdata, le nom de couche par défaut sur la carte est mygdb.gdbdata.rivers. Définissez le nom de la couche sur rivers.
Vous pouvez modifier le nom de la couche davantage encore si vous définissez un ensemble de définitions sur la couche qui modifie les entités affichées sur la carte. Ainsi, si vous définissez un ensemble de définitions de sorte que seules les rivières situées dans les 5 miles d’une mine s’affichent, vous pouvez modifier le nom de la couche en conséquence, en lui attribuant par exemple le nom rivers near mines. Si la classe d’entités participe à une classe de relations et que les données relatives sont incluses dans le service que vous publiez, vous pouvez modifier le nom de la couche en conséquence. Ainsi, si la classe d’entités Rivières participe à une classe de relations qui la joint à une table contenant des informations sur les bassins versants, vous pouvez définir le nom de la couche sur rivers and watersheds.
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 démarre pas. Utilisez le journal ArcGIS Server pour identifier 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. Définissez 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 Map Viewer. Sinon, les développeurs peuvent utiliser l'API client pour définir des styles de fenêtres contextuelles.
Prise en charge du temps
Les services d'entités prennent en charge les données temporelles, qui représentent un état dans le temps. Stockez les informations temporelles dans un ou plusieurs champs attributaires et utilisez ces informations pour visualiser des données à des moments particuliers ou par intervalles de temps. Pour afficher les données temporelles d'une couche via le service d'entités, activez 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 d'une couche, reportez-vous à la rubrique Activation des propriétés de temps sur vos données.
Systèmes de coordonnées
Le document ArcMap que vous publiez en tant que service d'entités peut contenir des couches dotées de systèmes de coordonnées différents. Lorsque les clients accèdent au service d'entités, celui-ci convertit le système de coordonnées si nécessaire. 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, le service d'entités convertit le système de coordonnées de l'entité pour qu'il corresponde à celui de la couche avant de stocker la nouvelle entité. 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.
Le service d'entités utilise par ailleurs des transformations géographiques (datum). 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.
Données jointes
Vous pouvez définir des jointures attributaires pour les couches ou tables du document ArcMap. Lorsque vous publiez un service de carte avec la fonction d'accès aux entités sur un site GIS Server, les colonnes jointes sont intégrées dans le service de carte, mais ne sont pas autorisées dans le service d'entités. Le service d'entités comprend uniquement les colonnes de la table de jointure (la table ou classe d'entités sur laquelle vous avez défini la jointure). Si la symbologie de la couche repose sur une colonne jointe, le service de carte comprend le moteur de rendu utilisé pour symboliser les entités, mais le service d'entités revient à un moteur de rendu simple. Si le moteur de rendu de la couche repose sur une colonne issue de la classe d’entités la plus à gauche dans la jointure, le serveur de carte et le serveur d’entités comprennent le moteur de rendu.
Vous ne pouvez pas publier de données jointes sur le portail ArcGIS Enterprise ou sur ArcGIS Online. Supprimez les jointures avant de publier un service d'entités (couche d'entités hébergée) sur l'une de ces applications.
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 des sous-types et des domaines attributaires
Si les données que vous publiez se trouvent dans une géodatabase, configurez vos jeux de données pour qu'ils utilisent des sous-types et des domaines attributaires lorsque cela est approprié, afin d'améliorer l'expérience utilisateur du service d'entités et d'empêcher les erreurs de saisie de données. 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.
Modèles d'entités personnalisés
Dans ArcMap, vous pouvez créer des 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 carte, vous êtes prêt à publier le service.
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 multimédia associé à une entité ou à un objet dans une géodatabase. 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 Chargements dans l’aide de ArcGIS REST API.
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.
Exemple de workflow ArcMap : 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 proposées via un service d'entités d'observation ornithologique. Le service d’entités permet aux membres de la communauté des ornithologues de publier directement leurs observations ornithologiques sur la carte et de joindre des fichiers multimédias, tels que des photographies, des fichiers audio et des fichiers vidéo, aux points d’observation spécifiques.
Définir les 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, 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.
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 reposent sur la symbologie des couches dans le 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 sur la couche et sélectionnez Properties (Propriétés). Dans la boîte de dialogue Layer Properties (Propriétés de la couche), cliquez sur l’onglet Symbology (Symbologie) et choisissez Unique values (Valeurs uniques) sous Categories (Catégories). 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 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è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 Desktop pour l'interroger et le mettre à jour.
Pour plus d’informations, reportez-vous à la rubrique Publication d’un service d’entités à partir de ArcMap.
Autres didacticiels d'exemple
Si vous avez besoin d'aide complémentaire sur la configuration et l'utilisation d'un service d'entités, les didacticiels suivants proposent des exemples détaillés portant sur la configuration d'un document ArcMap, la définition des données et la définition de la symbologie, via un service d'entités de mise à jour Web. Les didacticiels varient selon que vous avez stocké vos données dans une géodatabase d’entreprise ou dans une base de données.
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 : 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