Strategy ONE

Arquivo de configuração ESRI

Quando você instala MicroStrategy Web, o arquivo de configuração ESRI, mapConfig.xml, é salvo por padrão em WEB-INF/xml/config no MicroStrategy Web diretório de instalação.

Para instalar e configurar a integração de mapas ESRI personalizados, você criar um plug-in e copie o arquivo de configuração ESRI pronto para uso para o plug-in. Você faz todas as alterações de personalização no arquivo do plug-in, e não no arquivo pronto para uso. Isso permite que você salve seu MicroStrategy chave do mapa e mantenha suas personalizações durante uma atualização. Todas as referências à customização referem-se ao arquivo de configuração ESRI no plug-in.

O conteúdo pronto para uso mapConfig.xml arquivo são mostrados abaixo, seguidos por uma tabela que explica cada um dos elementos e atributos do arquivo.

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>

Estrutura XML

A tabela abaixo descreve todos os atributos e elementos do arquivo de configuração ESRI. As três colunas da tabela incluem as seguintes informações:

Elemento pai

  • Elemento filho 1

  • Elemento filho 2

Indica o nome do elemento descrito nas próximas duas colunas. Se este for um elemento pai, os nomes de todos os elementos filhos possíveis serão listados abaixo do elemento pai.

Número de nós

Especifica o número de nós necessários ou permitidos para o elemento correspondente na coluna Elemento Pai. Por exemplo, se o valor for "1", deverá haver apenas um nó — nem mais, nem menos. Se o valor for “0 ou mais”, o nó não é obrigatório (“0”), mas não há restrição quanto ao número de nós que podem ser adicionados (“ou mais”). Se o valor for “1 ou mais”, o nó é obrigatório (“1”), mas não há restrição quanto ao número de nós que podem ser adicionados (“ou mais”).

Descrição

Descreve o elemento pai na coluna Elemento Pai.

Elemento pai Número de nós Descrição
<mc> 1 O elemento <mc> é o nó raiz do arquivo de configuração do mapa. É o nó pai dos nós de contêiner filho para um tipo diferente de configuração de mapa.

<ec>

  • <bms>
  • <pjs>
  • <aplicativos>
  • <mapas da web>
  • <camadas>
  • <formas>

1

O elemento <ec> é o nó pai da configuração ESRI. É o nó pai dos nós de contêiner filho para mapas e projetos base.

<bms>

  • <bm>

1

O elemento <bms> é o nó contêiner para todos os mapas base. Ele contém um nó separado para cada mapa base.

<pjs>

  • <pj>

1

O elemento <pjs> é o nó contêiner para todos os projetos. Ele contém um nó separado para cada projeto.

<aplicativos>

  • <aplicativo>

1

O elemento <apps> é o nó contêiner para todos os aplicativos de mapas da web. Ele contém um nó separado para cada aplicativo. O valor do<apps> elemento fornece o MicroStrategy Chave do mapa. Para ser usado MicroStrategyCom a integração de mapa pronta para uso, os usuários devem obter sua chave em MicroStrategy Suporte Técnico e insira-o como o valor deste elemento.

<mapas da web>

  • <mapa da web>

1

O elemento <webmaps> é o nó contêiner para todos os mapas da web. Ele contém um nó separado para cada mapa da web.

<camadas>

  • <camada>

1

O elemento <layers> é o nó contêiner para todas as camadas do mapa. Ele contém um nó separado para cada camada do mapa.

<formas>

  • <forma>

1

O elemento <shapes> é o nó contêiner para todas as definições de área do mapa. Ele contém um nó separado para cada definição de área do mapa.

<bm>

1 ou mais

O elemento <bm> identifica um único mapa base. Este mapa base pode estar em um ArcGIS Server local ou em um servidor público na nuvem; isso é determinado pelo URL que você fornece como valor. Este elemento possui os seguintes atributos:

  • O atributo chave é automaticamente definido como "padrão".

  • Para usar serviços de mapas dinâmicos em vez de serviços de mapas em cache, adicione o atributo isDyn e defina-o como "1".

  • Para sempre usar o servidor proxy, adicione o atributo proxyURL e defina-o como “true”.

O valor deste elemento é um caminho de URL válido para o mapa base ESRI que é usado pelo widget Mapa.

Por exemplo: http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer

<pj>

  • <em>

1 ou mais

O elemento <pj> identifica um único projeto e é o nó do contêiner para todos os atributos geográficos mapeados nesse projeto. Este elemento possui o seguinte atributo:

  • O valor do atributo id é um GUID, entre aspas duplas, para o MicroStrategy projeto que fornece dados para o widget Mapa. Por exemplo: "B19DEDCC11D4E0EFC000EB9495D0F44F"

<mapa da web>

1 ou mais

O elemento <webmap> identifica um único mapa da web. Este elemento possui os seguintes atributos:

  • O atributo id é configurado com o valor do identificador ESRI para o mapa da web.

  • O atributo deste elemento é definido como "true" para informar ao aplicativo para usar este mapa da web. Se este atributo estiver ausente ou definido como "false", este mapa da web não será usado.

O elemento padrão identifica o pronto para uso MicroStrategy web mapa que é usado para integração de mapas pronta para uso.

 

<aplicativo>

  • <chave>

1 ou mais

O elemento <app> identifica um único aplicativo de mapa da web. O objetivo principal deste nó é hospedar as credenciais ESRI associadas a um determinado aplicativo de mapa da web. Este elemento possui os seguintes atributos:

  • O atributo id deste elemento é definido com um valor exclusivo. Este é o mesmo valor que o valor do atributo no nó deste mapa da web. Ele permite que o aplicativo recupere as credenciais ESRI corretas (AppID e AppSecret) a serem usadas para acessar o mapa da web privado na nuvem ESRI.

  • O atributo AppID é configurado com o valor que foi gerado quando o aplicativo de mapa da web foi criado e registrado.

  • O atributo AppSecret é configurado com o valor que foi gerado quando o aplicativo de mapa da web foi criado e registrado.

<chave>

1

O<key> elemento identifica o valor do MicroStrategy Chave do mapa fornecida a você por MicroStrategy Suporte Técnico para integração de mapas pronta para uso.

<camada>

1 ou mais

O elemento <layer> identifica uma única camada do mapa. Este elemento possui os seguintes atributos:

  • O atributo id é um número inteiro exclusivo que identifica esta camada do mapa.

  • O atributo title é um nome descritivo exclusivo, como "Estados dos EUA".

  • O atributo ml é um caminho de URL válido para uma camada específica de documento/mapa em um servidor ESRI que fornece dados para o widget Mapa. Por exemplo: "http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0"

<forma>

1 ou mais

O elemento <shape> identifica uma única definição de área do mapa. Este elemento possui os seguintes atributos:

  • O atributo id é um número inteiro exclusivo que identifica esta definição de área do mapa.

  • O atributo padrão é um BOOLEAN que especifica se esta é a definição de área do mapa padrão.

  • O atributo personalizado é opcional e definido como "true" para indicar que o mapa deve use um arquivo de formato personalizado.

  • O atributo plugin é opcional e é definido como o nome do plug-in de formas personalizadas quando você criar e usar formas personalizadas.

  • O atributo desc é uma descrição da definição da área do mapa, como "Nomes de estados dos EUA".

  • O atributo roleId identifica a função geográfica do atributo geográfico primário.

  • O atributo type está definido como "POLYGON".

  • O atributo descWeb é uma referência a um arquivo que possui a descrição para esta definição de área do mapa quando usado em MicroStrategy Web. Por exemplo: "mstrweb.9229."

  • O atributo descFlash é uma referência a um arquivo que possui a descrição para esta definição de área do mapa quando usada na visualização Flash. Por exemplo, "mstr.1622."

  • O atributo descDesktop é uma referência a um arquivo que possui a descrição para esta definição de área do mapa quando usado em MicroStrategy Desktop. Por exemplo, “26973”.

  • O atributo qf especifica os nomes dos campos de consulta/atributos geográficos no banco de dados ESRI que fornece dados para o widget Mapa. Esses nomes de campos são usados para construir a cláusula SELECT na instrução SQL que busca dados do banco de dados ESRI. O valor deste atributo é um nome de campo/atributo geográfico válido, entre colchetes e aspas simples. Por exemplo, ['ESTADO_NOME'].

  • O atributo sf identifica o atributo geográfico secundário. Este valor deve corresponder ao valor do atributo sf no elemento <elem> do arquivo de configuração de conversões de nome de mapa. Cada elemento <elem> define uma regra de conversão de nome. O atributo geográfico secundário pode ser usado para restringir ainda mais uma regra de conversão de nome.

  • O atributo sfr identifica a função geográfica do atributo geográfico secundário.

  • O atributo pk identifica a chave primária do elemento.

  • O atributo ea especifica o atributo geográfico ESRI cujo mapeamento correspondente MicroStrategy atributo é usado para recuperar o MicroStrategy dados usados pelo widget Mapa. Este valor é usado para construir a cláusula WHERE na instrução SQL que busca dados do banco de dados ESRI (o valor após e à esquerda do sinal de igual). O valor deste atributo é um nome de campo/atributo geográfico válido.

  • O atributo layerId faz referência ao atributo do elemento <layer> específico usado por esta forma.

<em>

  • <ml>

  • <gf>

  • <de>

1 ou mais

O<at> elemento identifica um único MicroStrategy atributo geo e é o nó do contêiner para as informações necessárias para construir a instrução SQL usada para buscar dados do banco de dados ESRI.

O valor do elemento <at> é usado para construir a cláusula WHERE na instrução SQL que busca dados do banco de dados ESRI (o valor à direita do sinal de igual).

Este elemento possui o seguinte atributo:

O valor ESRI correspondente para a cláusula WHERE é obtido usando o nome do campo ESRI especificado pelo elemento <ea>.

<ml>

1

O elemento <ml> especifica uma única camada de mapa, que representa a tabela ESRI a ser consultada. Este valor é usado para construir a cláusula FROM na instrução SQL que busca dados do banco de dados ESRI.

O valor deste elemento é um caminho de URL válido para uma camada de documento/mapa específica em um servidor ESRI que fornece dados para o widget Mapa. Por exemplo: http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5.

Este pode ser o mesmo servidor ESRI que fornece o mapa base ou um servidor diferente. Pode ser um ArcGIS Server local ou um servidor público na nuvem.

<qf>

1

O elemento <qf> especifica os nomes dos campos de consulta/atributos geográficos no banco de dados ESRI que fornece dados para o widget Mapa. Esses nomes de campo são usados para construir a cláusula SELECT na instrução SQL que busca dados do banco de dados ESRI. Eles podem ser referenciados como macros no HTML para uma janela de informações personalizada.

Os valores deste elemento são nomes de campo/atributos geográficos válidos, entre aspas simples, na tabela de banco de dados ESRI especificada pelo elemento. Por exemplo: 'STATE_NAME','POP2008' ou 'ZIP'.

Se mais de um valor for fornecido, toda a lista de valores deverá ser colocada entre colchetes, com cada valor individual entre aspas simples e separado por vírgulas. Um dos valores deve ser o atributo geográfico ESRI que está mapeado para um MicroStrategy atributo (o atributo especificado pelo atributo).

<de>

1

O<ea> elemento especifica o atributo geográfico ESRI cujo correspondente mapeado MicroStrategy atributo é usado para recuperar o MicroStrategy dados usados pelo widget Mapa. Este valor é usado para construir a cláusula WHERE na instrução SQL que busca dados do banco de dados ESRI (o valor após e à esquerda do sinal de igual).

O valor deste elemento <ml> é um nome de campo/atributo geográfico válido, entre aspas simples, na tabela de banco de dados ESRI especificada pelo elemento. Por exemplo: STATE_NAME ou ZIP .

O correspondente MicroStrategy o valor da cláusula WHERE é obtido usando o MicroStrategy atributo GUID especificado pelo<at> elemento.

Relacionado

KB483288: A conexão com ESRI é redefinida na Web embora a conexão entre a máquina do servidor web e os servidores ArcGIS esteja disponível