Collaborare a un'app

Condividendo l'app con un'organizzazione, i suoi membri possono visualizzarla in ArcGIS AppStudio e scaricarla. In seguito, potranno quindi eseguire una copia dell'app e impiegarla come desiderano; tuttavia non potranno modificare l'istanza dell'app dell'utente che la ha condivisa. Per collaborare con un collega e modificare la stessa app, occorre anzitutto condividerla con un gruppo che consenta la collaborazione.

Creare un gruppo di collaborazione ArcGIS

I gruppi di collaborazione possono essere creati solo da un amministratore di un'organizzazione.

Nota:

Solo l'amministratore di un'organizzazione possono abilitare questa funzionalità su un gruppo ed essere proprietario di gruppi con tale funzionalità. Solo i membri della stessa organizzazione possono appartenere a un gruppo di collaborazione. Il gruppo deve essere nuovo; la funzionalità di aggiornamento degli elementi non può essere aggiunta a un gruppo esistente.

Per creare un gruppo di collaborazione, procedere come segue:

  1. Accedere con le credenziali di amministratore dell'organizzazione.
  2. Selezionare Gruppi.
  3. Selezionare Crea gruppo.
  4. Immettere nome, riepilogo, descrizione e i tag per il gruppo, quindi allegare un'anteprima.
  5. Nella sezione Stato, selezionare I membri possono aggiornare tutti gli elementi di questo gruppo.
  6. In Collaboratori, selezionare Membri.
  7. Fare clic su Salva.

Il nuovo gruppo è stato creato. È ora possibile selezionare tale gruppo e invitare utenti o condividere il gruppo. Qualsiasi membro del gruppo può aggiungere app per la collaborazione e aggiornare le app aggiunte al gruppo da altri membri mediante AppStudio.

Aggiungere l'app a un gruppo di collaborazione ArcGIS

I membri dei gruppi di collaborazione possono aggiungere app su cui collaborare con i propri colleghi.

Per aggiungere un'app a un gruppo di collaborazione, attenersi alla procedura seguente:

  1. Accedere ad ArcGIS Online come membro del gruppo.
  2. Selezionare I miei contenuti.
  3. Spuntare la casella accanto all'app su cui si desidera collaborare.
  4. Dal menu Condividi, selezionare Funzionalità di accesso e di aggiornamento.
    Selezionare Funzionalità di accesso e di aggiornamento
  5. Dall'elenco dei gruppi di collaborazione, selezionare il gruppo con cui si desidera condividere il componente, quindi fare clic su OK.

L'app è ora condivisa con quel gruppo di collaborazione.

Tutti i membri del gruppo possono aggiornare gli elementi indipendentemente dai privilegi del loro ruolo. Tuttavia, non possono effettuare altre azioni fuori dall'ambito dei loro privilegi. Ad esempio, se non dispongono di privilegi per creare contenuti, non possono salvare un elemento da loro aggiornato. Se qualcuno modifica un'app e la aggiorna, la proprietà indicata per quell'elemento passerà a quella persona. Quando un altro utente modificherà e aggiornerà nuovamente l'app, il proprietario indicato sarà quell'utente. Solo il proprietario (o amministratore) dell'elemento può eseguire le seguenti azioni: eliminazione, condivisione, spostamento, modifica della proprietà, modifica della protezione contro l'eliminazione, pubblicazione e registrazione di un'app.

Collaborare a un'app mediante i sistemi di controllo delle versioni

Per accedere a strumenti di collaborazione più completi, quali cronologia delle modifiche, monitoraggio dei problemi e associazione di problemi a modifiche, è possibile configurare l'app per utilizzare un determinato sistema di controllo versioni. Questa sezione è dedicata all'impiego di Git, tuttavia sono disponibili anche altri sistemi di controllo versioni. È supportato da Qt Creator.

Per preparare, creare e modificare un'app con GitHub, attenersi alla seguente procedura.

Nota:

È necessario disporre di un account GitHub.

  1. Scarica strumenti Git.

    Questi strumenti dovrebbero già essere disponibili su dispositivi macOS e alcuni dispositivi Linux; devono invece essere scaricati per Windows.

  2. Aprire Qt Creator, utilizzando il pulsante Modifica nel pannello laterale di AppStudio Desktop.
  3. In Qt Creator, aprire il menu Strumenti e fare clic su Opzioni. Fare clic su Controllo versioni e, sulla scheda Git, fornire il percorso file alla posizione dell'applicazione Git, ad esempio, C:\Program Files\Git\bin. Assicurarsi che la casella di testo Imposta variabile ambiente HOME sia selezionata per controllare l'autorizzazione a cercare chiavi SSH nella stessa posizione utilizzata da Git Bash.
  4. Questa operazione non è possibile né necessaria su macOS; è invece configurata automaticamente per l'integrazione Git.
  5. Creare l'app AppStudio come di consueto.
  6. In GitHub, creare un nuovo archivio per l'app. Sebbene non sia necessario, si consiglia di usare lo stesso nome per l'app e il relativo archivio.
  7. Clonare l'archivio sul PC impiegando il programma e il metodo preferiti. Facoltativamente, è possibile scegliere di clonare l'archivio sulla cartella ~ArcGIS/Apps. Ciò significa che si mantiene una sola copia dell'app sul computer. Assicurarsi che l'app eseguita e testata AppStudio sia la stessa app gestita con Git.
  8. Inizialmente, l'archivio è vuoto.
  9. Spostare (o copiare) tutti i file dalla cartella dell'app nella cartella radice dell'archivio.
  10. Creare un file denominato .gitignore e aggiungerlo alla cartella principale dell'archivio. Questo file contiene un elenco di file che Git dovrebbe ignorare quando si esegue il controllo delle modifiche. I file da includere sono .info.json, *.user, *.qmlc e *.jsc.

È ora possibile lavorare sull'app utilizzando gli strumenti Git prescelti, effettuando al contempo il commit periodico delle modifiche all'archivio. Impiegando i problemi per monitorare specifiche e modifiche, sarà possibile monitorare il progresso compiuto nello sviluppo dell'app. È inoltre possibile utilizzare questi strumenti in Qt Creator nel menu Strumenti > Git.

Si consiglia di effettuare un singolo check-in dei file appinfo.json e iteminfo.json sull'archivio dopo ogni aggiornamento dell'elemento ArcGIS Online per l'app. Ciò mantiene l'archivio aggiornato con il numero di versione, il numero di visualizzazioni e i commenti dell'elemento online ed è possibile utilizzare la numerazione delle versioni per tenere traccia delle modifiche nell'archivio rispetto alle versioni dell'app condivise con altri.

Per ulteriori informazioni sull'impiego di GitHub, consultare le guide di GitHub.