A partire dalla versione ArcGIS Enterprise 10.5.1, è possibile aggiungere widget personalizzati al portale. Ciò significa che è possibile scegliere widget personalizzati nell'ambiente del generatore quando si crea un'app. Prima di poter utilizzare un widget personalizzato, esso deve utilizzare un servizio di hosting su un server Web e registrato sul proprio portalePer motivi di sicurezza, gli amministratori del portale possono registrare widget personalizzati. Nella versione 10.6, i widget personalizzati condivisi con tutti (pubblico) possono essere utilizzati nelle app pubbliche per accesso utente anonimo.
Legacy:
Nella versione 10.5.1, le app pubbliche non possono caricare widget personalizzati. Questa restrizione è stata rimossa nella versione 10.6. Attualmente, i widget personalizzati condivisi pubblicamente possono essere utilizzati nelle app pubbliche per accesso utente anonimo.
Usufruire di un servizio di hosting su un server Web per un widget personalizzato
Usufruire di un servizio di hosting su un server Web per un widget personalizzato non è diverso dall'utilizzare un servizio di hosting su una qualsiasi app webÈ necessario installare e configurare un server Web. I server Web comuni includono IIS, OS X Server e Apache.
Per widget personalizzati sul server Web, attenersi ai seguenti passaggi:
- Abilitare l'accesso anonimo sul server Web.
La posizione di hosting deve essere accessibile anonimamente in maniera anonima.
- Abilitare HTTPS.
Abilitare l'accesso HTTPS nel server Web per evitare di creare contenuti misti. Web AppBuilder non consente contenuti attivi misti causati dal caricamento di HTTP in una connessione HTTPS. Inoltre, il server dovrebbe avere un certificato SSL valido rilasciato da un'autorità di certificazione per stabilire la connessione HTTPS.
- Abilitare Cross Origin Resource Sharing (CORS).
Web AppBuilder viene eseguito nel dominio del portale che potrebbe essere diverso dal dominio del server Web che effettua servizio di hosting sul widget personalizzato. È necessario abilitare CORS nel server Web in modo che l'accesso dal dominio del portale sia consentito.
- Aggiungere un gestore JSON al server Web.
Ciascun widget è costituito da un file JSON formato Manifest che descrive le proprietà del widget. Alcuni server Web non riconoscono l'estensione del file JSON per impostazione predefinita. In tali casi, sarà necessario aggiungerlo al server come un nuovo tipo MIME a livello di applicazione o a un livello più elevato. Il tipo MIME deve avere .json come estensione del nome del file e application/json come tipo MIME.
- Distribuire il widget personalizzato sul server Web.
È possibile copiare la cartella del widget personalizzato sul server Web. Dopo la distribuzione, è necessario ottenere il percorso dell'URL al file Manifest del widget personalizzato. Un esempio di percorso di URL a un file Manifest è <server.domain.com>/<my widget>/manifest.json.
Registrare un widget personalizzato
È necessario registrare ciascun widget personalizzato nel portale. Per questa operazione è necessario avere effettuato l'accesso come amministratore del portale.
- In una finestra del browser accedere al portale.
- Fare clic sulla scheda I miei contenuti della pagina dei contenuti.
- Fare clic su Aggiungi elemento e scegliere Un'applicazione.
- Scegliere Estensione app (AppBuilder) e fornire l'URL sul file Manifest.
Un esempio di percorso di URL a un file Manifest è <server.domain.com>/<my widget>/manifest.json.
- Fare clic sulla casella Titolo.
Il titolo dell'elemento verrà immesso automaticamente dal file Manifest. Facoltativamente, è possibile modificare manualmente il titolo.
- Aggiungere tag nella casella Tag.
- Fare clic su Aggiungi elemento.
Il widget personale è quindi disponibile nella scheda I miei contenuti della pagina dei contenuti come tipo Estensione AppBuilder.
Condividere un widget personalizzato
In qualità di amministratore del portale, è possibile condividere i widget personalizzati con i gruppi dell'organizzazione che necessitano l'accesso con l'intera organizzazione o pubblicamente, se necessario.
Attenzione:
Un'app caricherà solo il widget personalizzato che è stato registrato nella stessa organizzazione degli utenti che hanno le autorizzazioni per accedere all'app.
In I miei contenuti individuare il widget personalizzato e condividerlo. Quando si apre il generatore, il widget personalizzato viene visualizzato sotto la scheda Personalizzato nella finestra di dialogo Seleziona widget.
Attenzione:
Se si riceve un errore 404 durante il caricamento del widget personalizzato, assicurarsi che il widget non richieda moduli che utilizzano il nome del pacchetto di widget. Utilizzare invece un percorso relativo per caricare moduli.
Aggiornare un widget personalizzato
Benché non sia possibile aggiornare il widget personalizzato nel portale, è possibile aggiornare la struttura HTML e il codice JavaScript del widget personalizzato hosted nel server Web.
Nota:
Una volta che il widget personalizzato è stato distribuito su un server Web e registrato come elemento di tipo Estensione AppBuilder nel portale, i contenuti del file Manifest vengono salvati nell'elemento di estensione. Ciò significa che qualunque modifica al file manifesto che usufruisce di un servizio di hosting su un server Web non verrà riconosciuto dall'estensione registrata. Si consiglia di creare una nuova estensione anziché aggiornare il file Manifest.