Configurare i Boundary Layer

In Esri sono disponibili layer contenenti informazioni demografiche e di confine per diverse parti del mondo. Questo tipo di layer, ad esempio confini per stati, province, aree di censimento e CAP, include informazioni locali correlate che i membri del portale possono utilizzare in mappe, scene, app, strumenti di analisi delle feature e ArcGIS Insights.

È consigliabile pubblicare questi layer nel portale se è installato ArcGIS Insights oppure se il portale non può accedere ai contenuti di ArcGIS Living Atlas of the World da ArcGIS Online.

In qualità di amministratore del portale, è possibile scaricare i file della definizione del servizio dei boundary layer (.sd) desiderati da My Esri e utilizzare lo strumento publishboundarylayers per pubblicare feature layer hosted dai file.

Nota:

Quando si esegue uno degli strumenti descritti in questo argomento, è necessario utilizzare un account amministratore predefinito del portale. L'URL usato per questi strumenti dipende da dove viene distribuito ArcGIS Enterprise.

• Quando si eseguono questi strumenti in una distribuzione di ArcGIS Enterprise in loco, è necessario accedere al portale tramite la porta 7443 anziché tramite un Web Adaptor o un bilanciatore.
• Quando si eseguono questi strumenti in una distribuzione di ArcGIS Enterprise nel cloud, è necessario accedere al portale mediante un Web Adaptor o un bilanciatore; non usare la porta 7443.

È possibile eseguire la pubblicazione da una cartella contenente tutti i file desiderati, pubblicare singoli file oppure specificare in un file di testo un elenco di file da pubblicare. Assicurarsi che l'account utilizzato per installare Portal for ArcGIS disponga dell'accesso in lettura a questa directory.

La pubblicazione di questi file di definizione del boundary service (.sd) nel portale comporta quanto segue:

• Ogni file .sd viene aggiunto come elemento di definizione del servizio nel portale. Questi file devono rimanere nel portale se si desidera aggiornare i boundary layer quando sono disponibili contenuti aggiornati.
• Viene creato un feature layer ospitato per ogni file .sd pubblicato. Ogni feature layer ospitato contiene più layer.
• Gli elementi di definizione del servizio e i feature layer ospitati sono entrambi di proprietà di un membro interno del portale denominato esri_boundaries. Non modificare la proprietà di questi elementi assegnandoli a un altro utente.
• Per impostazione predefinita, tutti i membri dell'organizzazione del portale hanno accesso ai boudary feature layer hosted nel portale. I membri del portale possono accedere ai Boundary Layer utilizzando quanto segue:
  • Cercare elementi di boundary layer sul portale dalla scheda La mia organizzazione della pagina Contenuto.
  • Aggiungere boundary layer singoli agli strumenti di analisi delle feature in Map Viewer classico dalla finestra di dialogo Seleziona layer di analisi.
  • Aggiungere i Boundary Layer a Scene Viewer dal riquadro Contenuti.

pubblicare i boundary layer demografici

Questi layer sono autorizzati da un Contratto di licenza Master di Esri. Leggere il riepilogo e i termini di utilizzo prima della pubblicazione.

Importanti requisiti per l'utilizzo

• Questi layer sono autorizzati per uso interno in ArcGIS Enterprise, incluse Portal for ArcGIS, ArcGIS Insights e altre app ArcGIS collegate.
  • Gli utenti non sono autorizzati ad usarli al di fuori della famiglia di prodotti ArcGIS Enterprise o a esportare i dati per un utilizzo disconnesso in ArcGIS o con altre applicazioni.
  • Gli utenti non sono autorizzati a condividere il layer (pubblicamente o privatamente) per uso esterno da parte di membri di altre organizzazioni o del pubblico senza autorizzazione scritta specifica da parte di Esri.
• Questi layer sono autorizzati per essere utilizzati per due (2) anni dopo il download da Esri. È possibile effettuare ogni anno il download dei dati più recenti per estendere la licenza.
• Qualunque visualizzazione di questi layer deve includere i Diritti d'Autore (Attribuzione) pubblicati con ogni layer.

Attenersi alla procedura seguente per recuperare i boundary file e ospitarli come feature layer nel portale.

1. Eseguire il download dei file compressi contenenti le definizioni servizio (.sd) da My Esri.
2. Estrarre i file scaricati e posizionarli in una cartella nel computer di Portal for ArcGIS.

   I nomi file utilizzano un codice a tre lettere per indicare le regioni a cui fanno riferimento e l'anno cui i dati fanno riferimento viene aggiunto alla fine del nome. Ad esempio, USA_Boundaries_2015 contiene i confini per gli Stati Uniti d'America come apparivano nel 2015.

   Rimuovere i file che non si desidera caricare e pubblicare nel portale. In alternativa, creare un file di testo contenente l'elenco del sottoinsieme di file che si desidera caricare e pubblicare. Formattare il file di testo in modo che ogni nome di file occupi una riga. Ad esempio, per caricare i confini per gli Stati Uniti o per il mondo, il file di testo deve contenere quanto segue:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Aprire un prompt comandi nel computer di Portal for ArcGIS.
4. Cambiare directory impostando il percorso dello strumento.
5. Eseguire lo strumento publishboundarylayers.

   Lo strumento viene installato in <Portal installation directory>/tools/publishboundarylayers. La sintassi dello strumento è la seguente: publishboundarylayers --folder <location of sd files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]

   Se durante l'esecuzione dello strumento non viene specificata una password, verrà richiesto di immettere la password dell'amministratore del portale. Questo utente deve essere un membro del ruolo Amministratore predefinito nel portale.

   Se si utilizza l'operazione --files, specificare un elenco di file di definizione del servizio separati da virgole. Se si utilizza l'opzione --file, specificare la posizione e il nome di un file di testo contenente l'elenco di boundary file che si desidera pubblicare.

   In questo esempio, tutti i file nella directory boundaryfiles vengono pubblicati in un portale in loco:

   ./publishboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   In questo esempio, i file si trovano nella stessa directory (boundaryfiles), ma vengono pubblicati due file.

   ./publishboundarylayers --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   In questo esempio, è stato creato un file di testo (boundarysubset.vi) nella directory boundaryfiles. Lo strumento legge l'elenco di file incluso nel file di testo per pubblicare un subset di boundary layer.

   ./publishboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Una volta completata la pubblicazione, per ogni file .sd pubblicato esistono un elemento di definizione dei servizi e un feature layer ospitato.

Per confermare l'esistenza degli elementi, all'interno del portale è possibile eseguire una ricerca di tutti gli elementi di proprietà di un membro interno del portale denominato esri_boundaries. Immettere proprietario:esri_boundaries nel campo di ricerca del portale, quindi fare clic su Cerca in tutto il contenuto.

Aggiornare i boundary layer

Nella maggior parte dei casi, aggiornamenti per unboundary layer vengono forniti come un nuovo file di definizione del servizio pubblicato nel portale utilizzando il comando publishboundarylayers. Questo consente di utilizzare i layer in maniera indipendente e analizzare le due versioni dei dati. Ad esempio, potrebbe esistere una versione 2015 e una versione 2017 dei boudary file mondiali. Anche se raramente, i file di definizione del servizio forniti in My Esri vengono aggiornati per correggere il contenuto. In questi casi, è possibile scaricare il file di aggiornamento e pubblicarlo utilizzando lo strumento updateboundarylayers. Questa procedura comporta la sovrascrittura dei feature layer ospitati esistenti nel portale.

Come descritto nell'introduzione, è possibile aggiornare i boundary layer solo se l'elemento di definizione del layer service esiste ancora nel portale.

Attenersi alla procedura seguente per aggiornare i boundary feature layer nel portale.

1. Eseguire il download dei file compressi contenenti i file aggiornati di definizione del servizio (.sd) da My Esri.
2. Estrarre i file e posizionarli in una cartella nel computer di Portal for ArcGIS.

   Rimuovere i file che non si desidera caricare e pubblicare nel portale. In alternativa, creare un file di testo contenente l'elenco del sottoinsieme di file che si desidera caricare e pubblicare. Formattare il file di testo in modo che ogni nome di file occupi una riga. Ad esempio, per caricare i confini per gli Stati Uniti o il mondo, il file di testo deve contenere quanto segue:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Aprire un prompt comandi nel computer di Portal for ArcGIS.
4. Cambiare directory impostando il percorso dello strumento.
5. Eseguire lo strumento updateboundarylayers.

   Lo strumento viene installato in <Portal installation directory>/tools/publishboundarylayers. La sintassi dello strumento è la seguente: updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]

   Se durante l'esecuzione dello strumento non viene specificata una password, verrà richiesto di immettere la password dell'amministratore del portale. Questo utente deve essere un membro del ruolo Amministratore predefinito nel portale.

   Se si utilizza l'operazione --files, specificare un elenco di file di definizione del servizio separati da virgole. Se si utilizza l'opzione --file, specificare il nome di un file di testo contenente l'elenco di boundary file che si desidera pubblicare.

   In questo esempio, lo strumento updateboundarylayers pubblica tutti i file nei boundaryfiles della directory, sovrascrivendo i layer esistenti:

   ./updateboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   In questo esempio, i file si trovano nella stessa directory (boundaryfiles), ma viene ripubblicato un solo file:

   ./updateboundarylayers --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   In questo esempio, è stato creato un file di testo (boundaryupdatesubset.vi) nella directory boundaryfiles. Lo strumento legge l'elenco di file incluso nel file di testo per ripubblicare un subset di boundary layer.

   ./updateboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Una volta che la pubblicazione è completata, i feature layer ospitati esistenti contengono i dati o i metadati aggiornati.

Eliminare i boundary layer

Se si decide che un boundary layer non è più necessario nel portale, è possibile eliminarlo. È possibile cercare tale layer nel Portale Web ed eliminarlo oppure eseguire lo strumento deleteboundarylayers. Se si desidera eliminare più boundary layer contemporaneamente, utilizzare lo strumento deleteboundarylayers.

Lo strumento deleteboundarylayers non elimina i layer con la funzionalità di protezione dall'eliminazione abilitata.

Attenzione:

Se si elimina un boundary layer attualmente utilizzato in un'altra mappa, app o scena, tale layer non verrà più visualizzato in tali elementi. La ripubblicazione non sostituisce il layer nella mappa, nell'app o nella scena perché la ripubblicazione crea un novo elemento con un nuovo ID nel portale.

È possibile specificare un elenco di layer separati da virgole da eliminare utilizzando l'operazione --files oppure specificare un file di testo contenente un elenco di layer da eliminare utilizzando l'operazione --file.

La sintassi per l'immissione di un elenco di layer separati da virgole è riportata di seguito: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Ad esempio, per eliminare i layer USA_Boundaries_2015 e WOR_Boundaries_2015 dal portale https://portal.domain.com:7443/arcgis come un amministratore del portale denominato portaladmin, immettere quanto segue:

./deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

La sintassi per l'immissione di un file di testo contenente un elenco di layer da eliminare è riportata di seguito: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Ad esempio, per eliminare gli stessi layer utilizzando un file, creare un file di testo contenente un nome di layer per ogni riga (come illustrato di seguito) e quindi specificare la posizione e il nome del file di testo quando lo strumento viene eseguito:

USA_Boundaries_2015
WOR_Boundaries_2015

Nell'esempio seguente, il file boundarylist si trova in /usr/data/boundaries. Contiene un elenco di layer da eliminare dal portale https://webadaptorhost.domain.com/webadaptorname.

./deleteboundarylayers --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin