本主题提供了一些基本的疑难解答策略，并针对以 PDF 或 Excel 格式查看已启用地图功能的报表，介绍了几个最常见的问题。
基本疑难解答
以 PDF 或 Excel 格式查看报表时，地图图像将被上传到 EM4C Server。该图像文件将临时写入磁盘中由 <em4c_location>\webapps\em4c\WEB-INF\web.xml 中的 IMAGE_TEMP_FOLDER 属性指定的位置。默认情况，临时图像文件夹位于 <em4c_location>\webapps\em4c\temp\images。
解决以 PDF 或 Excel 格式查看地图的疑难问题时，首先要验证地图图像是否已上传到 EM4C Server 的临时图像文件夹中。如果影像未上传，请验证 EM4C Server 是否正在运行以及临时图像文件夹是否可写入。
如果地图图像已成功上传到 EM4C Server，但地图仍未出现在 PDF 或 Excel 报表中，这很可能是 IBM Cognos 或 Esri Maps for IBM Cognos 的配置问题。通过仅使用静态图像创建或测试报表，您可以确定问题的原因是 IBM Cognos 配置还是 Esri Maps for IBM Cognos 配置。图像必须位于 IBM Cognos Gateway（例如，<cognos_gateway_machine>\ibmcognos\em4c\images\move_down.gif）中，且必须使用相对 URL（例如，..\em4c\images\move_down.gif）引用。如果以 PDF 或 Excel 格式查看报表时未出现图像，则 IBM Cognos 配置出现了问题。
如果测试报表中出现了图像，则可能是 Esri Maps for IBM Cognos 配置出现了问题。开始疑难解答之前，请验证是否满足下列需求：
- EM4C Gateway URI （服务器名称、端口和 IBM Cognos 虚拟目录） 和 IBM Cognos Gateway URI 必须相同。
- 在包含安全套接字层 (SSL) 安全协议的配置中，IBM Cognos Dispatcher 将通过 IBM Cognos Gateway 下载地图图像。这意味着必须符合以下条件：
- Web 服务器必须允许 Dispatcher 进程使用 HTTP 或 HTTPS 调用 \<ibmcognos>\em4c\cgi-bin\em4c.cgi。
- IBM Cognos Dispatcher 必须信任 SSL 证书。有关此配置问题的详细信息，请查看 IBM Cognos 文档和以 PDF 格式运行报表时未显示影像。有关其他信息，请参阅知识库文章 000012432。
- 如果在 IBM Cognos Gateway 和 IBM Cognos Dispatcher 之间存在防火墙，则必须创建允许 Dispatcher 访问 \<ibmcognos>\em4c\cgi-bin\em4c.cgi 的防火墙规则。
字体未正确显示
从 Internet Explorer 查看或打印地图时，如果 EM4C Server 尚未安装支持地图中显示的字符的 TrueType 字体，则地图影像中的某些字符可能会丢失。在这种情况下，您必须找到支持所需字符的 TrueType 字体，然后将其安装为系统字体或复制到 EM4C Server 的 \fonts\fallback 文件夹中。安装或放置新字体后，必须重新启动 EM4C 服务以使更改生效。
以下步骤概括了将 TrueType 字体副本放置到 EM4C Server 的方法。这些步骤必须由管理员来完成，且必须在环境中的每台 EM4C Server 上均执行这些步骤。
- 将支持所需字符的 TrueType 字体副本放置到以下位置：
<em4c_location>\bin\jre-server\lib\fonts\fallback
- 在 EM4C Server 计算机上打开服务。
- 找到 EM4C 服务。Windows 服务的默认名称为 EM4C<端口号>。
- 右键单击服务，然后选择重新启动。
多页面和多地图的报表仅可显示一张地图
以 PDF 或 Excel 格式渲染地图时，Esri Maps for IBM Cognos 会按地图在 HTML 中的显示形式生成地图影像。为生成地图影像，Esri Maps for IBM Cognos 需要在已选择 PDF 或 Excel 格式的情况下渲染地图。
因此，如果报表在多页上显示地图，将仅在 PDF 或 Excel 输出文档中渲染当前显示的 HTML 页面上的地图。如果想要打印多页报表中的所有地图，必须单独打印每一页以确保在打印输出中正确显示每个地图的影像快照。 对于包含地图的每一页，浏览到想要打印的 HTML 页面，选择所需输出格式，然后在输出文档中查找并打印该页。
地图位置显示为白色方框
在以 PDF 或 Excel 2007 格式查看报表时，如果地图位置显示为白色方框，原因可能是下列情况中的一种：
- 如果 EM4C Gateway URI（服务器名称、端口等）与 IBM Cognos Gateway URI 不匹配，或者，如果在配置 EM4C Gateway 时发生其他错误，将不会显示地图。请确保 EM4C Gateway 和 IBM Cognos Gateway 的 URL 主机名部分已由 localhost 更改为 IP 地址或网络主机名。有关详细信息，请参阅配置 EM4C Gateway。
- 以 PDF 和 Excel 2007 格式查看启用地图功能的报表时，会生成地图影像并将其保存到 EM4C Server。地图图像的存储位置使用相对 URL 进行指定，以使得在报表移动至配置了不同的 IBM Cognos 虚拟目录的环境中时仍可保存和访问内容。一些 IBM Cognos 版本存在一个已知缺陷，即阻止使用通过 HTTP 请求的相对 URL 上传图像。将 IBM Cognos 升级到包含缺陷修复的版本，或手动编辑受影响的报表以使用地图图像 URL 的绝对路径，均可解决该问题。有关详细信息，请参阅知识库文章 000013621。
- 在包括安全套接字层 (SSL) 安全协议的配置中，IBM Cognos keystore 内不完整或丢失的 SSL 信任链可能会导致此问题。在这种情况下，由于尚未在 web 服务器和 IBM Cognos 应用程序层组件间建立 SSL 信任链，以 PDF 和 Excel 2007 格式查看启用地图功能的报表时，IBM Cognos Gateway 无法在 web 服务器上访问地图影像。
要在 web 服务器和 IBM Cognos 间建立信任，IBM Cognos 管理员必须将 SSL 信任证书链导入到 IBM Cognos CA keystore。有关详细信息，请参阅知识库文章 000012432。
选择报表格式后未生成报表
以 HTML 格式查看启用地图功能的报表时选择报表格式后，等待报表生成时在地图上发生鼠标指针旋转现象。在将 Internet 信息服务 (IIS) 用作 EM4C Gateway 的 Web 服务器的系统环境中，使用 Mozilla Firefox 或 Google Chrome 会出现这种问题。有关如何解决该问题的详细信息和步骤，请参阅知识库文章 000012227。