多语言配置

SuperMap iPortal 及内置的 WebApps 均支持多语言环境并默认提供中、英双语配置，如果默认的语言无法满足使用环境，您可以根据所处地区与语言习惯，自行定制特定语言的门户站点。

• 特定语言定制
• 支持的语言

特定语言定制

iPortal 定制特定语言的流程如下：

1. 编写语言文件

第一步：在 %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

第五步：在 %SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\lib 路径下，进入 iportal-adminui-{version.number}.jar 包中，在 META-INF\resources\admin-ui\locale\setup 路径下新建一个语言配置文件，以日语为例，新建 ja.json 文件。文件名必须参照 iPortal 支持的语言的国际化对照表中对应的语言缩写。

第六步：填写语言配置文件内容，文件结构与同级目录下默认提供的 Language_zh.json/Language_en.json （或 zh.json/en.json）保持一致，只需将具体的内容更改为新语言对应的内容即可。

第七步：保存配置文件。

2. 将语言文件引入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值。

第三步：保存配置文件。

3. 更改首页显示语言

第一步：以管理员身份登录 iPortal ，从门户首页->管理->站点配置，点击“首页定制”选项卡，进入首页定制页面。

第二步：在布局构建器中，将首页每个组件的标题和描述文字更改为新语言对应的内容并保存。

第三步：重启 iPortal ，在页面底部进行多种语言的切换，即可访问定制了新语言的 iPortal 站点。

注意：如果完成多语言配置后，日志文件和提示信息的语言变更未生效，您可以通过修改【SuperMap iPortal_HOME】\bin\catalina.bat(.sh) 文件指定 iPortal 日志文件和提示信息的显示语言，具体请参考：FAQ。

支持的语言

iPortal 目前支持62种语言定制，具体参考以下国际化对照表：