Commencer des appariements de données simples
Pour commencer, vous allez télécharger un fichier .zip contenant tout ce dont vous aurez besoin pour ce didacticiel. Une fois que vous avez téléchargé les données, vous créerez et alimenterez un classeur d’appariement de données simple pour définir le mode de migration de vos données de la géodatabase source vers le modèle de réseau de distribution de votre choix.
Télécharger et exporter les données
Tout d’abord, vous allez télécharger les données de ce didacticiel.
- Téléchargez le fichier Water_Data_Loading.zip et extrayez-le dans un emplacement de votre ordinateur (par exemple, dans le dossier Documents).
- Accédez à l’emplacement dans lequel vous avez extrait le fichier .zip et ouvrez le dossier Water_Data_Loading. Ouvrez le paquetage de projet ArcGIS Pro Water Data Loading (Chargement des données hydrauliques).
ArcGIS Pro s’ouvre et une carte des données d’exemple de réseau de distribution d’eau apparaît.
Cette carte représente les données de votre réseau. Elle utilise actuellement la structure LGIM (Modèle d’informations des collectivités locales). Cela signifie que vos données sont enregistrées à l’aide d’un ensemble de classes d’entités et d’attributs particulier.
- Faites défiler la fenêtre Contents (Contenu) pour rechercher les couches Fitting (Raccord), Station et Service.
Chaque couche est symbolisée à l’aide d’un attribut présent dans la table attributaire correspondante : Fitting Type (Type de raccord), Structure Type (Type de structure) ou Line Type (Type de ligne). Ces attributs permettent par la suite d’apparier votre structure de données existante à la structure du réseau de distribution.
Créer des appariements simples
Dans cette section, vous allez créer un classeur d’appariement de données simple qui permettra de capturer des appariements de données généraux. Ces appariements de données permettent de définir le mode de migration de vos entités dans le réseau de distribution. Plus loin dans cette procédure, un outil lira ces appariements et les utilisera pour personnaliser le modèle de données et générer une migration des données spécifique de vos données.
- Dans la fenêtre Catalog (Catalogue), développez Toolboxes (Boîtes à outils). Développez la boîte à outils UtilityDataManagementSupport. Développez le jeu d’outils Data Migration (Migration des données).
Remarque :
Vous pouvez ouvrir la fenêtre Catalog (Catalogue) en cliquant sur l’onglet View (Vue) sur le ruban. Dans le groupe Windows (Fenêtres), cliquez sur Catalog Pane (Fenêtre Catalogue).
- Ouvrez l’outil Create Simple Data Mapping (Créer un appariement de données simple).
La fenêtre Geoprocessing (Géotraitement) apparaît et l’outil Create Simple Data Mapping (Créer un appariement de données simple) s’ouvre. Cet outil crée un classeur Microsoft Excel qui apparie la structure de votre géodatabase source à la structure de réseau de distribution, appelée paquetage de ressources. Pour ce didacticiel, vous allez apparier la géodatabase water_source.gdb du projet ArcGIS Pro à la géodatabase WaterEssentials_AssetPackage.gdb.
- Définissez les paramètres suivants :
- Pour Source Dataset (Jeu de données source), accédez au dossier de projet et sélectionnez water_source.gdb.
- Pour Asset Package (Paquetage de ressources), accédez au dossier de projet et sélectionnez WaterEssentials_AssetPackage.gdb.
- Pour Output Folder (Dossier en sortie), accédez au dossier de projet. Cliquez dessus avec le bouton droit Folder (Dossier) pour créer un dossier. Nommez-le Migration Workspace (Espace de travail des migrations). Sélectionnez-le et cliquez sur OK.
- Pour Output Name (Nom en sortie), saisissez Appariements initiaux.
L’outil Create Simple Data Mappings (Créer un appariement de données simple) utilise des sous-types pour différencier les types d’équipements stockés dans chaque couche de votre base de données source. Si vos données ne contiennent pas de sous-type, vous pouvez utiliser le paramètre Source Types (Types sources) pour spécifier manuellement un ensemble de champs à utiliser par l’outil pour classer les entités dans chaque couche.
Les données source ne contenant pas de sous-type, vous allez créer une table et la mettre à jour pour qu’elle contienne trois types sources. Les types sources sont importants pour identifier les divers types d’équipements que vous avez enregistrés dans votre modèle (par exemple, les raccords, les structures de station et les lignes de service).
- Pour Source Types (Types sources), cliquez sur Create table (Créer une table).
La table Create_Simple_Data_Mapping_Source_Types est créée et ajoutée à la fenêtre Contents (Contenu). Vous allez alimenter cette table avec les champs attributaires utilisés pour symboliser les couches Fitting (Raccord), Station et Service. Lorsque vous saisissez ces attributs dans la table, utilisez leur nom de champ au lieu de leur alias de champ.
- Dans la fenêtre Contents (Contenu), cliquez avec le bouton droit sur Create_Simple_Data_Mapping_Source_Types et sélectionnez Open (Ouvrir).
La table Create_Simple_Data_Mapping_Source_Types s’ouvre. Elle est vide. Vous allez ajouter trois lignes ; une par attribut d’intérêt.
- Dans la table Create_Simple_Data_Mapping_Source_Types, cliquez sur Click to add a new row (Cliquez pour ajouter une nouvelle ligne).
- Dans la première ligne qui apparaît, pour Source Type (Type de source), saisissez fittingtype, puis appuyez sur Entrée.
- Ajoutez une deuxième ligne, puis, pour Source Type (Type de source), saisissez linetype et appuyez sur Entrée.
- Ajoutez une troisième ligne, puis, pour Source Type (Type de source), saisissez structtype et appuyez sur Entrée.
Remarque :
Les valeurs que vous avez saisies fonctionnent pour ce didacticiel. Toutefois, vous allez devoir rechercher des champs similaires qui différencient les diverses ressources pour les données de votre réseau de distribution spécifique.
Une fois que vous avez enregistré les mises à jour de la table, exécutez l’outil Create Simple Data Mapping (Créer un appariement de données simple).
- Dans la fenêtre Geoprocessing (Géotraitement), sous Pending edits (Mises à jour en attente), cliquez sur Save Edits (Enregistrer les mises à jour).
- Cliquez sur Run (Exécuter).
L’outil crée un classeur Excel d’appariement de données simple, appelé DataMapping, que vous allez utiliser pour apparier toutes les couches réseau de vos données source aux entités correspondantes du réseau de distribution. Cette table est générée de manière dynamique à l’aide des couches et sous-types présents dans vos données.
- Fermez la table Create_Simple_Data_Mapping_Source_Types.
Alimenter des appariements de données simples
Maintenant que vous avez créé un classeur DataMapping, vous allez identifier le mode de conversion de vos données source dans les classes d’entités du réseau de distribution.
En premier lieu, vous allez ouvrir le classeur.
- Dans la fenêtre Catalog (Catalogue), développez Folders (Dossiers). Développez les dossiers Water_Data_Loading et Migration Workspace (Espace de travail des migrations).
- Cliquez avec le bouton droit sur le dossier Initial Mappings (Appariements initiaux) et sélectionnez Show In File Explorer (Afficher dans l’explorateur de fichiers).
Une fenêtre de l’explorateur de fichiers apparaît. Elle est ouverte sur le dossier Initial Mappings (Appariements initiaux). Le classeur Excel DataMapping est visible.
- Ouvrez le classeur Excel DataMapping.
Cette feuille de calcul contient des informations sur votre base de données source (par exemple, le jeu de classes d’entités, le type de source et la classe source de chaque classe d’entités). Vous allez utiliser cette table pour spécifier les entités à migrer vers le réseau de distribution. Les couches de votre base de données source n’ont pas toutes d’entités correspondantes dans le réseau de distribution ; si ce cas se présente, ignorez ces lignes dans la feuille de calcul.
À présent, vous allez apparier les classes d’entités de vos données source répertoriées dans la colonne Source Class (Classe source) à la classe d’entités appropriée du réseau de distribution, à l’aide de la colonne Target Utility Network Layer (Couche de réseau de distribution cible). Vous allez commencer par la classe d’entités wCasing sur la deuxième ligne de la table. La couche wCasing est une couche linéaire qui représente le renforcement structurel de vos conduites d’eau ; elle appartient à la classe d’entités StructureLine du réseau de distribution.
- Pour la ligne 2, dans la colonne Target Utility Network Layer (Couche de réseau de distribution cible), sélectionnez StructureLine.
À présent, vous allez choisir un groupe de ressources pour la couche wCasing.
- Pour la ligne 2, dans la colonne Target Asset Group (Groupe de ressources cible), sélectionnez Pipe Casing (Gaine de conduite).
Enfin, vous allez choisir un type de ressource pour la couche wCasing.
- Pour la ligne 2, dans la colonne Target Asset Type (Type de ressource cible), sélectionnez Casing (Gaine).
Par la suite, au cours du chargement des données, la classe d’entités wCasing sera chargée dans Target Utility Network Layer (Couche de réseau de distribution cible), Target Asset Group (Groupe de ressources cible) et Target Asset Type (Type de ressource cible) en fonction de votre sélection.
Vous allez à présent suivre la même procédure pour la couche wControlValve. Les vannes de contrôle sont des équipements hydrauliques car elles affectent la circulation de l’eau dans le réseau. Elles appartiennent également au groupe de ressources PressureValve car elles affectent la pression d’eau.
- Pour la ligne 3, définissez ce qui suit :
- Définissez Target Utility Network Layer (Couche de réseau de distribution cible) sur WaterDevice.
- Définissez Target Asset Group (Groupe de ressources cible) sur Pressure Valve (Vanne de pression).
- Définissez Target Asset Type (Type de ressource cible) sur Pressure Reducing (Réducteur de pression).
La classe d’entités wControlValve a été appariée. Vous allez apparier une classe d’entités de plus : wFitting. Dans la table DataMapping, plusieurs lignes représentent des raccords, mais la ligne 8 contient des valeurs fittingtype considérées comme de type Other (Autre), comme indiqué dans la colonne Source Definition Query (Ensemble de définition source).
Ce modèle cible ne contient pas d’appariement exact pour ce type d’équipement Other (Autre), mais en sélectionnant le type de ressource Tee (Té), vous choisissez de le placer dans un emplacement du modèle où il servira de raccord en té.
- Pour la ligne 8, définissez ce qui suit :
- Définissez Target Utility Network Layer (Couche de réseau de distribution cible) sur WaterJunction.
- Définissez Target Asset Group (Groupe de ressources cible) sur Fitting (Raccord).
- Définissez Target Asset Type (Type de ressource cible) sur Tee (Té).
Vous allez maintenant lui fournir un nouveau type de ressource pour garder une trace de ces raccords pendant et après le chargement des données. En outre, lorsqu’un nouveau type de ressource est spécifié à l’aide de cette feuille de calcul, l’outil Create Migration (Créer une migration) l’ajoute et le configure automatiquement de sorte qu’il possède la même configuration que le type de ressource Tee (Té) et qu’il se comporte de la même manière.
- Pour la ligne 8, dans la colonne New Asset Type (Nouveau type de ressource), saisissez Autre.
À ce stade, vous poursuivez ce traitement et suivez ces étapes pour les autres classes d’entités répertoriées dans la colonne Source Class (Classe source). Toutefois, une table déjà remplie vous est fournie dans le paquetage de projet que vous avez téléchargé précédemment.
- Enregistrez la table DataMapping et fermez Excel.
- Dans File Explorer, accédez au dossier Water_Data_Loading. Ouvrez le fichier Excel CompleteMapping.
Cette table est utilisée pour apparier vos données source au réseau de distribution. Notez que les couches de votre géodatabase source ne deviennent pas toutes des entités dans le modèle de réseau de distribution. Dans cet exemple, les entités de limite surfaciques, wOperationalArea et wPressureZone, dans la géodatabase source n’ont pas reçu de valeur Target Utility Network Layer (Couche de réseau de distribution cible).
- Fermez Excel.
Si vous souhaitiez migrer ces couches dans le réseau de distribution, vous devriez copier et coller ces couches source manuellement lors de la migration des données de la géodatabase source dans la géodatabase cible.
Créer un espace de travail des migrations
Dans cette section, vous allez utiliser les appariements de données simples que vous avez alimentés dans Excel pour créer un modèle de données et un espace de travail de chargement des données qui convertira vos données source en entités correspondantes dans le réseau de distribution.
Vous allez ensuite ajuster l’espace de travail de chargement des données pour renseigner certains des champs requis sur la couche System valve (Vanne système) afin qu’ils puissent être utilisés dans le réseau de distribution.
- Dans ArcGIS Pro, accédez à la fenêtre Catalog (Catalogue). Si nécessaire, développez Toolboxes (Boîtes à outils), UtilityDataManagementSupport et Data Migration (Migration des données).
- Double-cliquez sur l’outil Create Migration Workspace (Créer un espace de travail des migrations).
L’outil Create Migration Workspace (Créer un espace de travail des migrations) requiert votre géodatabase source, le paquetage de ressources dans lequel vous souhaitez migrer vos données, la table d’appariement de données que vous avez remplie et une classe d’entités représentant votre zone de service. Vous allez également spécifier un emplacement pour stocker cet espace de travail et lui donner un nom.
- Dans la fenêtre Geoprocessing (Géotraitement), définissez ce qui suit :
- Pour Source Database (Base de données source), accédez au dossier de projet et sélectionnez water_source.gdb.
- Pour Asset Package (Paquetage de ressources), accédez au dossier de projet et sélectionnez WaterEssentials_AssetPackage.gdb.
- Pour Data Mapping Spreadsheet (Feuille de calcul d’appariement de données), accédez au dossier de projet et sélectionnez CompleteMapping.
- Pour Service Territory Polygon (Polygone de zone de service), accédez au fichier water_source.gdb. Ouvrez le jeu de classes d’entités WaterDistribution et sélectionnez la classe d’entités wOperationalArea.
- Pour Output Folder (Dossier en sortie), accédez au dossier de projet. Ouvrez Migration Workspace (Espace de travail des migrations) et sélectionnez Initial Mappings (Appariements initiaux).
- Pour Output Name (Nom en sortie), saisissez Espace de travail initial.
Si vous créez votre premier pilote du réseau de distribution, vous devez également vérifier que tous les champs et domaines de vos classes d’entités source sont copiés dans les couches correspondantes du réseau de distribution. Vous allez donc utiliser l’option Copy Fields (Copier les champs).
La copie de tous vos champs facilite la comparaison de vos modèles source et cible dans la base de données migrée lors de la création du pilote. Une fois que le pilote a été créé, examinez tous les champs et déterminez ceux à conserver et ceux à supprimer.
- Cochez la case en regard de Copy Fields (Copier les champs).
- Cliquez sur Run (Exécuter).
- Dans la fenêtre Catalog (Catalogue), développez Folders (Dossiers), Water_Data_Loading, Migration Workspace (Espace de travail des migrations), Initial Mappings (Appariements initiaux), Initial Workspace (Espace de travail initial) et DataLoadingWorkspace.
Remarque :
Si l’un de ces dossiers n’est pas visible, cliquez avec le bouton droit sur le dossier Water_Data_Loading et sélectionnez Refresh (Actualiser).
Le dossier Initial Workspace (Espace de travail initial) contient votre modèle de données cible intitulé Initial Workspace.gdb avec un dossier DataLoadingWorkspace contenant tous les fichiers requis pour migrer vos données à l’aide des outils de chargement des données Esri.
Le modèle de données cible contient tous les types de ressources que vous avez spécifiés dans votre classeur d’appariement de données simple, ainsi que les champs migrés à l’aide de l’option Copy fields (Copier les champs).
Vous pouvez migrer vos données à l’aide de l’espace de travail, tel qu’il a été créé, mais vous devez y effectuer quelques ajustements pour renseigner plusieurs champs requis dans le réseau de distribution.
Préparer le classeur des vannes système
L’outil Create Migration Workspace (Créer un espace de travail des migrations) a créé un espace de travail utilisé par les outils de chargement des données pour migrer vos données vers le réseau de distribution. Ces outils de chargement de données étant génériques, ils n’incluent pas de logique spéciale pour remplir les champs spéciaux requis par les modèles de réseau de distribution.
Dans ce module, vous allez modifier l’espace de travail de chargement des données pour renseigner plusieurs champs obligatoires sur les vannes système afin de garantir que le réseau puisse les tracer correctement.
Ouvrir le dictionnaire de données
Avant de commencer à apparier les données, vous allez explorer le modèle de données à l’aide du dictionnaire de données inclus dans le projet.
Remarque :
Si vous avez apporté des modifications à la structure, vous devez utiliser l’outil Generate Schema Report (Générer le rapport de structure) pour générer un nouveau dictionnaire de données.
- Dans File Explorer, accédez au dossier Water_Data_Loading. Double-cliquez sur le fichier Excel WaterEssentials_DataDictionary.
Excel s’ouvre et le dictionnaire de données de la géodatabase WaterEssentials_UtilityNetwork s’affiche.
- Sous Datasets (Jeux de données), cliquez sur main.Network.
- Cliquez sur NetworkAttributeAssignment.
Cette liste affiche tous les champs requis par le modèle de données de ce réseau de distribution.
Ces champs sont renseignés par des valeurs par défaut lors du chargement des données. Toutefois, si les données sources contiennent déjà des champs supplémentaires servant des objectifs similaires, vous devez apparier les valeurs des champs sources afin de renseigner ces nouveaux champs lors de la migration.
- Sous NetworkAttributeAssignment, appliquez un filtre sur le champ Source Name (Nom de la source) pour qu’il n’affiche que main.WaterDevice.
Remarque :
Si vous ne pouvez pas faire de filtre sur la colonne Source Name (Nom de la source), essayez de cliquer sur le bouton Enable Editing (Activer la mise à jour) en haut de l’écran Excel.
Les valeurs suivantes, affichées sous Field Name (Nom de champ) sont essentielles au bon fonctionnement du réseau de distribution :
- Asset Group (Groupe de ressources) : ce champ est apparié à l’aide de l’outil Appariement de données simples. L’attribut des groupes de ressources représente la classification principale des classes de réseaux techniques.
- Asset Type (Type de ressource) : ce champ est apparié à l’aide de l’outil Appariement de données simples. L’attribut des types de ressources représente la classification mineure des classes de réseaux techniques. Cela permet de classer davantage chaque groupe d’actifs.
- Is Subnetwork Controller (Est un contrôleur de sous-réseau) : il s’agit d’un champ géré par le réseau de distribution. Il indique si une entité participe au réseau en tant que contrôleur de sous-réseau qui définit l’origine d’un sous-réseau.
- Tier Name (Nom du niveau) : il s’agit d’un champ géré par le réseau de distribution. Il s’agit du nom du niveau auquel le sous-réseau appartient.
- Construction Status (Statut de construction) : ce champ identifie le statut de construction d’une entité à partir d’un système de gestion des travaux.
- Lifecycle Status (Statut du cycle de vie) : ce champ sert à déterminer si une entité est en service ou non lors du traçage.
- Operable (Utilisable) : ce champ sert à identifier l’équipement utilisable lors du traçage.
- Normal Status (Statut normal) : ce champ sert à déterminer si une vanne est ouverte ou fermée lors du traçage.
Vous allez explorer ces champs plus avant dans la section suivante en utilisant les classeurs Excel créés par l’outil Create Migration Workspace (Créer un espace de travail de migration).
Apparier les champs
Vous allez commencer par indiquer les appariements de champs sur la première feuille du classeur des vannes système. L’objectif est de renseigner autant de champs que possible dans le modèle de données cible à l’aide des données disponibles. Les champs de la classe d’entités n’étant pas tous nécessaires, si aucune valeur n’est disponible pour un champ ou si vous ne savez pas comment le renseigner, vous pouvez l’ignorer et y revenir par la suite.
- Dans ArcGIS Pro, dans la fenêtre Catalog (Catalogue), cliquez avec le bouton droit sur DataReference et sélectionnez Show In File Explorer (Afficher dans l’explorateur de fichiers).
- Dans File Explorer, ouvrez le classeur DataReference.
Ce classeur donne une vue d’ensemble des différents jeux de données disponibles dans les données sources et indique le jeu de données auquel ils seront appariés dans le réseau de distribution. Pour comprendre la façon dont les attributs sont appariés entre les jeux de données sources et cibles, vous allez explorer une des tables de la colonne MappingWorkbook. Vous allez apparier les attributs des vannes système du réseau.
- Dans la colonne MappingWorkbook, cliquez sur DataMapping/Points/wSystemValve-WaterDevice.xlsx.
Le classeur wSystemValve-WaterDevice s’ouvre. La colonne TargetField répertorie les champs attributaires pour le type de ressource indiqué dans le réseau de distribution. Les champs ou les valeurs appariées qui vont être renseignés dans ces attributs du réseau de distribution à partir des données sources se trouvent dans la colonne Expression.
Comme vous pouvez le voir, certaines valeurs de la colonne Expression ont été appariées automatiquement. L’outil Create Migration Workspace (Créer un espace de travail des migrations) créé automatiquement des appariements de données pour tous les champs portant le même nom dans les jeux de données sources et cibles. Il calcule en outre le groupe de ressources et le type de ressource de l’entité, car ces derniers ont été indiqués dans le classeur Appariement de données simples. Vous devez cependant créer des appariements pour d’autres champs requis par le réseau de distribution.
Plusieurs champs requis pour le type de ressource de vanne système sont répertoriés à la fin de la section précédente. Dans la colonne Expression, vous allez voir que les champs Asset Group (Groupe de ressources), Asset Type (Type de ressource) et Operable (Utilisable) sont renseignés. Les attributs Is Subnetwork Controller (Est un contrôleur de sous-réseau) et Tier Name (Nom du niveau) sont des champs système gérés par le réseau de distribution. Cependant, les champs Construction Status (Statut de construction), Lifecycle Status (Statut du cycle de vie) et Normal Status (Statut normal) ne sont pas renseignés.
Vous devez déterminer les attributs de la classe d’entités wSystemValve source qui peuvent être utilisés pour ces trois champs requis. La liste complète des champs sources est disponible dans la feuille de calcul SourceSchema.
- Cliquez sur l’onglet SourceSchema.
La structure de la classe d’entités wSystemValve est visible. Vous allez examiner la liste des champs pour déterminer si un ou plusieurs d’entre eux peuvent servir à renseigner les champs requis. Si votre organisation conserve une référence de structure ou un dictionnaire de données interne, vous pouvez également vous référer à ces informations.
Le champ NORMALLYOPEN enregistre le statut normal d’une vanne, tandis que le champ ACTIVEFLAG enregistre les informations relatives au statut du cycle de vie. Vous avez également remarqué que le réseau de distribution utilise un champ différent pour enregistrer la rotation des entités. Votre attribut se nomme ROTATION, mais le réseau de distribution l’appelle symbolrotation.
Vous n’avez pas trouvé de champ pour constructionstatus dans les données sources. Ce n’est pas un problème. Pendant le traitement de migration des données, une valeur par défaut sera appliquée à ce champ pour toutes les entités.
Vous allez maintenant retourner à l’onglet Appariement du classeur et ajouter ces informations au champ Expression.
- Cliquez sur l’onglet Mapping (Appariement).
- Pour la ligne normalstatus, dans la colonne Expression, sélectionnez !NORMALLYOPEN!.
Vous allez ensuite apparier les champs restants de la même manière.
- Pour la ligne lifecyclestatus, dans la colonne Expression, sélectionnez !ACTIVEFLAG!.
- Pour la ligne symbolrotation, dans la colonne Expression, sélectionnez !ROTATION!.
À présent que vous avez trouvé les champs communs aux deux modèles, vous avez terminé la première étape de l’appariement des entités entre les données sources et le paquetage des ressources. Vous allez maintenant créer une recherche. Cela garantit que les valeurs attributaires dans les domaines sont alignées entre les données sources et le paquetage de ressources du réseau de distribution.
Créer une recherche pour les vannes système
Vous avez créé des appariements pour chacun des champs et avez supposé que chaque champ serait directement apparié entre les deux couches. Dans cette section, vous allez réexaminer cette supposition et identifier les situations dans lesquelles vous devez créer des recherches pour convertir des valeurs de domaine entre les données sources et le paquetage de ressources. Cela peut être aussi simple que convertir une valeur Yes en Y ou transformer quelque chose de plus complexe, comme une liste de noms de fabricant des données sources en un ensemble de codes dans les données cibles.
Vous allez explorer et mettre à jour les valeurs de domaine ACTIVEFLAG du jeu de données source pour voir si elles correspondent aux valeurs attendues pour le domaine lifecyclestatus dans le réseau de distribution. Si elles ne correspondent pas, vous allez créer une recherche pour convertir les anciennes valeurs en nouvelles valeurs attendues par le réseau de distribution.
- Dans le classeur wSystemValve-WaterDevice, cliquez sur l’onglet ACTIVEFLAG.
Remarque :
Faites défiler au besoin les différents onglets du classeur jusqu’à accéder à l’onglet ACTIVEFLAG.
Cet onglet affiche les valeurs de domaine du champ ACTIVEFLAG dans le jeu de données source.
Il comporte deux valeurs : 1 (vrai) si la vanne est en service et 0 (faux) si elle est hors service.
Vous allez maintenant explorer les valeurs attendues dans le champ de statut du cycle de vie par le réseau de distribution.
- Restaurez le classeur WaterEssentials_DataDictionary. Cliquez sur l’onglet TOC (Table des matières).
- Sous Datasets, cliquez sur main.WaterDevice.
Vous êtes transféré vers un nouvel onglet du classeur qui comporte des informations détaillées sur la classe d’entités WaterDevice.
Vous allez ensuite explorer les sous-types au sein de cette classe d’entités. Le champ de sous-type de chaque couche du réseau de distribution correspond à son groupe de ressources.
Remarque :
Chaque groupe de ressources du réseau de distribution a un sous-type correspondant. Aussi, on utilise souvent les termes groupe de ressources et sous-type de façon interchangeable.
- Cliquez sur SubtypeFieldInfo.
Toutes les ressources d’équipement hydraulique sont répertoriées, mais pour l’heure, vous allez vous concentrer sur la vanne système. Vous allez filtrer cette table pour n’afficher que ce type de ressource.
- Appliquez un filtre sur la colonne Subtype Name (Nom du sous-type) pour n’afficher que System Valve (Vanne système).
La System Valve (Vanne système) et ses champs dans le réseau de distribution s’affichent. La colonne Field Name (Nom de champ) affiche les attributs associés à ce type de ressource.
- Dans la colonne Field Name (Nom de champ), recherchez la ligne qui représente l’attribut lifecyclestatus.
Sa valeur par défaut est 2. Si vous ne la mettez pas à jour pendant le traitement de chargement des données, cette valeur 2 est attribuée à toutes les vannes système. Mais que représente ce 2 ? Pour comprendre ce que signifie cette valeur précodée, vous allez examiner le domaine du statut de cycle de vie.
- Dans la colonne Domain Name (Nom du domaine), pour l’attribut lifecyclestatus, cliquez sur Lifecycle_Status.
Vous êtes transféré vers une autre feuille de calcul qui explique les valeurs de ce domaine. Sous DomainCodedValue, quatre valeurs sont indiquées. La valeur par défaut, 2, représente une ressource qui est In Service (En service).
Vous connaissez désormais les valeurs de statut du cycle de vie que le réseau de distribution utilise. Toutefois, les valeurs du champ indicateur des données sources, 0 et 1, ne correspondent pas parfaitement à celles du réseau de distribution. Vous allez donc devoir mettre à jour l’onglet ACTIVEFLAG dans le classeur wSystemValve-WaterDevice pour convertir les valeurs en valeurs attendues par le réseau de distribution.
- Retournez au classeur wSystemValve-WaterDevice. Si nécessaire, cliquez sur l’onglet ACTIVEFLAG.
Pour créer une recherche et convertir les valeurs en valeurs attendues par le réseau de distribution, vous allez ajouter deux autres colonnes à l’onglet ACTIVEFLAG : une colonne pour le code et l’autre pour la description.
- À côté du champ BooleanDomain (Description), dans la colonne C, saisissez New Lifecycle Status (Nouveau statut de cycle de vie). Dans la colonne D, saisissez Description.
Remarque :
Lorsque vous créez ces colonnes, vous pouvez les nommer comme bon vous semble, mais dans ce didacticiel, vous allez utiliser les noms indiqués. Pour vos propres migrations, vous pouvez utiliser vos propres normes d’attribution de nom.
- Sur la ligne 2, dans la colonne New Lifecycle Status (Nouveau statut de cycle de vie), saisissez 0. Pour la Description, saisissez Out of Service (Hors service).
La valeur 0 du jeu de données source est alignée avec la valeur 0 du réseau de distribution. La valeur 1, True (Vrai), doit être convertie. Souvenez-vous que cette valeur est égale à 2 dans le réseau de distribution et que sa description est In Service (En service).
- Sur la ligne 3, dans la colonne New Lifecycle Status (Nouveau statut de cycle de vie), saisissez 2. Pour la Description, saisissez In Service (En service).
Lorsque les données sont chargées, les valeurs 1 des données sources sont converties en valeurs 2. Ces données vont maintenant être correctement lues par le réseau de distribution et les vannes système mises en service.
À présent que vous avez créé votre recherche, vous allez mettre à jour la feuille Mapping (Appariement) pour référencer ces colonnes.
- Cliquez sur l’onglet Mapping (Appariement).
- Recherchez la ligne lifecyclestatus. Procédez de la manière suivante :
- Dans la colonne LookupSheet, saisissez ACTIVEFLAG.
- Dans la colonne LookupKeys, saisissez ACTIVEFLAG.
- Dans la colonne LookupValue, saisissez New Lifecycle Status (Nouveau statut du cycle de vie).
- Dans la colonne LookupDefault, saisissez 2.
La valeur LookupSheet détermine dans quel onglet de la feuille de calcul les informations de la recherche sont stockées. La valeur LookupKeys désigne la colonne de la feuille de calcul LookupSheet qui contient les valeurs d’origine des données sources. LookupValue désigne la colonne qui contient les valeurs devant être utilisées pendant la migration des données et qui doivent être alignées avec celles du réseau de distribution. LookupDefault détermine la valeur qui doit être celle par défaut. Dans notre exemple, il s’agit de 2 ou In Service (En service).
Les valeurs que vous utilisez sont mises en surbrillance en rouge. Cela est dû au fait qu’une expression et une recherche ne peuvent pas être définies dans la même ligne. Pour résoudre ce problème, vous allez supprimer l’expression.
- Sur la ligne lifecyclestatus, supprimez le texte de la colonne Expression.
La mise en surbrillance en rouge disparaît.
- Enregistrez le classeur wSystemValve-WaterDevice.
- Fermez tous les classeurs Excel que vous avez ouverts.
Vous n’avez pas besoin d’enregistrer les classeurs WaterEssentials_DataDictionary et DataReference.
Vous avez fini d’apparier les valeurs des données sources et du réseau de distribution pour la couche des vannes système. Vous êtes à présent prêt à déployer le réseau de distribution et à migrer les données vers ce modèle de données.
Charger les données sur le réseau de distribution
Vous allez maintenant utiliser les outils de chargement de données pour renseigner l’espace de travail du paquetage de ressources à l’aide de votre espace de travail d’appariement de données. Vous allez alors utiliser ce paquetage de ressources pour déployer un réseau de distribution local à des fins d’assurance qualité. Une fois que vous avez déployé le réseau de distribution, vous allez valider les données migrées pour identifier les éventuels problèmes topologiques que vous devrez résoudre avec vos données.
Effectuer la migration des données
Vous allez maintenant exécuter un outil de géotraitement de chargement de données pour convertir les données de votre geodatabase source dans le paquetage de ressources à l’aide du classeur que vous avez créé dans ce didacticiel.
- Ouvrez ArcGIS Pro. Si nécessaire, ouvrez le projet Water Data Loading (Chargement des données hydrauliques).
- Sur le ruban, cliquez sur l’onglet Analysis (Analyse). Dans le groupe Geoprocessing (Géotraitement), cliquez sur Tools (Outils).
La fenêtre Geoprocessing (Géotraitement) s’affiche.
- Cliquez sur l’onglet Toolboxes (Boîtes d’outils). Sous System (Système), développez Data Management Tools (Outils de gestion de données) et cliquez sur Data Loading (Chargement des données). Ouvrez l’outil Load Data Using Workspace (Charger des données en utilisant un espace de travail).
Remarque :
Si vous testez les appariements et ne voulez pas alimenter votre base de données cible, utilisez l’outil Load Data To Preview (Charger des données dans l’aperçu) pour procéder à la migration vers une géodatabase temporaire en vue de sa consultation.
- Pour Data Reference Workbook (Classeur de référence de données), cliquez sur Browse (Parcourir). Accédez au dossier Water_Data_Loading. Ouvrez les dossiers Migration Workspace (Espace de travail des migrations), Initial Mappings (Appariements initiaux), Initial Workspace (Espace de travail initial) et DataLoadingWorkspace.
- Sélectionnez DataReference et cliquez sur OK.
- Cliquez sur Run (Exécuter).
Déployer le réseau de distribution
Vous allez ensuite utiliser la boîte à outils Utility Network Package Tools (Outils de paquetage de réseau de distribution) pour déployer le réseau de distribution sur une géodatabase locale à des fins d’assurance qualité et de tests.
- Dans la fenêtre Geoprocessing (Géotraitement), cliquez sur Back (Retour) .
- Sous Project (Projet), développez la boîte à outils Utility Network Package Tools (Outils de paquetage de réseau de distribution). Développez le jeu d’outils Asset Package (Paquetage de ressources). Ouvrez l’outil Asset Package To Geodatabase (Paquetage de ressources vers géodatabase).
L’outil Asset Package To Geodatabase (Paquetage de ressources vers géodatabase) permet de déployer un réseau de distribution sur une géodatabase locale à des fins d’assurance qualité.
Remarque :
Pour déployer vos données sur une géodatabase d’entreprise, vous devez utiliser les outils Stage Utility Network (Organiser le réseau de distribution) et Apply Asset Package (Appliquer un paquetage de ressources). Ces outils conviennent plus au déploiement d’un jeu de données entièrement nettoyé sur un environnement de production.
- Pour Asset Package (Paquetage de ressources), accédez au dossier Initial Workspace (Espace de travail initial). Sélectionnez Initial Workspace.gdb et cliquez sur OK.
La valeur du paramètre Service Territory Feature Class (Classe d’entités de zone de service) est automatiquement remplie Par ailleurs, un grand nombre d’éléments de l’outil sont prérenseignés à l’aide de la géodatabase Initial Workspace (Espace de travail initial). Par défaut, la géodatabase en sortie est créée dans le répertoire de base de votre projet.
Comme il s’agit de la première migration de vos données sources vers le réseau de distribution, vous allez désactiver le post-traitement automatique du réseau. Désélectionner cette option permet de procéder à l’assurance qualité de la migration des données dans la mesure où la topologie reste désactivée. Si le post-traitement n’est pas désactivé, le déploiement échoue en cas de détection d’un nombre élevé d’erreurs.
- Sous Asset Package Options (Options du paquetage de ressources). Décochez la case en regard de Post Process (Post-traitement).
- Cliquez sur Run (Exécuter).
Remarque :
L’exécution de cet outil peut prendre plusieurs minutes. Si vous exécutez cet outil avec vos données, son exécution peut prendre plus de temps selon la taille de la géodatabase en entrée.
Effectuer l’assurance qualité
À présent que vous avez déployé un réseau de distribution local, vous allez évaluer la qualité pour identifier d’éventuelles erreurs de topologie dans les données. Par chance, le réseau de distribution valide toutes les entités du réseau lorsqu’il est activé pour la première fois. Lorsque la topologie est activée, le suivi et la validation de la topologie du réseau se poursuivent comme des entités sont mises à jour à l’aide des zones à valider.
Une fois les erreurs de topologie identifiées, vous allez produire un rapport pour examiner et classer les erreurs. Ce rapport permet de traiter les problèmes qui nécessitent un nettoyage manuel des données source et des modifications de la configuration.
- Dans la fenêtre Geoprocessing (Géotraitement), cliquez sur le bouton Back (Retour).
- Sous System (Système), développez la boîte à outils Utility Network Tools (Outils du réseau de distribution). Développez le jeu d’outils Administration. Ouvrez l’outil Enable Network Topology (Activer la topologie du réseau).
- Pour Input Utility Network (Réseau de distribution en entrée), cliquez sur Browse (Parcourir). Dans la fenêtre Input Utility Network (Réseau de distribution en entrée), accédez au dossier Water_Data_Loading. Ouvrez Initial Workspace_UtilityNetwork.geodatabase. Ouvrez le jeu de classes d’entités main.UtilityNetwork. Sélectionnez main.Network et cliquez sur OK.
Remarque :
Si Initial Workspace_UtilityNetwork.geodatabase n’est pas visible dans le dossier Water_Data_Loading. Cliquez avec le bouton droit sur la fenêtre Input Utility Network (Réseau de distribution en entrée) et choisissez Refresh (Actualiser).
Vous allez à présent modifier les paramètres associés au nombre d’erreurs détectées par cet outil.
- Développez Advanced Options (Options avancées).
- Dans Maximum number of errors (Nombre maximal d’erreurs), effacez la valeur par défaut. Cochez la case Only generate errors (Générer uniquement les erreurs).
Laisser le paramètre Maximum number of errors (Nombre maximal d’erreurs) vide permet de supprimer la limite du nombre d’erreurs à laquelle l’outil échoue.
Sélectionner Only generate errors (Générer uniquement les erreurs) garantit que les erreurs de validation de la topologie du réseau sont conservées sans activer la topologie du réseau en vue de l'analyse.
- Cliquez sur Run (Exécuter).
Remarque :
Le processus ne prend que quelques secondes pour les données du didacticiel. Son exécution peut nécessiter plusieurs minutes, voire plusieurs heures sur de plus grands jeux de données.
Vous allez à présent examiner les résultats et créer un rapport d’assurance qualité.
- Cliquez sur le bouton Retour.
- Sous Project (Projet), développez la boîte à outils Utility Data Management Support (Aide à la gestion des données de réseau de distribution). Développez le jeu d’outils Utility Network (Réseau de distribution). Ouvrez l’outil Summarize Utility Network Errors (Synthétiser les erreurs du réseau de distribution).
- Dans Input Network (Réseau en entrée), accédez au dossier Water_Data_Loading. Ouvrez Initial Workspace_UtilityNetwork.geodatabase et ouvrez le jeu de classes d’entités main.UtilityNetwork. Sélectionnez main.Network et cliquez sur OK.
Cet outil peut identifier de nombreux types d’erreurs différents. Comme vous vous intéressez pour le moment aux erreurs liées à la topologie, vous allez laisser le paramètre Error Options (Options des erreurs) sur la sélection par défaut Extract Dirty Areas and Associations in Error (Inclure les zones à valider et les associations dans les erreurs).
Par défaut, le récapitulatif des erreurs est enregistré dans le dossier du projet.
- Cliquez sur Run (Exécuter).
Une géodatabase nommée Summary.geodatabase est créée. Vous allez explorer certaines tables incluses dans celle-ci par la suite.
- Dans la fenêtre Catalog (Catalogue), dans le dossier Water_Data_Loading, développez Summary.geodatabase. Cliquez avec le bouton droit sur main.View_Error_Summary et sélectionnez Open Table (Ouvrir la table).
Remarque :
Si Summary.geodatabase n’est pas visible, cliquez avec le bouton droit sur le dossier Water_Data_Loading et cliquez sur Refresh (Actualiser).
La table main.View_Error_Summary apparaît. Cette table récapitule toutes les erreurs de topologie dans le réseau de distribution. Ce jeu de données fourni à titre d’exemple contient quatre types d’erreurs.
- Dans la fenêtre Catalog (Catalogue), dans Summary.geodatabase, cliquez avec le bouton droit sur la table main.View_Errors_By_Type.
Cette table fournit des détails sur les différents types d’erreur contenues dans les données migrées. Elle permet de développer un plan de nettoyage détaillé de vos données source.
- Fermez les tables main.View_Errors_By_Type et main.View_Error_Summary.
- Dans la fenêtre Catalog (Catalogue), dans Summary.geodatabase, développez main.Data.
- Cliquez avec le bouton droit sur main.Errors, pointez sur Add To New (Ajouter à une nouvelle) et sélectionnez Map (Carte).
Une couche de polygones représentant les erreurs de réseau est ajoutée à une carte en vue de son examen.
- Zoomez sur l’un des polygones sur la carte. Cliquez sur le polygone pour examiner l’erreur correspondante.
L’ajout de la classe d’entités main.Errors contenant des erreurs sur une carte de vos données source permet d’identifier les zones qui ont besoin d’un nettoyage dans la mesure où vous préparez le réseau de distribution pour un environnement de production. Il est souvent utile de fournir cette classe d’entités aux éditeurs pour indiquer là où ils doivent réaliser un nettoyage des données source.
- Dans Quick Access Toolbar (Barre d’outils Accès rapide), cliquez sur Save Project (Enregistrer le projet).
Dans ce module, vous avez exécuté votre propre migration de données pour créer un réseau de distribution. Vous avez activé la topologie de réseau pour trouver les erreurs dans vos données source et exploré l’une d’entre elles.
Vous avez créé un prototype de réseau de distribution en migrant les données de votre base de données source dans l’un des modèles de données de base de réseau de distribution. Vous avez utilisé l’outil Create Simple Data Mapping (Créer un appariement de données simple) pour créer un classeur d’appariement de données simple qui vous permet ensuite d’apparier vos données à partir de votre base de données source sur votre base de données cible. Ensuite, vous avez ensutilisé l’outil Create Migration Workspace (Créer un espace de travail des migrations) pour créer une migration des données et étendu le modèle en ajoutant un nouveau type de ressource et en copiant les champs de votre base de données source. Vous avez ajusté la migration des données en changeant les appariements des champs et en ajoutant les recherches pour effectuer une conversion entre les deux modèles. Vous avez utilisé l’outil Load Data to Workspace (Charger des données en utilisant un espace de travail) pour migrer vos données dans le paquetage de ressources cible.
Enfin, vous avez déployé un réseau de distribution local à des fins d’assurance qualité à l’aide de l’outil Asset Package to Geodatabase (Paquetage de ressources vers géodatabase). Vous avez créé un rapport de toutes les erreurs topologiques dans la base de données à l’aide de l’outil Summarize Utility Network Errors (Synthétiser les erreurs du réseau de distribution). Ce rapport peut vous permettre de créer un plan de nettoyage des données. Savoir identifier les erreurs de topologie dans vos données constitue une partie importante de la préparation de la migration vers le réseau de distribution.
Vous trouverez plus d’informations sur le réseau de distribution dans cette série de didacticiels et dans la bibliothèque des didacticiels.
Si vous voulez en savoir plus sur les modèles de données applicables à différents secteurs, lisez Présentation de la solution Electric Utility Network Foundation. Chaque base inclut un paquetage de ressources qui permet de faciliter la migration et le déploiement du réseau de distribution. Pour en savoir plus sur les outils utilisés pour le déploiement, reportez-vous à la rubrique Vue d’ensemble de la boîte à outils Paquetage de réseau de distribution.
Pour connaître les outils supplémentaires qui facilitent la migration et le nettoyage des données, lisez Outils d’aide à la gestion des données de réseau de distribution.
Pour finir, pour connaître les outils permettant de charger les données, lisez Vue d’ensemble de la boîte à outils Chargement des données.