Archivo de configuración de ESRI

Al instalar MicroStrategy Web, el archivo de configuración de ESRI, mapConfig.xml, se guarda por defecto en WEB-INF/xml/config en el directorio de instalación de MicroStrategy Web.

Para instalar y configurar la integración de mapas ESRI personalizada, crear un complemento y copie el archivo de configuración de ESRI listo para usar en el complemento. Todos los cambios de personalización se realizan en el archivo del complemento, no en el archivo estándar. Esto le permite guardar la clave de mapa de MicroStrategy y mantener las personalizaciones durante una actualización. Todas las referencias a la personalización hacen referencia al archivo de configuración de ESRI en el complemento.

El contenido del paquete listo para usar mapConfig.xml a continuación se muestran seguidas de una tabla que explica cada uno de los elementos y atributos del archivo.

Copiar

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

Estructura XML

La siguiente tabla describe todos los atributos y elementos del archivo de configuración de ESRI. Las tres columnas de la tabla incluyen la siguiente información:

Elemento padre

- Elemento hijo 1

- Elemento hijo 2

Indica el nombre del elemento descrito en las dos columnas siguientes. Si se trata de un elemento padre, los nombres de todos los elementos hijo posibles se enumeran debajo del elemento padre.

Número de nodos

Especifica el número de nodos que son necesarios o permitidos para el elemento correspondiente en la columna Elemento padre. Por ejemplo, si el valor es "1", solo debe haber un nodo, ni más ni menos. Si el valor es "0 o más", el nodo no es necesario ("0"), pero no hay restricción en cuanto al número de nodos que se pueden añadir ("o más"). Si el valor es "1 o más", el nodo es necesario ("1"), pero no hay restricción en el número de nodos que se pueden añadir ("o más").

Descripción

Describe el elemento padre en la columna Elemento padre.

Elemento padre	Número de nodos	Descripción
<mc>	1	El< mc> es el nodo raíz del archivo de configuración del mapa. Es el nodo principal de los nodos contenedores secundarios para un tipo diferente de configuración de asignación.
<ce> -< bms> -< pjs> -< aplicaciones> -< webmaps> -< capas> -< formas>	1	El< ce> es el nodo padre de la configuración de ESRI. Es el nodo principal de los nodos contenedores secundarios de los mapas base y los proyectos.
<bms> -< bm>	1	El< bms> es el nodo contenedor de todos los mapas base. Contiene un nodo independiente para cada mapa base.
<pjs> -< pj>	1	El< pjs> es el nodo contenedor de todos los proyectos. Contiene un nodo independiente para cada proyecto.
<aplicaciones> -< aplicación>	1	El< aplicaciones> es el nodo contenedor de todas las aplicaciones de mapas en la web. Contiene un nodo independiente para cada aplicación. El valor de< aplicaciones> proporciona la clave del MicroStrategy Map. Para utilizar la integración con mapas lista para usar de MicroStrategy, los usuarios deben pedirle su clave al soporte técnico de MicroStrategy e introducirla como el valor de este elemento.
<webmaps> -< mapa web>	1	El< webmaps> El elemento es el nodo contenedor de todos los mapas Web. Contiene un nodo independiente para cada mapa web.
<capas> -< capa>	1	El< capas> es el nodo contenedor de todas las capas del mapa. Contiene un nodo independiente para cada capa de mapa.
<formas> -< forma>	1	El< formas> es el nodo contenedor de todas las definiciones de área de mapa. Contiene un nodo independiente para cada definición de área de mapa.
<bm>	1 o más	El< bm> identifica un único mapa base. Este mapa base puede estar en un ArcGIS Server local o en un servidor público en la nube; viene determinado por la URL que proporcione como valor. Este elemento tiene los siguientes atributos: El atributo de clave se establece automáticamente en "por defecto". Para utilizar servicios de mapas dinámicos en lugar de servicios de mapas en caché, agregue el atributo isDyn y establézcalo en "1". Para utilizar siempre el servidor proxy, agregue el atributo proxyURL y establézcalo en "true". El valor de este elemento es una ruta URL válida al mapa base de ESRI utilizado por el widget de mapa. Por ejemplo: http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer
<pj> -< a las>	1 o más	El< pj> identifica un único proyecto y es el nodo contenedor de todos los atributos geográficos asignados a ese proyecto. Este elemento tiene el siguiente atributo: El valor del atributo id es un GUID, entre comillas dobles, para el proyecto de MicroStrategy que proporciona datos para el widget de mapa. Por ejemplo: "B19DEDC11D4E0EFC000EB9495D0F44F"
<mapa web>	1 o más	El< mapa web> identifica un único mapa web. Este elemento tiene los siguientes atributos: El atributo id se establece en el valor del identificador ESRI para el mapa web. El atributo de este elemento se establece en "verdadero" para indicarle a la aplicación que use este mapa web. Si este atributo falta o se establece en "false", este mapa web no se utiliza. El elemento por defecto identifica el mapa web de MicroStrategy listo para usar que se utiliza para la integración del mapa lista para usar.
<aplicación> -< clave>	1 o más	El< aplicación> identifica una única aplicación de mapa en la web. La finalidad principal de este nodo es alojar las credenciales de ESRI asociadas a esta aplicación de mapa web en particular. Este elemento tiene los siguientes atributos: El atributo de ID de este elemento está establecido en un valor único. Equivale al valor del atributo en el nodo para este mapa web. Permite que la aplicación recupere las credenciales de ESRI correctas (AppID y AppSecret) que se utilizarán para acceder al mapa web privado en la nube de ESRI. El atributo AppID está establecido en el valor que se generó cuando se creó y registró la aplicación de mapa en la web. El atributo AppSecret está establecido en el valor que se generó cuando la aplicación de mapa en la web se creó y registró.
<clave>	1	El< clave> identifica el valor de la clave del MicroStrategy Map que le proporcionó el soporte técnico de MicroStrategy para integración de mapas lista para usar.
<capa>	1 o más	El< capa> identifica una sola capa de mapa. Este elemento tiene los siguientes atributos: El atributo id es un número entero único que identifica esta capa de mapa. El atributo de título es un nombre descriptivo único; por ejemplo, "Estados de EE. UU.". El atributo ml es una ruta de URL válida a una capa de mapa/documento específica en un servidor ESRI que proporciona datos al widget de mapa. Por ejemplo: "http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0"
<forma>	1 o más	El< forma> identifica una única definición de área de mapa. Este elemento tiene los siguientes atributos: El atributo id es un número entero único que identifica esta definición de área de mapa. El atributo por defecto es un valor booleano que especifica si esta es la definición de área de mapa por defecto. El atributo personalizado es opcional y se establece en "true" para indicar que el mapa debe utilizar un archivo de forma personalizada. El atributo de complemento es opcional y se establece en el nombre del complemento de formas personalizadas cuando crear y usar formas personalizadas. El atributo desc es una descripción de la definición del área del mapa; por ejemplo, " Nombres de estados de EE. UU. " El atributo roleId identifica la función geográfica del atributo geográfico principal. El atributo de tipo está establecido en "POLYGON". El atributo descWeb es una referencia a un archivo que tiene la descripción para esta definición de área de mapa cuando se utiliza en MicroStrategy Web. Por ejemplo: "mstrweb.9229". El atributo descFlash es una referencia a un archivo que tiene la descripción para esta definición de área de mapa cuando se utiliza en la vista Flash. Por ejemplo, "mstr.1622". El atributo descDesktop es una referencia a un archivo que tiene la descripción para esta definición de área de mapa cuando se utiliza en MicroStrategy Desktop. Por ejemplo, "26973". El atributo qf especifica los nombres de los campos de consulta/atributos geográficos en la base de datos de ESRI que proporcionan datos al widget de mapa. Estos nombres de campo se utilizan para construir la cláusula SELECT en la instrucción SQL que recupera los datos de la base de datos de ESRI. El valor de este atributo es un nombre de campo/atributo geográfico válido y está entre corchetes y comillas simples. Por ejemplo, ['STATE_NAME']. El atributo sf identifica el atributo geográfico secundario. Este valor debe coincidir con el valor del atributo sf en el< elemento> del archivo de configuración de conversiones de nombres del mapa. Cada< elemento> define una regla de conversión de nombre. El atributo geográfico secundario se puede utilizar para restringir aún más una regla de conversión de nombres. El atributo sfr identifica la función geográfica del atributo geográfico secundario. El atributo pk identifica la clave primaria del elemento. El atributo ea especifica el atributo geográfico de ESRI cuyo atributo de MicroStrategy correspondiente se utiliza para recuperar los datos de MicroStrategy utilizados por el widget de mapa. Este valor se utiliza para construir la cláusula WHERE en la instrucción SQL que recupera los datos de la base de datos de ESRI (el valor sigue a la izquierda del signo igual). El valor de este atributo es un nombre de campo/atributo geográfico válido. El atributo layerId hace referencia al atributo de la< capa> utilizado por esta forma.
<a las> -< ml> -< gf> -< ea>	1 o más	El< a las> identifica un solo atributo geográfico de MicroStrategy y es el nodo contenedor de la información necesaria para construir la instrucción SQL utilizada para recuperar datos de la base de datos ESRI. El valor de< a las> se utiliza para construir la cláusula WHERE en la instrucción SQL que recupera los datos de la base de datos de ESRI (el valor a la derecha del signo igual). Este elemento tiene el siguiente atributo: El valor del atributo de ID de este elemento es GUID válido, entre paréntesis, para un atributo geográfico en el proyecto principal de MicroStrategy asignado a un atributo geográfico de ESRI. Por ejemplo: "54BABC8311D59D57C000B28A4CC5F24F" El valor de ESRI correspondiente para la cláusula WHERE se obtiene mediante el nombre de campo de ESRI especificado por el< ea> elemento.
<ml>	1	El< ml> El elemento especifica una única capa de mapa, que representa la tabla ESRI que se va a consultar. Este valor se utiliza para construir la cláusula FROM en la instrucción SQL que recupera los datos de la base de datos de ESRI. El valor de este elemento es una ruta URL válida a una capa de mapa/documento específica en un servidor ESRI que proporciona datos al widget de mapa. Por ejemplo: http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5. Puede ser el mismo servidor ESRI que proporciona el mapa base u otro servidor. Puede ser un ArcGIS Server local o un servidor público en la nube.
<qf>	1	El< qf> El elemento especifica los nombres de los campos de consulta/atributos geográficos en la base de datos de ESRI que proporcionan datos al widget de mapa. Estos nombres de campo se utilizan para construir la cláusula SELECT en la instrucción SQL que recupera los datos de la base de datos de ESRI. Se puede hacer referencia a ellas como macros en el HTML de una ventana de información personalizada. Los valores de este elemento son nombres de campo/atributos geográficos válidos, entre comillas simples, en la tabla de base de datos ESRI especificada por el elemento. Por ejemplo: 'STATE_NAME', 'POP2008' o 'ZIP'. Si se proporciona más de un valor, la lista completa de valores debe ir entre corchetes, cada valor individual debe ir entre comillas simples y separarse por comas. Uno de los valores debe ser el atributo geográfico de ESRI asignado a un atributo de MicroStrategy (el atributo especificado por el atributo).
<ea>	1	El< ea> especifica el atributo geográfico de ESRI cuyo atributo de MicroStrategy correspondiente se utiliza para recuperar los datos de MicroStrategy utilizados por el widget de mapa. Este valor se utiliza para construir la cláusula WHERE en la instrucción SQL que recupera los datos de la base de datos de ESRI (el valor sigue a la izquierda del signo igual). El valor de este< ml> El elemento es un nombre de campo/atributo geográfico válido, entre comillas simples, en la tabla de base de datos ESRI especificada por el elemento. Por ejemplo: STATE_NAME o ZIP . El valor de MicroStrategy correspondiente para la cláusula WHERE se obtiene mediante el GUID del atributo de MicroStrategy especificado por el< a las> elemento.

Relacionado

KB483288: La conexión con ESRI se restablece en Web aunque la conexión entre el equipo del servidor de web y los servidores de ArcGIS está disponible