操作方法：安装 JavaScript API 以与 ArcGIS for Server 配合使用

摘要

在隔离环境或安全环境中使用 ArcGIS for Server 时，可能无法访问托管的 Esri JavaScript API 库。 本文将介绍如何安装 JavaScript API 的本地副本并对其进行配置以与 ArcGIS for Server 配合使用。

过程

注：
本文档假设 Microsoft IIS 用作 web 服务器。 如果使用其他程序，则根据该配置，某些步骤可能不适用或可能会有所不同。 如果需要，请查阅该软件的文档。

下载并安装 JavaScript API

1. 导航至 ArcGIS API for JavaScript 页面。
2. 使用 Esri 全球帐户凭据进行登录。
3. 在 ArcGIS Web SDK（下载以用于本地托管）部分下，同时下载 API 和文档。

注：
在发布时，当前 JSAPI 版本为 3.16，并且所有后续文件夹路径均包含此信息。 如果使用备用版本，请相应地调整路径。

4. 将两个文件提取到如下所示的临时位置：

C:\Users\\Downloads\arcgis_js_v316_api\arcgis_js_api
C:\Users\\Downloads\arcgis_js_v316_sdk\arcgis_js_api

5. 在名为 arcgis_js_api 的 IIS 根虚拟目录中创建一个新文件夹，如下所示：

C:\inetpub\wwwroot\arcgis_js_api

6. 将提取的 library 和 sdk 子文件夹从其临时位置复制到新创建的 arcgis_js_api 文件夹：

C:\inetpub\wwwroot\arcgis_js_api\library
C:\inetpub\wwwroot\arcgis_js_api\sdk

修改 JavaScript 文件

注：
请注意，在以下两个步骤中，请勿包含“http://”和完全限定主机名，因为已经在两个文件中对其进行了定义。

1. 使用文本编辑器打开以下文件：

C:\inetpub\wwwroot\arcgis_js_api\library\3.16\3.16\init.js

2. 搜索文本 [HOSTNAME_AND_PATH_TO_JSAPI] 并将此文本替换为：

/arcgis_js_api/library/3.16/3.16/

3. 使用文本编辑器打开以下文件：

C:\Inetpub\wwwroot\arcgis_js_api\library\3.16\3.16\dojo\dojo.js

4. 搜索文本 [HOSTNAME_AND_PATH_TO_JSAPI] 并将此文本替换为：

/arcgis_js_api/library/3.16/3.16/

1. 在服务器上的 web 浏览器中，导航至以下位置：

http://localhost:6080/arcgis/admin/system/handlers/rest/servicesdirectory

2. 使用管理员凭据进行登录。
3. 如果需要恢复为默认设置，请复制当前“服务目录”设置或获取其屏幕截图。
4. 单击编辑以修改设置。
5. 使用完全限定主机名代替以下示例，将以下各字段替换为 JavaScript API 本地安装程序的路径：

http://myhost.example.com/arcgis_js_api/library/3.16/3.16/init.js

http://myhost.example.com/arcgis_js_api/sdk/

http://myhost.example.com/arcgis_js_api/library/3.16/3.16compact/dijit/themes/tundra/tundra.css

http://myhost.example.com/arcgis_js_api/library/3.16/3.16/esri/css/esri.css

注：
如果将服务器配置为仅使用 HTTPS，请修改以上示例以使用 HTTPS 代替 HTTP 作为 URL 连接。

6. 清除浏览器缓存以完成安装。

注：
要确认 ArcGIS for Server 使用正确的 JavaScript API 设置，请打开 web 调试程序，然后使用 Services Directory (REST) 中的 ArcGIS JavaScript 查看器来预览地图服务。 如果配置正确，则查看器应成功加载，并且 web 调试器中列出的所有 URL 均来自本地 web 服务器，而非“serverapi.arcgisonline.com”