Générer un rapport de structure

La géodatabase vous permet de modéliser des entités réelles telles que des tables, des classes d’entités et des relations, puis d’ajouter un comportement via la logique de la géodatabase (domaines, valeurs conditionnelles, règles attributaires, etc.). La création de la structure fait partie de la définition d’une géodatabase. Dans les bases de données relationnelles, la structure inclut un ensemble de tables. Vous pouvez considérer la structure comme le plan de la base de données et, de même, de la géodatabase. Les jeux de données et leurs définitions, les règles ainsi que les relations d’une géodatabase définissent la structure de la géodatabase. Une manière de visualiser votre structure consiste à générer un rapport de structure.

Rapport de structure

L’outil de géotraitement Generate Schema Report (Générer le rapport de structure) génère un rapport lisible au format Excel, JSON, PDF, HTML ou HTML dynamique détaillant la définition de la structure de la géodatabase. Il permet de visualiser et d’explorer votre modèle de données, tel qu’un dictionnaire de données, ou peut être utilisé comme base pour générer un document plus détaillé.

Regardez cette courte vidéo pour obtenir une présentation générale sur l’utilisation du rapport de structure.

Cas d’utilisation

Il est important de comprendre comment votre rapport de structure s’intègre à votre processus. Voici quelques exemples :

  • Documentation
    • Grâce à la documentation de la structure, le personnel SIG et non-SIG peut comprendre les données et leur relation avec les autres données du modèle. Par exemple, dans le cadre du processus d’intégration, le rapport de structure peut être utilisé en tant que ressource pour montrer à un utilisateur non-SIG comment ses processus métier contribuent à la collecte de données à l’échelle de son département.
  • Collaboration et modélisation des données
    • La conception de la structure est l’une des premières étapes les plus importantes. Le rapport de structure de la géodatabase vous permet d’apporter des modifications à la géodatabase et d’exporter le rapport à des fins de collaboration. Par exemple, un nouveau service a été créé pour récupérer les données sur les eaux et les eaux usées, et deux groupes ont commencé à créer le modèle de données. Cependant, il existe des différences entre les deux modèles de données. Le rapport de structure peut constituer une méthode de collaboration pour aligner les différences.
  • Création de rapport et adoption par les parties prenantes
    • Le rapport de structure inclut deux types de sorties qui peuvent être envoyées aux parties prenantes. Par exemple, un cadre supérieur a demandé un rapport sur les modifications proposées pour le modèle de données et sur la manière dont elles permettent de résoudre les problèmes liés au changement climatique dans sa zone d’intérêt. Pour obtenir le soutien des parties prenantes, le rapport de structure peut être utilisé pour présenter l’organisation du modèle de données et la façon dont les modifications proposées peuvent générer des résultats tangibles.
  • Migration des données
    • Le rapport de structure peut être utilisé dans le cadre de la migration de données. En utilisant deux rapports de structure, vous pouvez comparer la structure après la migration des données vers leur destination, tout en vous assurant que les rapports source et cible correspondent. Par exemple, vous migrez une géodatabase d’entreprise d’un fournisseur SGBD à un autre. Grâce au rapport de structure issu de la géodatabase source, vous pouvez comparer le rapport de structure de destination au rapport de structure d’origine, afin de confirmer que les données ont bien été migrées.
  • Audit et conformité
    • Le rapport de structure peut servir de rapport de moment temporel pour la structure de géodatabase. Cela est utile à des fins d’audit et de conformité lorsque des exigences légales régissent la conservation des données. Par exemple, votre service doit conserver les enregistrements annuels pendant plusieurs années. Vous pouvez utiliser le rapport de structure de géodatabase pour vous aider à respecter les exigences de conservation des données. En capturant des instantanés, vous pouvez voir l’évolution de la géodatabase au fil du temps et le moment où des modifications importantes ont été apportées à la structure.

Format du rapport

L’outil de géotraitement Generate Schema Report (Générer le rapport de structure) vous permet de sélectionner un dossier de destination cible et de générer une représentation lisible de la structure de la géodatabase au format Excel XLSX, JSON, PDF, HTML ou HTML dynamique.

Excel

Voici un exemple de classeur Excel généré à partir des données d’adresse issues d’une géodatabase. L’onglet Table of contents (TOC) (Table des matières) donne un aperçu des informations incluses dans le rapport. Pour naviguer rapidement vers les autres sections du classeur, vous pouvez cliquer sur le texte du lien hypertexte ou utiliser les onglets au bas de la feuille de calcul.

Exemple de rapport Excel en sortie de l’outil de géotraitement Generate Schema Report (Générer le rapport de structure)

HTML dynamique

HTML dynamique est un autre format pris en charge et permet d’utiliser un navigateur. Vous pouvez afficher les informations de deux manières : la vue de liste et la vue tabulaire. La vue de liste permet de naviguer rapidement, la vue tabulaire permettant de voir l’ensemble des propriétés. Un exemple de HTML dynamique est présenté ci-dessous :

Rapport HTML dynamique en sortie de l’outil de géotraitement Generate Schema Report (Générer le rapport de structure)

Le tableau ci-après met en correspondance les numéros figurant dans l’image ci-dessus de la vue de liste d’une part et le numéro d’élément et la description correspondants d’autre part.

ElémentDescription

1

La barre de navigation affiche les objets de la géodatabase tels que les jeux de données, et les fonctionnalités de la géodatabase (les domaines, par exemple).

2

Le chemin de navigation indique la relation entre la hiérarchie du rapport de structure et les informations qui s’affichent dans la vue de contenu (vue de table ou de liste).

3

Les outils de tri, de recherche et de filtrage permettent de trouver des informations rapidement et de manière efficace.

4

La vue de liste affiche des informations dans la vue de contenu pour une analyse rapide.

5

La vue tabulaire affiche des informations dans la vue de contenu de manière à pouvoir voir toutes les propriétés communes.

6

Les paramètres contrôlent l’affichage des propriétés du système dans l’ensemble du rapport.

Éléments issus de la vue de liste du rapport de structure

Créer un rapport de structure

Pour générer un rapport de structure, procédez comme suit :

  1. Dans la fenêtre Catalog (Catalogue), cliquez avec le bouton droit de la souris sur la table, la classe d’entités, le jeu de classes d’entités ou la géodatabase que vous voulez utiliser comme entrée pour l’outil de géotraitement Générer le rapport de structure.
  2. Cliquez sur Exporter.
  3. Cliquez sur Generate Schema Report (Générer le rapport de structure).
  4. Dans l’outil de géotraitement Générer le rapport de structure, complétez les paramètres restants, sélectionnez les formats en sortie souhaités, puis cliquez sur Run (Exécuter).

    Les rapports sélectionnés sont générés à l’emplacement en sortie spécifié.

Lisez l’article de blog sur les rapports de structure des géodatabase pour obtenir plus de conseils et d’astuces sur l’utilisation du rapport de structure.

Comparer les structures

Une autre activité importante de la modélisation des données consiste à comparer des structures, comme dans les scénarios suivants.

Cas d’utilisation de comparaison de structures

Il est essentiel de bien comprendre dans quelle mesure la comparaison de vos structures s’intègre dans votre processus. Voici quelques exemples :

  • Migration des données

    • Lors de la migration des données de géodatabase d’entreprise d’un fournisseur à l’autre, vous pouvez comparer des structures pour vous assurer que toutes les classes d’entités et tables sont présentes dans les deux environnements, et que les conventions de dénomination et types de données correspondent. La comparaison de structures permet également de vérifier que les jeux de données ne sont pas perdus et que les problèmes de configuration sont bien identifiés lors de la migration.

  • Comparaison d’environnements

    • Les organisations peuvent disposer de plusieurs environnements représentant la production, les tests et le développement. Lorsque vous intégrez des modifications d’un environnement à un autre, la comparaison de structures permet de vérifier que les résultats prévus sont synchronisés entre les environnements.

  • Contrôle des versions

    • Le contrôle des versions permet d’assurer le suivi des modifications de structure au niveau d’instances particulières pour un état donné de votre structure. Les rapports de structure permettent de comparer une version de structure attendue entre différents environnements et les versions pour visualiser les modifications apportées ou requises.

  • Audit et conformité

    • Pour les secteurs d’activité régulés, le rapport de comparaison de structures peut être utilisé dans le cadre d’activités d’audit et pour prouver que la structure n’a fait l’objet d’aucune modification interdite.

  • Identification et résolution des problèmes

    • Parfois, les erreurs découlent de différences de structure (il peut s’agir de types de données qui ne correspondent pas, de numéros ou noms de jeu de données incorrects, de champs manquants, etc.). Le fait de générer une comparaison de structures peut permettre d’identifier rapidement dans quelle mesure les deux structures diffèrent.

Sortie de la comparaison de structures

Le rapport de comparaison de structures est créé avec l’outil de géotraitement Compare schemas (Comparer les structures) et ressemble à la sortie du rapport HTML dynamique, avec quelques différences notables. Show Differences Only (Afficher uniquement les différences) est activé par défaut. Un exemple de la vue de liste du rapport de comparaison de structures est donné ci-dessous :

Vue de liste de la sortie du rapport de comparaison de structures de l’outil de géotraitement Compare Schema (Comparer les structures)

Le tableau ci-après met en correspondance les numéros figurant dans l’image ci-dessus de la vue de liste d’une part et le numéro d’élément et la description correspondants d’autre part.

ElémentDescription

1

Les points bleus indiquent des différences dans le rapport.

2

Les icônes d’insertion, de mise à jour et de suppression indiquent le type de modification. Les mises à jour peuvent comporter une insertion, une mise à jour et une suppression en fonction du niveau hiérarchique dans la vue de contenu.

3

Les paramètres contrôlent l’affichage des propriétés du système et la visualisation des différences uniquement.

Éléments issus de la vue tabulaire du rapport de structure

Un exemple de vue tabulaire du rapport de comparaison de structures est présenté ci-dessous :

Vue tabulaire de la sortie du rapport de comparaison de structures issue de l’outil de géotraitement Compare Schema (Comparer les structures)

Créer un rapport de comparaison de structures

Pour générer un rapport de comparaison de structures, procédez comme suit :

  1. Ouvrez l’outil de géotraitement Compare schema (Comparer les structures) dans la boîte à outils Data Management (Gestion des données).
  2. Définissez les paramètres suivants :
    1. Définissez la source de base en tant que rapport de géodatabase ou de structure que vous allez utiliser comme point de départ de votre comparaison.
    2. Définissez la source d’essai en tant que rapport de géodatabase ou de structure que vous allez utiliser comme point d’arrivée de votre comparaison.
    3. Définissez l’emplacement de sortie, entrez le nom du fichier, puis vérifiez que le format HTML dynamique est sélectionné.
  3. Exécutez l’outil pour générer une sortie HTML dynamique.

Effectuer des modifications de structure dans le rapport de structure

Un processus courant consiste à exporter le rapport de structure dans un classeur Excel, puis à effectuer des modifications de structure dans Excel. Cette approche constitue une alternative à l’ouverture et à l’utilisation des vues de conception (Champs, Domaines, Sous-types, etc.) pour effectuer des modifications de structure et peut souvent se révéler plus rapide et plus productive lorsque des modifications de structure en masse sont nécessaires.

Le court document vidéo ci-dessous offre un aperçu rapide du processus.

La procédure suivante présente le processus et les outils de géotraitement utilisés pouvant être appliqués à n’importe quel nombre de tâches de modélisation de données.

  1. Générez un rapport de structure et exportez-le vers un fichier .xlsx ou .json.
  2. Ouvrez le classeur Excel ou le document JSON et effectuez des modifications de structure.
  3. Convertissez le rapport de structure à partir de son format initial en un fichier .xml.
  4. Créez une géodatabase à partir de la fenêtre Catalog (Catalogue), d’une vue du catalogue ou d’un outil de géotraitement.
  5. Importez le document d’espace de travail XML contenant les modifications de structure dans la nouvelle géodatabase.

Diagramme représentant la génération d’un rapport de structure, sa conversion au format XML et l’importation du document XML dans une nouvelle géodatabase

Pour plus d’informations sur la façon d’apporter des modifications au rapport de structure, lisez l’article de blog Mettre à jour les rapports de structure pour la conversion.

Conseils pour mettre à jour les rapports de structure

Gardez les points suivants à l’esprit lorsque vous mettez à jour des rapports de structure :

  • Il est important de bien comprendre votre structure avant de la modifier de cette manière. La logique de validation qui est associée à ce processus est très limitée et toute erreur due à une saisie utilisateur dans le fichier .xlsx peut endommager les éléments de structure lors de la création de la nouvelle géodatabase. Un rapport de structure n’est pas une géodatabase et ne peut pas confirmer la réussite des modifications que vous apporterez. Le rapport ne peut pas être validé par rapport à espace de travail de destination, ni identifier des dépendances ni vérifier des règles ou contraintes imposées par votre organisation. C’est pour ces raisons qu’il est important d’effectuer les mises à jour avec précaution, de connaître les limitations de votre espace de travail de destination et de toujours mettre à jour une copie de votre rapport de structure d’origine.

  • Seules les modifications de structure réalisées sur les feuilles individuelles d’un élément de structure donné seront converties de .xlsx en .xml au cours du processus. Par exemple, si vous voulez changer l’ordre des champs pour une classe d’entités ou actualiser sa référence spatiale, vous devez accéder à la feuille de calcul de la classe d’entités en question dans le classeur Microsoft Excel et y apporter les modifications. Effectuer cette mise à jour dans la feuille de calcul FeatureClass contenant toutes les classes d’entités du rapport de structure n’aura aucun effet.

  • Lorsque vous ajoutez de nouvelles lignes à des tables existantes du rapport, vérifiez que chaque cellule des lignes que vous ajoutez contient une valeur. En cas de doute, référez-vous à des tables similaires d’une autre feuille de travail pour vous servir d’exemple et garantir une information de structure suffisante.
  • Certaines mises à jour ne seront pas appliquées lors de la conversion d’un rapport de structure en géodatabase, comme les valeurs d’échelle ou de précision pour les champs lors de l’import dans une géodatabase fichier. Les champs gérés par le système (OBJECTID, par exemple) et certains champs requis par les jeux de données de contrôleur (les réseaux de distribution, par exemple) ne reflèteront pas les modifications effectuées dans le rapport de structure.