Инструменты диагностики IBM Cognos: Вариант использования – пакетное обновление URL изображений в отчетах

Продукт(ы): IBM Cognos BI. Область применения: инфраструктура

В данном сценарии клиент спрашивает у аналитика службы поддержки, как можно легко и быстро обновить путь к изображениям в нескольких отчетах. Для решения проблемы в сценарии используется программа Dynamic Report Specification Updater Diagnostic.

Введение

Назначение

В данном документе описывается методология поиска и устранения неисправностей, объединяющая общедоступные инструментальные средства для диагностирования и решения проблемы, возникающей при определенном варианте использования. Вариант использования будет представлен в виде сценария, в котором сотрудник службы поддержки IBM Cognos работает с клиентом с целью диагностирования и решения конкретной проблемы.

Упоминаемые в данном документе инструментальные средства можно найти по адресу

http://www.ibm.com/software/data/support/cognos_sdk.html.

Применимость

Хотя рассматриваемая методика поиска и устранения неисправностей не зависит от конкретной версии IBM Cognos BI, этого нельзя сказать о некоторых из используемых средств диагностики. Версия загружаемого инструментального средства будет специфична для версии IBM Cognos BI, в которой возникла проблема.


Описание варианта использования

В данном сценарии клиент спрашивает у аналитика службы поддержки, как можно легко и быстро обновить путь к изображениям в нескольких отчетах. Клиент сообщает, что у них есть несколько отчетов, содержащих логотип компании – GIF-изображение, извлекаемое по относительному пути на каждом из серверов IBM Cognos BI Report Server. В связи с этим изображения должны располагаться на каждом сервере отчетов именно по этому относительному пути, чтобы быть включенными в генерируемые PDF-отчеты.

Они хотели бы разместить изображение логотипа на Web-сервере и изменить путь к нему, используя URL-адрес. Это позволит хранить и обновлять изображения централизовано, а не на каждом сервере IBM Cognos BI Report Server. Т.е. нужно изменить путь с

..\samples\images\logo_great_outdoors.gif

на

http://www.corpimages.com/images/logo_great_outdoors.gif


Сбор информации для этого варианта использования

Аналитик службы поддержки запрашивает номер используемой версии IBM Cognos BI. Клиент сообщает, что используется версия 8.4.1. На основании этой информации аналитик информирует клиента о наличии вспомогательной программы Dynamic Report Specification Updater Diagnostic. Существует версия этой программы для IBM Cognos BI версий 8.3, 8.4 и 10.1. Поскольку среда клиента попадает в поддерживаемую категорию, аналитик службы поддержки сообщает, что эта программа поможет быстро обновить их отчеты в пакетном режиме.

Dynamic Report Specification Updater Diagnostic представляет собой мощное средство глобального поиска и замены, позволяющее пользователю искать любые XML-элементы в спецификациях отчетов IBM Cognos Report Studio, IBM Cognos Query Studio, IBM Cognos Analysis Studio и IBM Cognos PowerPlay 8, и заменять их новыми XML-элементами.

Аналитик просит клиента загрузить версию 8.4 этой программы по URL-адресу

http://www.ibm.com/support/docview.wss?uid=swg24021248.

После загрузки аналитик службы поддержки помогает клиенту настроить приложение путем редактирования файла runme.bat file, где нужно указать поддерживаемую локальную среду исполнения Java (JRE).


Указание причин и мер предосторожности

Аналитик службы поддержки объясняет клиенту важность резервного копирования отдельных отчетов, подлежащих изменению, путем создания развертываемого архива отчетов. Для выбора и архивирования отчетов клиенты могут также использовать сторонние инструментальные средства, продаваемые партнерами IBM Cognos. Если полной уверенности в местоположении отчетов нет, можно сделать резервную копию всего хранилища контента IBM Cognos BI.

Аналитик службы поддержки указывает также, что пакетное обновление должно выполняться в среде развертывания или тестирования, а измененные отчеты должны быть тщательно протестированы перед развертыванием в рабочей среде.


Пакетное обновление спецификаций отчетов

Аналитик службы поддержки объясняет клиенту, что процесс обновления спецификаций отчетов включает в себя:

  • создание XML-файла преобразования, содержащего синтаксис операций поиска и замены для данного отчета;
  • запуск программы Dynamic Report Specification Updater Diagnostic и подключение ее к хранилищу контента IBM Cognos BI;
  • загрузку файла преобразования в программу;
  • выбор участка хранилища контента IBM Cognos BI, где выполняется обновление;
  • обновление спецификаций отчетов.

Основываясь на информации о пути, предоставленной в PMR-заявке, аналитик службы поддержки работает с клиентом с целью создания соответствующего файла преобразования, который выглядит следующим образом:

<?xml version="1.0" encoding="UTF-8"?>

<Transformations>
<Transformation id="Image URL Replace">
<Search><![CDATA[..\\samples\\images\\logo_great_outdoors.gif]]></Search>

<Replace><![CDATA[http://www.mycorpimages.com/images/logo_great_outdoors.gif]]></Replace>

</Transformation>

</Transformations>

Аналитик информирует клиента о том, что в некоторых ситуациях, когда в регулярных выражениях, используемых для преобразования XML-спецификаций отчетов, присутствуют специальные символы, их необходимо предварять символом перехода (escape). В данном сценарии символу обратной косой черты предшествует еще один символ обратной косой черты, поэтому в файле преобразования исходный путь ..\samples\images\logo_great_outdoors.gif имеет две косые черты.

После создания клиентом резервной копии хранилища контента IBM Cognos BI аналитик вместе с клиентом загружают файл преобразования во вспомогательную программу и перед пакетным обновлением всех необходимых отчетов используют функцию поиска, чтобы увидеть, сколько отчетов будет обновлено. Просмотрев log-файл результатов, они видят, что будет выполняться изменение 236 отчетов.

Сначала аналитик и клиент выполняют преобразование одного отчета. Если тестирование проходит успешно, они спокойно переходят к выполнению пакетного обновления оставшихся отчетов.

Если клиент удовлетворен результатами тестирования всех отчетов, он развертывает содержимое в рабочей среде и отправляет запрос на закрытие PMR-заявки.

Ресурсы

Комментарии

developerWorks: Войти

Обязательные поля отмечены звездочкой (*).


Нужен IBM ID?
Забыли Ваш IBM ID?


Забыли Ваш пароль?
Изменить пароль

Нажимая Отправить, Вы принимаете Условия использования developerWorks.

 


Профиль создается, когда вы первый раз заходите в developerWorks. Информация в вашем профиле (имя, страна / регион, название компании) отображается для всех пользователей и будет сопровождать любой опубликованный вами контент пока вы специально не укажите скрыть название вашей компании. Вы можете обновить ваш IBM аккаунт в любое время.

Вся введенная информация защищена.

Выберите имя, которое будет отображаться на экране



При первом входе в developerWorks для Вас будет создан профиль и Вам нужно будет выбрать Отображаемое имя. Оно будет выводиться рядом с контентом, опубликованным Вами в developerWorks.

Отображаемое имя должно иметь длину от 3 символов до 31 символа. Ваше Имя в системе должно быть уникальным. В качестве имени по соображениям приватности нельзя использовать контактный e-mail.

Обязательные поля отмечены звездочкой (*).

(Отображаемое имя должно иметь длину от 3 символов до 31 символа.)

Нажимая Отправить, Вы принимаете Условия использования developerWorks.

 


Вся введенная информация защищена.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=40
Zone=Information Management
ArticleID=845046
ArticleTitle=Инструменты диагностики IBM Cognos: Вариант использования – пакетное обновление URL изображений в отчетах
publish-date=11082012