Замечания о редакции
Crystal Reports Toolkit для платформы разработки программного обеспечения Rational Software
Замечания о редакции
Содержание замечаний о редакции
Эти замечания содержат важную информацию о настоящей редакции программы, в том числе о неполадках при установке и других известных неполадках, а также информацию для пользователей, выполняющих обновление более ранней версии. Перед установкой программы полностью прочитайте настоящий документ.
Установка
На платформе Linux установка Crystal Reports должна выполняться пользователем, вошедшим в систему не в качестве "привилегированного" пользователя.
Ограничения
На данную версию Crystal Reports Toolkit для платформы разработки программного обеспечения Rational Software распространяются следующие ограничения:
• С помощью компонента создания отчетов Java можно обрабатывать только отчеты, созданные в Crystal Reports 9 или более поздней версии. Отчеты, созданные в более ранних версиях Crystal Reports, следует преобразовать с применением средства преобразования отчетов, которое доступно для загрузки с web-узла Business Objects.
• В настоящей редакции не доступен интерфейс API создания и изменения отчетов для компонента создания отчетов Java.
• Не поддерживается работа с отчетами, использующими следующие источники данных:
• OLAP
• представления деловой информации
• юнивёрсы
• Экспортировать отчеты с помощью компонента создания отчетов Java можно только в форматы PDF, RPT, CSV и RTF.
• В настоящей редакции не поддерживаются следующие функции:
• шаблоны отчетов
• географические карты
• репозиторий Crystal Reports
• предупредительные сигналы в отчетах
• динамические приглашения
• Невозможно открыть отчеты, содержащие группы, для которых задан исходный порядок сортировки.
• Для экспорта отчета с помощью компонента создания отчетов Java необходимо задать абсолютный путь для java.io.tmpdir.
Конструктор Crystal Reports
• Конструктор Crystal Reports не поддерживает одновременное редактирование одного отчета в нескольких окнах.
• Отчеты, содержащие именованное условие группирования с полями, отличными от "Группировать по", неправильно отображаются в предыдущих версиях конструктора Crystal Reports.
• Не поддерживается предварительный просмотр отчетов, содержащих ссылки между таблицей пользовательских запросов и таблицей базы данных.
InfoView
• Если в системном поле содержится IP-адрес сервера, вход в систему BusinessObjects Enterprise Java InfoView невозможен.
Способ обхода ошибки: при входе в систему укажите имя узла сервера централизованного управления (CMS).
• При запуске IinfoView с платформы разработки программного обеспечения Rational Software не действует команда создания новых отчетов (верхняя панель инструментов > Создать > Отчет Crystal)
Способ обхода ошибки 1: создайте новый отчет с помощью конструктора Crystal Reports.
Способ обхода ошибки 2: запустите InfoView из внешнего обозревателя.
• Для последующего подключения средства просмотра отчетов к BusinessObjects Enterprise с применением обновленных учетных данных необходимо перед выходом из системы BusinessObjects Enterprise очистить все переменные сеанса, в которых содержатся помещенные в кэш-память исходные данные отчета.
Публикация
• В BusinessObjects Enterprise невозможно опубликовать отчет, содержащий нарастающую сумму со значением “Для каждой записи” для параметра "Тип условия оценки" или со значением "Никогда" для параметра "Сбросить тип условия".
Способ обхода ошибки: выберите другие значения в списках, относящихся к типу условия.
• При публикации отчетов, содержащих несколько соединений JDBC, в мастере публикации отображаются не все соединения.
Способ обхода ошибки: перейдите в консоль централизованного управления (СМС) и измените соединения JDBC, которые не отображаются в мастере публикаций.
Компонент создания отчетов Java
• Если JRC и средство просмотра JSF используются в одном и том же процессе, для JSF должен действовать режим сохранения состояния на стороне сервера.
• При создании новой страницы JSP необходимо снять флажок "Использовать шаблон JSP"; во фрагментах кода Crystal Reports для собственной страницы средства просмотра по умолчанию установлено значение "Истина", и использование шаблона может привести к повторению форматных маркеров HTML.
• Если для web-проекта не задан рабочий модуль, компиляция приложения JRCHelperSample не выполняется.
Способ обхода ошибки: задайте рабочий модуль, выбрав в меню "Свойства" команду "Целевые рабочие модули".
• При удалении из проекта фасета JRC класс JRCHelperSample не удаляется автоматически, так как в него могли быть внесены изменения.
• Фрагменты кода Crystal Reports невозможно вставить в конструкторе станиц в режиме проектирования.
Способ обхода ошибки: для вставки фрагмента кода перейдите в режим просмотра исходного кода, предусмотренный в конструкторе страниц.
• Для правильного отображения отчета в средстве просмотра JSF необходимо изменить объявление DOCTYPE на <!DOCTYPE html PUBLIC”-//W3C//DTD HTML 4.01 Transitional//EN”>.
• При синхронизации органов управления с компонентом EnterpriseItem, созданным с применением параметра “Использовать последний экземпляр”, в коде страницы может возникнуть ошибка.
Способ обхода ошибки: в коде страницы измените “getParentItemID” на “getItemID”, а “setParentItemID” на “setItemID”.
• В режиме данных страницы невозможно изменить конфигурацию элемента в категории компонентов страницы.
Способ обхода ошибки: измените конфигурацию этого же элемента в категории компонентов, управляемых посредством фасетов.
Функции работы с отчетами
• Если для отчета, содержащего сохраненные данные, задан режим "проверки при первом обновлении", при предварительном просмотре такого отчета сохраненные данные удаляются, а на экране отображается предупреждение.
Способ обхода ошибки: перед предварительным просмотром отчета откройте его в том конструкторе Crystal Reports, в котором создан этот отчет, отключите режим "проверки при первом обновлении" и сохраните отчет.
• Открытие страницы во время выполнения другой операции может привести к исключению java.lang.IndexOutOfBoundsException. Это исключение возникает в том случае, если используется средство просмотра JSF, а для параметра javax.faces.STATE_SAVING_METHOD задано значение "сервер". Данная неполадка обусловлена ошибкой в реализации JSF, допущенной корпорацией Sun.
Способ обхода ошибки: обновите реализацию Sun JSF до более поздней версии по сравнению с 1.1 или воспользуйтесь реализацией JSF, выполненной другой компанией.
• Если после задания источника данных для java.sql.ResultSet значения параметров OldTableAlias и NewTableName различны, при попытке задания значения NewTableName в качестве имени новой таблицы происходит сбой комплекта средств разработки программного обеспечения RAS.
• Во время предварительного просмотра отчета подсистема данных не может извлечь данные POJO с преобразованием в тип java.util.Date.
Способ обхода ошибки: воспользуйтесь типом java.sql.Date.
• При экспорте вложенных отчетов, формируемых по требованию, в формат CSV экспортируются только те вложенные отчеты, которые расположены на первой странице главного отчета.
• При редактировании диаграммы невозможно изменить значение свойства "Группировать по" после того, как для параметра "Порядок сортировки" задано значение "N наибольших", "N наименьших", "Наибольший процент" или "Наименьший процент".
Способ обхода ошибки: перед изменением значения поля "Группировать по" задайте для параметра "Порядок сортировки" значение "По возрастанию" или "По убыванию".
• Проводник базы данных не поддерживает хранимые процедуры. Это известная ошибка Eclipse. Подробнее см. Eclipse Bugzilla - ошибка 132107.
Способ обхода ошибки: пример кода, позволяющего обойти эту ошибку, см. в материалах телеконференции по адресу: http://diamond.businessobjects.com/node/520#comment-209.
Неполадки, связанные с конкретными платформами
• При работе с виртуальной машиной Java, реализованной корпорацией Sun, может появиться следующее сообщение об ошибке: “java.lang.OutOfMemoryError: PermGen space.“
Способ обхода ошибки: обновите файл eclipse.ini, указав следующие параметры:
-vmargs
-Xms40m
-Xmx512m
-XX:MaxPermSize=256m
Подробнее см. Eclipse Bugzilla - ошибки 129490 и 92250.
• При редактировании отчета, ранее опубликованного на сервере Apache Tomcat, для успешного сохранения изменений необходимо перед сохранением отчета завершить работу Tomcat.
• При удалении фасета файлы удаляются из каталога библиотеки, но не из пути компоновки. Это может привести к появлению сообщений об ошибках в режиме просмотра неполадок.
• При использовании IBM Websphere 6.0 и 6.1 функция экспорта может не поддерживать все форматы экспорта.
Способ обхода ошибки 1: экспортируйте отчет в различные форматы с помощью средства просмотра страниц JSF Crystal Reports.
Способ обхода ошибки 2: обеспечьте отсутствие на странице каких-либо выходных данных, кроме кода средства просмотра.
• При работе с виртуальными машинами Java более ранней версии по сравнению с 1.5.0_07, реализованными корпорацией Sun, загрузка отчета, содержащего изображение в виде объекта OLE, в многопоточной среде может привести к исключению java.awt.color.CMMException.
• Обозреватель Konqueror не поддерживается. При выполнении кода JSP для просмотра отчета в Konqueror может появиться сообщение об ошибке.
Способ обхода ошибки: воспользуйтесь поддерживаемым web-обозревателем.
• При работе с Sun JVM 1.4.2 возможны несогласованные результаты экспорта значений разделов в XML.
• На платформе SUSE Linux не работает функция поиска в интерактивной справочной системе.
Способ обхода ошибки: найдите требуемую информацию в содержании справочной системы.
Форматирование и визуализация
• Для отмены перетаскивания внутри текстового объекта дважды щелкните на команде "Отменить".
• В режиме редактирования текстового объекта не отображается первый знак табуляции, вставленный перед объектом-полем в начале абзаца.
• Если при создании в отчете нового текстового объекта для него задано отрицательное значение свойства "Отступ первой строки", текст отображается только при прохождении курсора через левое поле отступа.
• При редактировании абзаца в текстовом объекте отображается только первый знак табуляции.
• Форматирование текста в многострочном абзаце текстового объекта приводит к тому, что форматируемый текст отображается с новой строки.
• Для выбора объекта в составе прямоугольника сначала переместите прямоугольник на задний план.
• Свойство раздела "Относительное положение" не применяется к линиям и прямоугольникам, содержащимся в этом разделе.
• При настройке свойства "Формат даты" конструктора Crystal Reports изображение в области "Образец" не зависит от того, выбрано ли для параметра "Заполнение дня недели" значение ''Скобка" или "Открывающиеся круглые скобки".
• В следующей таблице приведены результаты открытия и сохранения в JRC отчетов, содержащих неподдерживаемые функции, во время выполнения.
Функция
Результат открытия в JRC отчета с этой функцией
Результат сохранения в JRC отчета с этой функцией
 
Предупредительные сигналы в отчетах
Предупредительные сигналы не включаются.
В определении отчета сохраняется информация, относящаяся к предупредительным сигналам. Однако визуальные представления предупредительных сигналов не сохраняются.
Географические карты
Отображаются как незаполненные объекты.
Сохраняются в определении отчета.
Диаграммы отчетов Crystal Reports 9 с текстурой и изображениями
Не отображаются.
Сохраняются в определении отчета.
Расположение меток диаграмм
В случае перемещения меток они возвращаются в положение по умолчанию.
Сохраняются в определении отчета.
Специальные поля контекста Crystal Enterprise: ИД текущего пользователя CE.
 
Отображаются на номер страницы по вертикали.
 
Специальные поля сохраняются.
Динамические изображения
Не поддерживаются.
Полностью поддерживаются.
Параметрическая сортировка
Поддерживается.
Полностью поддерживается.
Сортировка групп с иерархической структурой
Поддерживается.
Полностью поддерживается.
Добавление функций формул
Поддерживаются (за исключением часового пояса Crystal Enterprise).
Полностью поддерживаются.
Динамические приглашения
Не поддерживаются.
Не сохраняются.
Расширенные функции отображения сетки
Поддерживается выравнивание заголовков столбцов для кросс-таблиц.
Выровненные заголовки столбцов сохраняются. Представление сквозного перехода не сохраняется.
Реляционные базы данных и операторы SQL
• Драйвер Oracle JDBC не поддерживает таблицы, связанные с использованием "полных внешних связей". Отображается следующее сообщение: "Полные внешние связи не поддерживаются."
• Задание ODBC в качестве местоположения таблицы базы данных может привести к удалению объектов отчета.
Способ обхода ошибки: задайте в качестве местоположения таблицы JDBC, JNDI, XML или набор результатов Java.
• При загрузке отчета на сервер приложения SunOne8 или сервер приложений Oracle 10g необходимо указать не относительный, а абсолютный путь.
• Если изменить местоположение таблицы с ODBC на JDBC/JNDI с помощью команд задания местоположения, предусмотренных в JRC, обновление отчета разрешается только в JRC.
Способ обхода ошибки: для включения функции обновления отчетов в конструкторе Crystal Reports при вводе команды задания местоположения укажите параметры сервера JNDI.
• Драйвер Informix не поддерживает поля Blob, добавленные к отчету из базы данных Informix.
• Вследствие ошибки драйвера Informix JDBC при просмотре отчета Informix, содержащего хранимую процедуру, отображается следующее сообщение об ошибке: “Невозможно найти процедуру (prc_decimal).“
• При подключении к базе данных Microsoft SQL Server из конструктора после ввода имени базы данных в проводнике базы данных отображается база данных пользователя по умолчанию.
Способ обхода ошибки: укажите полную строку подключения, включая имя базы данных.
• Если поле "Поля данных" в отчете является полем формулы, в свойствах поля отсутствует параметр "Не суммировать".
• При предварительном просмотре отчета с полем базы данных сервера SQL "вещественного" типа может отображаться следующее сообщение об ошибке: “Ошибка JDBC: Невозможно преобразовать значение в требуемый тип“. Эта неполадка обусловлена ошибкой Microsoft JDBC.
• При добавлении нескольких операторов SQL на буферную страницу SQL (щелчок правой кнопкой на Crystal Reports > "Добавить в новый отчет") к отчету добавляется только первый оператор SQL. Эта неполадка возникает при работе с базой данных Derby.
• Ввод неверного пароля при создании нового соединения с базой данных DB2 UDB iSeries может привести к непредусмотренному завершению процесса Eclipse. Подробнее см. Eclipse Bugzilla - ошибка 148920.
• Если при создании в конструкторе Java нового соединения с базой данных сервера SQL включить в адрес URL соединения информацию о пароле, последующее обновление свойств соединения может восприниматься конструктором Java как создание нового соединения; в этом случае может быть сгенерирован код SQL, содержащий команду объединения баз данных, несмотря на то, что все таблицы расположены в одной и той же базе данных.
Способ обхода ошибки: сохраните отчет и затем откройте его заново. При создании нового соединения не рекомендуется включать в адрес URL информацию о пароле.
• При добавлении оператора SQL к отчету Crystal следует открывать файл SQL в редакторе SQL Editor, а не в используемой по умолчанию программе.
• При подключении к демонстрационной базе данных Derby, входящему в комплект поставки платформы разработки программного обеспечения Rational Software, может отображаться следующее сообщение об ошибке: “Could not Add Object. Logon Error: The user name ‘{userid}’ is not valid.” (Невозможно добавить объект. Ошибка при входе в систему. Недопустимое имя пользователя "{идентификатор_пользователя}").
Способ обхода ошибки: измените соединение с базой данных таким образом, чтобы идентификатор пользователя был введен в сведениях о соединении.
Неполадки, связанные с конкретными языками
• Во время создания локализованной документации были доступны не все пакеты локализации. Поэтому некоторые элементы пользовательского интерфейса, переведенные в последнем наборе пакетов локализации, представлены в документации на английском языке.
• JRC интерпретирует текст, читаемый справа налево, на уровне абзаца, а не на уровне символов; поэтому наличие в одном и том же параграфе фрагментов текста, читаемых справа налево и слева направо, может привести к неправильному отображению текста.
• При экспорте в формат RTF неправильно кодируются символы арабского языка и иврита.
• Если параметры локализации операционной системы (например, для Германии и Италии) предусматривают употребление запятой в качестве разделителя десятичных дробей, вследствие ошибки сдвига выравнивание десятичных дробей выполняется неправильно.
• При экспорте отчетов в формат PDF с применением JRC вместо символов некоторых языков могут отображаться вопросительные знаки или прямоугольники.
• В среде, локализованной для Италии, в некоторых диалоговых окнах конструктора Crystal Reports неверно отображается разделитель десятичных дробей. Однако можно настроить правильное отображение разделителя десятичных дробей для Италии.
• При работе с версией операционной системы, отличной от английской, во избежание появления посторонних символов убедитесь в том, что в состав набора символов для выбранного шрифта входят глифы.
• В среде, локализованной для Польши, в диалоговом окне "Формат денежного значения" денежные величины отображаются без пробела между обозначением денежной единицы и суммой.
Средства работы для лиц с ограниченными физическими возможностями
• Для правильной работы средства чтения с экрана, например, JAWS, с конструктором Crystal Reports необходимо установить Java Access Bridge. Для установки Java Access Bridge можно перейти по следующему адресу: http://java.sun.com/products/accessbridge.
Для использования Java Access Bridge с IBM JVM 1.5 необходимо установить некоторые файлы jar. Подробнее см. файл readme.txt по следующему адресу: http://java.sun.com/products/accessbridge/README.txt.
• Комбинации клавиш быстрого вызова команд в средстве чтения с экрана JAWS не соответствуют комбинациям клавиш в Crystal Reports.
Способ обхода ошибки: с помощью диспетчера клавиатуры JAWS измените назначение комбинаций клавиш Alt+стрелка вверх, Alt+стрелка вниз, Ctrl+Home и Ctrl+End в соответствии с функциями этих комбинаций клавиш в Crystal Reports
• Функция перехода вниз по иерархии на странице предварительного просмотра не доступна с клавиатуры.
• JAWS не сообщает о полях в палитре конструктора Crystal Reports. Подробнее см. Eclipse Bugzilla - ошибка 146620.
• JAWS сообщает о метке палитры конструктора Crystal Reports как о регуляторе. Подробнее см. Eclipse Bugzilla - ошибка 146859.
• При работе с проводником базы данных некоторые клавиши быстрого вызова команд могут не функционировать, поскольку они назначены нескольким действиям. Эта ошибка обусловлена ограничением JAWS, которое состоит в том, что в пункте контекстного меню считывается только первая буква.
• Для вставки объекта-поля в текстовый объект с клавиатуры выберите эти два объекта, а затем в контекстном меню щелкните на пункте "Добавить поле в текстовый объект".