Se connecter à une géodatabase d’entreprise
Dans ce premier module, vous allez vous connecter à une géodatabase d’entreprise. Le versionnement de branche n’est possible qu’avec une géodatabase d’entreprise. Ensuite, vous allez copier les données de Madrid d’une géodatabase fichier locale dans la géodatabase d’entreprise.
Créer une connexion à une base de données
Pour commencer, vous allez créer une nouvelle connexion de base de données à une géodatabase d’entreprise qui servira de stockage des données principal pour le projet solaire à Madrid. Vous allez créer la connexion en tant que propriétaire des données, c’est-à-dire en tant qu’utilisateur habilité à charger des données.
Remarque :
Ce didacticiel nécessite une géodatabase d’entreprise et un compte d’utilisateur de base de données avec un accès en lecture et en écriture (compte de propriétaire des données). Si vous ne disposez pas de ces éléments, suivez la procédure indiquée dans Déployer une géodatabase d’entreprise pour l’immobilier. Seules les quatre premières sections de ce didacticiel sont nécessaires pour réaliser celui-ci. Vous pouvez vous arrêter après l’exécution de l’outil Créer un utilisateur de base de données.
- Téléchargez le paquetage de projet MadridSolar.
Un fichier nommé MadridSolar.ppkx est téléchargé sur votre ordinateur.
Remarque :
Un fichier .ppkx est un paquetage de projet ArcGIS Pro qui peut contenir des cartes, des données et d’autres fichiers pouvant être ouverts dans ArcGIS Pro. Pour en savoir plus sur la gestion des fichiers .ppkx, consultez ce guide.
- Recherchez le fichier téléchargé sur votre ordinateur. Double-cliquez sur MadridSolar.ppkx pour l’ouvrir dans ArcGIS Pro.
Une carte apparaît, centrée sur Madrid. Hormis le fond de carte, aucune donnée n’est présente.
- Dans la fenêtre Catalog (Catalogue), sur l’onglet Project (Projet), cliquez avec le bouton droit sur le dossier Databases (Bases de données) et sélectionnez New Database Connection (Nouvelle connexion à une base de données).
La fenêtre Database Connexion (Connexion à une base de données) s’affiche. Vous allez remplir les paramètres de cette fenêtre pour créer une connexion à la géodatabase d’entreprise que vous prévoyez d’utiliser tout au long de cette série de didacticiels.
- Pour Database Platform (Plateforme de base de données), choisissez le système de gestion de base de données qui a servi pour créer votre géodatabase d’entreprise, par exemple, SQL Server.
Remarque :
Cette série de didacticiels montre comment activer un versionnement de branche sur une géodatabase d’entreprise en utilisant SQL Server en tant que système de gestion de base de données. Vous pouvez également suivre ce didacticiel si vous utilisez un autre SGBD pris en charge, tel que Oracle, IBM Db2, PostgreSQL et SAP HANA.
Si vous sélectionnez une valeur Database Platform (Plateforme de base de données) autre que SQL Server, les paramètres restants dans la fenêtre Database Connection (Connexion à une base de données) seront différents de ceux décrits ci-dessous.
- Pour Instance, saisissez le nom de l’instance qui a permis de créer votre géodatabase d’entreprise, par exemple, MadridSQL.
- Pour Authentication Type (Type d’authentification), choisissez Database authentication (Authentification de base de données).
Il s’agit du type d’authentification le plus largement utilisé.
- Pour User Name (Nom d’utilisateur), saisissez le nom d’utilisateur d’un compte d’utilisateur de base de données avec un accès en lecture et en écriture à la géodatabase d’entreprise.
Conseil :
Si vous avez créé votre géodatabase d’entreprise en suivant le didacticiel Déployer une géodatabase d’entreprise pour l’immobilier, saisissez SIG.
Cet utilisateur deviendra le propriétaire des données.
- Pour Password (Mot de passe), saisissez le mot de passe associé au compte d’utilisateur de base de données choisi.
- Vérifiez que la case Save User/Password (Enregistrer l’utilisateur/le mot de passe) est cochée.
- Pour Database (Base de données), choisissez la géodatabase d’entreprise, par exemple, MadridSolar.
- Pour Connection File Name (Nom du fichier de connexion), saisissez un nom en suivant le modèle nom de la base de données_utilisateur de la base de données, par exemple, MadridSolar_GIS.
Cette convention d’affectation de noms est recommandée pour les connexions aux bases de données.
Remarque :
Vos paramètres d’outil seront différents de ceux affichés dans l’image ci-dessus. Saisissez des propriétés de connexion propres à votre plateforme de base de données. Pour obtenir de l’aide, consultez la documentation Définir une connexion à la base de données.
- Cliquez sur OK.
Une nouvelle connexion à la base de données apparaît dans la fenêtre Catalog (Catalogue).
Charger des données dans la géodatabase d’entreprise
Le projet contient une géodatabase fichier, madrid_solar.gdb, avec deux classes d’entités. Vous allez déplacer ces données dans la géodatabase d’entreprise récemment connectée afin de l’utiliser pour le versionnement de branche.
- Dans la fenêtre Catalog (Catalogue), sur l’onglet Project (Projet), dans le dossier Databases (Bases de données), cliquez sur la flèche en regard de la géodatabase madrid_solar.gdb pour la développer.
La géodatabase fichier contient deux classes d’entités. Buildings (Bâtiments) représente le potentiel solaire des toits dans l’arrondissement d’Arganzuela de Madrid. Neighborhoods (Voisinages) représente les limites des sept voisinages d’Arganzuela. Le projet solaire à Madrid évaluera à terme tous les bâtiments de Madrid, mais pour l’instant, seul cet arrondissement a été évalué.
- Faites glisser la classe d’entités Buildings (Bâtiments) dans la connexion à la géodatabase d’entreprise (par exemple, MadridSolar_GIS.sde.)
La copie des données dans la géodatabase d’entreprise peut prendre quelques minutes.
- Faites également glisser la classe d’entités Neighborhoods (Voisinages) dans la connexion à la géodatabase d’entreprise.
- Développez la connexion à la géodatabase d’entreprise.
La connexion à la géodatabase d’entreprise contient désormais deux classes d’entités, copies des deux qui se trouvent dans la géodatabase fichier.
Le nom de chaque classe d’entités est ajouté devant le nom de l’utilisateur de base de données, par exemple, GIS.Buildings. Il s’agit du nom complet, modèle qui permet d’indiquer le propriétaire des données de chaque classe d’entités dans la base de données et d’éviter les doublons.
Conseil :
Si la géodatabase d’entreprise semble toujours vide, cliquez avec le bouton droit sur la connexion et sélectionnez Refresh (Actualiser).
- Dans la fenêtre Catalog (Catalogue), cliquez sur la flèche en regard de madrid_solar_project.gdb pour réduire la géodatabase fichier.
Vous n’utiliserez pas la géodatabase fichier dans le reste du didacticiel.
Dans ce module, vous avez créé une connexion à une géodatabase d’entreprise en tant que propriétaire des données et copié deux classes d’entités à l’intérieur.
Préparer les données pour le versionnement de branche
La mise à jour de toutes les données de ce projet nécessitera plusieurs personnes. Vous souhaitez qu’elles puissent effectuer leur travail simultanément et non à tour de rôle. Vous voulez qu’elles puissent annuler et rétablir leurs modifications et vous souhaitez détecter et résoudre les conflits éventuels, par exemple, si deux personnes saisissent des valeurs différentes pour la même entité. Tout cela est possible grâce au versionnement de branche.
Dans ce module, vous allez préparer les données pour le versionnement. Vous allez configurer la connexion à une base de données pour le versionnement de branche, puis vous allez inscrire les classes d’entités en tant que de branche versionnée.
Configurer la connexion à la base de données pour le versionnement de branche
Lorsque vous utilisez des données en branche versionnées, il est important, dans les processus de publication et d’administration, de définir le type de versionnement de la connexion à une base de données sur Branche.
- Dans la fenêtre Contents (Contenu), cliquez avec le bouton droit sur la connexion à une géodatabase d’entreprise (par exemple, MadridSolar_GIS.sde) et sélectionnez Geodatabase Connection Properties (Propriétés de connexion de géodatabase).
La fenêtre Database Connexion (Connexion à une base de données) s’affiche.
- Sur l’onglet Geodatabase Connection Properties (Propriétés de connexion de géodatabase), pour Versioning Type (Type de versionnement), choisissez Branch (Branche).
- Cliquez sur OK.
Inscrire des classes d’entités en tant que branche versionnée
Pour pouvoir mettre à jour un jeu de données dans une version, vous devez d’abord l’inscrire comme versionné.
- Dans la connexion à une géodatabase d’entreprise, cliquez avec le bouton droit sur la classe d’entités Buildings (Bâtiments) (par exemple, GIS.Buildings) et sélectionnez Manage (Gérer).
Remarque :
Si vous utilisez une version de ArcGIS Pro antérieure à 2.9, cliquez avec le bouton droit sur chaque classe d’entités dans la fenêtre Catalog (Catalogue), pointez sur Manage (Gérer), puis activez Add Global IDs (Ajouter les ID globaux), Enable Archiving (Activer l’archivage) et Enable Editor Tracking (Activer le suivi de l’éditeur). Cliquez de nouveau avec le bouton droit sur chaque classe d’entités, pointez sur Manage (Gérer) et cliquez sur Register As Versioned (Inscrire comme versionné). Passez au module suivant.
- Dans la fenêtre Feature Class Properties (Propriétés de la classe d’entités), sur l’onglet Manage (Gérer), cochez la case Versioning (Versionnement).
Davantage de paramètres apparaissent.
- Assurez-vous que l’option Branch (Branche) est sélectionnée. Cliquez sur OK.
Vous allez ensuite inscrire la classe d’entités Neighborhoods (Voisinages) de la même manière.
- Dans la fenêtre Catalog (Catalogue), dans la connexion à une géodatabase d’entreprise, cliquez avec le bouton droit sur la classe d’entités Neighborhoods (Voisinages), puis sélectionnez Manage (Gérer).
- Cochez la case Versioning (Versionnement) et assurez-vous que l’option Branch (Branche) est sélectionnée.
- Cliquez sur OK.
Les données sont maintenant inscrites en tant que de branche versionnée et la connexion à une base de données est configurée pour le versionnement de branche. Ces configurations étant terminées, vous êtes prêt à partager les données en tant que couche d’entités Web (service d’entités) afin que d’autres personnes puissent y accéder et les mettre à jour.
Publier les données en tant que couche d’entités Web
Le versionnement de branche utilise une architecture basée sur les services, ce qui signifie que vous devez publier les données en tant que services.
Dans le versionnement de branche, les données doivent être inscrites en tant que branche versionnée et publiées à partir d’une géodatabase d’entreprise. Vous avez déjà chargé les données dans une géodatabase d’entreprise et les avez inscrites en tant que branche versionnée. L’étape suivante consiste à publier les données sur votre portail ArcGIS Enterprise.
Ajouter des couches à la carte et définir une symbologie
Pour publier les données, vous devez commencer par ajouter les deux classes d’entités à une carte. Pour faciliter l’expérience de mise à jour, vous allez également modifier la symbologie des deux couches avant de les partager. Vous allez appliquer les propriétés de symbologie et d’étiquetage avec les fichiers de couche fournis.
- Dans la fenêtre Catalog (Catalogue), dans la connexion à une géodatabase d’entreprise (par exemple, MadridSolar_GIS.sde), faites glisser les classes d’entités Neighborhoods (Voisinages) et Buildings (Bâtiments) sur la carte.
Les données s’affichent sur la carte. Les couleurs sont attribuées de manière aléatoire. Vous allez les modifier pour rendre la carte plus lisible.
- Dans la fenêtre Contents (Contenu), cliquez sur la couche Buildings (Bâtiments) (par exemple, GIS.Buildings) pour la sélectionner.
Vous allez utiliser l’outil Import Symbology (Importer la symbologie) pour définir la symbologie de la couche avec les propriétés fournies dans le fichier de couche (.lyrx).
- Sur le ruban, cliquez sur l’onglet Feature Layer (Couche d’entités). Dans le groupe Drawing (Dessin), cliquez sur Import (Importer).
- Dans la fenêtre Import Symbology (Importer la symbologie), vérifiez que le paramètre Input Layer (Couche en entrée) est défini sur la couche Buildings (Bâtiments) (par exemple, GIS.Buildings).
- Dans Couche de symbologie, cliquez sur le bouton Parcourir.
- Dans la fenêtre Symbology Layer (Couche de symbologie), double-cliquez sur le dossier commondata.
Conseil :
Si le dossier commondata est introuvable, dans la fenêtre de navigation, développez Project (Projet), Folders (Dossiers), puis MadridSolar.
- Double-cliquez sur le dossier userdata et sélectionnez le fichier Buildings.lyrx.
- Cliquez sur OK.
Les paramètres restants sont renseignés dans la fenêtre Import Symbology (Importer la symbologie).
- Acceptez les paramètres par défaut et cliquez sur OK.
La symbologie de la couche Buildings s’actualise. Les toits dont le potentiel solaire est supérieur apparaissent en rouge foncé, tandis que les toits dont le potentiel solaire est plus faible s’affichent en orange et jaune. Tous les bâtiments du quartier Imperial sont en jaune car les valeurs du potentiel solaire n’ont pas encore été calculées pour cette zone.
Ensuite, vous allez modifier la symbologie de la couche Neighborhoods (Voisinages) de la même manière.
- Dans la fenêtre Contents (Contenu), cliquez sur la couche Neighborhoods (Voisinages) pour la sélectionner. Sur le ruban, cliquez sur Import (Importer).
- Dans la fenêtre Import Symbology (Importer la symbologie), pour Symbology Layer (Couche de symbologie), cliquez sur le bouton Browse (Parcourir). Choisissez le fichier Neighborhoods.lyrx et cliquez sur OK.
Les paramètres Symbology Fields (Champs de symbologie) sont vierges. Cela est normal puisque la symbologie que vous appliquez ne repose sur aucun champ.
- Cliquez sur OK.
La couche s’actualise en un symbole sans couleur de remplissage ni contours noirs.
Le fichier de couche a également modifié les propriétés d’étiquetage de la couche, de sorte que chaque voisinage est maintenant étiqueté avec son nom.
Partager les données sur votre portail en tant que couche d’entités Web
Maintenant que les données sont symbolisées correctement, vous êtes prêt à les partager sur votre portail. Vous allez utiliser la fenêtre Share As Web Layer (Partager en tant que couche Web) pour publier les classes d’entités de votre géodatabase d’entreprise en tant que couche d’entités Web. La mise à jour sera appliquée à cette couche d’entités Web.
Pour réaliser la publication, vous devez d’abord vous connecter à votre portail ArcGIS Enterprise avec un compte de portail doté des privilèges de publication.
- Au-dessus du ruban, cliquez sur Not signed in (Non connecté) et sur Sign in (Se connecter).
- Dans la fenêtre ArcGIS Sign In (Connexion à ArcGIS), saisissez le nom d’utilisateur et le mot de passe du compte de portail. Cliquez sur Connexion.
- Sur le ruban, cliquez sur l’onglet Share (Partager). Dans le groupe Share As (Partager en tant que), cliquez sur le bouton Web Layer (Couche web).
- Dans la fenêtre Share As Web Layer (Partager en tant que couche Web), définissez les propriétés suivantes :
- Pour Name (Nom), saisissez Madrid Solar Project.
- Pour Summary (Résumé), saisissez Solar potential of each building roof in Madrid.
- Pour Tags (Balise), saisissez CENER, solar potential, Madrid, branch versioning, Esri. Appuyez sur la touche Entrée.
Le processus de partage génère une couche d’entités Web contenant deux sous-couches : l’une pour les données des bâtiments et l’autre pour les voisinages.
Sous Data and Layer Tape (Type de données et de couche), vous pouvez choisir Reference registered data (Référencer les données enregistrées) ou Copy all data (Copier toutes les données). Le versionnement de branche fonctionne uniquement si la couche d’entités Web fait référence à des données inscrites. Lorsque vous choisissez de référencer des données inscrites, toutes les modifications que vous apportez à la couche d’entités Web (ajout, mise à jour ou suppression d’entités, par exemple) sont répercutées dans la géodatabase d’entreprise. Si vous choisissez à la place de copier les données, une couche d’entités Web contenant les données est publiée, mais elle n’a aucune connexion à la géodatabase d’entreprise et la gestion des versions n’est pas activée.
- Sous Reference registered data (Référencer les données inscrites), vérifiez que le paramètre Map Image (Image de carte) est sélectionné. Cochez la case Feature (Entité).
- Défilez l’affichage vers le bas. Pour Share with (Partager avec), cochez la case ArcGIS Enterprise.
Cette case à cocher permet de s’assurer que tous les membres de votre organisation auront accès à cette couche Web.
Vous allez ensuite activer la fonctionnalité Version Management (Gestion des versions). Cette fonctionnalité vous permettra de tirer pleinement parti du versionnement de branche, par exemple, pour créer, modifier et supprimer des versions et pour réconcilier et réinjecter les mises à jour des versions.
- En haut de la fenêtre, cliquez sur l'onglet Configuration. Sous Capabilities (Fonctionnalités), cochez la case Version Management (Gestion des versions).
- Cliquez sur le bouton Configure Pooling (Configurer le groupage). Comme valeur pour Instance Type (Type d’instance), choisissez Dedicated instance (Instance dédiée).
Il s’agit d’une condition requise pour publier des données en branche versionnées.
Remarque :
Pour en savoir plus sur les paramètres de partage, consultez la documentation Partager des données en branche versionnées.
Résoudre les erreurs de l’analyseur et publier
Avant de cliquer sur le bouton Publish (Publier), vous allez analyser la couche d’entités pour savoir si des corrections sont nécessaires à la réussite de la publication.
- Au bas de la fenêtre, cliquez sur Analyser.
La fenêtre affiche l’onglet Messages. Il indique un nombre d’avertissements de l’analyseur et deux erreurs de l’analyseur. Vous devez corriger les erreurs avant de procéder à la publication.
- Cliquez sur la flèche en regard de la première erreur pour la développer.
Cet avertissement indique que la source des deux couches n’est pas inscrite auprès du serveur. Vous allez résoudre ce problème en inscrivant votre géodatabase d’entreprise auprès de ArcGIS Server.
- Sous le premier message d’erreur, cliquez avec le bouton droit sur le premier sous-message et sélectionnez Register Data Source With Server (Inscrire la source de données auprès du serveur).
La fenêtre Add data store (Ajouter un data store) s’ouvre.
Souvenez-vous que, dans ce processus de partage, votre objectif est de créer une couche Web qui référence les données stockées dans votre géodatabase d’entreprise et non de créer une couche Web qui soit une copie de ces données. Pour ce faire, vous devez inscrire votre géodatabase d’entreprise en tant que data store auprès de votre site ArcGIS Server. Cela garantit que la couche d’entités Web publiée sur votre portail fait référence à la classe d’entités dans votre géodatabase d’entreprise. Vous pouvez considérer le data store comme la connexion entre votre site ArcGIS Server et la géodatabase d’entreprise.
- Pour Title (Titre), saisissez MadridDataStore.
- Pour Tags (Balise), saisissez CENER, solar potential, Madrid, branch versioning, Esri.
- Cliquez sur le bouton Validate (Valider) pour valider votre connexion au serveur.
- Pour Share with (Partager avec), cochez la case ArcGIS Enterprise.
- Cliquez sur Create (Créer).
Dans la fenêtre Share As Web Layer (Partager en tant que couche Web), une coche verte apparaît en regard du premier sous-message pour indiquer que la source de données de la couche est désormais inscrite auprès du serveur. Comme les deux couches Buildings (Bâtiments) et Neighborhoods (Voisinages) ont la même source de données, il n’est pas nécessaire de répéter ces étapes pour le second sous-message. La création d’un data store résout cette erreur pour les deux couches.
Vous allez ensuite traiter la seconde erreur.
- Cliquez avec le bouton droit sur 00374 Unique numeric IDs are not assigned (00374 : Les ID numériques uniques ne sont pas attribués) et sélectionnez Auto-Assign IDs Sequentially (Automatiquement attribuer les ID séquentiellement).
Il s’agit d’une condition requise lors du partage d’une couche Web. Cela permet de s’assurer que les ID de couche restent statiques lorsque la couche Web est remplacée.
Une coche verte apparaît en regard de l’erreur.
- Au bas de la fenêtre, cliquez sur Publish (Publier).
- Une fois la publication terminée, cliquez sur le lien Manage the web layer (Gérer la couche Web).
- À l’invite, connectez-vous avec le compte d’utilisateur de portail que vous avez utilisé pour vous connecter à ArcGIS Pro.
Votre portail apparaît, présentant la page des éléments de la couche d’images de carte Madrid Solar Project (Projet solaire à Madrid) que vous venez de créer.
- Sur le ruban, cliquez sur l’onglet Content (Contenu).
Votre portail comporte trois nouveaux éléments : une couche d’entités, une couche d’images de carte et un data store. Les trois éléments sont partagés avec votre organisation.
- Pour l’élément Madrid Solar Project (Projet solaire à Madrid), cliquez sur la flèche en regard de Feature layer (Couche d’entités).
La couche d’entités Web Madrid Solar Project (Projet solaire à Madrid) contient deux sous-couches : Buildings (Bâtiments) et Neighborhoods (Voisinages). Dans le didacticiel suivant, vous allez ajouter ces couches à une carte dans ArcGIS Pro et les mettre à jour.
- Fermez le navigateur Web et ArcGIS Pro. Il n’est pas nécessaire d’enregistrer le projet.
Dans ce module, vous avez ajouté deux classes d’entités à la carte et appliqué une symbologie pour mieux représenter le potentiel solaire de chaque bâtiment. Vous avez ensuite publié les données avec la fonctionnalité Version Management (Gestion des versions) et résolu deux erreurs de l’analyseur.
Dans ce didacticiel, vous avez créé une connexion de base de données à une géodatabase d’entreprise et chargé deux classes d’entités à l’intérieur. Vous avez préparé les données à publier en inscrivant les jeux de données en tant que branche versionnée. Enfin, vous vous êtes connecté au portail avec un compte doté des privilèges de publication et vous avez publié une nouvelle couche d’entités Web nommée Madrid Solar Project (Projet solaire à Madrid).
Vous allez utiliser cette couche d’entités Web pour calculer et signaler le potentiel solaire pour chaque bâtiment. Grâce au versionnement de branche, plusieurs membres de l’organisation CENER pourront mettre à jour ces données simultanément, ce qui permet d’accélérer la progression du projet.
Dans le didacticiel suivant, Créer des mises à jour dans une version de branche, vous apprendrez à utiliser la couche d’entités Web dans ArcGIS Pro, à créer des versions nommées, à vous connecter à une version nommée et à réaliser des mises à jour.