当您需要 ArcGIS Enterprise 中默认 PrintingTools 服务范围之外的打印功能时,您可以在 ArcGIS Pro 中创建布局并将其作为 Web 工具共享到您的门户。
您不应更新默认 PrintingTools 服务随附的布局,也不应添加新布局和重新发布此服务。相反,您应该运行 ArcGIS Pro 中的导出 Web 地图脚本工具并将结果作为 Web 工具共享,用作 Web 地图打印的其他资源。
与任何 Web 工具一样,本教程的结果将共享到您登录的 ArcGIS Enterprise 门户,且作为 Web 工具基础的地理处理服务将保存到您指定的联合 ArcGIS Server。
本主题类似于发布用于在 ArcMap 中打印的其他服务。但是,该主题使用 ArcMap 将地理处理服务发布到服务器;本主题使用 ArcGIS Pro 与您的门户共享 Web 工具。
创建自定义布局
如果要创建自定义布局模板,可以在 ArcGIS Pro 中执行此操作。相关信息请查阅 ArcGIS Pro 中的布局。将新布局保存到文件夹:在共享选项卡的另存为组中,单击布局文件。或者,右键单击目录窗格中的布局,然后选择另存为布局文件。
准备布局时的注意事项
在 ArcGIS Pro 中创建用于 ArcGIS Enterprise 门户的布局时,以下最佳做法可供使用:
- 如果布局中有多个地图框,请标识希望 Web 工具使用的地图框并将其命名为 WEBMAP_MAP_FRAME(区分大小写)。Web 工具的基础服务将使用以此命名的地图框。
- 插入动态文本,例如标题、作者姓名等。要了解有关动态文本的详细信息,请参阅什么是动态文本? (位于 ArcGIS Pro 文档)。要执行此操作:
- 从功能区的插入选项卡,选择文本组中的文本命令。
- 单击布局上的位置以定位新的文本元素。
- 打开文本元素的属性页面。
- 将以下标签之一插入到所选元素的文本属性:
titleText
<dyn type="layout" property="metadata" attribute="title" emptyStr=""/> authorText
<dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/> copyrightText
<dyn type="layout" property="metadata" attribute="credits" emptyStr=""/>
- 您也可以从动态文本下拉菜单中的系统类别添加当前时间动态文本元素。这也位于插入功能区的文本组。
- 如果要插入自定义文本元素,请添加文本元素并将元素的名称嵌入一对大括号中,例如 {parcel-id}。
警告:
请勿在布局中插入用户动态文本。该动态文本会填充有关打印服务的敏感信息。
将您的布局模板文件夹注册到 ArcGIS Server
要使用 ArcGIS Enterprise 创建和共享 Web 工具,包含布局模板的文件夹必须可供 ArcGIS Server 访问。如果服务器可以访问该文件夹,则可以将其注册到服务器;否则,共享 Web 工具时将文件夹的内容复制到 ArcGIS Pro 的服务器。
有关说明,请参阅 ArcGIS Pro 帮助中的管理注册的数据存储。
准备和共享 Web 工具
准备就绪后,使用包含自定义布局模板的文件夹运行导出 Web 地图脚本工具。接下来,运行获取布局模板信息脚本工具(引用同一文件夹)。然后将结果作为 Web 工具共享。
- 在地理处理窗格中,浏览至工具箱 > 服务器工具 > 打印。
- 双击导出 Web 地图工具将其打开。
- 将作为 JSON 的 Web 地图参数保留为 #。
要获得可打印图像,此服务的用户将提交自己的 Web 地图 JSON 用于此参数。ArcGIS Web API、ArcGIS Enterprise 应用程序模板和 Web AppBuilder for ArcGIS 中的打印微件生成此 JSON。
- 使输出文件参数保持不变。
将此工具发布到服务器之后,输出将被放置在服务器作业目录中。
- 对于布局模板文件夹参数,单击浏览按钮并浏览至存储布局的文件夹。
提示:
如果您只想参考使用 ArcGIS Enterprise 安装的基本布局,请将此参数留空。
- 您可以从布局模板下拉列表中选择布局。
这将是用户运行服务时的默认布局。
- 单击运行以运行此工具。
- 浏览至工具箱 > 服务器工具 > 打印,双击获取布局模板信息脚本工具并将其打开。
- 图例
- 标题文本
- 版权文本
- 作者文本
- 自定义文本元素
- 选择运行步骤 5 中导出 Web 地图工具时指定的相同布局模板文件夹。单击运行以运行此脚本。
- 在功能区的分析选项卡上,单击历史记录,或单击目录窗格中的历史记录选项卡。右键单击导出 Web 地图结果,并选择共享为 > Web 工具。
共享为 Web 工具对话框随即出现。
- 使用分析选项识别任何可能的问题。
- 在对话框的常规选项卡上,根据需要替换项目详细信息(名称、摘要和标签)中的默认值。如果您如上所述将布局模板文件夹注册到服务器,请选择引用注册数据选项;否则,选择复制所有数据。指定要保存 Web 工具的门户文件夹、联合 ArcGIS Server 站点和要保存其基础地理处理服务的服务器文件夹。然后,为此 Web 工具设置共享选项。
- 切换到配置选项卡。在参数部分中指定工具的执行模式。在大多数情况下,您将选择同步。如果对工具的期望请求时间超过几秒钟(例如打印大型精细地图时),请选择异步。然后,设置工具的日志记录消息级别。
- 切换到目录选项卡。单击添加工具并添加获取布局模板信息结果。
您运行的两个工具现已整合到此 Web 工具中。
- 单击共享以共享 web 工具。
- 验证您的 Web 工具是否正确发布;应可用于您的 ArcGIS Enterprise 门户,其基础地理处理服务应该可用于 ArcGIS Server Manager。
获取布局模板信息脚本工具允许将获取布局模板信息任务添加至打印服务。该任务提供布局页面的大小和地图框的大小。还会显示下列布局元素是否可用:
现在,您可以在 ArcGIS Web API 提供的打印微件以及门户地图查看器中引用新的 Web 工具。Web 工具的 URL 可从其 ArcGIS Enterprise 门户中的项目页面获取。
Web 工具由联合 ArcGIS Server 站点中的自定义服务提供支持。您可以将此服务指定为 ArcGIS Enterprise 门户的打印服务。打开 ArcGIS Server Manager 并定位服务,然后复制其 URL(包括导出 Web 地图任务),然后将其粘贴在实用程序服务对话框中以进行打印。
更新布局模板
如果要更新布局模板文件夹中的布局,需要根据发布前是否将布局模板文件夹注册到服务器来确定相应的工作流(请参阅上述“将布局模板注册到 ArcGIS Server”部分)。无论将新布局添加到文件夹还是仅更新现有布局,它都很重要。这是因为您创建的地理处理任务会保留执行时布局模板文件夹中的布局列表。
如果发布前将布局模板文件夹注册到服务器,则意味着服务器可以访问布局。如果您更新文件夹中的现有布局文件 (.pagx),则您修改的布局将立即可用。但是,服务器将不会看到您在共享 Web 工具后添加的任何新布局。
因此,如果存在以下任一情况,您将需要重做上述工作流并共享新的 web 工具,以便您的更改可供 ArcGIS Server 用户使用:
- 共享 web 工具前未将布局模板文件夹注册到服务器,这意味着在发布时将布局复制到服务器。
- 共享 Web 工具后,您想要将新的布局模板添加到该文件夹,并使其可供用户使用。