iPortal 配置文件说明

SuperMap iPortal 的主要配置信息位于 WEB-INF（【SuperMap iPortal 安装目录】\webapps\iportal\WEB-INF）目录下，关于目录说明请参考：安装之后目录说明。

iPortal 配置文件简介

SuperMap iPortal 的配置文件包含 iPortal 门户功能的配置文件和与 iServer 共用的基础配置文件（关于 iServer 的配置文件说明请参见：iServer 配置文件说明）。

iPortal 门户功能的配置文件主要内容如下表所示：

配置文件的内容

文件名	描述
iportal.xml	iPortal 门户的主要配置信息，包括数据库配置以及一些门户功能的配置等。
iportal-monitor.xml	节点监控配置信息，包括节点监控数据存储的数据库配置、添加的 iServer 节点信息等。关于此配置文件的使用，请参见：监控配置。
iportal-storage.xml	用户上传数据文件的存储配置信息，包括 FTP 服务器存储配置等。关于此配置文件的使用，请参见：托管数据存储配置。
iportal-ehcache.xml	iPortal 代理服务权限信息缓存共享配置信息，默认保存在本地，无需配置，当使用 iPortal 高可用方案时，需配置。关于此配置文件的使用，请参见：代理服务权限信息缓存共享配置。

iPortal 配置文件结构

SuperMap iPortal 配置文件 iportal.xml，包含了 iPortal 门户的主要配置信息，根节点为 <IportalConfig>。<IportalConfig> 节点目前主要包含：

数据库配置： <dataSourceConnectionPoolInfo>
数据上传配置：<uploadSetting>
服务相关配置：<serviceSetting>、<serviceCheckSetting>、<serviceAuditSetting>、<serviceProxy>、
用户注册配置：<registerSetting>
共享范围配置：<shareSetting>
地图相关配置：<thumbnailSetting>、<mapViewerSetting> 、<mapsSetting>、<defaultInternetBuildinMapSetting>、<mapApps>
自定义目录配置：<customDirectorySetting>
部门相关配置：<departmentSetting>
群组相关配置：<groupSetting>
访问域配置：<httpHeaderSetting>

在启动 SuperMap iPortal 服务之前，建议您详细阅读下面的配置文件说明，方便您根据自身业务需求，做好产品的配置。

1. <dataSourceConnectionPoolInfo>

用于设置 SuperMap iPortal 数据库连接池，默认配置的是 SQLite 数据库，我们以注释的方式提供了 MySQL 数据库的配置信息，并建议您选用 MySQL 数据库。

<dbType>：数据库类型，字符需要大写，如 SQLITE、MYSQL。
<driverClass>：数据库驱动的类全名。
<jdbcUrl>：连接至驱动的 url，对于 SQLite 数据库文件路径，如果使用相对路径，则是相对于 iPortal home 的路径；MYSQL JDBC URL 的格式为：jdbc:mysql://[host:port]/[database]?[参数名1]=[参数值1]&[参数名2]=[参数值2]…。其中 MySQL 的默认端口为：3306，database 为数据库名，参数可选。需要注意的是，在 xml 配置文件中，url 中的&符号需要转义成&。
<maxPoolSize>：连接池在同一时刻内所提供最大活动连接数。
<initialPoolSize>：初始化连接池大小。
<minPoolSize>：连接池在同一时刻内所提供最小活动连接数。
<maxIdleTime>：最大空闲时间，maxIdleTime 秒内未使用则连接被丢弃。若为0则永不丢弃，默认值: 0。
<maxWait>：当发生异常时数据库等待最大毫秒数（当没有可用连接时）。
<username>：用户名。SQLite 数据库的用户名可以为空；MySQL 数据库的初始管理员账号是 root。
<password>：密码。SQLite 数据库的密码可以为空；MySQL 数据库没有初始密码。

2. <uploadSetting>

用于设置用户允许上传的最大数据容量默认值，单位：MB。

3. <serviceSetting>

用于设置服务资源的访问模式，默认使用 V2 版本。V1 和 V2版本区别如下：

V1 版本：禁用资源申请功能，即：用户可以在门户中检索到有权限访问的服务，对于无权限访问的服务，检索不到。
V2 版本：启用资源申请功能，即：用户可以在门户中检索到所有服务，但是对于无权限访问的服务，仅可以查看到该服务除 URL 地址以外的元数据信息，“资源申请”审批通过后方可访问和查看该服务。

4. <serviceCheckSetting>

用于设置注册服务的检测，单个注册的服务和批量注册的服务分开配置，单位：分钟。

<singleCheckInterval>：单个注册的服务自动检测时间，默认：30分钟。
<batchCheckInterval>：批量注册的服务自动检测时间，默认：60分钟。

5. <serviceAuditSetting>

<allowServiceAudit>：用于设置是否开启服务审核功能，默认值：false，不开启服务审核功能。
<auditedAttributes>：用于设置哪些服务属性字段被修改后需要管理员重新审核，默认值：all，审核所有服务属性字段，即：如果普通用户对审核通过的服务进行了修改，即使修改任意一个属性字段，都需要管理员重新审核。当然，管理员可以配置哪些服务属性字段被修改后需要重新审核，以英文","分隔，如：resTitle,thumbnail。服务属性字段包括：名称(resTitle)、描述(idAbs)、缩略图(thumbnail)、标签(tags)、参照系(refSysInfo)、标识(exDesc)、范围(geoBndBox)、提供者(mdContact)。

6. <registerSetting>

<allowRegister>：用于设置用户注册功能的开启与禁用，默认值：true，开启用户注册功能。
<allowUserAudit>：用于设置是否开启对注册用户的审核功能，默认值：false，不开启对注册用户的审核功能。
<sendEmailNotification>：用于设置是否向注册用户发送审核结果的邮件通知，默认值：false，不开启发送邮件通知功能。
<extendUserFields>：用于设置用户注册时需要填写的除基本信息（如：账号、密码等）之外的其他信息（如：部门、邮箱等）。
<name>：用于设置用户注册时的扩展字段名称，目前支持：部门（Department）、邮箱（Email），即：用户注册时可选择部门或邮箱。
<required>：用户设置扩展字段是否为必填项，true 表示必填项，false 表示可选项。

7. <shareSetting>

<allowListUsers>：用于设置资源分享给指定用户时，是否允许列出所有用户列表，默认值：false，不允许列出所有用户列表。
<scope>：用于设置资源的共享范围。
<toUser>：用于设置是否允许共享给指定用户，默认值：true，允许共享给指定用户。
<toGroup>：用于设置是否允许共享给群组，默认值：true，允许共享给群组。
<toDepartment>：用于设置是否允许共享给部门，默认值：false，不允许共享给部门。

8. <thumbnailSetting>

用于设置 ImageMagick 软件安装路径，实时动态生成缩略图。具体配置请参见：缩略图配置。

9. <mapViewerSetting>

<displayCoords>：用于设置 mapViewer 中浏览地图时，是否显示地图坐标信息，默认值：false，不显示地图的坐标信息。
<displayDataLayers>：用于设置在 mapViewer 中添加矢量图层时，是否显示添加数据服务选项，默认值：true，显示添加数据服务项。

10. <mapsSetting>

<showBatchAddMaps>：用于设置在 iPortal 的地图列表页面是否显示批量添加地图按钮，默认值：true，显示批量添加地图按钮。
<allowMapAudit>：用于设置是否开启地图审核功能，默认值：false，不开启地图审核功能。
<auditedAttributes>：用于设置哪些地图属性字段被修改后需要管理员重新审核，默认值：all，审核所有地图属性字段，即：如果普通用户对审核通过的地图进行了修改，即使修改任意一个属性字段，都需要管理员重新审核。当然，管理员可以配置哪些地图属性字段被修改后需要重新审核，以英文","分隔，如：title,description。地图属性字段包括：标题(title)、描述(description)、缩略图(thumbnail)、标签(tags)、中心点和缩放级别(geoAttr)、图层(layers)。

11. <serviceProxy>

用于设置在 iPortal 中注册的服务是否使用代理，默认不启用服务代理，建议您启用服务代理。

如果您不启用服务代理，会存在以下这种状况：

用户 A 注册了一个服务，并分享给用户 B，此时用户 B 知道了该服务地址。当用户 A 修改了该注册服务的共享设置后，用户 B 登录 iPortal 门户，在服务列表中看不到该条服务信息了，但之前已经知道该服务地址的事实无法改变，用户 B 仍然可以访问该服务，服务的信息安全受到威胁。

启用服务代理后，只有服务的注册者和管理员可以看到原始的服务地址，其他有权限访问该服务的用户只能看到代理后的服务地址，在门户级别实现了对注册服务的访问控制。

<enable>：设置是否启用服务代理，默认值：false，不启用服务代理，如果您希望启用服务代理，可以设置为： true。
<port>：设置代理服务地址的端口号，默认值：8095。您也可以自定义设置该端口号，只要保证您设置的端口号没有被占用就可以。
<httpConnPoolInfo>：代理服务的连接池设置项，用于设置代理服务内部的 HttpClient 连接池。调整该节点下的各个设置项，从而提升代理服务的并发性能。
<maxTotal>：设置整个连接池最大连接数。默认值是：20。
<defaultMaxPerRoute>：对于一个路由地址，设置最多存在几个连接。默认值是：2。
<enableAccessStatistics>：设置是否开启代理服务访问统计功能，默认值：false，不开启。

注意：

支持注册的服务类型中，SuperMap REST 服务、OGC 服务（WMS、WMTS、WFS、WCS、WPS）、ArcGIS REST 服务均支持服务代理，而“其他服务”类型不支持服务代理。
停用代理服务后，需要重启 iPortal 服务，设置才会生效。

一旦在 iportal.xml 文件中配置启用代理服务，您还需要将 iportal 这个应用的 “Context path” 的值设置为空，代理服务功能才能生效。设置完成后， iPortal 门户首页地址变更为： http://<server>:<port>。具体配置请参见：注册的服务使用代理设置。

12. <customDirectorySetting>

用于设置自定义目录功能的显示或者隐藏。地图和服务自定义目录的默认值都是：false，不显示地图、服务、场景的自定义目录。您可以分别开启地图和服务的自定义目录功能。关于自定义目录配置请参见：自定义目录配置。

13. <defaultInternetBuildinMapSetting>

<defaultInternetMap>：用于设置主流互联网地图作为默认底图。默认值：false，不设置主流互联网地图作为默认底图。其中 CLOUD : 高德地图 TIANDITU : 天地图
<googleMapsAPIKey>：用于设置 Google Maps JavaScript API Key，需要您去 Google Developers 申请一个 Key。

14. <httpHeaderSetting>

用于设置允许访问 iPortal 资源的域。

<accessControlAllowOrigins>：设置允许的域，优先匹配这些域，不匹配时使用defaultAccessControlAllowOrigin 的设置。
<defaultAccessControlAllowOrigin>：默认允许所有域，可配置特定的域。

15. <departmentSetting>

用于设置组织结构功能的启用与禁用。默认值：false，不启用组织结构配置。如果您希望实现管理员分级管理，各级单位或部门管理员在门户中管理各级单位或部门的资源和用户，那么建议您启用组织结构配置功能。

16. <mapApps>

Map App 集合，用于扩展用户自定义的地图应用 APP，默认使用 iPortal 内置的在线制图 APP。

17. <groupSetting>

用于设置在“我的申请”和“我的审批”页面是否显示群组相关信息。默认值：true，显示群组相关信息。