MicroStrategy ONE

File di configurazione ESRI

Quando si installa MicroStrategy Web, il file di configurazione ESRI, mapConfig.xml, è salvato per impostazione predefinita in WEB-INF/xml/config nella directory di installazione di MicroStrategy Web.

Per impostare e configurare l'integrazione delle mappe ESRI personalizzate, è necessario creare un plug-in e copia il file di configurazione ESRI predefinito nel plug-in. Tutte le modifiche di personalizzazione vengono apportate al file nel plug-in, non al file predefinito. In questo modo è possibile salvare la chiave della mappa MicroStrategy e mantenere le personalizzazioni durante l'aggiornamento. Tutti i riferimenti alla personalizzazione fanno riferimento al file di configurazione ESRI nel plug-in.

Il contenuto della procedura predefinita mapConfig.xml file sono mostrati di seguito, seguiti da una tabella che spiega ciascun elemento e attributo nel file.

Copia 
<mc>
    <ec>
        <!-- The following nodes are used for on-premises map integration -->
        <bms>
            <bm key="default">http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer</bm>
        </bms>
        <pjs>
            <pj id="B19DEDCC11D4E0EFC000EB9495D0F44F">
                <at id="54BABC8311D59D57C000B28A4CC5F24F">
                    <ml>http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0</ml>
                    <qf>['STATE_NAME']</qf>
                    <ea>state_name</ea>
                </at>
            </pj>
        </pjs>
        <!-- End of nodes used for on-premises map integration -->

        <!-- The following nodes are used for cloud-based map integration, including out-of-the-box map integration -->
        <apps></apps>
        <webmaps>
            <webmap id="5fac74d8e7924e169afdc01105235324" default="true" />
        </webmaps>
        <layers>
            <layer id="1"
                title="US-States"
                ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0"/>
                <layer id="2"
                    title="US-ZipCodes"
                    ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_ZIP_Codes/FeatureServer/0"/>
                <layer id="3"
                    itle="US-Counties"
                    ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_Counties_Generalized/FeatureServer/0"/>
                <layer id="4"
                    title="World-Countries Detailed"
                    ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Countries/FeatureServer/0" />
                <layer id="5"
                    title="World-Countries Generalized"
                    ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Countries_(Generalized)/FeatureServer/0" />
                <layer id="6"
                    title="World-Admin-Divisions"
                    ml="http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Administrative_Divisions/FeatureServer/0"/>
        </layers>

        <!-- The following values identify the geo-role of the primary (roleId) and secondary (sfr) geo attributes in the <shape> node -->
        roleId 1 = "City"
        roleId 2 = "State"
        roleId 3 = "Country"
        roleId 4 = "Location"
        roleId 5 = "Latitude"
        roleId 6 = "Longitude"
        roleId 7 = "Other"
        roleId 8 = "ZipCode"
        roleId 9 = "County"
        <!-- End of values that identify geo-role of the primary (roleId) and secondary (sfr) geo attributes -->

        <shapes>
            <shape id="100"
                default="true"
                desc="US State Names"
                roleId="2"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['STATE_NAME']"
                ea="state_name"
                layerId="1" />
            <shape id="200"
                desc="US State Abbreviations"
                roleId="2"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['state_abbr']"
                ea="state_abbr"
                layerId="1" />
            <shape id="300"
                desc="US Zip Codes"
                roleId="8"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['ZIP']"
                ea="ZIP"
                layerId="2"/>
            <shape id="400"
                desc="Countries of World"
                roleId="3"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['ISO','Country']"
                ea="Country"
                layerId="5" />
            <shape id="500"
                desc="World Admin Divisions"
                roleId="2"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['NAME']"
                ea="NAME"
                layerId="6" />
            <shape id="600"
                desc="US Counties"
                roleId="9"
                type="Polygon"
                descWeb="mstrweb.9229"
                descFlash="mstr.1622"
                descDesktop="26973"
                qf="['NAME']"
                sf="STATE_NAME"
                sfr="2"
                pk="FID"
                ea="NAME"
                layerId="3" />
        </shapes>
        <!-- End of nodes used for cloud-based map integration -->
    </ec>
</mc>

Struttura XML

La tabella seguente descrive tutti gli attributi e gli elementi nel file di configurazione ESRI. Le tre colonne della tabella includono le seguenti informazioni:

Elemento principale

- Elemento figlio 1

- Elemento figlio 2

Indica il nome dell'elemento descritto nelle due colonne successive. Se si tratta di un elemento padre, i nomi di tutti i possibili elementi figlio sono elencati sotto l'elemento padre.

Numero di nodi

Specifica il numero di nodi necessari o consentiti per l'elemento corrispondente nella colonna Elemento padre. Ad esempio, se il valore è &quot;1&quot;, deve esserci solo un nodo, né di più né di meno. Se il valore è &quot;0 o più&quot;, il nodo non è obbligatorio (&quot;0&quot;), ma non vi sono restrizioni sul numero di nodi che possono essere aggiunti (&quot;o più&quot;). Se il valore è &quot;1 o più&quot;, il nodo è obbligatorio (&quot;1&quot;), ma non vi sono restrizioni sul numero di nodi che possono essere aggiunti (&quot;o più&quot;).

Descrizione

Descrive l'elemento padre nella colonna Elemento padre.
Elemento principale Numero di nodi Descrizione
<mc> 1 Il< mc> è il nodo radice del file di configurazione della mappa. È il nodo padre per i nodi contenitore figlio per un diverso tipo di configurazione della mappa.

<ec>

-< bms>

-< pjs>

-< app>

-< mappe web>

-< livelli>

-< forme>

1

Il< ec> L'elemento è il nodo padre per la configurazione ESRI. È il nodo padre per i nodi contenitore figlio per mappe base e progetti.

<bms>

-< bm>

1

Il< bms> L'elemento è il nodo contenitore per tutte le mappe di base. Contiene un nodo separato per ogni mappa base.

<pjs>

-< pj>

1

Il< pjs> elemento è il nodo contenitore per tutti i progetti. Contiene un nodo separato per ogni progetto.

<app>

-< app>

1

Il< app> L'elemento è il nodo contenitore per tutte le applicazioni di mappe Web. Contiene un nodo separato per ogni applicazione. Il valore di< app> fornisce la chiave MicroStrategy Map. Per poter utilizzare l'integrazione delle mappe predefinita di MicroStrategy, gli utenti devono richiedere la chiave all'Assistenza tecnica di MicroStrategy e inserirla come valore per l'elemento.

<mappe web>

-< webmap>

1

Il< mappe web> L'elemento è il nodo contenitore per tutte le mappe Web. Contiene un nodo separato per ogni mappa Web.

<livelli>

-< livello>

1

Il< livelli> L'elemento è il nodo contenitore per tutti i livelli della mappa. Contiene un nodo separato per ciascun livello mappa.

<forme>

-< forma>

1

Il< forme> L'elemento è il nodo contenitore per tutte le definizioni dell'area della mappa. Contiene un nodo separato per ciascuna definizione di area della mappa.

<bm>

1 o più

Il< bm> identifica una singola mappa di base. Questa mappa di base può trovarsi su un ArcGIS Server locale o su un server pubblico sul cloud; è determinato dall'URL fornito come valore. Questo elemento ha i seguenti attributi:

L'attributo chiave è impostato automaticamente su &quot;predefinito&quot;.

Per utilizzare i servizi delle mappe dinamici anziché i servizi delle mappe memorizzati nella cache, aggiungere l'attributo isDyn e impostarlo su &quot;1&quot;.

Per utilizzare sempre il server proxy, aggiungere l'attributo proxyURL e impostarlo su &quot;true&quot;.

Il valore di questo elemento è un percorso URL valido alla mappa di base ESRI utilizzata dal widget Mappa.

Ad esempio: http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer

<pj>

-< alle>

1 o più

Il< pj> identifica un singolo progetto ed è il nodo contenitore per tutti gli attributi geografici mappati in quel progetto. Questo elemento ha il seguente attributo:

Il valore dell'attributo id è un GUID, racchiuso tra virgolette, per il progetto MicroStrategy che fornisce dati per il widget Mappa. Ad esempio: &quot;B19DEDCC11D4E0EFC000EB9495D0F44F&quot;

<webmap>

1 o più

Il< webmap> identifica una singola mappa Web. Questo elemento ha i seguenti attributi:

L'attributo id è impostato sul valore dell'identificatore ESRI per la mappa web.

L'attributo di questo elemento è impostato su &quot;true&quot; per indicare all'applicazione di utilizzare questa mappa Web. Se l'attributo manca o è impostato su &quot;false&quot;, la mappa web non è utilizzata.

L'elemento predefinito identifica la mappa Web MicroStrategy predefinita utilizzata per l'integrazione della mappa predefinita.

 

<app>

-< chiave>

1 o più

Il< app> identifica una singola applicazione di mappe Web. Lo scopo principale di questo nodo è ospitare le credenziali ESRI associate a una particolare applicazione di questa mappa Web. Questo elemento ha i seguenti attributi:

L'attributo id di questo elemento è impostato su un valore univoco. È lo stesso valore dell'attributo nel nodo per questa mappa Web. Consente all'applicazione di recuperare le credenziali ESRI corrette (AppID e AppSecret) da utilizzare per accedere alla mappa Web privata sul cloud ESRI.

L'attributo AppID è impostato sul valore generato al momento della creazione e della registrazione dell'applicazione mappe Web.

L'attributo AppSecret è impostato sul valore generato al momento della creazione e della registrazione dell'applicazione mappe Web.

<chiave>

1

Il< chiave> identifica il valore della chiave della mappa MicroStrategy fornita all'utente dall'Assistenza tecnica di MicroStrategy per integrazione delle mappe pronte all'uso.

<livello>

1 o più

Il< livello> identifica un singolo livello mappa. Questo elemento ha i seguenti attributi:

L'attributo id è un numero intero univoco che identifica questo livello mappa.

L'attributo title è un nome descrittivo univoco, ad esempio &quot;US-States&quot;.

L'attributo ml è un percorso URL valido a un livello mappa/documento specifico su un server ESRI che fornisce dati al widget Mappa. Ad esempio: &quot;http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0&quot;

<forma>

1 o più

Il< forma> identifica una singola definizione di area della mappa. Questo elemento ha i seguenti attributi:

L'attributo id è un numero intero univoco che identifica questa definizione di area mappa.

L'attributo predefinito è un valore BOOLEAN che specifica se questa è la definizione dell'area mappa predefinita.

L'attributo personalizzato è facoltativo ed è impostato su &quot;true&quot; per indicare che dovrebbe essere necessario per la mappa utilizzare un file di forma personalizzato.

L'attributo plug-in è facoltativo ed è impostato sul nome del plug-in delle forme personalizzate quando l'utente creare e utilizzare forme personalizzate.

L'attributo desc è una descrizione della definizione dell'area della mappa, ad esempio &quot; US State Names &quot;.

L'attributo roleId identifica il ruolo geografico dell'attributo geografico primario.

L'attributo tipo è impostato su &quot;POLYGON&quot;.

L'attributo descWeb è un riferimento a un file contenente la descrizione dell'area della mappa utilizzata in MicroStrategy Web. Ad esempio: &quot;mstrweb.9229.&quot;

L'attributo descFlash è un riferimento a un file contenente la descrizione per questa definizione di area mappa quando viene utilizzata nella vista Flash. Ad esempio, &quot;mstr.1622&quot;.

L'attributo descDesktop fa riferimento a un file contenente la descrizione dell'area della mappa utilizzata in MicroStrategy Desktop. Ad esempio, &quot;26973&quot;.

L'attributo qf specifica i nomi dei campi della query/gli attributi geografici nel database ESRI che fornisce i dati al widget Mappa. Questi nomi di campo vengono utilizzati per creare la clausola SELECT nell'istruzione SQL che recupera i dati dal database ESRI. Il valore di questo attributo è un nome di campo/attributo geografico valido, racchiuso tra parentesi e virgolette singole. Ad esempio, ['STATE_NAME'].

L'attributo sf identifica l'attributo geo secondario. Questo valore deve corrispondere al valore dell'attributo sf in< elem> elemento del file di configurazione delle conversioni dei nomi mappa. Ciascuno< elem> definisce una regola di conversione dei nomi. L'attributo geografico secondario può essere utilizzato per limitare ulteriormente una regola di conversione del nome.

L'attributo sfr identifica il ruolo geografico dell'attributo geografico secondario.

L'attributo pk identifica la chiave primaria dell'elemento.

L'attributo ea specifica l'attributo ESRI geo il cui attributo MicroStrategy mappato corrispondente è utilizzato per recuperare i dati MicroStrategy utilizzati dal widget Mappa. Questo valore viene utilizzato per costruire la clausola WHERE nell'istruzione SQL che recupera i dati dal database ESRI (il valore dopo il segno di uguale e a sinistra del segno di uguale). Il valore di questo attributo è un nome campo/attributo geografico valido.

L'attributo layerId fa riferimento all'attributo dello specifico< livello> elemento utilizzato da questa forma.

<alle>

-< ml>

-< gf>

-< ea>

1 o più

Il< alle> identifica un singolo attributo geografico di MicroStrategy ed è il nodo contenitore per le informazioni richieste per costruire l'istruzione SQL utilizzata per recuperare i dati dal database ESRI.

Il valore di< alle> L'elemento viene utilizzato per costruire la clausola WHERE nell'istruzione SQL che recupera i dati dal database ESRI (il valore a destra del segno di uguale).

Questo elemento ha il seguente attributo:

Il valore dell'attributo id per questo elemento è a GUID valido, racchiuso tra parentesi, per un attributo geografico nel progetto MicroStrategy padre mappato a un attributo geografico ESRI. Ad esempio: &quot;54BABC8311D59D57C000B28A4CC5F24F&quot;

Il valore ESRI corrispondente per la clausola WHERE è stato ottenuto utilizzando il nome del campo ESRI specificato da< ea> elemento.

<ml>

1

Il< ml> specifica un singolo livello mappa, che rappresenta la tabella ESRI su cui eseguire la query. Questo valore viene utilizzato per costruire la clausola FROM nell'istruzione SQL che recupera i dati dal database ESRI.

Il valore di questo elemento è un percorso URL valido a un livello mappa/documento specifico su un server ESRI che fornisce dati al widget Mappa. Ad esempio: http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5.

Può essere lo stesso server ESRI che fornisce la mappa di base o un server diverso. Può trattarsi di un ArcGIS Server locale o di un server pubblico nel cloud.

<qf>

1

Il< qf> specifica i nomi dei campi della query/gli attributi geografici nel database ESRI che fornisce i dati al widget Mappa. Questi nomi di campo vengono utilizzati per creare la clausola SELECT nell'istruzione SQL che recupera i dati dal database ESRI. È possibile fare riferimento ad esse come macro in HTML per creare una Finestra informazioni personalizzata.

I valori di questo elemento sono nomi di campo/attributi geografici validi, racchiusi tra virgolette, nella tabella del database ESRI specificata dall'elemento. Ad esempio: &quot;STATE_NAME&quot;, &quot;POP2008&quot; o &quot;ZIP&quot;.

Se viene fornito più di un valore, l'intero elenco di valori deve essere racchiuso tra parentesi quadre, con ogni singolo valore racchiuso tra virgolette singole e separato da virgole. Uno dei valori deve essere l'attributo geografico ESRI mappato a un attributo MicroStrategy (l'attributo specificato dall'attributo).

<ea>

1

Il< ea> specifica l'attributo geografico ESRI il cui attributo MicroStrategy mappato corrispondente è utilizzato per recuperare i dati MicroStrategy utilizzati dal widget Mappa. Questo valore viene utilizzato per costruire la clausola WHERE nell'istruzione SQL che recupera i dati dal database ESRI (il valore dopo il segno di uguale e a sinistra del segno di uguale).

Il valore di this< ml> L'elemento è un nome campo/attributo geografico valido, racchiuso tra virgolette, nella tabella di database ESRI specificata dall'elemento. Ad esempio: STATE_NAME o ZIP .

Il valore MicroStrategy corrispondente per la clausola WHERE è ottenuto utilizzando il GUID dell'attributo MicroStrategy specificato da< alle> elemento.

Imparentato

KB483288: la connessione a ESRI viene reimpostata in Web anche se la connessione tra il computer server Web e i server ArcGIS è disponibile