Crystal Reports para Rational Software Architect - Notas sobre o Release
1.0 Restrições
2.0 Instalação/Desinstalação
3.0 Problemas Específicos da Plataforma
4.0 Formatando e Processando
5.0 Bancos de Dados Relacionais e Instruções SQL
6.0 Gráficos
7.0 Funcionalidade de Relatório
8.0 Visualizadores
9.0 Integração do IDE
10.0 Componentes JSF do Crystal Enterprise
1.0 Restrições
O componente de geração de relatórios que processa relatórios, fornecido com
o Crystal Reports para Rational Software Architect, é restringido pelo
código-chave para fornecer desempenho adequado para desenvolvimento, teste
e implementação de geração limitada de relatórios nos aplicativos. As outras
restrições a seguir aplicam-se a esta versão do Crystal Reports para
Rational Software Architect:
- O Componente de Geração de Relatórios JavaTM processará
apenas os relatórios criados utilizando o Crystal Reports 9 ou posterior. Os relatórios
de versões anteriores do Crystal Reports devem ser convertidos utilizando a
ferramenta Report Conversion disponível para download a partir do Web site
da Business Objects.
- A API de Criação e Modificação de Relatório para o
Componente de Geração de Relatórios Java não é apresentada neste release.
- Os dados do relatório que são salvos juntamente com o
gabarito de relatório podem ser atualizados no tempo de execução, mas não salvos
com o gabarito de relatório. Os dados somente podem ser atualizados e salvos com o gabarito
de relatório no tempo de design, utilizando o projetista de relatórios de desktop.
- Não é possível utilizar os relatórios que acessam as
seguintes origens de dados:
- Driver do Java Bean
- Múltiplas origens de dados
- OLAP
- Os relatórios somente podem ser exportados para PDF e RTF.
- O salvamento de estado no lado cliente não é suportado.
- Os seguintes recursos não são suportados
neste release:
- Interpretação de RTF
- Gabaritos de relatório
- Mapeamento geográfico
- Gráficos de Gantt, de Calibre, de Funil e de Eixo Numérico
- Repositório do Crystal Reports
- Alertas de relatório
2.0 Instalação/Desinstalação
- Na desinstalação, os arquivos comuns localizados em
C:\Program Files\Common Files\Crystal Decisions\2.5 e C:\Program
Files\Common Files\Business Objects\3.0 não são removidos.
3.0 Problemas Específicos da Plataforma
- Em uma plataforma AIX® que esteja executando o IBM JDK
1.3.1 ou 1.4, um erro no JDK pode causar travamento dos relatório. Como
solução alternativa, defina o ambiente JITC_COMPILEOPT para
SKIP{com/crystaldecisions/reports/common/encryption/Processing}{processing}.
- A JVM BEA JRockit possui uma opção de coleta de
lixo paralela que causa exceções de falta de memória o lidar com
blocos adjacentes de memória superiores a 2 MB. Como solução alternativa,
aumente o tamanho máximo de heap ou comute para o coletor de lixo de
cópia geracional. Para definir o tamanho máximo de heap, utilize a opção
"-XmxNNNm", em que NNN é o tamanho do heap em MB. Para utilizar o
coletor de lixo de cópia geracional, utilize a opção "-Xgc:gencopy".
- A exportação de um relatório para PDF (de modo programático
ou por meio de visualizadores) não é suportada no WebSphere®
Studio 6. Essa limitação não se aplica a outros servidores de aplicativos.
Recomenda-se utilizar a impressão ActiveX se seu aplicativo da Web
for implementado no WebSphere Studio 6. Alternativamente, você pode utilizar a
versão JSF do visualizador de páginas de relatório DHTML, que não possui essa
limitação.
4.0 Formatando e Processando
- Se uma seção ou área de um relatório for suprimida,
os novos sinalizadores newPageBefore e newPageAfter não são avaliados para essa
seção ou área. Como solução alternativa, você pode definir o sinalizador
newPageBefore ou newPageAfter na próxima seção visível; isso também é verdadeiro
para uma seção de altura 0.
- O símbolo monetário em um relatório é flutuante mesmo se
a opção de posição fixa for selecionada.
- O formato de hora e data exibido em um relatório
baseia-se apenas nas configurações padrão do código do idioma do servidor.
- Ao visualizar um relatório, se o relatório contiver
objetos que cruzam um limite da página, a página resultante é exibida como
duas páginas horizontais.
- Ao visualizar um relatório no visualizador, os objetos de
texto sem espaços não são exibidos se a largura for muito pequena. O aumento da
largura do objeto de texto faz com que o relatório seja exibido corretamente.
- O recurso de espaçamento de caractere não é suportado
neste release. O espaço de caractere aplicado a um objeto de texto é ignorado.
- Devido a limitações no HTML 4.0, o estilo de moldura
Arredondada de um objeto caixa é exibido como um retângulo.
- Ao visualizar um relatório no visualizador, os títulos das
colunas de uma guia cruzada podem se sobrepor ou ser truncados.
- Ao visualizar um relatório com uma guia cruzada no
visualizador, se a guia cruzada tiver uma linha de total no início da guia cruzada,
parte dos campos nas células é recortada. Se a guia cruzada tiver uma
linha de total no final da guia cruzada, as células não são recortadas
(o comportamento será o esperado).
- Ao visualizar um relatório no visualizador, podem aparecer
linhas extras no campo de texto. Isso ocorre devido ao arredondamento da
conversão de twips to pixels. Como solução alternativa, redimensione um
pouco a seção.
- Ao exportar um relatório para PDF, você poderá receber
uma mensagem de erro informando "A fonte contém um BBox inválido" ao abrir
o PDF. Esse erro pode ser seguramente ignorado porque não afeta a
visualização do arquivo PDF.
- Ao exportar um relatório para RTF utilizando o
Componente de Geração de Relatórios Java, se o relatório contiver um objeto com a
definição "mover para a frente", o objeto não é movido para a frente do RTF resultante.
Entretanto, a opção "mover para trás" funciona conforme o esperado.
- Os relatórios que contêm gráficos de superfície com
dados nulos não são processados corretamente pelo Componente de Geração
de Relatórios Java.
- As posições personalizadas de itens nos gráficos não são
utilizadas pelo Componente de Geração de Relatórios Java no processamento do relatório. Em vez disso,
são utilizadas as posições padrão.
5.0 Bancos de Dados Relacionais e Instruções SQL
- Ao atualizar um relatório de procedimentos armazenados BIT a partir
de um banco de dados do Servidor SQL ou do Sybase, os campos de parâmetros tornam-se
menus de opções sem valores padrão. Não é possível visualizar o relatório se
ele considerar valores de parâmetros.
- O driver JDBC Oracle não suporta relatórios
com dados BFILE.
- O driver JDBC Oracle não suporta tipos de dados
de intervalo.
- O driver JDBC Oracle não suporta relatórios
com dados UROWID.
- O driver JDBC Sybase permite apenas que até 255
caracteres sejam digitados para os campos do tipo char, varchar e
nvarchar. Se você precisar digitar mais de 255 caracteres em um campo,
utilize então o tipo de texto.
- Versões anteriores do driver JDBC Sybase não suportam
relatórios com dados UNICHAR ou UNIVARCHAR. Utilize jConnect para JDBC
versão 5.5 ESD #9 ou acima.
- O driver ODBC Informix® retorna
o campo CLOB como um objeto em vez de um CLOB.
- Os relatórios com junções cíclicas não são suportados
neste release. Além disso, as junções que requerem a execução de consultas
independentes, que são posteriormente vinculadas por algum outro conjunto de
tabelas, não são suportadas neste release.
- Os campos BLOB que são definidos como 'podem aumentar' não
aumentam. Por exemplo, imagens com tamanhos diferentes colocadas em campos BLOB com
a propriedade 'podem aumentar' são processadas com o mesmo tamanho.
- Ao atualizar um relatório de procedimentos armazenados
a partir de um banco de dados do Servidor SQL, os parâmetros de timestamp devem
estar no formato hexadecimal.
- O Componente de Geração de Relatórios Java não respeita a junção
imposta de tabelas.
6.0 Gráficos
- A legenda do gráfico pode aparecer no
Crystal Reports Designer diferente do visualizador.
- Ao visualizar um relatório com uma guia cruzada e um
gráfico, a guia cruzada sempre aparece sobre o gráfico, independentemente
da definição da propriedade MoveToFront para a guia cruzada.
- O visualizador não exibe texturas ou figuras
utilizadas como o segundo plano dos gráficos.
- Ao visualizar um gráfico que possui uma imagem dividida
em várias páginas, a imagem pode ser exibida incorretamente. Como
solução alternativa, utilize o sinalizador Manter Juntos no objeto imagem
para evitar a divisão em várias páginas.
7.0 Funcionalidade de Relatório
- O Componente de Geração de Relatórios Java utiliza um formato de
hora e data de alta resolução. As funções de data e hora podem retornar
um número não inteiro de segundos.
- Ao utilizar as funções ASC e CHR, ocorre um erro de
tempo de execução se forem utilizados caracteres com um valor fora de 0 a 127. As
funções ASC e CHR foram desaprovadas e, portanto, as funções ASCW e CHRW
devem ser utilizadas em seus locais para evitar o erro de tempo de execução
com valores fora de 0 a 127. As funções ASC e CHR não serão suportadas
em versões futuras.
- Apenas cadeias de datetime do código do idioma inglês
na linguagem de fórmulas são suportadas neste release.
8.0 Visualizadores
- Ao visualizar um relatório, os botões Exportar e
Imprimir não são mostrados por padrão. Para ativar os botões, defina a
propriedade isOwnPage para true (ou defina o método setOwnPage para true).
(Nota: A versão JSF do visualizador de páginas de relatório DHTML não possui uma
propriedade isOwnPage.)
- Ao exportar um relatório, se o usuário pressionar o
botão de atualização do navegador após a exportação do relatório, ele será
avisado para exportar o relatório novamente.
- A procura de texto sempre começa na segunda página. Além
disso, a procura de texto realça apenas a primeira instância da cadeia de
procura em cada página. Por exemplo, se duas instâncias da cadeia de
procura ocorrerem na página atual, a primeira instância será realçada
mas a nova procura irá para a próxima página.
- A colocação de dois visualizadores na mesma página pode
resultar em um comportamento não desejado. Por exemplo, executar uma ação em um visualizador
também pode alterar o outro visualizador. Para evitar esse comportamento, você não
deve colocar dois visualizadores na mesma página.
- Ao navegar em um relatório com avisos de parâmetros,
o destino da navegação não é realçado. Por exemplo, se você clicar em
um link, o destino do link na visualização da página resultante não será
realçado. Se o relatório não contiver avisos de parâmetros, o
destino da navegação será realçado.
- Quando a propriedade IsIgnoreViewStateOnLoad dos
visualizadores Java é definida para true, a propriedade ViewState não é ignorada. O
comportamento esperado é a propriedade ViewState ser ignorada com
IsIgnoreViewStateOnLoad definido para true.
- O estado dos itens da barra de ferramentas do visualizador
persiste em sessões do navegador. Por exemplo, se você executou um JSP com alguns itens da
barra de ferramentas ativados e, depois, desativar esses itens da barra de ferramentas, os
itens da barra de ferramentas desativados continuarão sendo exibidos na próxima vez em que o JSP for executado. Como
solução alternativa, reinicie seu servidor de aplicativos da Web depois de alterar as
configurações dos itens da barra de ferramentas.
- O seguinte erro é retornado ao definir o
atributo reportSource da versão JSF do visualizador de páginas de relatório DHTML
utilizando um valor de scriptlet: "org.apache.jasper.JasperException:
Apenas objetos de origem do relatório são aceitos". Como solução alternativa, utilize
um valor de propriedade do bean ao definir o atributo reportSource da versão JSF
do visualizador de páginas de relatório DHTML.
- Ao utilizar a versão JSF do visualizador DHTML, se
o método de salvamento de estados do JSF for servidor, o realce de um item
no visualizador é retido mesmo depois de navegar fora da página original
na qual o item foi realçado.
- O valor do campo Hora da Impressão não é atualizado quando
um relatório é atualizado utilizando os visualizadores. O campo Hora da Impressão
especifica a hora em que o relatório foi visualizado pela primeira vez na
sessão atual.
- No WebSphere Application Server 6.0, por padrão, a versão
JSF do visualizador de páginas de relatório DHTML utiliza a definição do código
do idioma do servidor de aplicativos na exibição de um relatório. Para utilizar o
código do idioma do navegador da máquina cliente, você deve definir o atributo
productLocale manualmente (por exemplo,
productLocale=#{facesContext.externalContext.requestLocale} ).
9.0 Integração do IDE
- O arquivo de propriedades do log aponta para $HOME/Crystal
como um local para criar arquivos de log. Como ele não existe, uma mensagem
de erro é exibida. Você deve criar esse diretório ou modificar
o arquivo para apontar para um diretório existente.
- O visualizador não funciona se você excluir
manualmente o CRConfig.xml da pasta de classes. A criação de novas instâncias
do visualizador utilizando o assistente não cria uma nova cópia do arquivo XML.
- Ao ativar o projetista do Crystal Reports para
visualizar um relatório no IDE, o projetista não consegue localizar o relatório
se o nome do relatório contiver caracteres não disponíveis no código
do sistema do sistema operacional. Por exemplo, em um sistema com inglês
como o código do idioma do sistema, ocorre falha no carregamento de um relatório
com caracteres japoneses em seu nome. Como solução alternativa, abra o relatório utilizando
o item de menu "Abrir Arquivo" no projetista em execução.
- Pressionar Ctrl-S enquanto trabalha no
projetista de relatórios Crystal incorporado no Rational Software Architect não
salva o relatório.
- A desinstalação do Crystal Reports desativará o
projetista de relatórios Crystal no Rational Software Architect.
- Após a criação de um novo relatório no Rational
Software Architect utilizando o projetista de relatórios Crystal incorporado, as
tabelas de banco de dados escolhidas como parte do processo de criação de relatório não
aparecem na seção Campos do Banco de Dados do Explorador de Campos. Como solução
alternativa, clique com o botão direito do mouse em Campos do Banco de Dados,
selecione Especialista em Banco de Dados e clique em OK. Agora os campos aparecerão na seção Campos do Banco de Dados.
- Erros são emitidos ao criar um novo relatório no
Rational Application Developer, se o editor padrão for o projetista
externo e o relatório que você está criando utilizar um
gabarito.
10.0 Componentes JSF do Crystal Enterprise
- Definir a propriedade ButtonType de um objeto
ButtonProps para "ImageButton" resulta na exibição de imagem e texto
do botão.
- O ItemEventArgs disparado pelo componente de Caminho
não contém o tipo, apenas o ID do objeto. Como solução alternativa,
obtenha o progID do próprio InfoObject, utilizando EnterpriseItem
ou uma consulta infostore. Por exemplo:
1. A partir do evento, obtenha o componente e converta-o em UIBaseControl ou
UIPath, se o listener manipular apenas componentes UIPath.
2. Para ItemClickedEvent, obtenha o ItemID do evento, chamando:
curEvent.getEventArgs().getItemID()
3. Crie um EnterpriseItem temporário, defina o atributo Identidade (utilizando
aquele de UIPath.getItemSource().getIdentity()) e defina o ItemID.
4. Obtenha o InfoObject, chamando: item.getInfoObject()
5. Consulte o progID.
Retornar para o Arquivo Leia-me Principal
Copyright (C) 2004 Business Objects. Todos os direitos reservados.