Fichier de configuration ESRI

Lorsque vous installez MicroStrategy Web, le fichier de configuration ESRI, mapConfig.xml, est enregistré par défaut sous WEB-INF/xml/config dans le répertoire d'installation MicroStrategy Web.

Pour installer et configurer l'intégration de carte ESRI personnalisée, vous créer un plug-in et copiez le fichier de configuration ESRI prêt à l'emploi vers le plug-in. Vous apportez toutes vos modifications de personnalisation au fichier dans le plug-in, et non au fichier prêt à l'emploi. Cela vous permet d'enregistrer votre clé de carte MicroStrategy et de conserver vos personnalisations pendant une mise à niveau. Toutes les références à la personnalisation font référence au fichier de configuration ESRI dans le plug-in.

Contenu de la boîte d'origine mapConfig.xml Le fichier est présenté ci-dessous, suivi d'un tableau qui explique chacun des éléments et attributs du fichier.

Copier

<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>

Structure XML

Le tableau ci-dessous décrit tous les attributs et éléments du fichier de configuration ESRI. Les trois colonnes de la table contiennent les informations suivantes :

Élément parent

- Élément enfant 1

- Élément enfant 2

Indique le nom de l'élément décrit dans les deux colonnes suivantes. S'il s'agit d'un élément parent, les noms de tous les éléments fils possibles sont répertoriés sous l'élément parent.

Nombre de nœuds

Indique le nombre de nœuds requis ou autorisés pour l'élément correspondant dans la colonne Élément parent. Par exemple, si la valeur est « 1 », il doit y avoir un seul nœud – ni plus, ni moins. Si la valeur est « 0 ou plus », le nœud n'est pas obligatoire (« 0 »), mais il n'y a aucune restriction sur le nombre de nœuds qui peuvent être ajoutés (« ou plus »). Si la valeur est « 1 ou plus », le nœud est requis (« 1 »), mais il n'y a aucune restriction sur le nombre de nœuds qui peuvent être ajoutés (« ou plus »).

Description

Décrit l'élément parent dans la colonne Élément parent.

Élément parent	Nombre de nœuds	Description
<mc>	1	Le< mc> L'élément est le nœud racine du fichier de configuration de la carte. Il s'agit du nœud parent des nœuds de conteneur fils pour un type différent de configuration de carte.
<ce> -< bms> -< pjs> -< applications> -< cartes Web> -< couches> -< formes>	1	Le< ce> L'élément est le nœud parent pour la configuration ESRI. Il s'agit du nœud parent pour les nœuds de conteneur fils pour les cartes de base et les projets.
<bms> -< bm>	1	Le< bms> L'élément est le nœud de conteneur pour toutes les cartes de base. Elle contient un nœud séparé pour chaque carte de base.
<pjs> -< pj>	1	Le< pjs> L'élément est le nœud de conteneur pour tous les projets. Il contient un nœud distinct pour chaque projet.
<applications> -< application>	1	Le< applications> L'élément est le nœud de conteneur pour toutes les applications de carte Web. Il contient un nœud distinct pour chaque application. La valeur de< applications> L'élément fournit la clé MicroStrategy Map. Pour utiliser l'intégration de carte prête à l'emploi de MicroStrategy, les utilisateurs doivent obtenir leur clé auprès du Support technique de MicroStrategy et la saisir comme valeur de l'élément.
<cartes Web> -< carte Web>	1	Le< cartes Web> L'élément est le nœud de conteneur pour toutes les cartes Web. Elle contient un nœud distinct pour chaque carte Web.
<couches> -< couche>	1	Le< couches> L'élément est le nœud de conteneur pour toutes les couches de carte. Il contient un nœud séparé pour chaque couche de carte.
<formes> -< forme>	1	Le< formes> L'élément est le nœud de conteneur pour toutes les définitions de zones de carte. Elle contient un nœud séparé pour chaque définition de zone de carte.
<bm>	1 ou plus	Le< bm> L'élément identifie une carte de base unique. Cette carte de base peut se trouver sur un serveur ArcGIS Server local ou sur un serveur public sur le cloud ; ceci est déterminé par l'URL que vous indiquez comme valeur. Cet élément a les attributs suivants : L'attribut de clé est automatiquement défini sur « par défaut ». Pour utiliser des services de carte dynamique au lieu de services de carte en cache, ajoutez l'attribut isDyn et définissez-le sur « 1 ». Pour toujours utiliser le serveur proxy, ajoutez l'attribut proxyURL et définissez-le sur « true ». La valeur de cet élément est un chemin URL valide vers la carte de base ESRI utilisée par le widget Carte. Par exemple : http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer
<pj> -< à>	1 ou plus	Le< pj> L'élément identifie un projet unique et est le nœud conteneur pour tous les attributs géographiques mappés de ce projet. Cet élément a l'attribut suivant : La valeur de l'attribut ID est un GUID, entre guillemets doubles, pour le projet MicroStrategy qui fournit des données pour le widget Map. Par exemple : « B19DEDCC11D4E0EFC000EB9495D0F44F »
<carte Web>	1 ou plus	Le< carte Web> L'élément identifie une carte Web unique. Cet élément a les attributs suivants : L'attribut ID est défini sur la valeur de l'identifiant ESRI pour la carte Web. L'attribut de cet élément est défini sur « true » pour indiquer à l'application d'utiliser cette carte Web. Si cet attribut est manquant ou défini sur « false », cette carte Web n'est pas utilisée. L'élément par défaut identifie la carte Web MicroStrategy prête à l'emploi qui est utilisée pour l'intégration de carte prête à l'emploi.
<application> -< clé>	1 ou plus	Le< application> L'élément identifie une application de carte Web unique. Le but principal de ce nœud est d'héberger les informations d'identification ESRI associées à une application de carte Web particulière. Cet élément a les attributs suivants : L'attribut ID de cet élément est défini sur une valeur unique. Il s'agit de la même valeur que la valeur de l'attribut dans le nœud pour cette carte Web. Cela permet à l'application de récupérer les informations d'identification ESRI correctes (AppID et AppSecret) à utiliser pour accéder à la carte Web privée sur le cloud ESRI. L'attribut AppID est défini sur la valeur générée lors de la création et de l'inscription de l'application de carte Web. L'attribut AppSecret est défini sur la valeur générée lors de la création et de l'inscription de l'application de carte Web.
<clé>	1	Le< clé> L'élément identifie la valeur de la clé MicroStrategy Map qui vous est fournie par le Support technique de MicroStrategy pour intégration de carte prête à l'emploi.
<couche>	1 ou plus	Le< couche> L'élément identifie une seule couche de carte. Cet élément a les attributs suivants : L'attribut ID est un nombre entier unique qui identifie cette couche de carte. L'attribut de titre est un nom descriptif unique, par exemple « États-États-Unis ». L'attribut ml est un chemin d'accès URL valide vers une couche de document/carte spécifique sur un serveur ESRI qui fournit des données au widget Carte. Par exemple : « http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_États_Généralisé/FeatureServer/0 »
<forme>	1 ou plus	Le< forme> L'élément identifie une définition de zone de carte unique. Cet élément a les attributs suivants : L'attribut ID est un nombre entier unique qui identifie cette définition de zone de carte. L'attribut par défaut est un booléen qui indique s'il s'agit de la définition de la zone de carte par défaut. L'attribut personnalisé est facultatif et est défini sur « True » pour indiquer que la carte doit utiliser un fichier de forme personnalisée. L'attribut du plug-in est facultatif et est défini sur le nom du plug-in des formes personnalisées lorsque vous créer et utiliser des formes personnalisées. L'attribut desc est une description de la définition de la zone de carte, par exemple « Noms des États américains ». L'attribut rôleId identifie le rôle géographique de l'attribut géographique principal. L'attribut de type est défini sur « POLYGON ». L'attribut descWeb est une référence à un fichier qui contient la description pour cette définition de zone de carte lorsqu'elle est utilisée dans MicroStrategy Web. Par exemple : « mstrweb.9229 ». L'attribut descFlash est une référence à un fichier qui contient la description de cette définition de la zone de carte lorsqu'elle est utilisée dans la vue Flash. Par exemple, « mstr.1622 ». L'attribut descDesktop est une référence à un fichier qui contient la description de cette définition de zone de carte lorsqu'elle est utilisée dans MicroStrategy Desktop. Par exemple, « 26973 ». L'attribut qf indique les noms des champs de requête/attributs géo dans la base de données ESRI qui fournit les données au widget Carte. Ces noms de champs sont utilisés pour construire la clause SELECT dans l'instruction SQL qui récupère les données de la base de données ESRI. La valeur de cet attribut est un nom de champ/attribut géographique valide, entre parenthèses et guillemets simples. Par exemple, ['STATE_NAME']. L'attribut sf identifie l'attribut géographique secondaire. Cette valeur doit correspondre à la valeur de l'attribut sf dans< élément> élément du fichier de configuration des conversions de noms de carte. Chaque< élément> L'élément définit une règle de conversion de nom. L'attribut géographique secondaire peut être utilisé pour restreindre davantage une règle de conversion de nom. L'attribut sfr identifie le rôle géographique de l'attribut géographique secondaire. L'attribut pk identifie la clé primaire pour l'élément. L'attribut ea spécifie l'attribut géographique ESRI dont l'attribut MicroStrategy mappé correspondant est utilisé pour récupérer les données MicroStrategy utilisées par le widget Carte. Cette valeur est utilisée pour construire la clause WHERE dans l'instruction SQL qui récupère les données de la base de données ESRI (la valeur après et à gauche du signe égal). La valeur de cet attribut est un attribut nom de champ/géo valide. L'attribut coucheId fait référence à l'attribut de l'élément spécifique< couche> élément utilisé par cette forme.
<à> -< ml> -< gf> -< ch>	1 ou plus	Le< à> L'élément identifie un attribut géographique MicroStrategy unique et est le nœud de conteneur pour les informations requises pour construire l'instruction SQL utilisée pour récupérer les données de la base de données ESRI. La valeur de< à> L'élément est utilisé pour construire la clause WHERE dans l'instruction SQL qui récupère les données de la base de données ESRI (la valeur à droite du signe égal). Cet élément a l'attribut suivant : La valeur de l'attribut ID pour cet élément est valide GUID, entre parenthèses, pour un attribut géographique dans le projet MicroStrategy parent qui est mappé à un attribut géographique ESRI. Par exemple : « 54BABC8311D59D57C000B28A4CC5F24F » La valeur ESRI correspondante pour la clause WHERE est obtenue en utilisant le nom de champ ESRI spécifié par la< ch> élément.
<ml>	1	Le< ml> L'élément indique une couche de carte unique qui représente la table ESRI à interroger. Cette valeur est utilisée pour construire la clause De dans l'instruction SQL qui récupère les données de la base de données ESRI. La valeur de cet élément est un chemin d'accès URL valide vers une couche de document/carte spécifique sur un serveur ESRI qui fournit des données au widget Carte. Par exemple : http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographys/ESRI_Census_USA/MapServer/5. Il peut s'agir du même serveur ESRI qui fournit la carte de base ou d'un serveur différent. Cela peut être un serveur ArcGIS Server local ou un serveur public sur le cloud.
<qf>	1	Le< qf> L'élément indique les noms des champs de requête/attributs géographiques de la base de données ESRI qui fournit les données au widget Carte. Ces noms de champs sont utilisés pour construire la clause SELECT dans l'instruction SQL qui récupère les données de la base de données ESRI. Elles peuvent être référencées en tant que macros dans le code HTML d'une fenêtre d'informations personnalisées. Les valeurs de cet élément sont des noms de champs/attributs géographiques valides, entre guillemets simples, dans la table de la base de données ESRI spécifiée par l'élément. Par exemple : « STATE_NAME », « POP2008 » ou « ZIP ». Si plusieurs valeurs sont fournies, la liste entière de valeurs doit être entre crochets, chaque valeur individuelle étant entre guillemets simples et séparée par des virgules. L'une des valeurs doit être l'attribut géographique ESRI mappé à un attribut MicroStrategy (l'attribut spécifié par l'attribut).
<ch>	1	Le< ch> L'élément indique l'attribut géographique ESRI dont l'attribut MicroStrategy mappé correspondant est utilisé pour récupérer les données MicroStrategy utilisées par le widget Carte. Cette valeur est utilisée pour construire la clause WHERE dans l'instruction SQL qui récupère les données de la base de données ESRI (la valeur après et à gauche du signe égal). La valeur de ce< ml> L'élément est un nom de champ/attribut géographique valide, entre guillemets simples, dans la table de la base de données ESRI spécifiée par l'élément. Par exemple : STATE_NAME ou ZIP . La valeur MicroStrategy correspondante pour la clause WHERE est obtenue à l'aide de l'attribut MicroStrategy GUID spécifié par la< à> élément.

En rapport

KB483288: La connexion à l'ESRI est réinitialisée dans Web, bien que la connexion entre le serveur Web et les serveurs ArcGIS soit disponible