Réconcilier des versions (Gestion des données)

Synthèse

Réconcilie une ou plusieurs versions avec une version cible.

En savoir plus sur la réconciliation et la réinjection des versions

Utilisation

• Le processus de réconciliation nécessite que vous soyez le seul utilisateur qui met à jour actuellement la version et le seul utilisateur qui va mettre à jour la version dans tout le processus de réconciliation jusqu’à son enregistrement ou sa réinjection.

• Le processus de réconciliation nécessite que vous ayez pleinement accès à toutes les classes d’entités modifiées dans la version en cours de modification.

• Les outils de versionnement fonctionnent avec les géodatabases d’entreprise. Les géodatabases fichier ne prennent pas en charge le versionnement.

• Cet outil prend en charge les opérations de réconciliation et de réinjection des données publiées à partir d’un espace de travail de branche avec les fonctionnalités de gestion des versions activées. Les opérations de réconciliation et de réinjection pour le versionnement de branche via un fichier de connexion à une géodatabase ne sont pas prises en charge.

• La géodatabase est conçue pour gérer efficacement et prendre en charge des transactions longues à l’aide de versions.

• Le processus de réconciliation détecte des différences entre la version mise à jour et la version cible et signale ces différences comme des conflits. S’il y a des conflits, réglez-les.

• Une fois le processus de réconciliation avec l’option Reconcile all versions (Réconcilier toutes les versions) exécuté, toutes les versions dans la géodatabase ont le même aspect.

Remarque :

À partir de ArcGIS Enterprise 10.9.1, les opérations de réconciliation et de réinjection tirent parti du processus asynchrone à l’aide du service de géotraitement VersionManagementTools lors de l’utilisation de jeux de données de branche versionnée via un service d’entités avec la fonctionnalité de gestion de versions activée. Le service VersionManagementTools est préconfiguré dans le dossier système pour prendre en charge les fonctionnalités de gestion des versions asynchrones. Il possède un paramètre de délai d’expiration plus long et est réservé aux tâches de géotraitement de gestion des versions.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Espace de travail en entrée	Géodatabase d’entreprise contenant les versions à réconcilier. Pour le versionnement de branche, il s’agit de l’URL du service d’entités (c’est-à-dire, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) ou de l’élément de portail de la couche d’entités.	Workspace
Mode de réconciliation	Spécifie les versions à réconcilier lorsque l’outil est exécuté. Si l’entrée est un espace de travail de branche, le seul choix valide pour ce paramètre est de réconcilier toutes les versions. Réconcilier toutes les versions—Les versions de mise à jour sont réconciliées avec la version cible. Il s’agit de l’option par défaut. Réconcilier les versions de blocage uniquement—Les versions qui empêchent la version cible d’être compressée sont réconciliées. Cette option utilise l’ordre de réconciliation recommandé.	String
Version cible (Facultatif)	Nom de toute version ayant un lien direct avec la version de mise à jour, telle que la version parent ou la version par défaut. Elle contient généralement des mises à jour provenant d’autres versions que vous voulez inclure dans la version de mise à jour. Si l’entrée est un espace de travail de branche, le seul choix valide pour ce paramètre est de procéder à la réconciliation avec la version par défaut.	String
Versions de mise à jour (Facultatif)	Nom de la version de mise à jour à réconcilier avec la version cible sélectionnée. Seules les versions ayant un lien direct avec la version cible sélectionnée s’affichent.	String
Acquérir les verrous (Facultatif)	Spécifie si l’acquisition des verrous d’entités est nécessaire. Si l’entrée est un espace de travail de branche, aucun verrou n’est acquis au cours du processus de réconciliation. Activé : les verrouillages sont acquis pendant le processus de réconciliation. Utilisez cette option lorsque vous avez l’intention d’injecter des mises à jour. Elle permet de garantir que la version cible ne sera pas modifiée au cours du laps de temps entre les opérations de réconciliation et de réinjection. Il s’agit de l’option par défaut. Désactivé : les verrouillages ne sont pas acquis pendant le processus de réconciliation. Cela permet à plusieurs utilisateurs d’effectuer une réconciliation en parallèle. Utilisez cette option lorsque la version de mise à jour n’est pas réinjectée dans la version cible en raison de la possibilité que la version cible soit modifiée dans le laps de temps entre les opérations de réconciliation et de réinjection.	Boolean
Abandonner si des conflits sont détectés (Facultatif)	Spécifie si le processus de réconciliation doit être annulé si des conflits sont détectés entre la version cible et la version de mise à jour au cours du processus de réconciliation. Activé : la réconciliation est annulée si des conflits sont détectés. Désactivé : la réconciliation n’est pas annulée si des conflits sont détectés. Il s’agit de l’option par défaut.	Boolean
Définition des conflits (Facultatif)	Indique si les conditions requises pour la survenance d’un conflit sont définies par objet (ligne) ou par attribut (colonne). Conflits définis par objet (par ligne)—Les conflits sont définis par objet. Un conflit est détecté lors de la réconciliation dès lors qu’une même ligne ou entité a été modifiée dans les versions parent et enfant. Il s’agit de l’option par défaut. Conflits définis par attribut (par colonne)—Les conflits sont définis par attribut. Un conflit est détecté lors de la réconciliation uniquement si des modifications sont apportées au même attribut (colonne) de la même ligne ou de la même entité dans les versions parents et enfants. Les modifications effectuées sur des attributs différents ne génèrent pas de conflit lors de la réconciliation.	String
Résolution des conflits (Facultatif)	Spécifie la résolution utilisée en cas de conflit. Si l’entrée est un espace de travail de branche, le comportement par défaut consiste à favoriser la version de mise à jour. Résoudre les conflits en faveur de la version cible—Tous les conflits sont résolus en faveur de la version cible. Il s’agit de la valeur par défaut pour le versionnement traditionnel. Résoudre les conflits en faveur de la version de mise à jour—Tous les conflits sont résolus en faveur de la version de mise à jour. Il s’agit de la valeur par défaut pour le versionnement de branche.	String
Réinjecter les versions après réconciliation (Facultatif)	Spécifie si la session de mise à jour actuelle est réinjectée dans la version cible réconciliée. Activé : la version de mise à jour actuelle sera réinjectée dans la version cible après la réconciliation. Désactivé : la version de mise à jour actuelle ne sera pas réinjectée dans la version cible après la réconciliation. Il s’agit de l’option par défaut.	Boolean
Supprimer les versions après réinjection (Facultatif)	Spécifie si la session de mise à jour actuelle sera supprimée après avoir été réinjectée. Ce paramètre ne s’applique que si le paramètre Post Versions After Reconcile (Réinjecter les versions après réconciliation) est activé. Activé : la version de mise à jour actuelle qui a été réconciliée sera supprimée après avoir été réinjectée dans la version cible. Désactivé : la version de mise à jour actuelle qui a été réconciliée ne sera pas supprimée. Il s’agit de l’option par défaut.	Boolean
Journal de réconciliation de versions (Facultatif)	Nom et emplacement dans lequel le fichier journal est écrit. Le fichier journal est un fichier ASCII qui contient le contenu des messages de géotraitement.	File
Continuer si des conflits non examinés sont détectés (Facultatif)	Indique si la réconciliation a lieu dans le cas où des conflits non examinés sont détectés avant le démarrage du processus de réconciliation. Si vous poursuivez, les conflits existants issus des sessions précédentes seront perdus lors de l’exécution de l’outil. Ce paramètre s’applique uniquement au versionnement de branche. Coché : le processus de réconciliation a lieu si des conflits existants non examinés sont détectés. Il s’agit de l’option par défaut. Non coché : le processus de réconciliation n’a pas lieu si des conflits existants non examinés sont détectés.	Boolean
Réconcilier les versions des réplicas d’extraction (Facultatif)	Indique si le processus de réconciliation inclut les versions des réplicas d’extraction. Si vous créez un réplica d’extraction dans le cadre d’un processus de réplication de géodatabase, une version associée est créée dans la géodatabase. Cette option vous permet d’inclure ou de retirer ces types de versions de la liste des versions à réconcilier. Ce paramètre ne s’applique pas au versionnement de branche. Activé : le processus de réconciliation inclut les versions des réplicas d’extraction. Il s’agit de l’option par défaut. Désactivé : le processus de réconciliation n’inclut pas les versions des réplicas d’extraction.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Espace de travail en entrée mis à jour	Espace de travail en entrée mis à jour.	Workspace

Python

arcpy.management.ReconcileVersions(input_database, reconcile_mode, {target_version}, {edit_versions}, {acquire_locks}, {abort_if_conflicts}, {conflict_definition}, {conflict_resolution}, {with_post}, {with_delete}, {out_log}, {proceed_if_conflicts_not_reviewed}, {reconcile_checkout_versions})

Nom	Explication	Type de données
input_database	Géodatabase d’entreprise contenant les versions à réconcilier. L’option par défaut consiste à utiliser l’environnement d’espace de travail de géotraitement. Pour le versionnement de branche, il s’agit de l’URL du service d’entités (c’est-à-dire, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer).	Workspace
reconcile_mode	Spécifie les versions à réconcilier lorsque l’outil est exécuté. Si l’entrée est un espace de travail de branche, le seul choix valide pour ce paramètre est de réconcilier toutes les versions. ALL_VERSIONS—Les versions de mise à jour sont réconciliées avec la version cible. Il s’agit de l’option par défaut. BLOCKING_VERSIONS—Les versions qui empêchent la version cible d’être compressée sont réconciliées. Cette option utilise l’ordre de réconciliation recommandé.	String
target_version (Facultatif)	Nom de toute version ayant un lien direct avec la version de mise à jour, telle que la version parent ou la version par défaut. Elle contient généralement des mises à jour provenant d’autres versions que vous voulez inclure dans la version de mise à jour. Si l’entrée est un espace de travail de branche, le seul choix valide pour ce paramètre est de procéder à la réconciliation avec la version par défaut.	String
edit_versions [edit_versions,...] (Facultatif)	Nom de la version de mise à jour à réconcilier avec la version cible sélectionnée. Il peut s’agir du nom d’une version individuelle ou d’une liste de noms de version.	String
acquire_locks (Facultatif)	Spécifie si l’acquisition des verrous d’entités est nécessaire. LOCK_ACQUIRED—Les verrouillages sont acquis pendant le processus de réconciliation. Utilisez cette option lorsque vous avez l’intention d’injecter des mises à jour. Elle permet de garantir que la version cible ne sera pas modifiée au cours du laps de temps entre les opérations de réconciliation et de réinjection. Il s’agit de l’option par défaut. NO_LOCK_ACQUIRED—Les verrouillages sont acquis pendant le processus de réconciliation. Cela permet à plusieurs utilisateurs d’effectuer une réconciliation en parallèle. Utilisez cette option lorsque la version de mise à jour n’est pas réinjectée dans la version cible en raison de la possibilité que la version cible soit modifiée dans le laps de temps entre les opérations de réconciliation et de réinjection.	Boolean
abort_if_conflicts (Facultatif)	Spécifie si le processus de réconciliation doit être annulé si des conflits sont détectés entre la version cible et la version de mise à jour au cours du processus de réconciliation. NO_ABORT—La réconciliation n’est pas annulée si des conflits sont détectés. Il s’agit de l’option par défaut. ABORT_CONFLICTS—La réconciliation est annulée si des conflits sont détectés.	Boolean
conflict_definition (Facultatif)	Indique si les conditions requises pour la survenance d’un conflit sont définies par objet (ligne) ou par attribut (colonne). BY_OBJECT—Les conflits sont définis par objet. Un conflit est détecté lors de la réconciliation dès lors qu’une même ligne ou entité a été modifiée dans les versions parent et enfant. Il s’agit de l’option par défaut. BY_ATTRIBUTE—Les conflits sont définis par attribut. Un conflit est détecté lors de la réconciliation uniquement si des modifications sont apportées au même attribut (colonne) de la même ligne ou de la même entité dans les versions parents et enfants. Les modifications effectuées sur des attributs différents ne génèrent pas de conflit lors de la réconciliation.	String
conflict_resolution (Facultatif)	Spécifie la résolution utilisée en cas de conflit. Si l’entrée est un espace de travail de branche, le comportement par défaut consiste à favoriser la version de mise à jour. FAVOR_TARGET_VERSION—Tous les conflits sont résolus en faveur de la version cible. Il s’agit de la valeur par défaut pour le versionnement traditionnel. FAVOR_EDIT_VERSION—Tous les conflits sont résolus en faveur de la version de mise à jour. Il s’agit de la valeur par défaut pour le versionnement de branche.	String
with_post (Facultatif)	Spécifie si la session de mise à jour actuelle est réinjectée dans la version cible réconciliée. NO_POST—La version de mise à jour actuelle ne sera pas réinjectée dans la version cible après la réconciliation. Il s’agit de l’option par défaut. POST—la version de mise à jour actuelle sera réinjectée dans la version cible après la réconciliation.	Boolean
with_delete (Facultatif)	Spécifie si la session de mise à jour actuelle sera supprimée après avoir été réinjectée. Ce paramètre ne s’applique que si le paramètre with_post est défini sur POST. DELETE_VERSION—La version de mise à jour actuelle qui a été réconciliée sera supprimée après avoir été réinjectée dans la version cible. KEEP_VERSION—La version de mise à jour actuelle qui a été réconciliée ne sera pas supprimée. Il s’agit de l’option par défaut.	Boolean
out_log (Facultatif)	Nom et emplacement dans lequel le fichier journal est écrit. Le fichier journal est un fichier ASCII qui contient le contenu des messages de géotraitement.	File
proceed_if_conflicts_not_reviewed (Facultatif)	Indique si la réconciliation a lieu dans le cas où des conflits non examinés sont détectés avant le démarrage du processus de réconciliation. Si vous poursuivez, les conflits existants issus des sessions précédentes seront perdus lors de l’exécution de l’outil. Ce paramètre s’applique uniquement au versionnement de branche. PROCEED—Le processus de réconciliation a lieu si des conflits existants non examinés sont détectés. Il s’agit de l’option par défaut. NOT_PROCEED—Le processus de réconciliation n’a pas lieu si des conflits existants non examinés sont détectés.	Boolean
reconcile_checkout_versions (Facultatif)	Indique si le processus de réconciliation inclut les versions des réplicas d’extraction. Si vous créez un réplica d’extraction dans le cadre d’un processus de réplication de géodatabase, une version associée est créée dans la géodatabase. Cette option vous permet d’inclure ou de retirer ces types de versions de la liste des versions à réconcilier. Ce paramètre ne s’applique pas au versionnement de branche. RECONCILE—Le processus de réconciliation inclut les versions des réplicas d’extraction. Il s’agit de l’option par défaut. DO_NOT_RECONCILE—Le processus de réconciliation n’inclut pas les versions des réplicas d’extraction.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_workspace	Espace de travail en entrée mis à jour.	Workspace

Exemple de code

Exemple d’utilisation de l’outil ReconcileVersions (script autonome)

Le script autonome suivant montre comment utiliser l’outil ReconcileVersions pour réconcilier toutes les versions que l’utilisateur spécifié possède dans le fichier de connexion à une base de données.

# Name: ReconcileVersions.py
# Description: Reconciles all versions owned by a user with SDE.Default

# Import system modules
import arcpy, os

# Set workspace
workspace = 'C:/Data/connections/[e-mail]'

# Set the workspace environment
arcpy.env.workspace = workspace

# Use a list comprehension to get a list of version names where the owner
# is the current user and make sure sde.default is not selected.
verList = [ver.name for ver in arcpy.da.ListVersions() if ver.isOwner
           == True and ver.name.lower() != 'sde.default']

arcpy.ReconcileVersions_management(workspace,
                                   "ALL_VERSIONS",
                                   "SDE.Default",
                                   verList,
                                   "LOCK_ACQUIRED",
                                   "NO_ABORT",
                                   "BY_OBJECT",
                                   "FAVOR_TARGET_VERSION",
                                   "NO_POST",
                                   "KEEP_VERSION",
                                   "c:\RecLog.txt")
print('Reconciling Complete')

Environnements

Espace de travail courant

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui