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, aggiornare ed eliminare 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.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- 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 Terra federale è considerato un tag mentre Terra, federale 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 sua organizzazione nonché di sfruttare altre funzionalità di ArcGIS Online quali la geocodifica, il routing e GeoEnrichment. Per scoprire di più sull'autenticazione e OAuth 2.0, vedere Esri Developer.
In alternativa, è possibile integrare una chiave API nell'app al momento della registrazione.
Il tipo di credenziali sviluppatore che possono essere incluse nell'app dipende dai propri privilegi nell'organizzazione. Se si è membri del ruolo amministratore predefinito o del ruolo personalizzato con il privilegio di generare chiavi API, è possibile utilizzare una credenziale OAuth 2.0 o di chiave API nell'app. Altrimenti è possibile utilizzare solo le credenziali sviluppatore OAuth 2.0.
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 Esri Developer include dettagli ed esempi di codice per applicazioni sia basate sul web che native.
Aggiungere e registrare un'app con credenziali OAuth 2.0 incorporate
Quando si utilizzano le credenziali OAuth 2.0 con le app create, il token per accedere è generato in modo dinamico all'accesso dell'app. Il token di accesso è valido per un massimo di 14 giorni.
Procedere come indicato nei passaggi seguenti se il proprio ruolo non comprende il privilegio per creare chiavi API.
- Verificare di avere effettuato l'accesso con un account aziendale con privilegio per creare, aggiornare ed eliminare 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.
- Scegliere l'opzione Credenziali OAuth 2.0 e fare clic su Avanti.
- 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 URL referrer, inserire un'URL o l'indirizzo IP a cui è consentito connettersi. Fare clic su Aggiungi per aggiungere altri URL referrer o indirizzi IP in base alle necessità.
- 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.
Se si è membri di un ruolo con il privilegio di assegnare privilegi ad applicazioni OAuth 2.0, facendo clic su Avanti si passa a una finestra dove è possibile definire ciò che l'app potrà effettuare. Se non si è possesso di questo privilegio continuare con il passaggio 12.
- Scegliere quali azioni l'app potrà svolgere in virtù delle credenziali assegnando i privilegi e facendo clic su Avanti.
L'elenco dei privilegi disponibili varia in funzione del possesso o meno di un abbonamento ad ArcGIS Location Platform e dei privilegi che si possiede nell'organizzazione. Non è possibile garantire privilegi che il proprio account non possiede.
Per informazioni sui tipi di privilegi, fare riferimento alla guida sulla sicurezza e autenticazione nella guida per sviluppatori di Esri.
- Fare clic su Sfoglia elementi e scegliere a quali elementi le credenziali integrate consentiranno l'accesso e fare clic su Aggiungi elementi.
In alternativa, è possibile fare clic su Salta.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- 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 Terra federale è considerato un tag mentre Terra, federale 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 Avanti.
- Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento.
- Se sono stati concessi privilegi personali per le credenziali, selezionare la casella accanto alla notifica sulla sicurezza per confermare di averla letta e accettata e fare clic su Crea per creare le credenziali.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge 
indicante che le credenziali OAuth 2.0 sono utilizzate con l'app appare sulla pagina dell'elemento e quando l'elemento è visualizzato dalla pagina contenuti o dal riquadro anteprima elemento. Nella scheda Panoramica della pagina dell'elemento, il badge indica se i privilegi personali sono inclusi o se solo i privilegi standard sono inclusi nelle credenziali.
È possibile configurare i dettagli dell'elemento per l'app.
Fare clic su Visualizza utilizzo nella scheda Impostazioni per visualizzare le informazioni riguardanti gli utenti che hanno effettuato l'accesso all'app e il numero di crediti che hanno consumato.
Nota:
La sezione Visualizza utilizzo non è disponibile quando si accede con un abbonamento ad ArcGIS Location Platform.
È inoltre possibile gestire le impostazioni per le credenziali incorporate nell'app.
Aggiungere e registrare un'app con credenziali chiave API incorporate
Utilizzare le credenziali chiave API se è necessario incorporare le credenziali nell'app e se la chiave deve essere valida per un periodo superiore ai 14 giorni.
Procedere come indicato nei passaggi che seguono per aggiungere un'app e creare una chiave API incorporata in essa da usare per scopi di autenticazione.
- Verificare di avere effettuato l'accesso con un account aziendale e di disporre dei privilegi per creare chiavi API e creare, aggiornare ed eliminare 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.
- Scegliere l'opzione credenziali chiave API e fare clic su Avanti.
- Utilizzare il calendario per indicare la data in cui scadranno le credenziali.
Le credenziali possono scadere l'indomani (minimo) o dopo 365 giorni (massimo). Scadono alle 23:59 della data del giorno scelto per la scadenza. L'ora è salvata in base all'ora del browser quando aggiungi l'app e generi le credenziali.
- In URL referrer, inserire un'URL o l'indirizzo IP a cui è consentito connettersi. Fare clic su Aggiungi per aggiungere altre URL referrer o indirizzi IP:
Gli URL specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione verrà negata.
Di seguito sono riportati alcuni esempi di formati di URL referrer supportati:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Fare clic su Avanti.
- Scegliere quali azioni l'app potrà svolgere in virtù delle credenziali assegnando i privilegi e facendo clic su Avanti.
L'elenco dei privilegi disponibili varia in funzione del possesso o meno di un abbonamento ad ArcGIS Location Platform e dei privilegi che si possiede nell'organizzazione. Non è possibile garantire privilegi che il proprio account non possiede.
Per informazioni sui tipi di privilegi, fare riferimento alla guida sulla sicurezza e autenticazione nella guida per sviluppatori di Esri.
- Fare clic su Sfoglia elementi, scegliere a quali elementi le credenziali integrate consentiranno l'accesso e fare clic su Aggiungi elementi.
In alternativa, è possibile fare clic su Salta.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- 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 Terra federale è considerato un tag mentre Terra, federale 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 Avanti.
- Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento.
- Se sono stati concessi privilegi personali per le credenziali, selezionare la casella accanto alla notifica sulla sicurezza per confermare di averla letta e accettata e fare clic su Avanti.
- Scegliere se generare la chiave API immediatamente o successivamente e fare clic su Avanti.
È necessario copiare la chiave API non appena viene generata.
- Se si fa clic sull'opzione Genera la chiave API e passa alla pagina dei dettagli dell'elemento. Sono pronto per copiare e salvare la chiave., compare il popup Genera chiave API quando si fa clic su Avanti. Fare clic sul pulsante Copia per copiare la chiave. Incollare la chiave in un documento protetto. Chiudere il popup quando si è concluso.
- Se si fa clic sull'opzione Vai alla pagina dei dettagli dell'elemento. Genererò la chiave più tardi., compare la pagina dell'elemento delle credenziali. Compare la pagina dell'elemento quando si fa clic su Avanti. È possibile generare la chiave API dalla scheda Impostazioni della pagina dell'elemento.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge 
indicante che una chiave API è incorporata nell'app appare sulla pagina dell'elemento e quando l'elemento è visualizzato dalla pagina contenuti o dal riquadro anteprima elemento. Nella scheda Panoramica della pagina dell'elemento, il badge indica se i privilegi personali sono inclusi o se solo i privilegi standard sono inclusi nelle credenziali.
È possibile configurare i dettagli dell'elemento per l'app.
Fare clic su Visualizza utilizzo nella scheda Impostazioni per visualizzare le informazioni riguardanti gli utenti che hanno effettuato l'accesso all'app e il numero di crediti che hanno consumato.
Nota:
La sezione Visualizza utilizzo non è disponibile quando si accede con un abbonamento ad ArcGIS Location Platform.
È inoltre possibile gestire le impostazioni per le credenziali incorporate nell'app.