L'aggiunta di un riferimento URL a un'app esistente è un metodo efficace per condividere il lavoro con i membri dell'organizzazione e il pubblico (a seconda dei privilegi di condivisione). Oltre all'URL, è possibile condividere altri dettagli, ad esempio il tipo dell'app, il relativo scopo, un riepilogo e una descrizione, nonché un file .zip con il codice utilizzato per crearla. Aggiungendo un'app a ArcGIS Online viene aggiunto solamente un riferimento all'URL dell'app; ArcGIS Online non memorizza i file dell'app.
Gli sviluppatori di app che dispongono di un account dell'organizzazione possono inoltre registrare le app con la piattaforma. Il processo include la registrazione di un'applicazione OAuth in modo che i membri dell'organizzazione e gli utenti esterni possano accedere all'app. Per ulteriori informazioni, consultare la sezione Aggiungere e registrare un'app usando le credenziali di sviluppatore.
Se non è necessario registrare l'app, ad esempio quando si carica un campione di codice, seguire i passaggi riportati nella sezione Aggiungere un'app da un URL seguente.
Suggerimento:
Un altro modo per condividere le app con i membri dell'organizzazione e il pubblico consiste nel creare app con mappe e app galleria con gruppi.
Aggiungi un'app da un URL
Segui questa procedura per aggiungere un elemento che utilizza un URL per l'accesso a un'app sul Web ma che non necessita di essere registrata (ad esempio i campioni di codice):
Nota:
Per aggiungere un'app registrata, seguire i passaggi per aggiungere e registrare un'app usando credenziali sviluppatore.
- Verificare di avere effettuato l'accesso e di disporre dei privilegi per creare contenuti.
- Dalla scheda I miei contenuti della pagina dei contenuti, fare clic su Nuovo elemento, quindi fare clic su Applicazione.
- Scegliere il tipo di app:
- Mappatura Web - Un'app Web creata con un'API Web, ad esempio JavaScript.
- Desktop: un app per desktop creata su una piattaforma desktop, ad esempio Java o .NET (Desktop Microsoft Windows).
- Mobile: un'applicazione scaricabile creata per dispositivi mobili con un SDK, come iOS o Android.
- Altra applicazione: un'applicazione desktop, script Python o qualunque tipo di app generica per cui non si dispone dei dettagli su API, SDK, indirizzo URL o scopo dell'applicazione.
- Per il mapping web, desktop o mobile, digitare l'URL dell'app, per esempio,https://<myServer>/myWebMapApp.
- Per le app desktop, fare clic su Sfoglia e scegliere il .zip file che contiene l'app.
- Fare clic su Avanti.
- Digitare il titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
- Se la propria organizzazione ha configurato categorie di contenuti, fare clic su Assegna categorie e selezionare fino a 20 categorie in modo che le persone possano individuarle facilmente.
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole, ad esempio Parco nazionale è un tag, mentre Parco, nazionale sono due tag.
Mentre si digita, è possibile selezionare uno qualsiasi dei tag suggeriti che vengono visualizzati; i suggerimenti vengono generati dai tag aggiunti in precedenza.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- Fare clic su Salva.
Quando l'app viene aggiunta, appare nei tuoi contenuti. Se è necessario registrarla in un secondo momento, è possibile farlo dalla scheda Impostazioni della pagina elemento dell'app. Per ulteriori informazioni, consultare la sezione Aggiungere e registrare un'app utilizzando le credenziali di sviluppatore.
È possibile configurare i dettagli dell'elemento, allegare codice se necessario e condividere l'app se si dispone di privilegi di condivisione.
Aggiungere e registrare un'app utilizzando le credenziali dello sviluppatore
Gli sviluppatori di app che dispongono di un account aziendale possono aggiungere e registrare l'app con la piattaforma per generare un ID app. Utilizzare l'ID app per raccogliere statistiche sull'utilizzo e consentire agli utenti di effettuare l'accesso alla piattaforma con OAuth 2.0, un framework di autorizzazione standardizzato. Con OAuth 2.0, le app guidano l'utente ad accedere alla piattaforma tramite una pagina login ospitata dalla piattaforma. Consente inoltre all'app di utilizzare i contenuti dell'utente associati alla relativa organizzazione, nonché di sfruttare altre ArcGIS Online funzionalità quali la geocodifica, il routing e il GeoEnrichment. Per scoprire di più sull'autenticazione e OAuth 2.0, vedere ArcGIS Developer.
Nota:
Lo schema di implementazione per l'accesso degli utenti varia lievemente a seconda che tu stia sviluppando un'app basata sul web o un'app nativa. La documentazione di ArcGIS Developer include dettagli ed esempi di codice per applicazioni sia basate sul web che native.
- Verificare di avere effettuato l'accesso con un account dell'organizzazione e di disporre dei privilegi per creare contenuti.
- Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
- Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
- In URL di reindirizzamento, inserire l'URL di una pagina Web o endpoint server che verrà utilizzato per reindirizzare gli utenti dopo aver completato l'accesso. Fare clic su Aggiungi per aggiungere altri URL di reindirizzamento se necessario.
Gli URL di reindirizzamento specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione verrà negata.
Può essere specificato il valore speciale urn:ietf:wg:oauth:2.0:oob per garantire le autorizzazioni. Ciò consente di consegnare il codice di autorizzazione a un URL del portale (/oauth2/approval). Questo valore viene tipicamente utilizzato dalle app che non dispongono di un server Web o uno schema URL personalizzato in cui il codice può essere consegnato.
Di seguito sono riportati alcuni esempi di formati di URL di reindirizzamento supportati:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- In Ambiente applicazione, scegliere un'ambiente applicazione per l'app: Multiplo, Nativo, Browser o Server.
- Nella casella URL, digitare un URL per l'app nel formato https://<myServer>/myWebMapApp.
- Fare clic su Avanti.
- Digitare il titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
- Se la propria organizzazione ha configurato categorie di contenuti, fare clic su Assegna categorie e selezionare fino a 20 categorie in modo che le persone possano individuarle facilmente.
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole, ad esempio Parco nazionale è un tag, mentre Parco, nazionale sono due tag.
Mentre si digita, è possibile selezionare uno qualsiasi dei tag suggeriti che vengono visualizzati; i suggerimenti vengono generati dai tag aggiunti in precedenza.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- Fare clic su Salva.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. È possibile configurare i dettagli dell'elemento, allegare codice se necessario e condividere l'app se si dispone di privilegi di condivisione.
Dalla scheda Impostazioni della pagina elemento dell'app, è possibile visualizzare le informazioni di registrazione, che includono l'ID app (Client ID), un segreto app (Client Secret) e gli ambienti dell'applicazione. È anche possibile aggiornare l'URL dell'origine dati o gli URL di reindirizzamento, reimpostare il segreto, annullare la registrazione dell'app o copiare o rinnovare il token temporaneo dell'app.
Nota:
La reimpostazione del segreto dell'app renderà nulli tutti i token utente e app esistenti emessi per l'app. Gli utenti dovranno accedere nuovamente all'app e potrebbe essere necessario aggiornare le app configurate con il segreto.
Dalla scheda Utilizzo della pagina elemento, è possibile visualizzare le informazioni d'utilizzo su chi ha effettuato l'accesso all'app e il numero di crediti che hanno consumato.