Замечания о редакции
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.
Неполадки, связанные с конкретными платформами
• При работе с виртуальной машиной 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.
• Комбинации клавиш быстрого вызова команд в средстве чтения с экрана 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, которое состоит в том, что в пункте контекстного меню считывается только первая буква.
• Для вставки объекта-поля в текстовый объект с клавиатуры выберите эти два объекта, а затем в контекстном меню щелкните на пункте "Добавить поле в текстовый объект".