Skip To Content

Creare modelli di app

Per creare un modello di app Web personalizzato, è possibile scaricare e modificare uno dei modelli esistenti, aggiornare un'app Web esistente affinché utilizzi i contenuti del portale o creare una nuova app Web utilizzando una delle API Web ArcGIS. Indipendentemente da come si crea il modello, sarà necessario gestire parametri di URL e mappe. È possibile utilizzare i gruppi, se si crea un modello di gruppo, e prendere in considerazione ulteriori requisiti per l'utilizzo delle mappe di base di Bing Maps, l'accesso a mappe non pubbliche e l'utilizzo di risorse che richiedono un proxy o la specifica Cross-Origin Resource Sharing (CORS).

Dopo aver creato il modello di app Web, è possibile aggiungere l’elemento dell’app al portale. If your organization plans to use your template in one of its app galleries, you can also share it with one of your organization's template groups. Per consentire agli utenti di personalizzare l'aspetto e il comportamento dell’app Web personalizzata, è possibile renderla personalizzabile.

Portal for ArcGIS include ArcGIS API 3.15 for JavaScript. Non è necessario ospitare un'API personalizzata e indirizzare il portale alla versione locale per nuovi modelli app creati. I modelli di app Web fanno automaticamente riferimento all'API installata. L'API installata in locale è in genere disponibile all'indirizzo https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi.

Attenzione:

Non modificare i file di modello di app Web forniti con Portal for ArcGIS, poiché tali file sono gestiti dal portale ed eventuali modifiche apportate potrebbero essere successivamente sovrascritte dal portale stesso. Se si desidera personalizzare i modelli, eseguire le operazioni seguenti:

  1. Effettuare una copia del file di modello esistente che si desidera personalizzare.
  2. Inserire la copia in un percorso diverso del disco.
  3. Personalizzare la copia del modello.
  4. Aggiungerla al Portale come nuovo modello.

In questo argomento viene spiegato come creare un modello di app Web. Nelle procedure si presuppone che l'utente disponga già dei privilegi per creare contenuti e condividere con gruppi dell'organizzazione.

Web Map

I modelli di app sono progettati per funzionare con la mappa attualmente visualizzata in Map Viewer. Con i modelli viene in genere creata una mappa basata sulla mappa Web specificata nel parametro dell'URL della mappa Web. Ciascuna API Web include un metodo helper che consente di creare una mappa utilizzando le informazioni dell'ID della mappa Web.

Ad esempio, è possibile utilizzare il metodo ArcGIS API for JavaScript esri.arcgis.utils.createMap per creare una mappa basata sull'ID di input, nonché includere una funzione callback che viene eseguita al completamento della richiesta sincrona a esri.arcgis.utils.createMap.

esri.arcgis.utils.createMap(webmap,"map",{
   mapOptions:{
     slider:false
   },
   bingMapsKey:bingMapsKey
}).then(function(response){
    map = response.map;
});
Nota:

Se una delle mappe Web include una mappa di base di Bing Maps, è necessario specificare una chiave di Bing Maps quando si utilizza il metodo createMap. Sono disponibili diverse altre opzioni della mappa che è possibile specificare, ad esempio per visualizzare il cursore, la navigazione, l'attribuzione e altro ancora.

La funzione callback fornisce l'accesso a un oggetto risposta che a sua volta consente di accedere all'oggetto mappa, ai layer e a molto altro ancora.

Registrare il modello di app

Se nel modello di app si utilizzano elementi sicuri, è possibile innanzitutto registrarli con la piattaforma. A tale scopo, aggiungere un nuovo elemento Applicazione mappatura Web e impostare l'URL sul modello di app ospitato nel server Web.

Dopo aver aggiunto gli elementi, è necessario registrare l'app. Poiché si tratta di un'app Web, mantenere il tipo impostato su Browser con il valore Redirect URI che fa riferimento all'URL del modello di app.

Dopo aver registrato l'app, sarà presente un ID app univoco.

Utilizzare Identity Manager per il riconoscimento dell'ID dell'app registrata. Per ulteriori informazioni, vedere gli esempi OAuth Basic e OAuth Popup inclusi con ArcGIS API for JavaScript.

Gruppo

I modelli di gruppo consentono di visualizzare il contenuto del gruppo specificato sotto forma di app.

L'API REST di ArcGIS consente di accedere al contenuto dal portale. Utilizzarla per recuperare i contenuti del gruppo sulla base dell'ID gruppo di input.

In questo esempio viene eseguita un'interrogazione per trovare un gruppo con l'ID di input.

var portal = new esri.arcgis.Portal('https://webadaptorhost.domain.com/webadaptorname/');
dojo.connect(portal, 'onLoad',function(){
    portal.queryGroup(groupid).then(function(response){
        var group = response.results[0];
     });
});

Dopo aver trovato il gruppo, è possibile eseguire un'interrogazione per recuperare gli elementi dal gruppo.

In questo esempio si interroga il gruppo per individuare cinque elementi di tipo Web Map o Web Mapping Application.

var queryParams = {
    q: 'type:"Web Map" -type:"Web Mapping Application"',
    num: 5
 };
group.queryItems(queryParams).then(function(response){
    var groupItems = response.results;
});

Considerazioni aggiuntive

Le app Web sono in genere progettate per l'uso con tipi diversi di contenuto, pertanto potrebbe essere necessario impostare il modello in modo che gestisca mappe con mappe di base Bing Maps, contenuto non pubblico e così via. Vedere le considerazioni specifiche riportate di seguito.

Chiave di Bing Maps

Se una delle mappe che si desidera visualizzare utilizza una mappa di base di Bing Maps, è necessario specificare una chiave di Bing Maps nell'app. La chiave di Bing Maps viene specificata come parametro del metodo createMap.

Supporto per proxy e CORS

Se l'app effettuerà richieste interdominio, sarà necessario abilitare CORS o aggiungere un proxy all'app.

Aggiungere il modello al portale

Dopo aver creato il modello ed averlo ospitato nel server Web, aggiungerlo al portale come elemento web app e specificare l'URL dell'app. A tale scopo, scegliere Configurabile. Per l'API, scegliere JavaScript.

Assicurarsi di includere un titolo descrittivo ed un riepilogo perché tali informazioni vengono visualizzate quando gli utenti passano con il puntatore del mouse sull'elemento del modello nella galleria di modelli. Facoltativamente, è possibile creare un file ZIP che contiene i file dell'app e collegarlo all'elemento per offrire la funzionalità di download.

Utilizza il modello nella galleria di app dell'organizzazione

Se si desidera utilizzare il modello nella galleria di app di Map Viewer o nella galleria di app di gruppo dell'organizzazione, condividere con il gruppo l'elemento in uso per quella galleria. L'amministratore dell'organizzazione può quindi configurare la mappa o configurare i gruppi in modo che utilizzino il gruppo che include il modello.