SuperMap iPortal 及内置的 WebApps 均支持多语言环境并默认提供中、英双语配置，如果默认的语言无法满足使用环境，您可以根据所处地区与语言习惯，自行定制特定语言的门户站点。 iPortal 还支持对日志输出语言、内置示例数据语言和默认界面显示语言进行独立调整。
特定语言定制
iPortal 定制特定语言的流程如下：
- 编写语言文件
第一步：在 %SuperMap iPortal_HOME%\webapps\iportal\resources\web-ui\config 路径下新建一个语言配置文件，以日语为例，新建 Language_ja.json 文件。其中“Language_”后接的名称可以参照 iPortal 支持的语言的国际化对照表中对应的语言文件名。
第二步：在 %SuperMap iPortal_HOME%\webapps\iportal\resources\admin-ui\lang 路径下新建一个语言配置文件，以日语为例，新建 Language_ja.json 文件。其中“Language_”后接的名称可以参照 iPortal 支持的语言的国际化对照表中对应的语言文件名。
第三步：在 %SuperMap iPortal_HOME%\webapps\iportal\resources\web-ui\config\locales\homePage 路径下新建一个语言配置文件，以日语为例，新建 ja.json 文件。文件名可以参照 iPortal 支持的语言的国际化对照表中对应的语言文件名。
第四步：在 %SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\lib 路径下，进入各 WebApps（DataViz/DataInsights/MapDashboard） 对应的 jar 包中，在语言配置文件所在路径下新建一个语言配置文件，以日语为例，新建 ja.json 文件。文件名可以参照 iPortal 支持的语言的国际化对照表中对应的文件名。各 WebApp jar 包中语言配置文件所在路径如下：
- 数据上图：%DataViz_HOME%\META-INF\resources\apps\dataviz\static\nls
- 数据洞察：%DataInsights_HOME%\META-INF\resources\apps\insights\language
- 地图大屏：%MapDashboard_HOME%\META-INF\resources\apps\mapdashboard\v2\static\locale
- 应用构建器：%Builderx_HOME%\META-INF\resources\apps\builderx\static\locale
- 三维地理设计：%Designer_HOME%\META-INF\resources\apps\designer-3D\js\locale
- 三维地球：%Earth_HOME%\META-INF\resources\apps\earth\v2\locale
- 处理自动化建模：%GPAModelBuilder_HOME%\META-INF\resources\apps\gpamodelbuilder\locale
- 地图工作室：%MapStudio_HOME%\META-INF\resources\apps\mapstudio\static\locales
第五步：在 %SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\lib 路径下，进入 iportal-adminui-{version.number}.jar 包中，在 META-INF\resources\admin-ui\locale\setup 路径下新建一个语言配置文件，以日语为例，新建 ja.json 文件。文件名可以参照 iPortal 支持的语言的国际化对照表中对应的文件名。
第六步：在 %SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\lib 路径下，进入 authentication-ui-{version.number}.jar 包中，在 META-INF\resources\apps\authentication-ui\static\locales 路径下新建一个语言配置文件，新建一个语言配置文件，以日语为例，新建 ja.json 文件。文件名必须参照 iPortal 支持的语言的国际化对照表中对应的文件名。
第七步：填写语言配置文件内容，文件结构与同级目录下默认提供的 Language_zh.json/Language_en.json （或 zh.json/en.json）保持一致，只需将具体的内容更改为新语言对应的内容即可。
第八步：保存配置文件。
- 将语言文件引入iPortal
第一步：打开 %SuperMap iPortal_HOME%\webapps\iportal\resources\web-ui\config\locales\ 路径下的 locales.json 配置文件，文件结构如下：
{
"locales": [
{
"name": "zh",
"label": "中文"
},
{
"name": "en",
"label": "English"
}
],
"default": "en"
}
在 locales 项中新增一项，其中 name 属性需与1中语言配置文件名“Language_”后接的名称一致；label 属性值可自定义，表示在页面中显示的语言名称。以日语为例，修改后的配置文件如下：
{
"locales": [
{
"name": "zh",
"label": "中文"
},
{
"name": "en",
"label": "English"
},
{
"name": "ja",
"label": "日本語"
}
],
"default": "en"
}
第二步（可选）：修改默认语言。配置文件中的 default 用于指定 iPortal 默认显示语言，例如："default": "ja"。注意："default" 设置仅当 iPortal 不支持用户浏览器中设置的默认语言时才生效。iPortal 默认语言显示规则的优先次序是：浏览器 Cookie > 浏览器默认语言 > default 值。
第三步：保存配置文件。
- 更改首页显示语言
第一步：以管理员身份登录 iPortal ，从门户首页->管理->站点配置，点击“首页定制”选项卡，进入首页定制页面。
第二步：在布局构建器中，将首页每个组件的标题和描述文字更改为新语言对应的内容并保存。
第三步：重启 iPortal，在页面底部进行多种语言的切换，即可访问定制了新语言的 iPortal 站点。
注意：如果完成多语言配置后，日志文件和提示信息的语言变更未生效，您可以通过修改【SuperMap iPortal_HOME】\bin\catalina.bat(.sh) 文件指定 iPortal 日志文件和提示信息的显示语言，具体请参考：FAQ。
支持的语言
iPortal 支持定制的语言可参考以下国际化语言参考表：
| 语言 | 语言码 | 文件名 |
| 阿拉伯语（埃及） | ar-EG | ar |
| 阿塞拜疆语 | az-AZ |
az |
| 保加利亚语（保加利亚） | bg-BG | bg |
| 孟加拉语（孟加拉国） | bn-BD | bn |
| 白俄罗斯语 | by-BY | by |
| 加泰罗尼亚语（西班牙） | ca-ES | ca |
| 捷克语（捷克共和国） | cs-CZ | cs |
| 丹麦语（丹麦） | da-DK | da |
| 德语（德国） | de-DE | de |
| 希腊语（希腊） | el-GR | el |
| 英语 | en-GB | en-GB |
| 英语（美式） | en-US | en |
| 西班牙语（西班牙） | es-ES | es |
| 爱沙尼亚语（爱沙尼亚） | et-EE | et |
| 波斯语 | fa-IR | fa |
| 芬兰语（芬兰） | fi-FI | fi |
| 法语（比利时） | fr-BE | fr-BE |
| 法语（加拿大） | fr-CA | fr-CA |
| 法语（法国） | fr-FR | fr |
| 爱尔兰语 | ga-IE | ga |
| 加利西亚语（西班牙） | gl-ES | gl |
| 希伯来语（以色列） | he-IL | he |
| 印地语 | hi-IN | hi |
| 克罗地亚语 | hr-HR | hr |
| 匈牙利语（匈牙利） | hu-HU | hu |
| 亚美尼亚 | hy-AM | hy |
| 印度尼西亚语（印度尼西亚） | id-ID | id |
| 冰岛语（冰岛） | is-IS | is |
| 意大利语（意大利） | it-IT | it |
| 日语（日本） | ja-JP | ja |
| 格鲁吉亚语 | ka-GE | ka |
| 高棉语 | km-KH | km |
| 北库尔德语 | kmr-IQ | kmr |
| 卡纳达语 | kn-IN | kn |
| 哈萨克语 | kk-KZ | kk |
| 韩语/朝鲜语 | ko-KR | ko |
| 立陶宛语 | lt-LT | lt |
| 拉脱维亚语 | lv-LV | lv |
| 马其顿语 | mk-MK | mk |
| 马拉雅拉姆语 | ml-IN | ml |
| 蒙古语（蒙古） | mn-MN | mn |
| 马来语 (马来西亚) | ms-MY | ms |
| 挪威语（挪威） | nb-NO | nb |
| 尼泊尔语（尼泊尔） | ne-NP | ne |
| 荷兰语（比利时） | nl-BE | nl-BE |
| 荷兰语（荷兰） | nl-NL | nl |
| 波兰语（波兰） | pl-PL | pl |
| 葡萄牙语(巴西) | pt-BR | pt-BR |
| 葡萄牙语（葡萄牙） | pt-PT | pt |
| 罗马尼亚语 | ro-RO | ro |
| 俄语（俄罗斯） | ru-RU | ru |
| 斯洛伐克语（斯洛伐克） | sk-SK | sk |
| 斯洛文尼亚语（斯洛文尼亚） | sl-SI | sl |
| 塞尔维亚语（拉丁文，塞尔维亚） | sr-RS | sr |
| 瑞典语（瑞典） | sv-SE | sv |
| 泰米尔语 | ta-IN | ta |
| 泰语（泰国） | th-TH | th |
| 土耳其语（土耳其） | tr-TR | tr |
| 乌尔都语 (巴基斯坦) | ur-PK | ur |
| 乌克兰语（乌克兰） | uk-UA | uk |
| 越南语（越南） | vi-VN | vi |
| 中文（简体） | zh-CN | zh |
| 中文（繁体） | zh-MO | zh-MO |
语言独立定制
iPortal 支持通过修改 locale-config.xml 配置文件，对 iPortal 的日志输出语言、内置示例数据语言和默认界面显示语言进行独立设置，以满足国际用户的使用需求，配置方式如下:
-
打开位于 %SuperMap iPortal_HOME%\webapps\iportal\WEB-INF 文件夹下的 locale-config.xml 配置文件，其中包含三个核心配置项：
<localeConfig>
<!-- 日志使用的语言 -->
<subsequentLogLocale>zh-CN</subsequentLogLocale>
<!-- 默认数据的语言 -->
<dataLocale>zh-CN</dataLocale>
<!-- 用户界面显示使用的语言 -->
<uiLocale>zh-CN</uiLocale>
</localeConfig>
- <subsequentLogLocale>：控制输出 iPortal 系统日志和操作日志使用的语言（不包括 Tomcat 等中间件的日志，其配置方式可见：FAQ），仅对配置生效后新产生的日志生效，已存在的日志保持原语言。iPortal 日志支持语言可参考语言支持情况，如果配置了其他语言，将默认输出英文日志
- <dataLocale>：控制 iPortal 内置数据、模板和底图的语言，包括数据上图 WebApp 示例数据、地图工作室 WebApp 模板、地图大屏 WebApp 模板、地图底图的语言，iPortal 内置数据、模板和底图支持语言可参考语言支持情况，如果配置了其他语言，将默认加载英文的内置数据、模板和底图
- <uiLocale>：控制用户首次访问或未登录时的默认界面显示语言，用户登录后可在导航栏中自行切换界面显示语言，iPortal 内置界面支持语言可参考语言支持情况，如果配置了其他未扩展的语言，界面将默认显示英文
- iPortal 支持用户自行扩展语言，如果此项填写了已扩展的其他语言，界面将显示相应扩展语言
- 如果此项留空，界面将默认跟随浏览器的语言设置，如果浏览器语言不支持，则默认显示英文界面语言
-
保存配置文件，重启 iPortal 即可生效。
| 语言 | 语言码 | 输出日志语言 | 内置数据语言 | 界面显示语言 |
| 中文（简体） | zh-CN | ✓ | ✓ | ✓ |
| 中文（繁体） | zh-MO | ✓ | - | ✓ |
| 英语 | en-US | ✓ | ✓ | ✓ |
| 西班牙语 | es-ES | - | - | ✓ |
| 法语 | fr-FR | - | - | ✓ |
| 阿拉伯语 | ar | ✓ | - | ✓ |
注意：
-
locale-config.xml 文件配置对数据洞察 WebApp 不生效，数据洞察 WebApp 的界面语言跟随浏览器语言设置，支持简体中文、英文、法语和西班牙语；当浏览器语言为繁体中文、阿拉伯语或其他不支持的语言时，界面默认显示简体中文。
-
为了保留 12.1.1 版本之前用户的语言使用习惯，此配置文件不影响原有的默认界面显示语言，若您在 12.1.1 版本及后续版本首次安装或启动 iPortal，系统将读取 locale-config.xml 文件中的配置作为默认界面语言设置。