ArcGIS Viewer for Flex（主要配置文件） .（转帖）

原文转自：http://blog.csdn.net/yu624774720hua/article/details/6572797

 

主要配置文件

---

对于Flex应用ArcGIS的浏览器有一个主配置文件名为config.xml - 这是默认的应用程序配置文件。它控制的外观，功能，在查看器应用程序和数据内容。它位于主flexviewer安装文件夹。 config.xml的内容可分为四个主要部分：

1. 一般特性（例如，应用程序的标题，样式颜色，字体）
2. 应用程序用户界面（例如，部件构成部分浏览器UI）
3. 地图内容（如底图和业务层）
4. 构件容器（例如，在部件托盘部件）

当Flex应用程序ArcGIS的浏览器最初部署，它加载的config.xml文件中设置。通过编辑这个文件，查看器应用程序可以很容易地配置，以满足任何特定的业务需求。其他样品查看器配置文件中包含的主要flexviewer文件夹以显示不同的浏览器配置的例子。

下图从概念上说明了浏览器的应用程序配置文件中的主要部分：

该文件开始和结束以<configuration>  标签标识作为该查看器应用程序配置文件中。

 

1。一般浏览器属性：

下面的标签可以用来设置浏览器的一般属性：

<httpproxy>到代理服务器，将用于URL

标签有其属性useproxy =“true”，以及小部件，支持在它们的配置文件将useProxy标签（DataExtract，GeoRSS，定位和查询部件）。阅读关于使用代理页面

<title> 该查看器应用程序的标题文字显示在浏览器上的左上角。

<subtitle> 该浏览器的字幕文本

<logo> 位置路径标识图像在浏览器的用户界面显示。这是显示在标题立即离开。图像应不超过48 × 48像素的，否则将被调整到该大小。 PNG和GIF文件的支持。

<style>包含以下样式相关设置:

<colors>颜色集定义了浏览器的外观。这个标签有五个价值观，它们代表（从左至右）：文字颜色，背景颜色，过渡色，选择颜色，标题文字的颜色。颜色值是基于RGB十六进制格式。例如有些浏览器风格的颜色显示在查看器主题设置样式。

<alpha>为浏览器UI组件的透明程度。值的范围从0.0（透明）到1.0（不透明）。

<font>主要字体用在应用程序（包括字幕）。它有两个属性：

name:标题的字体名称，如漫画SANS MS

size :字体大小，例如，12。为日文字符例如，一个更大的字体大小是很有帮助的。

<titlefont>字体用于在头控制器称号。它有两个属性：

name:标题的字体名称，如漫画SANS MS

size :28的字体大小。如果去掉字幕，有一个更大的字体大小，如36的空间。

 

<geometryservice>一般几何服务要使用的一些部件，当重叠是真实的。

它有以下属性：

url :URL你的几何服务

token:访问ArcGIS Server服务安全使用。

useproxy:是否使用代理与否。如果属实，将使用指定的代理页 。布尔值，默认为“false”。

<splashpage>这引用了一个闪屏显示查看器应用程序时，第一次打开。

它有以下属性：

label:名称为splashpage使用的部件。

config:位置路径的初始页面部件的配置文件。

url:URL的初始页面Widget的.swf文件

<bing>如果使用地图或地理编码，您需要提供自己的密钥Bing地图。它有一个属性：

key:your bing key. Required.

下面是一个config.xml文件及其一般属性的子集：

<configuration>    <title>ArcGIS Viewer for Flex</title>    <subtitle>... using ArcGIS</subtitle>    <logo>assets/images/logo.png</logo>    <mce:style><!--        <colors>0xFFFFFF,0x333333,0x101010,0x000000,0xFFD700</colors>        <alpha>0.8</alpha>    --></mce:style><style mce_bogus="1">        <colors>0xFFFFFF,0x333333,0x101010,0x000000,0xFFD700</colors>        <alpha>0.8</alpha>    </style>    <bing key="your-bing-key"/>    ...</configuration>

2. UI elements:

这些都是独立的部件（即，外构件的容器内），通常的形式查看器应用程序的布局/ UI的一部分。这些部件包括查看器应用程序的控制。四小部件表单的默认浏览器的用户界面：导航部件(Navigation widget)，部件概述地图（Overview Map widget），地图切换器构件 Map Switcher widget，HeaderController部件。

 

 

<widget>- 独立这里定义的标签对每个部件，构成了浏览器的用户界面。见它的属性信息控件标记的话题。也见以下为管理部件。

<!-- UI elements --><widget left="10" top="50" config="widgets/Navigation/NavigationWidget.xml" url="widgets/Navigation/NavigationWidget.swf"/><widget right="-2" bottom="-2" config="widgets/OverviewMap/OverviewMapWidget.xml" url="widgets/OverviewMap/OverviewMapWidget.swf"/><widget right="20" top="55" config="widgets/MapSwitcher/MapSwitcherWidget.xml" url="widgets/MapSwitcher/MapSwitcherWidget.swf"/><widget left="0" top="0" config="widgets/HeaderController/HeaderControllerWidget.xml" url="widgets/HeaderController/HeaderControllerWidget.swf"/>

3. Map content:

这种查看器应用程序配置文件的部分定义了浏览器的地图内容。它开始和结束以 <basemaps>, <operationallayers> 和 <lods>

 

地图的内容可以定义两种方法之一：

1. 通过expliciting数据层定义在配置文件（例如，底图和业务层）
2. 通过访问，从ArcGIS.com发布的Web地图（见ITEMID属性如下）

<map>-定义中的地图查看器组件。

它有（其中没有一个是必需的）以下属性：

initialextent - 初始地图的空间范围。在最小X，Y和最大x定义，Y坐标应用程序的空间参考。应用程序的空间参考是您的第一个基础层空间参考，或wkid / WKT，如果它们的定义。例如，平铺在ArcGIS在线服务，大部分是在WGS 1984网络辅助的球墨卡托投影（wkid＃102100）。坐标值可使用的范围内辅助应用程序。如果没有指定，初始范围将默认为第一个基地地图的初始程度。

fullextent - 这个属性是使用导航控件进行放大，以“最大的空间范围”的地图。语法是为initalextent相同。如果这个属性没有设置，应用程序的完整程度将是初步的程度。

center - 地图的初始中心点。

level-最初的水平，打开地图时。该级别的地图上的检测限而定。

scale - 地图的初始规模。

top - 在从以应用程序的顶部边缘地图上边缘像素的垂直距离。默认为0个像素，而40是最好的做法时使用HeaderController部件，因为它通常涵盖前40像素。

bottom - 在从以应用程序的底部边缘图的底部边缘像素的垂直距离。默认为0像素。

left - 在从申请到左边缘图左边缘像素的水平距离。默认为0像素。

right - 在从到应用程序的右边缘的像素图的右边缘的水平距离。默认为0像素。

itemid - 指的是从ArcGIS.com网站地图项目的ID。该浏览器可以访问和查看ArcGIS.com发布的Web地图，为更多的信息，请参阅有关ArcGIS.com网站地图。

esrilogovisible  - 确定是否显示在应用ESRI的标志。布尔值，默认为“true”。

openhandcursorvisible - 确定是否使用在应用程序中打开手形光标。布尔值，默认为“false”为版本2.3。 Prevously默认的是“true”。

paneasingfactor - 调整后的地图平移“宽松”。有效值介于0和1。值1关闭缓和。如果没有设置，默认为0.2。见API的更多细节Map.panEasingFactor参考。 [2.3版本新增]

scalebarvisible - 确定是否显示在应用程序中比例尺。布尔值，默认为“true”。

zoomslidervisible - 决定是否要显示在应用程序映射缩放滑块。布尔值，默认为“假”，因为导航部件是在默认浏览器显示出来。

wkid-众所周知ID，指的是空间参考地图的ID号。如果两个WKT和wkid指定，wkid将被使用。

wkt - 众所周知的文本，是指地图的空间参考文本。要求所有ArcGIS服务器是10.0或以上。

wraparound180 - 是否启用连续跨越日界线平移。默认为“false”。

<map        initialextent="-13046840 4036096 -13045400 4036867"        fullextent="-16677000 2009000 -4819000 8330000"        top="40">

<basemaps>- 地图服务列表用作在浏览器的基础地图。只有一个基础地图可以看得见的时间，但一个基本的地图可以包含多个图层。要创建混合底图，设置name属性要对所有在底图图层组，应该弥补混合底图相同。当多个地图服务中列出了 ，地图切换部件可以被用来使最终用户能够在它们之间切换。 有一个子标签，可重复多次：

<layer> - 这是一个地图服务，在浏览器显示的层。见它的属性信息层标签的话题。

<operationallayers>- 列出的地图是在浏览器中的基础地图数据之上叠加服务。业务层可以访问无论从地图切换部件，更多...按钮和图层列表小部件。 有一个子标签，可重复多次：

<layer> - 这是一个地图服务，在浏览器显示的层。见它的属性信息层标签的话题。

 

<lods>- 细节（检测限），或设置规模级别。默认情况下，可用的水平是按照您的底图。为了改变这一状况，指定您自己的一套的水平。对于预创建砖层，这些必须完全匹配的水平。 有一个子标签这反过来有两个属性：分辨率和规模。

<map>    <lods><!-- only show a few levels -->        <lod resolution="78271.5169639999" scale="295828763.795777"/>        <lod resolution="9783.93962049996" scale="36978595.474472"/>        <lod resolution="1222.99245256249" scale="4622324.434309"/>        <lod resolution="152.874056570411" scale="577790.554289"/>    </lods>    ...</map>

下面是config.xml文件的浏览器的地图内容的代码示例：

<map initialextent="8044000 1489000 15226000 7271000" top="40"wraparound180="true"><basemaps><layer label="街道图" type="tiled" visible="true"url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer" /><layer label="航空图" type="tiled" visible="false"url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer" /><layer label="地形图" type="tiled" visible="false"url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer" /></basemaps><operationallayers><layer label="边界和地点" type="tiled" visible="false"url="http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places_Alternate/MapServer" /><layer label="火灾" type="feature" visible="false"popupconfig="popups/PopUp_Fires.xml"url="http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Fire/Sheep/FeatureServer/0" /><layer label="旧金山 311 服务电话事件点" type="feature" visible="false"popupconfig="popups/PopUp_311.xml"url="http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/SanFrancisco/311Incidents/FeatureServer/0" /><layer label="地震" type="dynamic" visible="false"url="http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Earthquakes/Since_1970/MapServer" /></operationallayers></map>

4. Widget container:

一个widget容器是一个概念结构，是不是直接在浏览器的用户界面可见。它可以进行分组管理的目的一起在浏览器的部件。在容器中的小部件一个部件中引用部件托盘。部件最终用户可以轻松地在浏览器打开/关闭，通常存储在一个小部件的容器。见它的属性信息Widgetcontainer标签的话题。

 

<widgetcontainer>  - 定义为查看器应用程序部件的容器。一位观众可以有多个部件的容器。当子标签来标记 ，小部件存储在构件容器，它们将出现在widget托盘。

在config.xml文件中的代码示例所示，书签和查找地址部件都存储在一个小部件容器：

<widgetcontainer layout="float"> <!--horizontal(default)|float|vertical|fix--><widget label="书签" icon="assets/images/i_bookmark.png" config="apps/zh_CN/BookmarkWidget.xml"url="widgets/Bookmark/BookmarkWidget.swf" /><widget label="绘制和测量" icon="assets/images/i_draw2.png" config="widgets/Draw/DrawWidget.xml"url="widgets/Draw/DrawWidget.swf" /><widget label="地震点" icon="assets/images/i_rss.png" config="widgets/GeoRSS/GeoRSSWidget.xml"url="widgets/GeoRSS/GeoRSSWidget.swf" /><widget label="打印" icon="assets/images/i_print.png" config="widgets/Print/PrintWidget.xml"url="widgets/Print/PrintWidget.swf" /><widget label="交通监控摄像机" icon="assets/images/i_camera.png"config="widgets/Query/QueryWidget_Louisville_TrafficCams.xml" url="widgets/Query/QueryWidget.swf" /><widget label="路易斯维尔警察局" icon="assets/images/i_policestation.png"config="widgets/Query/QueryWidget_Louisville_PoliceStations.xml" url="widgets/Query/QueryWidget.swf" /><widget label="搜索" icon="assets/images/i_search.png"config="widgets/Search/SearchWidget_Louisville.xml" url="widgets/Search/SearchWidget.swf" /><widgetgroup label="更多微件(widget)"><widget label="查找欧洲地址" icon="assets/images/i_pin2.png"config="widgets/Locate/LocateWidget_EU.xml" url="widgets/Locate/LocateWidget.swf" /><widget label="查找世界地址" icon="assets/images/i_flag.png"config="widgets/Locate/LocateWidget_WorldGaz.xml" url="widgets/Locate/LocateWidget.swf" /><widget label="使用 Bing 查找地址" icon="assets/images/i_target.png"config="widgets/Locate/LocateWidget_Bing.xml" url="widgets/Locate/LocateWidget.swf" /><widget label="数据提取" icon="assets/images/i_scissors.png"config="widgets/DataExtract/DataExtractWidget.xml" url="widgets/DataExtract/DataExtractWidget.swf" /><widget label="图层列表" icon="assets/images/i_layers.png"config="widgets/LayerList/LayerListWidget.xml" url="widgets/LayerList/LayerListWidget.swf" /><widget label="按时间过滤" icon="assets/images/i_clock.png"config="widgets/Time/TimeWidget_QuakesSince1970.xml" url="widgets/Time/TimeWidget.swf" /></widgetgroup></widgetcontainer>