Esri Maps for IBM Cognos

В этом разделе
  1. Основные способы решения проблем
  2. Шрифты отображаются неправильно
  3. Отчеты на нескольких страницах и с множеством карт отображают только одну карту
  4. На месте карты появляется белая рамка
  5. После выбора формата отчет не создаётся

Просмотр в PDF или Excel

В этом разделе представлены некоторые основные способы решения проблем и описаны наиболее часто возникающие трудности, связанные с просмотром отчетов, содержащих карты, в форматах PDF и Excel.

Основные способы решения проблем

Когда отчет просматривается в форматах PDF или Excel, на EM4C Server загружаются изображения карты. Файлы изображений временно записываются на диск в местоположение, указанное в свойстве IMAGE_TEMP_FOLDER в <em4c_location>\webapps\em4c\WEB-INF\web.xml. По умолчанию папка для временного изображения располагается в <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 должны быть одинаковыми.
  • В настройках, которые включают протокол безопасности Secure Sockets Layer (SSL), диспетчер IBM Cognos Dispatcher загружает изображения карт через шлюз IBM Cognos Gateway. Это означает, что верно следующее:
    • Веб-сервер должен позволить процессу диспетчера выполнять HTTP или HTTPS вызовы на \<ibmcognos>\em4c\cgi-bin\em4c.cgi.
    • IBM Cognos Dispatcher должен доверять сертификату SSL. Ознакомьтесь с документацией IBM Cognos и разделом Изображения не отображаются при запуске отчета как файла PDF, чтобы узнать больше об этой проблеме настройки. Для дополнительной информации см. в статью 44377 Базы знаний.
    • Если между IBM Cognos Gateway и IBM Cognos Dispatcher действует брандмауэр, необходимо создать правило брандмауэра, позволяющее диспетчеру осуществлять доступ к \<ibmcognos>\em4c\cgi-bin\em4c.cgi.

Шрифты отображаются неправильно

Если карта была просмотрена или напечатана из Internet Explorer, некоторые символы из нее могут пропасть, если для EM4C Server не установлен соответствующий шрифт TrueType, которые поддерживает отображение этих символов на карте. В этих случаях необходимо найти шрифт TrueType, поддерживающий необходимые символы, установить его как системный или поместить копию шрифта в папку \fonts\fallback на EM4C Server. После этого сервис EM4C должен быть перезапущен, чтобы применились изменения.

Ниже описывается, как сохранить копию шрифта TrueType font на EM4C Server. Эти шаги должен выполнить администратор, причем необходимо проделать это на каждом EM4C Server в среде.

  1. Поместите копию шрифта TrueType, который поддерживает необходимые символы, в следующее местоположение:

    <em4c_location>\bin\jre-server\lib\fonts\fallback

  2. Откройте Сервисы на машине с EM4C Server.
  3. Найдите сервис EM4C. Имя сервиса в Windows по умолчанию EM4C<portnumber>.
  4. Щелкните сервис правой кнопкой и выберите команду Перезапустить.

Отчеты на нескольких страницах и с множеством карт отображают только одну карту

При отображении карты в форматах 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. Убедитесь, что часть имени хоста в URI для EM4C Gateway и IBM Cognos Gateway была изменена с localhost на IP адрес или имя хоста сети. Более подробно см. Настройка EM4C Gateway.
  • Когда отчеты, содержащие карты, просматриваются в форматах PDF и Excel 2007, изображение карты создается и сохраняется в EM4C Server. Местоположение, где хранятся изображения карты, указываются с помощью относительного URL-адреса, чтобы содержимое могло сохраняться и извлекаться, если отчет перемещается в другую среду, настроенную для другой виртуальной директории IBM Cognos. Некоторые версии IBM Cognos содержать известную ошибку, которая препятствует загрузке изображений по относительным URL-путям через HTTP-запросы. Чтобы избежать этой ошибки, обновитесь до более поздней версии IBM Cognos, или вручную отредактируйте отчеты с ошибкой и введите абсолютные пути для URL изображения карты. Более подробно см. в статье 43450 Базы знаний.
  • В настройках, которые включают протокол безопасности Secure Sockets Layer (SSL), эта проблема может быть вызвана неполной или отсутствующей цепочкой доверия для SSL внутри хранилища ключей IBM Cognos keystore. В этом случае при просмотре отчета, содержащего карту в PDF или Excel 2007 форматах IBM Cognos Gateway не может получить доступ к изображениям карт на веб-сервере, так как между веб-сервером и узловыми компонентами IBM Cognos Application Tier не установлена цепочка доверия для SSL.

    Чтобы установить доверие между веб-сервером и IBM Cognos, администратор IBM Cognos должен импортировать сертификат цепочки доверия SSL в CA хранилище ключей IBM Cognos. Более подробно см. в статье 44377 Базы знаний.

После выбора формата отчет не создаётся

После выбора формата отчета при просмотре в HTML отчета, содержащего карту, в области карты может появиться курсор в режиме ожидания, пока отчет загружается. Это происходит при использовании Mozilla Firefox или Google Chrome в системной среде, в которой Internet Information Services (IIS) используются как веб-сервер для EM4C Gateway. Для более подробной информации и шагов по решению этой проблемы см. Статью базы знаний Esri 43279.