Collaborer sur une application

Lorsque vous partagez votre application dans une organisation, les membres de l'organisation peuvent voir l'application dans ArcGIS AppStudio et la télécharger. Ils peuvent ensuite effectuer une copie de l'application et la traiter comme la leur, mais ils ne peuvent pas mettre à jour votre instance de l'application. Pour collaborer avec un collègue et mettre à jour la même application, vous devez d'abord partager votre application avec un groupe qui autorise la collaboration.

Créer un groupe de collaboration ArcGIS

Seul un administrateur d’une organisation peut créer un groupe de collaboration.

Remarque :

Seul l'administrateur d'une organisation peut activer cette fonctionnalité au sein d'un groupe et détenir des groupes bénéficiant de cette fonctionnalité. Seuls les membres de la même organisation peuvent appartenir à un groupe de collaboration. Le groupe doit être nouveau ; la capacité de mise à jour d'éléments ne peut pas être ajoutée à un groupe existant.

Pour créer un groupe de collaboration, procédez comme suit :

  1. Connectez-vous avec votre compte d'administrateur de l'organisation.
  2. Choisissez Groupes.
  3. Choisissez Créer un groupe.
  4. Attribuez un nom, un résumé, une description et des balises au groupe et joignez une miniature.
  5. Dans la section Statut, choisissez Les membres peuvent mettre à jour tous les éléments de ce groupe.
  6. Dans la section Contributeurs, choisissez Membres.
  7. Cliquez sur Save (Enregistrer).

Un nouveau groupe est créé. Vous pouvez maintenant sélectionner ce groupe et inviter des utilisateurs, ou partager le groupe. Les membres du groupe peuvent ajouter des applications pour la collaboration et mettre à jour des applications que d'autres membres ont ajoutées au groupe depuis AppStudio.

Ajouter votre application à un groupe de collaboration ArcGIS

Les membres de groupes de collaboration peuvent ajouter des applications pour travailler dessus avec leurs collègues.

Pour ajouter une application à un groupe de collaboration, procédez comme suit :

  1. Connectez-vous à ArcGIS Online en tant que membre du groupe.
  2. Choisissez Mon contenu.
  3. Cochez la case en regard de l'application sur laquelle vous voulez collaborer.
  4. Dans le menu Share (Partager), sélectionnez Access and update capabilities (Accéder aux fonctionnalités et les mettre à jour).
    Choisir Access and update capabilities (Accéder aux fonctionnalités et les mettre à jour)
  5. Dans la liste des groupes de collaboration, choisissez celui avec lequel vous voulez partager l'élément et cliquez sur OK.

Votre application est maintenant partagée avec ce groupe de collaboration.

Tous les membres du groupe peuvent mettre à jour l’élément, indépendamment des privilèges liés à leur rôle. Ils peuvent toutefois effectuer d’autres actions non incluses dans leurs privilèges. Par exemple, s'ils ne disposent pas des privilèges appropriés pour créer du contenu, ils ne peuvent pas enregistrer un élément qu'ils mettent à jour. Lorsqu'une personne modifie une application et la met à jour, la propriété signalée de l'élément est transférée vers cette personne. Lorsque vous mettez à jour et actualisez ensuite l’application, vous devenez le propriétaire signalé. Seul le propriétaire (ou l'administrateur) de l'élément peut effectuer les actions suivantes sur l'élément : suppression, partage, déplacement, changement de propriétaire, modification de la protection contre la suppression, publication et enregistrement d'une application.

Collaborer sur une application via les systèmes de contrôle des versions

Pour accéder à des outils de collaboration plus complets, tels que l'historique des modifications, le suivi des problèmes et l'association des problèmes avec les modifications, vous pouvez configurer votre application de façon à utiliser un système de contrôle des versions. Bien que cette section se concentre sur l'utilisation de Git, d'autres systèmes de contrôle des versions sont disponibles. Ceci est pris en charge par Qt Creator.

Pour préparer, créer et utiliser une application avec GitHub, procédez comme suit.

Remarque :

Un compte GitHub est nécessaire.

  1. Téléchargez les outils Git.

    Ces outils doivent déjà être présents sur les appareils macOS et certains appareils Linux, mais ils doivent être téléchargés pour Windows.

  2. Ouvrez Qt Creator à l’aide du bouton Edit (Mise à jour) du volet latéral de AppStudio Desktop.
  3. Dans Qt Creator, ouvrez le menu Tools (Outil) et cliquez sur Options. Cliquez sur Version Control (Contrôle des versions), et sur l’onglet Git, indiquez le chemin d’accès à l’application Git, par exemple, C:\Program Files\Git\bin. Vérifiez que la case Set HOME environment variable (Définir la variable d’environnement HOME) est cochée pour que l’autorisation recherche les clés SSH dans l’emplacement utilisé par Git Bash.
  4. Cette étape n’est pas possible ou nécessaire sur macOS, car l’intégration Git est configurée automatiquement.
  5. Créez votre application AppStudio comme d'habitude.
  6. Dans GitHub, créez un nouveau référentiel pour l’application. Il est recommandé, mais pas obligatoire, d'utiliser le même nom pour l'application et le référentiel.
  7. Clonez le référentiel sur votre ordinateur de bureau à l’aide de votre programme et méthode de prédilection. Vous pouvez éventuellement cloner le référentiel dans votre dossier ~ArcGIS/Apps. Dans ce cas, vous ne conservez qu’une seule copie de l’application sur votre ordinateur. Vérifiez que l’application que vous exécutez et testez dans AppStudio est la même que celle que vous gérez avec Git.
  8. À l’origine, ce référentiel est vide.
  9. Déplacez (ou copiez) tous les fichiers du dossier de votre application dans le dossier racine du référentiel.
  10. Créez un fichier nommé .gitignore et ajoutez-le au dossier racine du référentiel. Ce fichier contient une liste de fichiers que Git doit ignorer lors du contrôle des modifications. Les fichiers à inclure sont .info.json, *.user, *.qmlc et *.jsc.

Vous pouvez maintenant utiliser les outils Git de votre choix avec votre application, tout en validant régulièrement les modifications dans votre référentiel. Utilisez les problèmes pour suivre les caractéristiques et les changements. Vous pouvez également suivre la progression du développement de votre application. Vous pouvez également utiliser ces outils dans Qt Creator dans le menu Tools (Outils) > Git.

Il est recommandé de réaliser une insertion unique des fichiers appinfo.json et iteminfo.json dans votre référentiel chaque fois que vous mettez à jour l’élément ArcGIS Online pour votre application. Le référentiel est ainsi maintenu à jour avec le numéro de version, le nombre de vues et les commentaires de l’élément en ligne. Vous pouvez utiliser la numérotation des versions pour suivre les mises à jour dans le référentiel par rapport aux versions de votre application qui ont été partagées avec d’autres.

Pour plus d'informations sur l'utilisation de GitHub, reportez-vous aux guides et à l'aide de GitHub.