Préparer des données pour publier un service d’entités

Les couches et tables ajoutées à une carte sont incluses dans le service d’entités au moment de la publication. Vous devez configurer les données pour qu’elles répondent aux exigences d’un service d’entités.

Que votre source de données soit une géodatabase ou une base de données, certaines exigences de la définition des données sont identiques. Les exigences identiques sont décrites dans la section suivante. Dans d’autres cas, la façon dont vous définissez les données varie selon qu’elles se trouvent dans une géodatabase ou dans une base de données. Les sections ci-dessous Exigences propres aux géodatabases d’entreprise ou de groupe de travail et Exigences propres aux bases de données expliquent ces différences.

Si vous prévoyez d’utiliser le service d’entités hors connexion, une préparation supplémentaire des données est requise. Reportez-vous à la rubrique Préparer des données en vue d’une utilisation dans des services d’entités hors connexion de l’aide ArcGIS Pro pour plus d’informations sur ces exigences.

Remarque :

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

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

Les exigences suivantes sont vraies, que vos données source soient stockées dans une base de données, une géodatabase de groupe de travail ou une géodatabase d’entreprise

• Les données que vous publiez dans le service d’entités doivent provenir d’une géodatabase ou base de données source unique. Vous ne pouvez pas publier de données provenant de plusieurs connexions aux bases de données dans une seule carte.
• 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 ArcGIS Pro avant d’effectuer la publication. Si aucune référence spatiale n’est définie, vous ne pouvez pas publier les données.
• Puisque les vues ne peuvent pas être modifiées à l’aide des clients ArcGIS, vous ne pouvez pas publier des services d’entités éditables contenant des couches basées sur des vues.
• Le compte de base de données que vous avez stocké avec le fichier de connexion de base de données que vous inscrivez auprès du site GIS Server doit disposer des privilèges nécessaires pour accéder aux données. Si le service d’entités doit rester en lecture seule, le compte ne nécessite qu’un accès de sélection sur les données. Si vous projetez d’utiliser le service d’entités pour la mise à jour, vous devez accorder des autorisations de mise à jour sur les données. Si la connexion à une base de données que vous inscrivez auprès du site utilise l’authentification du système d’exploitation, ces autorisations doivent être accordées au compteArcGIS Server.
• Esri recommande que la carte que vous publiez en tant que service d’entités modifiable ne contienne que les données que vous souhaitez modifier. Publiez les données que vous ne souhaitez pas mettre à jour, telles que les couches de fond de carte, dans un service distinct. 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 ou Bing Maps.
• Ne définissez pas plusieurs couches pour la même classe d’entités dans la carte que vous publiez en tant que service d’entités si des utilisateurs prévoient d’ajouter le service d’entités à ArcGIS Pro et de le mettre à jour. Par exemple, si vous souhaitez servir la même classe d’entités avec une symbologie différente ou des ensembles de définition différents appliqués, créez des services d’entités séparés ; n’incluez pas ces représentations de la même classe d’entités configurées différemment dans le même service d’entités.
• Si vos données contiennent des valeurs z et que les éditeurs doivent modifier le service d’entités dans des clients ne prenant pas en charge l’ajout de valeurs z lors de l’édition d’une géométrie d’entité (par exemple, Map Viewer dans les portails ArcGIS Online et ArcGIS Enterprise), configurez le service d’entités pour insérer des valeurs z par défaut.
• Si vos données contiennent des valeurs m et que les éditeurs doivent modifier le service d’entités dans des clients ne prenant pas en charge l’ajout de valeurs m lors de l’édition d’une géométrie d’entité (par exemple, Map Viewer dans les portails ArcGIS Online et ArcGIS Enterprise), configurez le service d’entités pour insérer NaNs pour les valeurs m.

  Conseil :

  ArcGIS Pro permet d’effectuer toutes les opérations de mise à jour (insertion, suppression et mise à jour, y compris les mises à jour de géométrie) sur les entités dotées de valeurs m et z. Il n’est pas nécessaire de configurer des valeurs z et m NaN par défaut si les éditeurs ne mettront à jour le service d’entités que dans ces clients.

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

Les exigences du service d’entités répertoriées ci-dessous sont propres aux données stockées dans une géodatabase d’entreprise ou de groupe de travail. Vos données doivent répondre aux exigences décrites dans la section précédente, ainsi qu’à celles décrites dans cette section.

• Vous pouvez publier des tables ou des classes d’entités qui ne sont pas inscrites auprès de la géodatabase.
• Les données de géodatabase versionnées (versionnement traditionnel et de branche) et non versionnées sont prises en charge dans les services d’entités.
• Pour modifier des données de branche versionnée, vous devez publier à partir d’ArcGIS Pro une couche d’entités qui référence vos données inscrites. Pour plus d’informations, reportez-vous à la rubrique Partager des données de branche versionnée de l’aide d’ArcGIS Pro.
• La publication d’une couche d’entités référençant des données inscrites à partir de ArcGIS Pro n’est pas prise en charge si l’une des couches suivantes est présente sur votre carte :
  • Dimensions qui n’ont pas été mises à jour
  • Groupes de couches
  • Couches de requête contenant des colonnes virtuelles, des clauses where ou des jointures
  • Rasters
  • MNT
• Vous pouvez inclure des couches d’annotations dans votre carte quand vous publiez une couche d’entités référençant des données inscrites à partir d’ArcGIS Pro.
• Les ateliers parcellaires créés dans ArcGIS Pro doivent être publiés en tant que service d’entités pour modification.
• Vous pouvez publier des couches qui font partie de types complexes, tels que les réseaux de distribution et le réseau de traces, mais les types eux-mêmes ne sont pas renvoyés par le service d’entités. Par exemple, vous pouvez interroger les couches faisant partie d’un réseau de traces, mais vous ne pouvez pas interroger le réseau-même.
• Vous pouvez inclure dans des services d’entités des topologies contenant des classes d’entités de branche versionnée. Étant donné que vous pouvez mettre à jour les données versionnées de branche uniquement via un service d’entités, le fait d’inclure la topologie dans le service d’entités vous permet de valider la topologie après la mise à jour et de corriger les erreurs éventuelles de topologie résultant de vos mises à jour. Pour plus d’informations, reportez-vous à la rubrique Partager une topologie de l’aide ArcGIS Pro.
• Les services d’entités permettent également d’effectuer des requêtes sur les données associées, mais uniquement si la relation est définie via une classe de relations de géodatabase. Si une carte publiée comporte une couche ou table associée via une classe de relations de géodatabase, le service d’entités autorise les requêtes sur la couche à renvoyer des objets depuis la table associée. Pour prendre en charge des requêtes qui renvoient des objets associés, vous devez inclure la table et la couche impliquées dans la classe de relations dans la carte publiée. Si la couche ou la table d’origine ou de destination n’est pas comprise dans la carte, le service d’entités ignore la relation.

  Remarque :

  Pour les classes de relations attribuées, incluez la table de classes de relations dans la carte.

• Pour entretenir un réseau de distribution, vous devez le publier comme couche d’entités à partir d’ArcGIS Pro. Pour plus d’informations, reportez-vous à la rubrique Publication et utilisation de services avec le réseau de distribution de l’aide d’ArcGIS Pro.

Pour utiliser ArcGIS Survey123 avec un service d’entités qui fait référence aux données d’une géodatabase d’entreprise inscrite, exécutez l’outil de géotraitement Mettre à niveau les pièces jointes dans ArcGIS Pro sur les données. La mise à niveau des pièces jointes permet à Survey123 d’associer les images soumises dans l’enquête avec des questions spécifiques posées dans l’enquête. Si vous ne mettez pas à niveau les pièces jointes existantes, les images sont toujours stockées avec l’enquête, mais elles ne sont pas associées à une question spécifique de l’enquête.

Attention :

Après avoir exécuté l’outil Mettre à niveau les pièces jointes, ArcGIS Desktop, ArcGIS Pro 2.6 et version antérieure, ainsi que ArcGIS Enterprise 10.8.1 et version antérieure ne peuvent plus accéder aux données de pièces jointes. Si vous pensez devoir supprimer les pièces jointes pour autoriser ces clients à accéder aux données, exécutez l’outil de géotraitement Rétrograder les pièces jointes.

Activer des fonctionnalités de géodatabase

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

Sous-types et 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.

Suivi de l’éditeur

Si vous activez la mise à jour sur le service d’entités et que vous le partagez avec d’autres personnes pour qu’elles puissent le mettre à jour, pensez à activer le suivi de l’éditeur sur les classes d’entités source pour enregistrer les noms des personnes qui créent et modifient les entités.

Pièces jointes

Une pièce jointe est un fichier multimédia associé à une entité ou à un objet dans une géodatabase. Par exemple, vous pouvez joindre des photographies et des vidéos à une couche d’observation ornithologique. Il suffit de cliquer sur une entité de la couche d’observation ornithologique pour voir la pièce jointe.

Les services d’entités permettent d’interroger et de mettre à jour les pièces jointes. Toutefois, pour utiliser cette entité, vous devez configurer les jeux de données de la géodatabase 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 manière de modifier les paramètres des pièces jointes, consultez la rubrique Téléchargements dans l’aide 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 Ajouter ou supprimer des fichiers joints.

Classes de relations

Pour inclure des données apparentées dans un service d’entités ou une couche d’entités hébergée, définissez une classe de relations entre la classe d’entités et la table ou classe d’entités associée. Les données apparentées accessibles par le biais d’une classe de relations seront incluses dans le service d’entités que vous publiez.

Données versionnées de branche

Si vous devez demander à d’autres personnes de modifier des données inscrites pour le versionnement de branche, vous devez publier un service d’entités pour lequel la gestion des versions est activée. Seul le propriétaire des données peut publier les données de branche versionnée. Pour plus d’informations, reportez-vous à la rubrique Partager des données de branche versionnée de l’aide de ArcGIS Pro.

Topologies

Les topologies vérifient et appliquent les règles spatiales pour vous aider à assurer l’intégrité des données géographiques. Si vos données sont inscrites pour le versionnement de branche, vous pouvez créer des topologies dans la géodatabase avant de les publier dans un service d’entités.

Préparer les données de géodatabase pour les utiliser en mode hors connexion

Pour utiliser des cartes lorsque vous êtes hors connexion (en d’autres termes, lorsque vous n’êtes pas connecté au réseau de votre organisation), activez la fonction de synchronisation dans les services d’entités que vous utilisez dans votre carte. Vous devez préparer les données avant de publier un service d’entités pour lequel la synchronisation est activée référençant les données dans une géodatabase. Pour plus d’informations, reportez-vous aux rubriques Préparer des données pour une utilisation dans des services d’entités hors connexion et Préparer des services d’entités pour une utilisation hors connexion.

Exigences propres aux bases de données

Vous trouverez ci-dessous les exigences propres aux données du service d’entités qui sont stockées dans une base de données : Vos données doivent répondre à ces critères, en plus des exigences communes aux géodatabases et bases de données.

• Lorsque vous ajoutez des données de base de données à une carte dans ArcGIS Pro, 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.
• La couche de requête définie pour la table détermine les données publiées. 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 lorsque vous ajoutez une table de base de données à la carte.
• 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, un ID d’objet d’entier unique géré par la base de données est ajouté automatiquement. Si vous créez des données en-dehors de ArcGIS, veillez à inclure dans la table une colonne d’entiers uniques de valeur non nulle qui est gérée 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 mentionnée dans la section d’utilisation de l’outil. Pour toutes les autres bases de données, utilisez les outils de système de gestion de base de données ou SQL pour créer la colonne ID.
• Les plateformes des bases de données à partir desquelles vous pouvez publier des services d’entités comprennent : Dameng, Db2 (sous Linux, UNIX, ou Windows), Oracle, PostgreSQL, SAP HANA, SQL Server, Teradata Vantage, les services de base de données cloud pris en charge et Google BigQuery (lecture seule).