MicroStrategy ONE

Rendering di forme personalizzate

È possibile integrare forme personalizzate con dati MicroStrategy ed eseguirne il rendering su mappe ESRI basate su cloud. Per integrare le forme personalizzate con le forme predefinite fornite da MicroStrategy, è necessario modificare il file di configurazione delle forme geografiche nel plug-in e aggiungere un file delle forme personalizzate in formato KML, come descritto di seguito:

  1. Crea o ottieni un file KML che definisce le forme personalizzate per la mappa

  2. Modificare il file di configurazione della forma geografica in modo che la visualizzazione Mappa ESRI possa utilizzare le forme personalizzate

  3. Verificare di poter utilizzare le forme personalizzate

Scaricare il plug-in ESRI per la visualizzazione delle mappe fornito e attenersi alla seguente procedura.

  1. Crea o ottieni un file KML che definisce le forme personalizzate per la mappa

    È possibile utilizzare un file KML già in uso oppure crearne uno nuovo. KML è un formato di file utilizzato per visualizzare dati geografici in mappe bidimensionali e browser Earth tridimensionali. Di seguito è riportato uno snippet di codice da un file KML di esempio:

    Copia 
    <?xml version="1.0" encoding="UTF-8"?>
    <kml >
        <Document>
            <Placemark>
                <name>attribute value</name>
                <ExtendedData>
                    <Data name="attribute key">
                        <DisplayName>attribute display value</DisplayName>
                        <Value>attribute value</Value>
                    </Data>
                </ExtendedData>
    ...
                <Polygon>
                    <outerBoundaryIs>
                        <LinearRing>
                            <coordinates>set of custom shape coordinates</coordinates>
                        </LinearRing>
                    </outerBoundaryIs>
                </Polygon>
            </Placemark>
    ...
        </Document>
    </kml>

    Ciascuno <Placemark> contiene i dati di definizione della forma per una delle forme personalizzate. Contiene inoltre le informazioni necessarie per abbinare ogni forma ai dati corrispondenti.

    • Per impostazione predefinita, <name> L'elemento viene utilizzato per abbinare i dati alle forme Il suo valore deve corrispondere ai dati dell'elemento di attributo MicroStrategy utilizzati dalla mappa. Ad esempio, se le forme personalizzate sono stati, il valore di <name> l'elemento potrebbe essere &quot;Maryland&quot; o &quot;California&quot;.

    • È possibile ignorare il comportamento di corrispondenza predefinito aggiungendo un elemento<ExtendedData> elemento come elemento figlio di <Placemark>. Ciò garantisce flessibilità, consentendo di abbinare le forme personalizzate ai dati identificati in diversi modi. Ad esempio, questa operazione può essere eseguita se si desidera abbinare le forme nel file KML ai dati sullo stato identificati dalle abbreviazioni del nome dello stato o dagli ID oggetto, oltre ai nomi degli stati.

    • Il <coordinates> elemento (elemento figlio di <Polygon><outerBoundaryIs><LinearRing>)contiene la definizione di ogni forma personalizzata. La definizione è un insieme di punti descritti da longitudine, latitudine e altitudine facoltativa che determinano il contorno della forma.

    Sia per il file di forma ESRI sia per il file di forma KML è supportato solo il poligono.

    Il sistema di coordinate deve essere WGS 84.

    Attenersi alle seguenti operazioni:

    • Assegna un nome significativo al file KML che definisce le forme personalizzate, ad esempio CustomCountyShapesFile.kml e salvarlo nella cartella del plug-in ESRI di visualizzazione mappe.
    • Salvare il file KML direttamente nel plug-in oppure creare una cartella kml nel plug-in e salvare il file delle forme personalizzate nella cartella kml.

  2. Modificare il file di configurazione della forma geografica in modo che la visualizzazione Mappa ESRI possa utilizzare le forme personalizzate

    Vai a mstrGeoShapesConfig.xml, situato in xml/config nella cartella del plug-in e aprirlo in un editor di testo. Il file deve includere codice come quello di esempio mostrato di seguito.

    Copia 
    <layers>
        <layer id="900" title="Custom County Map Layer" ml="CustomCountyShapesFile.kml">
            <shapeKeys>
                <shapeKey key="name" path="/ExtendedData/Data[@name='name']/value"/>
                <shapeKey key="abbr" path="/ExtendedData/Data[@name='abbreviatedName']/value"/>
                <shapeKey key="id" path="/ExtendedData/Data[@name='object_id']/value"/>
            </shapeKeys>
        </layer>
    </layers>
    <shapes>
        <shape id="901"
            custom="true"
            plugin="ConnectorForMap"
            desc="Custom Counties by Name"
            descWeb="mstrweb.7777n"
            descFlash="mstr.6666n"
            descDesktop="5555n"
            roleId="9"
            type="Polygon"
            default="false"
            shapeCat="1004"
            shapeKey="name"
            layerId="900"
            sf="name"
            sfr="2"
        />
        <shape id="902"
        custom="true"
        plugin="ConnectorForMap"
        desc="Custom Counties by Abbreviation"
        descWeb="mstrweb.7777a"
        descFlash="mstr.6666a"
        descDesktop="5555a"
        roleId="9"
        type="Polygon"
        default="false"
        shapeCat="1004"
        shapeKey="abbr"
        layerId="900"
        sf="name"
        sfr="2"
        />
        <shape id="903"
            custom="true"
            plugin="ConnectorForMap"
        desc="Custom Counties by ID"
        descWeb="mstrweb.7777i"
        descFlash="mstr.6666i"
        descDesktop="5555i"
        roleId="9"
        type="Polygon"
        default="false"
        shapeCat="1004"
        shapeKey="id"
        layerId="900"
        sf="name"
        sfr="2"
        />
    </shapes>

    Apportare le modifiche seguenti per personalizzare il file di configurazione della forma geografica per l'ambiente. I valori da modificare sono mostrati in grassetto nell'esempio di codice riportato sopra.

    • Per il bambino <layer> elemento sotto l'elemento padre <layers> elemento, procedere come segue:

      • Per il id sostituire &quot;900&quot; con un valore univoco (non già utilizzato da MicroStrategy per un livello mappa). Questo valore identifica in modo univoco questo livello mappa che utilizza le forme personalizzate. Vi fa riferimento il layerID attributo in <shape> elemento.

        Multiplo< forma> Gli elementi possono utilizzare lo stesso livello mappa (ovvero lo stesso file KML), ma utilizzare chiavi diverse per corrispondere a forme e dati, quali nome, abbreviazione o ID. Le chiavi utilizzate per la corrispondenza sono fornite da shapeKey attributo di different <shape> elementi. La corrispondenza avviene come indicato di seguito per ogni forma personalizzata:

        • Il valore di ciascuna shapeKey Viene utilizzato per trovare una corrispondenza con l'attributo chiave in a <shapeKey> elemento.

          Il valore shapeKey fa distinzione tra maiuscole e minuscole.

        • La corrispondenza <shapeKey> elemento contiene a path, che punta a un attributo specifico <Data> nel file KML (identificato dal valore di name attributo in <Data> elemento).

        • La corrispondenza <Data> elemento ha un elemento figlio <Value> e il relativo valore viene utilizzato per ottenere i dati MicroStrategy associati a questa forma personalizzata.

      • Per il title, sostituire &quot;Livello mappa contea personalizzato&quot; con un valore che descriva questo livello mappa che utilizza le forme personalizzate dell'utente.

      • Per il ml attributo, sostituire &quot;CustomCountyShapesFile.kml &quot; con il nome del file KML, incluso il percorso relativo, all'interno della cartella dei plug-in. Ad esempio, utilizzare ml="CustomCountyShapesFile.kml" per un file salvato direttamente nella cartella dei plug-in oppure utilizzare ml="kml/CustomCountyShapesFile.kml" per un file salvato in una cartella denominata kml all'interno della cartella dei plug-in.

    • Per il bambino <shapeKey> elementi sotto l'elemento padre <shapeKeys> elemento, procedere come segue:

      • Rimuovi eventuali elementi figlio <shapeKey> elementi non necessari per l'ambiente. Il plug-in fornito contiene tre di questi elementi. Una identifica le forme per nome, un'altra per abbreviazione e la terza per ID.

        • Se non si desidera utilizzare uno o più di questi elementi, eliminare gli elementi appropriati.

        • Se si desidera utilizzare uno o più di questi elementi, conservare gli elementi appropriati.

        • Se si desidera identificare le forme in base a un valore diverso, modificare il valore di key attributo in uno dei file <shapeKey> elementi. Ad esempio, se si desidera utilizzare un valore denominato SMSA per identificare le forme, il codice potrebbe avere il seguente aspetto:
          <shapeKey key="SMSA" path="/ExtendedData/Data[@name='SMSA']/value"/>

          Il valore shapeKey fa distinzione tra maiuscole e minuscole.

      • Per ogni figlio <shapeKey> elemento necessario per l'ambiente:

        • Impostare il key al valore che sarà utilizzato per identificare l' <shape> elemento associato al file di forma personalizzato. È lo stesso valore di shapeKey nell'attributo <shape> elemento.

        • Se si desidera che il campo dati utilizzato corrisponda ai dati con le forme in modo che sia diverso dal valore di< nome> elemento per ciascuno <Placemark> nel file KML, impostare l'estensione path attributo alla posizione del campo di dati che si desidera utilizzare, utilizzando il formato /ExtendedData/Data[@name='>MyCustomShapes']/value.

          Si supponga, ad esempio, di voler utilizzare le abbreviazioni di stato per far corrispondere le forme personalizzate ai dati e il codice nel file KML assomigli a quello riportato di seguito:

          Copia 
          <?xml version="1.0" encoding="UTF-8"?>
          <kml >
              <Document>
                  <Placemark>
                      <name>custom shape name</name>
                      <ExtendedData>
                          <Data name="abbreviatedName">
                              <DisplayName>Pennsylvania</DisplayName>
                              <Value>PA</Value>
                          </Data>
                      </ExtendedData>
                      <Polygon>
                          <outerBoundaryIs>
                              <LinearRing>
                                  <coordinates>set of custom shape coordinates</coordinates>
                              </LinearRing>
                          </outerBoundaryIs>
                      </Polygon>
                  </Placemark>
          ...
              </Document>
          </kml>

          Il codice in mstrGeoShapesConfig.xml il file sarà simile al seguente:

          Copia 
          <layers>
              <layer id="900" title="My Custom Map Layer" ml="MyCustomShapesFile.kml">
                  <shapeKeys>
                      <shapeKey key="abbr" path="/ExtendedData/Data[@name='abbreviatedName']/value"/>
                  </shapeKeys>
              </layer>
          </layers>

    • Per il bambino< forma> elementi sotto l'elemento padre <shapes> elemento, procedere come segue:

      • Rimuovi eventuali elementi figlio <shape> elementi non necessari per l'ambiente. Il plug-in fornito contiene tre di questi elementi. Una identifica le forme per nome, un'altra per abbreviazione e la terza per ID. Questi valori sono identificati da shapeKey attributo.

        • Se non si desidera utilizzarne uno o più, eliminare gli elementi appropriati.

        • Se si desidera utilizzarne uno o più, conservare gli elementi appropriati.

        • Se si desidera identificare le forme in base a un valore diverso, modificare il valore di shapeKey attributo in uno dei file <shape> elementi. Ad esempio, se si desidera utilizzare un valore denominato SMSA per identificare le forme, il codice potrebbe avere il seguente aspetto:

          Il valore shapeKey fa distinzione tra maiuscole e minuscole.

          Copia 
          <shape
          ...
              shapeKey="SMSA"
          ...
          />

      • Per ogni figlio <shape> elemento necessario per l'ambiente:

        • Per il id Sostituire il valore corrente con uno univoco (non già utilizzato da MicroStrategy per una forma). Questo valore identifica in modo univoco questa definizione di forma personalizzata.

        • Per il custom Mantiene il valore corrente di &quot;true&quot;.

        • Per il plugin, se si utilizza il plug-in predefinito fornito, mantenere il valore corrente di ConnectorForMap oppure impostarlo su un nome diverso se è stato creato un plug-in con un altro nome.

        • Per il desc, modificare il valore corrente impostandolo su una descrizione significativa. Questo è il valore visualizzato nell'elenco a discesa Confini del riquadro Proprietà per la visualizzazione Mappa ESRI quando si sceglie di visualizzare una mappa con aree. Ad esempio, il valore potrebbe essere se si tratta di regioni identificate da SMSA desc="Regions by SMSA". In alternativa, se si tratta di stati identificati da abbreviazioni di stato, il valore potrebbe essere desc="Custom States by Abbr". Per localizzare la descrizione, è necessario aggiungere i valori per i seguenti attributi aggiuntivi:

          • descWeb

          • descFlash

          • descDesktop

        • Per il roleId, modificare il valore corrente nel ruolo geografico per le forme personalizzate utilizzando uno dei seguenti valori:

          roleId descrizione

          1

          		 Città

          2

          		 Stato

          3

          		 Paese

          4

          		 Posizione

          5

          		 Latitudine

          6

          		 Longitudine

          7

          		 Altro

          8

          		 Codice postale (ZIP)

          9

          		 Contea

          • Per il type Mantiene il valore corrente di &quot;Poligono&quot;.

            Sia per il file di forma ESRI sia per il file di forma KML è supportato solo il poligono.

          • Per il default, se non si desidera che questo sia il file di forma predefinito, mantenere &quot;false&quot; come valore corrente; in caso contrario, impostarlo su &quot;true&quot;.

          • Utilizzare il shapeCat se è necessario disporre di un'identificazione più granulare per una forma. La categoria della forma è un numero intero, ad esempio 1002 per i Paesi, 1003 per gli Stati Uniti e 1004 per le contee degli Stati Uniti. Si supponga, ad esempio, di scegliere &quot;7&quot; (Other) come valore dell'attributo roleId e di voler utilizzare gli SMSA per definire le forme. È possibile impostare l'attributo shapeCat su un valore non utilizzato da MicroStrategy. Inoltre, per visualizzare la forma personalizzata sui dispositivi mobili è necessario un valore shapeCat univoco.

          • Per il shapeKey, impostarlo sul valore che sarà utilizzato per far corrispondere le forme ai dati. Ad esempio, nel codice precedente i valori erano name, id e desc. Questo è il valore di key nell'attributo <shapeKey> elemento in <layers> gerarchia.

          • Per il layerid, impostarlo sul valore di id attributo utilizzato per <layer> elemento in <layers> gerarchia che fa riferimento al file KML associato a questo livello mappa. Ad esempio, layerid="900".

          • Utilizzare il sf e sfr attributi se sono necessarie informazioni geografiche aggiuntive per rendere univoca una località. Posizioni diverse potrebbero avere lo stesso nome di località principale e richiedere un nome di località secondaria per renderle univoche. Ad esempio, molte contee negli Stati Uniti hanno il nome "Washington". Questo nome di contea è univoco all'interno di uno stato, ma non al di fuori dello stato perché il nome della località principale esiste in più stati. Per identificare in modo univoco una contea di questo tipo, è necessario qualificarla con il nome dello stato. Quando si esegue questa operazione, Washington, AL diventa completamente diversa da Washington, GA o Washington, PA.

            • Impostare il sf attributo al campo del percorso secondario che sarà utilizzato per abbinare le forme ai dati. È analogo a shapeKey attributo per il campo primario.

            • Impostare il sfr al ruolo del percorso secondario che sarà utilizzato per abbinare le forme ai dati. È analogo a roleId attributo per il campo primario. Ad esempio, se il ruolo del campo principale è county, è possibile impostare questo valore su state.

    Salvare le modifiche.

  3. Verificare di poter utilizzare le forme personalizzate.

    1. Riavviare MicroStrategy Web.

    2. Utilizzare la visualizzazione Mappa ESRI in un dashboard VI e selezionare Mappa dell'area come Map Type nel riquadro Proprietà.

    3. Espandere l'elenco a discesa Confini nel riquadro Proprietà ESRI. Assicurarsi che includa la descrizione delle forme personalizzate come opzione.

    4. Scegliere l'opzione per le forme personalizzate. La visualizzazione Mappa legge il file KML specificato nell'attributo ml di <layer> nodo in mstrGeoShapesConfig.xml ed esegue il rendering delle forme personalizzate appropriate.

    5. In caso di problemi, consultare i seguenti suggerimenti per la risoluzione dei problemi:

      • Verificare che la tabella del report a cui si applica la visualizzazione contenga elementi di attributo che corrispondono al valore di <name> elemento per <Placemark> elementi nel file KML.

      • Verificare che i valori utilizzati in KML e mstrGeoShapesConfig.xml i file nel plug-in sono corretti. Tutti questi valori fanno distinzione tra maiuscole e minuscole.

      • Assicurarsi che ogni elemento abbia un tag di fine.

      • Per impostazione predefinita, i clienti di MicroStrategy Cloud non possono utilizzare mappe ESRI personalizzate basate su cloud; utilizzano server pubblici ESRI. Se desiderano utilizzare i server pubblici ESRI, devono farlo abilitare l'autenticazione client.