Gérer les versions de branche

Vous pouvez manipuler et gérer des versions de branche à l’aide de plusieurs outils de ArcGIS Pro. La vue Versions affiche toutes les versions et leurs propriétés dans un service d’entités donné. Grâce aux éléments du ruban et au menu contextuel, vous pouvez créer des versions, modifier les propriétés des versions, supprimer des versions, ainsi que réconcilier et réinjecter des mises à jour entre les versions.

L’image ci-dessous affiche le vue Versions et son ruban. Dans cette vue, vous pouvez voir que l’utilisateur Jon a créé une version nommée appelée Weddington et a défini l’option Access (Accès) sur Public.

Nouvelle version créée avec la vue Versions

Accès aux versions

Pour gérer des versions de branche, accédez à une couche d’entités web à partir de votre connexion au portail ArcGIS Enterprise. La fonctionnalité Version Management (Gestion des versions) du service d’entités sous-jacent de la couche d’entités Web doit être activée. L’accès aux versions est basé sur une combinaison des privilèges de l’utilisateur actif du portail et de l’autorisation d’accès à la version.

Remarque :
Les versions de branche ne sont disponibles que dans la service d’entités dans lequel elles ont été créées.

Privilèges de l’utilisateur du portail

Pour le versionnement de branches, la propriété de la version est basée sur l’utilisateur actif du portail. Les privilèges de l’utilisateur du portail déterminent également les versions que l’utilisateur peut consulter, mettre à jour et gérer.

  • L’utilisateur du portail connecté peut consulter, mettre à jour et gérer les versions de branche dont il est le propriétaire.
  • L’utilisateur du portail connecté peut consulter toutes les versions de branche publiques et protégées.
  • L’utilisateur du portail connecté peut consulter et mettre à jour toutes les versions de branche publiques.
    Remarque :

    Pour mettre à jour les versions de branche, l’utilisateur du portail doit se voir attribuer un rôle ayant le privilège de mise à jour.

Administrateur de versions

Certains utilisateurs du portail peuvent agir comme administrateur des versions pour les versions de branche dans un service d’entité. L’administrateur des versions peut consulter, mettre à jour et gérer les versions de branche pour le service d’entités, indépendamment du propriétaire de la version ou de l’autorisation d’accès.

Les utilisateurs du portail suivants sont considérés comme administrateurs des versions d’un service d’entité :

  • Le propriétaire de la couche d’entités Web (généralement l’utilisateur qui a publié le service d’entité)
  • Un utilisateur du portail qui s’est vu attribuer le rôle Administration
  • Un utilisateur du portail qui se voit attribuer un rôle personnalisé disposant du privilège Manage all (Gérer tout)

Remarque :
Lors de l’accès à la vue Versions depuis une connexion à la base de données en tant qu’administrateur de géodatabase, les versions de tous les services qui accèdent aux jeux de données dans la géodatabase sont répertoriées. L’administrateur de géodatabase peut consulter les versions de branche, modifier les propriétés des versions et supprimer les versions de branche dans la vue Versions.

Autorisation d’accès

Le niveau d’accès d’une version est défini afin qu’elle ne puisse pas être modifiée ni affichée par des utilisateurs autres que le propriétaire de la version. Vous avez le choix entre les niveaux d’autorisations suivants pour les versions :

  • Private (Privé) : seul le propriétaire ou l’administrateur de version peut afficher ou modifier la version.
  • Protected (Protégé) : tout utilisateur peut afficher la version, mais seul le propriétaire ou l’administrateur de version peut mettre à jour la version.
  • Public : n’importe quel utilisateur peut afficher et mettre à jour la version.

Lorsque vous définissez les autorisations d'accès aux versions, tenez compte de la stratégie de workflow de votre version ainsi que des besoins des différents utilisateurs de la structure. Utilisez les autorisations d’accès aux versions et les privilèges des utilisateurs du portail pour contrôler l’accès aux données.

Ouvrir la vue des versions

Vous pouvez ouvrir la vue Versions pour les données de votre carte active à partir de la fenêtre Contents (Contenu).

  1. Cliquez sur le bouton List By Data Source (Répertorier par source de données) dans la fenêtre Contents (Contenu).
    Fenêtre Répertorier par source de données de la fenêtre Contenu
  2. Cliquez avec le bouton droit sur la source de données de la couche d’entités Web serveur ArcGIS et sélectionnez Manage Versions (Gérer les versions) Gestionnaire de versions.

    La vue Versions s’affiche.

  3. Les boutons suivants sont disponibles dans le groupe Manage Versions (Gérer les versions). Vous pouvez aussi cliquer avec le bouton droit sur la vue de la grille pour accéder à ces commandes.

    Remarque :
    De nombreuses commandes dépendent des versions sélectionnées dans la vue de la grille.
    • New (Nouveau) Nouvelle version : permet de créer une version nommée.
    • Delete (Supprimer) Supprimer : permet de supprimer une version.
    • Restore (Restaurer) Annuler : permet de restaurer une version supprimée avant une opération d’enregistrement.
    • Reconcile/Post (Réconcilier/Réinjecter) Réconcilier et réinjecter : permet de réconcilier et de réinjecter des versions.
    • Save (Enregistrer) Enregistrer les mises à jour : permet d’enregistrer les modifications.

    La vue Versions contient les propriétés suivantes pour les versions de branche :

    Propriété de versionDescription

    Nom

    Nom de la version.

    Propriétaire

    Propriétaire de la version.

    Parent

    Parent de la version actuelle.

    Description

    Texte descriptif de la version.

    Accéder

    Niveau d’autorisation d’accès pour la version (public/privé/protégé).

    Date de création

    Date et heure (UTC) de création de la version.

    Date de modification

    Date et heure (UTC) de la dernière modification de la version. Les versions nouvellement créées héritent de l’heure de modification de la version parent.

    Pour les versions de branche, cela comprend des opérations telles que la mise à jour, la réconciliation et la réinjection.

    Réconciliée

    Date et heure (UTC) de la dernière opération de réconciliation. Si la version n’a jamais été réconciliée ou si elle n’a pas appelé la réconciliation depuis la dernière opération de réinjection, cette colonne est vide.

    Cette propriété est disponible uniquement pour les versions de branche.

    Validés

    Date et heure (UTC) de la dernière évaluation des règles de géodatabase pour la version avec l’option Modified in this branch (Modifié dans cette branche) définie sur true (vrai). Cette propriété est vide si l’outil Evaluate Rules (Évaluer les règles) n’a jamais été appelée sur la version.

    Cette propriété est disponible uniquement pour les versions de branche.

    Service

    Nom du service d’entités pour la version de branche.

    Cette propriété n’est disponible que pour les versions de branche dont l’accès se fait via une connexion à une base de données avec le paramètre Versioning Type (Type de versionnement) défini sur Branch (Branche).

    Propriétés des versions de branche dans la vue Versions

Rechercher, filtrer ou actualiser les versions disponibles dans la vue des versions

Pour retrouver et modifier une version spécifique de la géodatabase d’entreprise ou de la connexion au portail, vous pouvez filtrer les versions par propriétaire, rechercher le nom d’une version spécifique ou actualiser la vue.

Pour filtrer les versions listées dans la vue Versions par propriétaire, cliquez sur la flèche de la liste déroulante Owner (Propriétaire) dans le groupe Filter Versions (Filtrer les versions) sur le ruban Versions. La liste déroulante affiche les utilisateurs propriétaires d’une version. Sélectionnez un nom de propriétaire dans la liste déroulante ; la vue Versions n’affiche que les versions appartenant à cet utilisateur. Pour effacer le filtre et afficher les versions appartenant à tous les utilisateurs, sélectionnez la valeur vide en haut de la liste déroulante.

Pour rechercher une version par nom de version, utilisez la zone de recherche Name (Nom) dans le groupe Filter Versions (Filtrer les versions) sous l’onglet Versions. Au fur et à mesure que vous saisissez du texte, seules les versions avec texte correspondant s’affichent dans la vue Versions.

Cliquez sur Refresh Versions (Actualiser les versions) dans le groupe Filter Versions (Filtrer les versions) sous l’onglet Versions pour actualiser la vue et afficher les informations les plus récentes sur toutes les versions.

Modifier les propriétés d'une version

Le propriétaire de la version ou l’administrateur de version peut modifier les propriétés des versions existantes en utilisant la vue Versions.

Les propriétés de version suivantes peuvent être modifiées :

  • Nom
  • Propriétaire
  • Description
  • Accéder

Pour modifier les propriétés d’une version existante, procédez comme suit :

  1. Ouvrez la vue Versions.
  2. Double-cliquez sur la colonne de la propriété à modifier.
    Remarque :

    Pour modifier les propriétés Name (Nom) or Owner (Propriétaire), il ne doit y avoir aucune connexion active à la version.

  3. Cliquez sur Save (Enregistrer) Enregistrer les mises à jour dans l’onglet Versions.

Protéger la version par défaut

La version par défaut, ancêtre de toutes les versions d’une géodatabase, et la version qui est publiée pour les jeux de données faisant partie d’une branche versionnée.

Si vous avez choisi une règle selon laquelle personne ne peut mettre directement à jour la version par défaut, l’administrateur de géodatabase doit définir le niveau d’accès à la version par défaut comme étant protected (protégé). Si l’accès est protected (protégé), tous les utilisateurs peuvent afficher la version par défaut, mais seul l’administrateur de versions peut mettre directement à jour la version et réinjecter les modifications apportées à d’autres versions.

Pour définir la version par défaut sur le mode protected (protégé), une connexion à une base de données établie pour l’administrateur de géodatabase doit être utilisée. Suivez les étapes ci-dessus en utilisant la vue Versions pour modifier les propriétés de la version par défaut. L’outil de géotraitement Alter Version (Modifier une version) peut également être utilisé.

Gérer les versions de réplica

Une nouvelle version de la géodatabase (appelée version réplica lorsque vous utilisez des processus hors connexion) est automatiquement créée chaque fois que vous téléchargez et mettez hors connexion une carte contenant un service d’entités modifiables qui est publié avec l’option Create a version for each downloaded map (Créer une version pour chaque carte téléchargée) activée. Lorsqu’un client synchronise les mises à jour vers le service d’entités, les mises à jour du client sont appliquées à la nouvelle version. Pour plus d’informations sur l’utilisation de cette option, reportez-vous à la rubrique Cartes en mode hors connexion et données de branche versionnée.

Versions réplica dans la vue Versions

Toutes les versions de réplica sont visibles et peuvent être gérées dans la vue Versions. Pour enregistrer les mises à jour de la version de réplica dans la version par défaut et les partager avec d’autres, cliquez avec le bouton droit sur la version de réplica dans la vue Versions pour réconcilier et réinjecter les mises à jour dans la version par défaut. Pour en savoir plus sur un processus automatisé qui valide, réconcilie et réinjecte les versions de réplica, reportez-vous à la rubrique Automatiser les opérations de réconciliation et de réinjection pour les données pour lesquelles la synchronisation est activée.

Pour garantir son unicité, le nom de la version de réplica inclut les éléments suivants :

  • le nom du compte de portail qui télécharge la carte ;
  • le nom du service d'entités ;
  • un identifiant unique (ID).

Remarque :
Si vous essayez de supprimer une version utilisée par une carte hors connexion, un message d’erreur s’affiche indiquant qu’elle est en cours d’utilisation. Une fois que la carte hors connexion n’est plus nécessaire, la suppression de la carte hors connexion du projet désinscrit automatiquement le réplica et permet de supprimer la version de réplica. Vérifiez toutes les mises à jour apportées à la version de réplica et, si elles sont valables, réconciliez et réinjectez les mises à jour dans la version par défaut avant de supprimer la version de réplica. Toute mise à jour qui n’a pas été réconciliée et réinjectée vers la version par défaut sera perdue lors de la suppression de la version de réplica.

Pour plus d’informations sur cette configuration, reportez-vous à cet exemple détaillé de processus de synchronisation avec une version de réplica.