Mettre à niveau la base de données Indoors (Indoors)

Synthèse

Met à niveau un espace de travail Indoors existant en créant ou en mettant à jour des éléments de structure pour respecter la structure du modèle d’information ArcGIS Indoors le plus récent.

Utilisation

• Cet outil permet de mettre à jour la structure d’un espace de travail Indoors existant créé à l’aide des outils Créer une base de données Indoors, Créer un jeu de données Indoor et Créer un jeu de données réseau Indoor afin de respecter la version actuelle du modèle Indoors.

• Cet outil met à niveau un espace de travail Indoors existant en ajoutant des classes d’entités, des champs, des domaines et des valeurs de domaine, ainsi qu’en modifiant la propriété qui accepte les valeurs nulles de certains champs.

  Remarque :

  Cet outil modifie la base de données en entrée. Créez une copie de sauvegarde de l’espace de travail Indoors si vous souhaitez conserver une version précédente pour référence.

• Si la base de données est une géodatabase d’entreprise dont les données sont partagées en tant que services d’entités utilisant le versionnement de branche, vous devez arrêter tous les services utilisés et désactiver le verrouillage de la structure pour que l’outil puisse modifier la structure de la géodatabase.

• Dans ArcGIS Enterprise, tous les services qui utilisent un type d’instance partagé, comme la couche Réservations, doivent être supprimés pour que l’outil puisse modifier la structure.

• Cet outil recherche les éléments de structure en appariant les noms d’élément au modèle Indoors. Les éléments de structure qui ne sont pas trouvés sont créés en tant que nouveaux éléments. Si vous avez renommé des classes d’entités, des tables, des champs et des domaines dans l’espace de travail Indoors mentionné, vous devez restaurer leur nom d’origine afin qu’ils puissent être mis à niveau par l’outil.

• Cet outil ne supprime pas ni les éléments de structure, ni les règles attributaires personnalisées dans l’espace de travail Indoors en entrée.

• La base de données Indoors en entrée doit déjà exister et ne peut pas être vide.

• Si la base de données contient un jeu de données réseau Indoor, cet outil crée le champ LEVEL_ID dans les classes d’entités Parcours et PrelimPathways s’il en est absent. L’outil tente également de renseigner les valeurs du champ LEVEL_ID pour les entités Parcours et PrelimPathways qui se situent dans les bâtiments.

  Remarque :

  Si la base de données en entrée est une géodatabase d’entreprise contenant un jeu de données réseau obtenu après exécution de l’outil Générer un réseau, le champ LEVEL_ID peut être ajouté par l’outil Mettre à niveau la base de données Indoors, mais il n’est pas renseigné avec des valeurs en raison de la présence de verrous sur les classes d’entités participantes employées pour la génération du réseau.

  Pour renseigner les entités Parcours et PrelimPathways avec des valeurs LEVEL_ID, exécutez cet outil lors de la prochaine mise à jour du réseau avant de générer le réseau.

• Si la base de données contient des règles attributaires de validation Indoors, vous pouvez exécuter l’outil en cochant le paramètre Mettre à niveau les règles attributaires pour mettre à jour les règles attributaires existantes ou créer les règles attributaires manquantes à partir de la version la plus récente du modèle Indoors. Il s’agit de l’option par défaut.

• Les règles attributaires de sécurité associées à la classe d’entités Réservations sont créées ou mises à jour au cours de la mise à niveau, ceci afin de garantir la sécurité des réservations de l’espace de travail.

  Remarque :

  Lors de la mise à niveau d’une géodatabase d’entreprise, le versionnement de branche doit être activé si le paramètre Mettre à niveau les règles attributaires est coché.

  Les ID globaux et le suivi de l’éditeur sont activés si le paramètre Mettre à niveau les règles attributaires est coché et si la base de données présente des règles attributaires Indoors existantes.

• Vous pouvez générer un rapport des modifications que l’outil peut apporter à un espace de travail Indoors sans modifier la structure existante en spécifiant la valeur Générer le rapport sur les modifications de structure pour le paramètre Mettre à niveau la base de données Indoors. Lorsque cette option est spécifiée, voici ce qui se produit :

  • L’espace de travail Indoors n’est pas mis à jour.
  • Un rapport sous forme de fichier texte est généré ; il indique la liste des classes d’entités, des tables, des champs, des domaines, des valeurs de domaine et des règles attributaires qui seront ajoutés ou mis à niveau.
  • Le rapport obtenu inclut des informations si l’état de la géodatabase Indoors en entrée empêche l’ajout d’un élément de structure. Par exemple, il n’est peut-être pas possible d’ajouter un champ à une classe d’entités si un champ existant porte le même nom, mais présente un type de données différent.
  • Le rapport généré inclut des informations si l’état de la base de données ne permet qu’une mise à niveau partielle par l’outil. Par exemple, si un champ qui n’accepte pas les valeurs nulles doit être ajouté à une classe d’entités lors de la mise à niveau, il est ajouté comme acceptant les valeurs nulles plutôt que l’inverse si la classe d’entités contient des données existantes.
  • Le verrou de structure exclusif sur la base de données n’est pas acquis si l’outil est exécuté avec le paramètre Mettre à niveau la base de données Indoors défini sur Générer le rapport sur les modifications de structure.

• Après exécution de l’outil, actualisez le contenu au niveau de la base de données pour voir les modifications apportées aux tables, et au niveau du jeu de données pour afficher les modifications apportées aux classes d’entités.

• Si l’espace de travail Indoors existant est une géodatabase d’entreprise comportant des classes d’entités dans un jeu de données partagé dans des services d’entités utilisant le versionnement de branche, le versionnement de branche doit également être activé pour les nouvelles classes d’entités créées dans le même jeu de données par cet outil.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Base de données Indoors en entrée	Géodatabase existante qui contient les éléments de structure du modèle Indoors créés par l’outil Créer une base de données Indoors ou Créer un jeu de données Indoors. Ce paramètre accepte une géodatabase fichier ou une géodatabase d’entreprise.	Workspace
Mettre à niveau les règles attributaires (Facultatif)	Indique si les règles attributaires de validation sont créées ou mises à jour dans le but d’être utilisées dans les processus de contrôle qualité Indoors. Si la base de données Indoors en entrée est une géodatabase d’entreprise, le versionnement de branche doit être activé. Coché : les règles attributaires de validation sont créées ou remplacées par la version la plus récente des règles attributaires du modèle Indoors si la base de données présente des règles attributaires Indoors existantes. Il s’agit de l’option par défaut. Décoché : les règles attributaires de validation ne sont ni créées, ni mises à jour.	Boolean
Mettre à niveau la base de données Indoors (Facultatif)	Indique si la base de données Indoors en entrée est mise à niveau avec des modifications de structure ou si un rapport est généré pour indiquer les éventuelles modifications de structure qui seront apportées à la base de données Indoors en entrée. Mettre à niveau la base de données—La base de données Indoors en entrée est mise à niveau. Il s’agit de l’option par défaut. Générer le rapport sur les modifications de structure—Un rapport sous forme de fichier texte est généré. Il répertorie les modifications de structure qui seront apportées à la base de données Indoors en entrée au cours de la mise à niveau, ainsi que les problèmes susceptibles de se produire si la structure n’est pas mise à jour. La base de données Indoors en entrée n’est pas mise à niveau.	String

Sortie obtenue

Étiquette	Explication	Type de données
Base de données Indoors mise à niveau	Géodatabase Indoors mise à niveau par l’outil.	Workspace

Python

arcpy.indoors.UpgradeIndoorsDatabase(in_workspace, {upgrade_attribute_rules}, {upgrade_indoors_database})

Nom	Explication	Type de données
in_workspace	Géodatabase existante qui contient les éléments de structure du modèle Indoors créés par l’outil Créer une base de données Indoors ou Créer un jeu de données Indoors. Ce paramètre accepte une géodatabase fichier ou une géodatabase d’entreprise.	Workspace
upgrade_attribute_rules (Facultatif)	Indique si les règles attributaires de validation sont créées ou mises à jour dans le but d’être utilisées dans les processus de contrôle qualité Indoors. Si la base de données Indoors en entrée est une géodatabase d’entreprise, le versionnement de branche doit être activé. UPGRADE_ATTRIBUTE_RULES—Les règles attributaires de validation sont créées ou mises à jour s’il existe des règles attributaires Indoors dans la base de données en entrée. Il s’agit de l’option par défaut. NO_UPGRADE_ATTRIBUTE_RULES—Les règles attributaires de validation ne sont ni créées, ni mises à jour.	Boolean
upgrade_indoors_database (Facultatif)	Indique si la base de données Indoors en entrée est mise à niveau avec des modifications de structure ou si un rapport est généré pour indiquer les éventuelles modifications de structure qui seront apportées à la base de données Indoors en entrée. UPGRADE_DATABASE—La base de données Indoors en entrée est mise à niveau. Il s’agit de l’option par défaut. GENERATE_REPORT—Un rapport sous forme de fichier texte est généré. Il répertorie les modifications de structure qui seront apportées à la base de données Indoors en entrée au cours de la mise à niveau, ainsi que les problèmes susceptibles de se produire si la structure n’est pas mise à jour. La base de données Indoors en entrée n’est pas mise à niveau.	String

Sortie obtenue

Nom	Explication	Type de données
out_workspace	Géodatabase Indoors mise à niveau par l’outil.	Workspace

Exemple de code

Exemple 1 d’utilisation de la fonction UpgradeIndoorsDatabase (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction UpgradeIndoorsDatabase en mode immédiat.

arcpy.indoors.UpgradeIndoorsDatabase('C:\SampleGDB\Indoors_2_5.gdb','UPGRADE_ATTRIBUTE_RULES','UPGRADE_DATABASE')

Exemple 2 d’utilisation de la fonction UpgradeIndoorsDatabase (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction UpgradeIndoorsDatabase.

import arcpy
arcpy.indoors.UpgradeIndoorsDatabase()

#Set the input Indoors database and parameter settings.
input_workspace = 'C:\SampleGDB\Indoors_2_5.gdb'
upgrade_attribute_rules = True
execute_mode = 'UPGRADE_DATABASE'

#Run the tool with selected parameters.
arcpy.indoors.UpgradeIndoorsDatabase(input_workspace, upgrade_attribute_rules, execute_mode)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps
• Standard: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps
• Advanced: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps