MicroStrategy ONE
ESRI 構成ファイル
MicroStrategy Webをインストールすると、ESRI構成ファイル、マップ構成.xmlは、デフォルトでWEB-INF/xml/config
MicroStrategy Web インストール ディレクトリ内。
カスタムESRIマップ統合を設定および構成するには、プラグインを作成するすぐに使用できる ESRI 構成ファイルをプラグインにコピーします。カスタマイズの変更はすべて、すぐに使用できるファイルではなく、プラグイン内のファイルに対して行います。こうすると、MicroStrategy マップ キーを保存して、アップグレードの際にカスタマイズを保持することができます。カスタマイズの参照はすべて、プラグイン内の ESRI 構成ファイルを参照します。
すぐに使える内容マップ構成.xmlファイルの内容は以下に示されており、その後にファイル内の各要素と属性を説明する表が続きます。
<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>
XML 構造
次の表は、ESRI 構成ファイル内のアトリビュートとエレメントのすべてについて説明しています。表内の 3 つの列には、次の情報が含まれます。
親エレメント - 子要素 1 - 子要素 2 |
後続の 2 列で説明されるエレメントの名前を示します。それが親エレメントである場合は、可能性のあるすべての子エレメントの名前が親エレメントの下に示されます。 |
ノード数 |
[親エレメント] 列内の対応するエレメントに必要な、または許可されるノードの数を指定します。たとえば、この値が「1」である場合は、1 つのノードのみが必要で、それより多くても少なくてもいけません。この値が「0 以上」である場合は、ノードは必要ありません (「0」) が、追加できるノードの数に制限はありません (「以上」) 。この値が「1 以上」である場合は、ノードが必要です (「1」) が、追加できるノードの数に制限はありません (「以上」) 。 |
説明 |
[親エレメント] 列内の親エレメントについて説明します。 |
親エレメント | ノード数 | 説明 |
---|---|---|
<mc> | 1 | <mc> エレメントはマップ構成ファイルのルート ノードです。これは、各種マップ構成の子コンテナー ノードの親ノードです。 |
-<ビーエムエス> -<パジャマ> -<アプリ> -<ウェブマップ> -<レイヤー> -<形状> |
1 |
<ec> エレメントは ESRI 構成の親ノードです。これは、基本地図とプロジェクトの子コンテナー ノードの親ノードです。 |
-<んんん> |
1 |
<bms> エレメントは、すべての基本地図のコンテナー ノードです。これには、基本地図ごとに個別のノードが含まれます。 |
-< pj> |
1 |
<pjs> エレメントは、すべてのプロジェクトのコンテナー ノードです。これには、プロジェクトごとに個別のノードが含まれます。 |
-<アプリ> |
1 |
<apps> エレメントは、すべてのウェブ地図アプリケーションのコンテナー ノードです。これには、アプリケーションごとに個別のノードが含まれます。<apps> エレメントの値によって MicroStrategy マップ キーが指定されます。MicroStrategy の事前設定された地図の統合を使用するためには、ユーザーは MicroStrategy テクニカル サポートからキーを取得し、それをエレメントの値として入力する必要があります。 |
-<ウェブマップ> |
1 |
<webmaps> エレメントは、すべてのウェブ地図のコンテナー ノードです。これには、ウェブ地図ごとに個別のノードが含まれます。 |
-<層> |
1 |
<layers> エレメントは、すべてのマップ レイヤーのコンテナー ノードです。これには、マップ レイヤーごとに個別のノードが含まれます。 |
-<形> |
1 |
<shapes> エレメントは、すべての地図領域定義のコンテナー ノードです。これには、地図領域定義ごとに個別のノードが含まれます。 |
1 以上 |
<bm> エレメントは、1 つの基本地図を特定します。この基本地図は、ローカルの ArcGIS サーバーまたはクラウド上のパブリック サーバーに配置できます。これは、値として提供する URL によって決まります。このエレメントではアトリビュートは次のようになります。 key アトリビュートが、自動的に "default" に設定されます。 キャッシュ マップ サービスではなく、ダイナミック マップ サービスを使用するには、isDyn アトリビュートを追加して、"1" に設定します。 常にプロキシ サーバーを使用するには、proxyURL アトリビュートを追加して、"true" に設定します。 このエレメントの値は、地図ウィジェットが使用する ESRI 基本地図への有効な URL パスです。 例: http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer |
|
-<で> |
1 以上 |
<pj> エレメントは、1 つのプロジェクトを特定するもので、そのプロジェクト内のマップされたすべての地理アトリビュートのコンテナー ノードです。このエレメントではアトリビュートは次のようになります。 id アトリビュートの値は、地図ウィジェットのためのデータを提供する MicroStrategy プロジェクトの GUID であり、二重引用符で囲まれます。例: 「B19DEDCC11D4E0EFC000EB9495D0F44F」 |
1 以上 |
<webmap> エレメントは、1 つのウェブ地図を識別します。このエレメントではアトリビュートは次のようになります。 id アトリビュートはウェブ地図の ESRI 識別子の値に設定されます。 このエレメントのアトリビュートが "true" に設定されていて、このウェブ地図を使用するようにアプリケーションに指示します。このアトリビュートがない場合、または "false" に設定されている場合、このウェブ地図は使用されません。 デフォルトの エレメントは、事前設定された地図の統合に使用される、事前設定された MicroStrategy のウェブ地図を識別します。
|
|
-<鍵> |
1 以上 |
<app> エレメントは、1 つのウェブ地図アプリケーションを識別します。このノードの主な目的は、特定のウェブ地図アプリケーションに関連付けられている ESRI 資格情報を保持することです。このエレメントではアトリビュートは次のようになります。 このエレメントの id アトリビュートは、一意の値に設定されます。これは、このウェブ地図のノード内のアトリビュートの値と同じ値です。このため、アプリケーションは、ESRI クラウドのプライベートなウェブ地図にアクセスするための正しい ESRI 資格情報 (AppID および AppSecret) を取得できます。 AppID アトリビュートは、ウェブ地図アプリケーションが作成されて登録されたときに生成された値に設定されます。 AppSecret アトリビュートは、ウェブ地図アプリケーションが作成されて登録されたときに生成された値に設定されます。 |
1 |
の<鍵>要素は、MicroStrategyテクニカルサポートから提供されたMicroStrategyマップキーの値を識別します。すぐに使えるマップ統合。 |
|
1 以上 |
<layer> エレメントは、1 つのマップ レイヤーを識別します。このエレメントではアトリビュートは次のようになります。 id アトリビュートは、このマップ レイヤーを識別する一意の整数です。 title アトリビュートは、"US-States" (米国の州) などの一意の説明的な名前です。 ml アトリビュートは、地図ウィジェットにデータを提供する ESRI サーバー上の特定のドキュメント/マップ レイヤーへの有効な URL パスです。例: "http://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0" |
|
1 以上 |
<shape> エレメントは、1 つの地図領域定義を識別します。このエレメントではアトリビュートは次のようになります。 id アトリビュートは、この地図領域定義を識別する一意の整数です。 default アトリビュートは、これがデフォルトの地図領域定義かどうかを指定するブール値です。 カスタム属性はオプションであり、マップがカスタムシェイプファイルを使用する。 プラグイン属性はオプションであり、カスタムシェイププラグインの名前に設定されます。カスタムシェイプを作成して使用する。 desc アトリビュートは、" US State Names" (米国の州の名前) などの地図領域定義の説明です。 roleId アトリビュートは、第一地理アトリビュートの地理ロールを識別します。 type アトリビュートは、"POLYGON" (ポリゴン) に設定されます。 descWeb アトリビュートは、MicroStrategy Web でこの地図領域定義が使用されるときに、その説明を含むファイルに対して行われる参照です。たとえば、「mstrweb.9229」などです。 descFlash アトリビュートは、Flash 表示でこの地図領域定義が使用されるときに、その説明を含むファイルに対して行われる参照です。たとえば、"mstr.1622" です。 descDesktop アトリビュートは、MicroStrategy Desktop でこの地図領域定義が使用されるるときに、その説明を含むファイルに対して行われる参照です。たとえば、"26973" です。 qf アトリビュートは、地図ウィジェットにデータを供給する ESRI データベース内のクエリ フィールド名/地理アトリビュートを指定します。これらのフィールド名は、ESRI データベースからデータを取得する SQL ステートメントの SELECT 句を作成するために使用されます。このアトリビュートの値は、角かっこと一重引用符で囲まれた、有効なフィールド名/地理アトリビュートです。たとえば、['STATE_NAME'] です。 sf アトリビュートは、第二の地理アトリビュートを識別します。この値は、地図の名前変換構成ファイルの <elem> エレメント内の sf アトリビュートの値と一致する必要があります。各 <elem> エレメントは、名前変換規則を定義します。第二の地理アトリビュートを使用して、名前変換規則をさらに制限することができます。 sfr アトリビュートは、第二地理アトリビュートの地理ロールを識別します。 pk アトリビュートは、エレメントの主キーを識別します。 ea アトリビュートは ESRI 地理アトリビュートを指定し、その ESRI 地理アトリビュートに対応するマップされた MicroStrategy アトリビュートが、地図ウィジェットが使用する MicroStrategy データを取得するために使用されます。この値は、ESRI データベースからデータを取得する SQL ステートメントの WHERE 句を作成するために使用されます (WHERE の後にあり、等号の左にある値)。このアトリビュートの値は、有効なフィールド名/地理アトリビュートです。 layerId アトリビュートは、このシェイプによって使用される特定の <layer> エレメントのアトリビュートを参照します。 |
|
-<ミリリットル> -<ガールフレンド> -<それぞれ> |
1 以上 |
<at> エレメントは、1 つの MicroStrategy 地理アトリビュートを識別し、ESRI データベースからデータを取得する SQL ステートメントを作成するのに必要な情報のためのコンテナー ノードです。 <at> エレメントの値は、ESRI データベースからデータを取得する SQL ステートメントの WHERE 句を作成するために使用されます (等号の右にある値)。 このエレメントではアトリビュートは次のようになります。 この要素のid属性の値は有効なGUID ESRI 地理属性にマップされている親 MicroStrategy プロジェクト内の地理属性の場合は、括弧で囲まれます。例: 「54BABC8311D59D57C000B28A4CC5F24F」 WHERE 句の対応する ESRI 値は、<ea> エレメントによって指定される ESRI フィールド名を使用して取得されます。 |
1 |
<ml> エレメントは、クエリされる ESRI テーブルを表す 1 つのマップ レイヤーを指定します。この値は、ESRI データベースからデータを取得する SQL ステートメントの FROM 句を作成するために使用されます。 このエレメントの値は、地図ウィジェットにデータを提供する ESRI サーバー上の特定のドキュメント/マップ レイヤーへの有効な URL パスです。例: http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5 これには、基本地図を提供するのと同じ ESRI サーバーまたは異なるのサーバーを使用できます。異なるサーバーとしては、ローカルの ArcGIS サーバーまたはクラウド上のパブリック サーバーを使用できます。 |
|
1 |
<qf> エレメントは、地図ウィジェットにデータを供給する ESRI データベース内のクエリ フィールド名/地理アトリビュートを指定します。これらのフィールド名は、ESRI データベースからデータを取得する SQL ステートメントの SELECT 句を作成するために使用されます。これらは、カスタム情報ウィンドウのための HTML 内でマクロとして参照できます。 このエレメントの値は、エレメントで指定された ESRI データベース テーブル内の、一重引用符で囲まれた有効なフィールド名/地理アトリビュートです。たとえば、「STATE_NAME」、「POP2008」、「ZIP」などです。 複数の値を指定する場合は、値のリスト全体を角かっこで囲み、個々の値を一重引用符で囲んで、カンマで区切ってください。値の 1 つが、MicroStrategy アトリビュートにマップされた ESRI 地理アトリビュート (アトリビュートによって指定されたアトリビュート) である必要があります。 |
|
1 |
<ea> エレメントは ESRI 地理アトリビュートを指定し、その ESRI 地理アトリビュートに対応するマップされた MicroStrategy アトリビュートが、地図ウィジェットが使用する MicroStrategy データを取得するために使用されます。この値は、ESRI データベースからデータを取得する SQL ステートメントの WHERE 句を作成するために使用されます (WHERE の後にあり、等号の左にある値)。 このエレメントの値は、<ml> エレメントで指定された ESRI データベース テーブル内の、一重引用符で囲まれた有効なフィールド名/地理アトリビュートです。たとえば、 STATE_NAME または ZIP です。 WHERE 句に対応する MicroStrategy 値は、<at> エレメントで指定される MicroStrategy アトリビュート GUID を使用して取得されます。 |
関連項目
KB483288 : Web サーバー マシンと ArcGIS サーバー間の接続は利用可能であるにもかかわらず、Web で ESRI への接続がリセットされます