Seagate Crystal Reports™ 8 Guia do Administrador Web

Seagate Crystal Reports 8
Guia do Administrador Web
Seagate Software, Inc.
915 Disc Drive
Scotts Valley
California, USA 95066

Copyright ©2000 (documentação e software) Seagate Software, Inc., 915 Disc
Drive, Scotts Valley, California, USA 95066. Todos os direitos reservados.
Nenhuma parte desta documentação pode ser armazenada em um sistema de
recuperação, transmitida ou reproduzida de qualquer forma, exceto se de
acordo com os termos do contrato de licença de software aplicável. Esta
documentação contém informações proprietárias do Seagate Software, Inc.,
e/ou seus fornecedores.
Reconhecimento das marcas comerciais
Seagate, Seagate Software Holos, Crystal Info, Seagate Crystal Info, Seagate
Crystal Reports, Seagate Info, Seagate Analysis, Smart Navigation e os
logotipos Seagate são marcas comerciais ou marcas comerciais registradas da
Seagate Software, Inc. e/ou Seagate Technology, Inc.
Hyperion e Essbase são marcas comerciais da Hyperion Solutions
Corporation.
Todososoutrosnomesdeprodutoseempresasmencionadosnesta
documentação podem ser marcas comerciais ou marcas comerciais
registradas de seus respectivos proprietários.

S U M Á R I O
Capítulo 1: Bem-vindo
Bem-vindo ......................................................................................... 2
Sobre este manual ............................................................................. 2
Conteúdo dos capítulos .........................................................................................2
Ajuda on-line .........................................................................................................3
Convenções para comandos, botões e teclas .................................... 3
Comandos e botões ...............................................................................................3
Combinações de teclas ..........................................................................................3
Outras convenções ................................................................................................3
Capítulo 2: Visão Geral da Solução Web Reporting
Recursos de produtos para web ........................................................ 6
Remessa eficiente de páginas de relatórios .............................................................6
Possibilidade de pesquisar mais informações .........................................................6
Trabalha com a segurança do banco de dados .......................................................6
Suporte para procedimentos armazenados e campos parâmetro ............................7
Aproveita as extensões de servidores web da Microsoft e Netscape .......................7
Trabalha com diversos browsers ............................................................................7
Novos recursos na versão 8 ...................................................................................8
Solução Seagate Web Reporting ....................................................... 9
Visão geral da solicitação de relatórios ................................................................10
Etapas para solicitação de relatórios .....................................................................11
Browser/Report Viewers .......................................................................................12
Servidor web ........................................................................................................12
Web Component Server .......................................................................................12
Page Server ..........................................................................................................14
Guia do Administrador Web iii

Melhorando o desempenho ............................................................. 16
Gravar dados com os relatórios ...........................................................................16
Análise a partir dos dados ....................................................................................17
Árvore de Grupos (usando o comando GroupBy SQL) .........................................17
Capítulo 3: Web Component Server Implementação
Implementação do Web Component Server ................................... 20
Conector do Web Component .............................................................................20
Instalando o Web Component Server ..................................................................21
Configurando Serviços NT para reconhecer a impressora padrão ........................25
Garantindo uma instalação bem-sucedida ...........................................................27
Criando um site na Web ......................................................................................29
Especificando o Report Viewer ............................................................................31
Capítulo 4: Administração do Web Component Server
Administração do Web Component Server ..................................... 34
Acesso ao Crystal Report Web Components Manager ..........................................34
Guia Web Component Server ..............................................................................34
Guia Extensões de Arquivos .................................................................................35
Guia Visualização de Relatórios ..........................................................................36
Guia Servidor de Páginas .....................................................................................38
Guia Configurações do Cache .............................................................................40
Capítulo 5: Comandos do Web Component Server
Comandos do Web Component Server ........................................... 42
Criação de solicitações de relatórios ....................................................................42
Modificação das fórmulas de seleção em relatórios da Web ...............................44
Fontes de dados SQL e ODBC ............................................................................45
Procedimentos armazenados em SQL e campos de parâmetros ..........................48
Exportação de relatórios ......................................................................................50
Atualização de dados de relatórios da Web ........................................................51
iv Guia do Administrador Web

Capítulo 6: Report Viewers
Visão Geral do Report Viewer ........................................................ 54
recursos do Report Viewer ...................................................................................54
Padrões do Report Viewer ....................................................................................56
Imprimindo em Report Viewers ..........................................................................56
Usando Report Viewers em aplicativos ................................................................57
Report Viewer para ActiveX ........................................................... 58
Certificação AuthentiCode ...................................................................................58
Adicionando o Report Viewer a uma página da web ...........................................58
Fazendo o download do Report Viewer a partir do servidor .................................59
Incorporando o Report Viewer para Active X a uma página da web .....................62
Report Viewer para Java usando o Browser JVM ............................ 63
Adicionando o Visualizador a uma página da web ..............................................63
Report Viewer para Java usando o Plug-in Java ............................. 67
Report Viewer para Plug-in Netscape ............................................ 67
Report Viewers para HTML ............................................................. 67
Limitações do relatório HTML ..............................................................................67
Apêndice A: Suporte do produto
Registro do Produto ........................................................................ 72
Suporte do produto ......................................................................... 72
Suporte via Web ............................................................................. 73
Web site da Seagate Software ..............................................................................73
Suporte para produtos da Seagate Software ..........................................................73
Suporte via E-mail ........................................................................... 74
Suporte via Fax ............................................................................... 74
Suporte técnico ............................................................................... 75
Suporte Técnico Prioritário ..................................................................................75
Guia do Administrador Web v

Suporte Técnico padrão .......................................................................................76
Seagate Knowledge Link .................................................................. 77
Política de devolução do produto ................................................... 78
Política de substituição do produto ................................................. 78
vi Guia do Administrador Web

Bem-vindo 1
Bem-vindo! Este capítulo apresenta a solução de
criação derelatórios na web, da Seagate Software, e
descreve as informações contidas neste manual.
Guia do Administrador Web 1

Bem-vindo
Bem-vindo
Sobre este manual
A Seagate Software oferece uma solução abrangentedecriação derelatórios
da web com as edições Profissional e Desenvolvedor do Seagate Crystal
Reports. Esses produtos trabalham em conjunto com a Intranet/Extranet
existentes para fornecer ao Seagate Crystal Reports acesso à web.
Este manual inclui procedimentos para instalar, configurar e administrar o
Web Component Server e produtos associados.
Conteúdo dos capítulos
A seguir, uma descrição sucinta de cada capítulo deste manual.
Capítulo 1: Bem-vindo
Este capítulo apresenta uma visão geral do manual do usuário e da Ajuda online,
além de listar as convenções de comandos, botões e teclas empregadas no
manual do usuário.
Capítulo 2: Visão Geral da Solução Web Reporting
Este capítulo discute como os produtos para Web da Seagate trabalham em
conjunto com o servidor web existente. Também estão incluídas informações
sobre novos recursos e aperfeiçoamentos.
Capítulo 3: Web Component Server Implementação
Este capítulo contém informações sobre procedimentos necessários para
instalar e configurar o Web Component Server.
Capítulo 4: Administração do Web Component Server
Este capítulo fornece detalhes sobre a utilização do aplicativo Crystal Web
Components Manager incluído com o Web Component Server. Com esse
aplicativo, é possível personalizar as definições do Web Component Server.
Capítulo 5: Comandos do Web Component Server
Este capítulo fornece exemplos de comandos do Web Component Server, que
podem ser anexados a solicitações de URL. Essas solicitações de URL podem
ser utilizadas para orientar o usuário a inserir informações de segurança ou
valoresdecamposparâmetro.
Capítulo 6: Report Viewers
Este capítulo contém informações sobre configuração de Visualizadores de
Relatório para atender às necessidades dos usuários.
Apêndice A: Suporte do produto
Este apêndice lista os métodos e as informações de contato para obter suporte
para produtos.
2 Guia do Administrador Web

Ajuda on-line
1 : Bem-vindo
Além deste manual impresso, as edições Profissional e Desenvolvedor do
Seagate Crystal Reports incluem Ajuda on-line.
A Ajuda on-line contém todas as informações contidas no manual assim como
outros materiais de referência. Por exemplo, você pode encontrar na Ajuda
on-line informações sobre como configurar um servidor do Lotus Domino
para trabalhar com o Web Component Server.
Acesse a Ajuda on-line relacionada à solução Web Reporting da Seagate
carregando o aplicativo Crystal Report Web Components Manager.
Use a guia Conteúdo para visualizar todas as seções importantes da Ajuda online
e examinar os títulos específicos de cada seção. Use a guia Índice para
visualizar tópicos em ordem alfabéticaeaguiaBuscaparainseriruma
palavra-chave ou visualizar todas as seções relacionadas à palavra-chave.
Convenções para comandos, botões e teclas
Comandos e botões
Combinações de teclas
Outras convenções
Este manual emprega as seguintes convenções:
Para facilitar o reconhecimento, os nomes de comandos e de botões sãoexibidos
em negrito. Por exemplo: Comando Próximo,botão Imprimir e assim por diante.
Os atalhos de teclado são exibidosnasseguintesformas:
Delete significa a tecla Del (tecla Delete ou a tecla Del do teclado numérico).
Enter significa a tecla Enter, Return, CR ou ↵, dependendo de qual dessas
teclas consta em seu teclado.
Ctrl-tecla, Shift-tecla e Alt-tecla são exemplosdecombinações de duas
teclas. Pressione a primeira tecla da combinação (Control, Shift ou Alt) e,
simultaneamente, pressione a segunda tecla da combinação(designada
acima como tecla). Por exemplo: Ctrl-C significa manter pressionada a
tecla Control e, em seguida, pressionar a tecla C no teclado (Ctrl-C é o
comandoCopiardoWindows).
A fonte Courier indica os dados que devem ser inseridos atravésdoteclado.
Guia do Administrador Web 3

Convenções para comandos, botões e teclas
4 Guia do Administrador Web

Visão Geral da Solução Web Reporting 2
Além dasdescrições de recursos, este capítulo inclui
informações sobre como os produtos para web da
Seagate trabalham em conjunto com o servidor web
para fornecer acesso ao Seagate Crystal Reports através
da web.
Guia do Administrador Web 5

Recursos de produtos para web
Recursos de produtos para web
Remessa eficiente de páginas de relatórios
Para enviar relatórios com eficiência, o Web Component Server usa o recurso
Página Exigida, que permite o envio de páginas do relatório, quando
solicitadas. É possível que, às vezes, o usuário só precisedeumaouduas
páginas de informações de um relatório de 100 páginas. Em vez de ocupar a
rede, transferindo com freqüência grandes volumes de dados, o Web
Component Server envia uma página do relatório de cada vez, conforme
solicitação docliente.
Quando uma página do relatório é solicitada na primeira vez em que o
relatório é gerado, a página solicitada é enviada ao cliente e armazenada em
um cache. Na próxima vez em que o cliente solicitar a mesma página, ela será
recuperada no cache em vez de ser gerada novamente.
Ao manipular solicitações por página, o Web Component Server pode lidar
rapidamente com um alto número de solicitações, limitando a demora na
remessa a uma solicitação individual. O armazenamento de páginas do
relatório em cache também permite o compartilhamento mais eficiente de
informações do relatório entre clientes, porque diversas solicitações ao mesmo
relatório não exigemqueorelatórioseja gerado várias vezes.
Possibilidade de pesquisar mais informações
Para localizar informações facilmente, permite que os usuários acessem a
árvoredenavegação. Semelhante ao Windows Explorer, a árvore de
navegação é exibida dentro do browser juntamente com o Report Viewer
adequado. Isso permite que os usuários expandam os grupos, visualizem os
registros associados a cada grupo e sejam direcionados rapidamente às
informações de interesse, em vez de percorrerem cada página do relatório.
Trabalha com a segurança do banco de dados
O Seagate Crystal Reports continua oferecendo suporte para os
procedimentos de segurança definidos através daweb,pormeiodoWeb
Component Server. O Web Component Server reconhece automaticamente a
segurança definida e solicita aos usuários as IDs e as senhas para os relatórios
que utilizam fontes de dados ODBC e SQL.
Como alternativa, use os comandos do Web Component Server para
manipular automaticamente a segurança através de hyperlinks ou outros
links da web para relatórios.
6 Guia do Administrador Web

2 : Visão Geral da Solução Web Reporting
Suporte para procedimentos armazenados e campos parâmetro
Geralmente, os procedimentos armazenados melhoram o desempenho e a
seleção de dados em grandes bancos de dados SQL. Além disso, os campos de
parâmetros do Seagate Crystal Reports podem fornecer seleção dedados
durante o trabalho nos relatórios. Esses dois recursos excelentes são
suportados pelo Web Component Server.
Se seus relatórios se basearem em procedimentos armazenados ou se
incluírem campos de parâmetros Seagate Crystal Reports, o Web Component
Server solicitará automaticamente aos usuários os valores dos parâmetros,
quando o relatório for gerado. Os parâmetros de URL em hyperlinks ou
formulários HTML também podem especificar valores para campos
parâmetro ou procedimentos armazenados.
Aproveita as extensões de servidores web da Microsoft e Netscape
Se você estiver usando um servidor web da Microsoft ou Netscape para
distribuir relatórios, o Web Component Server poderá utilizar diretamente a
funcionalidade do servidor web por meio das interfaces de programação
ISAPI ou NSAPI. O Web Component Server tem suporte para as duas APIs em
um único arquivo: wcsinsapi.dll. As APIs aumentam o desempenho do
aplicativo web através dasextensões diretas para o próprio servidor web.
Para obter mais informações sobre a ISAPI, consulte a documentação da
Microsoft. Para obter mais informações sobre a NSAPI, consulte a
documentação da Netscape.
Trabalha com diversos browsers
O Web Component Server manipula a geração e a distribuição derelatórios
no lado do servidor. Entretanto, o usuário visualiza um relatório através de
um dos Report Viewers. Esses visualizadores baseados em browsers fornecem
acesso completo às informações do relatório sem precisar instalar aplicativos
adicionais na máquina cliente além deumbrowser.
Existem seis Report Viewers incluídos no Seagate Crystal Reports, a saber:
Report Viewer para ActiveX
Report Viewer para Java usando o Browser JVM
Report Viewer para Java usando o Plug-in Java
Report Viewer para o Plug-in Netscape
Report Viewer para HTML Padrão comMolduras
Report Viewer para HTML Padrão.
Guia do Administrador Web 7

Recursos de produtos para web
Cada visualizador tem vantagens e você pode escolher o visualizador mais
adequado para seu web site. Se você não especificar um visualizador, o Web
Component Server define automaticamente um visualizador com base no
browser utilizado para solicitar o relatório.
Report Viewer para ActiveX
O Report Viewer para ActiveX é um controle ActiveX padrão quetambém
exibe relatórios com o formato Encapsulated Page File (EPF).
Report Viewers para Java
Os visualizadores baseados em Java residem em uma página HTML como um
applet Java padrão. Os relatórios sãoexibidosdentrodovisualizadordoJava
usando o formato EPF avançado. EPF é um formato de relatório que preserva
quase todas as opções e as definições da formataçãooriginalaogerararquivos
menores que arquivos HTML. O resultado é um acesso mais rápido aos relatórios.
Report Viewer para Plug-in Netscape
O Report Viewer para o Plug-in Netscape exibe relatórios usando o formato EPF.
Report Viewers para HTML
Novos recursos na versão 8
Browser Report Viewer Padrão
Internet Explorer 4.0 Report Viewer para ActiveX
Netscape Navigator 3.0 Report Viewer para Java
Netscape Navigator 4.0 Report Viewer para Java
Os Report Viewers para HTML são baseadosnopadrãoHTML4.0,enviando
relatórios no formato HTML plano ou HTML com molduras. Esses
visualizadores podem ser utilizados em qualquer browser com suporte para
opadrão HTML4.0.
AVersão 8 do Seagate Crystal Reports inclui vários recursos novos para
aperfeiçoar as opções, a acessibilidade e o desempenho do Web Component
Server.
8 Guia do Administrador Web

Introdução aos espaços reservados
2 : Visão Geral da Solução Web Reporting
Ao utilizar espaços reservados, você pode fazer download parcial dos EPFs e
visualizarorestantedoconteúdo,quandoestiverpronto.Porexemplo,seo
relatório contiver um diagrama, aparecerão a estrutura do diagrama e os
dados abaixo. A partir de então, à medida que os detalhes do diagrama fossem
disponibilizados, o relatório seria atualizado.
Aperfeiçoamentos no Report Engine
O Report Engine foi otimizado para diminuir o tempo de espera. Em alguns
casos, isso resulta na abertura e na exibição deumrelatório com uma
velocidade dez vezes maior que anteriormente.
Uso de Manipulação de Trabalhos em Pool de Segmentos
O Web Component Server utiliza a manipulação de trabalhos em pool de
segmentos. Sempre que uma solicitação é efetuada por um cliente, o Web
Component Server passa o trabalho para um segmento colaborador que
manipula a solicitação. Ao alocar um novo segmento para cada tarefa, o
servidor pode aproveitar a funcionalidade inerente do ambiente multitarefa
no sistema operacional, remetendo relatórios com o máximo de eficiência.
Solução Seagate Web Reporting
Existem três produtosincluídos na edição Profissional e Desenvolvedor do
Seagate Crystal Reports, que permitem acessar o Seagate Crystal Reports
através daWeb.
Report Viewers
Web Component Server
Page Server.
Essa soluçãodecriação derelatório foi elaborada para web sites usando
servidores web da Microsoft, Netscape e a maioria dos servidores web
compatíveis com o padrão CGI executando em um ambiente do Microsoft
Windows NT.
Guia do Administrador Web 9

Solução Seagate Web Reporting
Visão geral da solicitação de relatórios
O diagrama a seguir ilustra o modo como os diversos componentes trabalham
em conjunto com o servidor web existente no sistema:
1
2
HTML
Browser
IE
Active X
Java
NN
Java
Plug-in
Queues Request
3 4
EPF Page
Generation
Servidor Web
CGI ISAPI NSAPI 5
Web Component Server
CRImage Retrieval HTML Formatting
Page Server
3.1 3.2
EPF Page
Caching
10 Guia do Administrador Web
6

Etapas para solicitação de relatórios
Etapa 1
2 : Visão Geral da Solução Web Reporting
Usando um browser, o usuário se conecta a um servidor web e faz uma
solicitação. O browser usa um Report Viewer para se comunicar com o
servidor.
Etapa 2
Se você estiver usando um servidor web da Microsoft ou Netscape, a
solicitaçãoserá processada atravésdaISAPouNSAPI.EmumLotusDomino
Server ou outro servidor compatível com o padrão CGI, a solicitação é
processada usando CGI. Em seguida, a solicitação é enviada ao Web
Component Server.
Etapa 3
Depois que o Web Component Server enfileirar e determinar o tipo de
solicitação, ela será enviada ao Page Server.
A única exceção é o processamento de uma solicitaçãoHTML.Asimagensem
um relatório HTML não seguem as duas etapas seguintes; saltam
automaticamente para a etapa 4.
Etapa 3.1 e 3.2
O Page Server se encarrega da geração e do armazenamento em cache do EPF.
Quando terminar, os detalhes do EPF são enviadosaoWebComponent
Server.
Etapa 4
No caso de uma solicitação HTML, o Web Component Server converte a
página do relatório em HTML. O Web Component Server envia a página em
HTML e armazena os arquivos .CRI até serem solicitados.
Etapa 5
O servidor web envia o relatórioaoReportVieweradequado,queexibeo
relatórionobrowserdousuário.
Guia do Administrador Web 11

Solução Seagate Web Reporting
Browser/Report Viewers
Servidor web
Web Component Server
Os browsers da web mais conhecidos são o Microsoft Internet Explorer e o
Netscape Navigator. O browser usa um Report Viewer (ActiveX, Java ou
HTML) para se comunicar com o seu servidor web.
Para obter mais informações sobre os Report Viewers, consulte “Visão Geral
do Report Viewer” na página 54.
Os componentes para web do Seagate Crystal Reports suportam servidores
webdaMicrosoft,daNetscapeeamaioriadosservidoreswebcompatíveis
com o padrão CGI executando em um ambiente do Microsoft Windows NT.
Quando você instala o Web Component Server, são definidas no sistema duas
novas extensões de arquivo: .rpt e .cri. Ao receber uma solicitação para
qualquer um desses tipos de arquivo, o servidor web a direciona para um dos
conectores do Web Component Server (wcsinsapi.dll ou wcscgi.exe).
O wcsinsapi.dll opera com a ISAPI/NSAPI. Essas extensões são utilizadas
com os servidores web da Microsoft e da Netscape.
Se você não estiver usando servidores web da Microsoft ou da Netscape, o
Web Component Server utilizará oarquivowcscgi.exe.
ISAPI/NSAPI
Ao utilizar as extensões de APIs exibidas pelos servidores web da Microsoft e
Netscape, o wcsinsapi.dll gera um sistema mais rápido e mais potente para a
remessa de relatórios ao servidor web.
As extensões da ISAPI operam com o Microsoft Internet Information Server
(IIS) versão 2.0 e superior, assim como com o Personal Web Server for
Windows NT Workstations.
Ainterfacedeprogramação NSAPIestádisponível em todos os servidores
web da Netscape.
CGI
Se você estiverusandoopadrão CGI, o Web Component Server utilizará o
arquivo wcscgi.exe.
12 Guia do Administrador Web

Formato de Relatório em HTML
2 : Visão Geral da Solução Web Reporting
Quando um relatório é gerado em HTML, as imagens gráficas, os mapas, os
diagramas e os objetos OLE são reproduzidos como arquivos do Crystal
Image (.CRI) e armazenados no Web Component Server. Quando o Web
Component Server encontra uma Crystal Image dentro do relatório HTML,
ele converte a imagem em um formato que pode ser exibido por browsers
(como o formato JPEG), e envia a imagem novamente para o servidor web,
para a distribuição.
Nota: Se você estiver usando o Report Viewer do Active X, Plug-in Java ou
Netscape, será usado o formato Encapsulated Page File (EPF) em vez do
formato de arquivo Crystal Image.
Web Component Server vs. Active Server Pages
Como uma alternativa para o Web Component Server, use o Active Server
Pages. O método a ser aplicado depende se você éum administrador da web
ou desenvolvedor da web.
Se vocêéresponsável pelo desenvolvimento de webs (criando scripts e
aplicativos para personalizar a funcionalidade de um site), experimente usar o
Servidor de Automatização RDC e o Active Server Pages. O Servidor de
AutomatizaçãoRDCfornececontroletotalsobreomododeapresentaçãoe
remessa dos relatórios a um cliente. Estãodisponíveis, em tempo de execução,
recursos excelentes, como mudar a fonte de dados ou manipular as fórmulas
existentes do relatório. Contudo, o Servidor de AutomatizaçãoRDCexigeuma
programação extensiva dentro do ambiente do Active Server Page. É necessário
conhecer uma linguagem de criaçãodescripts,comoaVBScriptouJScript.
Nota: Se você nãousarumservidorwebdaMicrosoftououtrocompatível com
opadrãoISAPI, o Servidor de AutomatizaçãoRDCeoActiveServerPagesnão
estarãodisponíveis como métodos de distribuiçãoderelatórios em um web site.
Ao contrário, o Web Component Server demora menos tempo para configurar
enãorequer qualquer programaçãooucriação de scripts. Basta armazenar os
relatórios em um diretório acessível ao servidor web, e criar links ao estilo
HTML padrão paraosrelatórios em suas páginas da web. É possível efetuar
algumas mudanças em tempo de execução nosrelatórios, como seleção de
registros e a possibilidade de mudar parâmetros armazenados. Contudo,
essas opções estão limitadas, tanto no escopo quanto na funcionalidade.
Para obter mais informações sobre o uso do Active Server Pages, consulte o
Servidor de Automatização RDCnoManualdeReferência Técnica.
Guia do Administrador Web 13

Solução Seagate Web Reporting
Page Server
OPageServeré executadonosistemaWindowsNTcomoumserviçodoNT.
Esse componente é responsável principalmente por receber solicitações de
arquivos de relatórios .rpt do Web Component Server e retornar as páginas
para esse Web Component Server.
Formato do Page Server
Ao gerar um relatório, o Page Server converte esse relatório em páginas com
o formato Encapsulated Page File (EPF). EPF é um formato da Seagate
Software baseado no formato Encapsulated Postscript (EPS). Esse formato de
página é utilizado pelos Report Viewers para ActiveX e Java.
Conseqüentemente, os relatórios EPF podem manipular descrições complexas
de layout e projeto. Quando visualizados no browser, os relatórios EPF
preservam a maioria, senão todos os componentes de projeto e layout do
relatório originalmente criado no Seagate Crystal Reports. Por ser um formato
proprietário, os relatórios EPF só podem ser exibidos nos Report Viewers para
ActiveX ou Java.
Nota: Os arquivos EPF mantêm asinformações de formatação definidas
pelos drivers de impressora. Isso inclui definições como tamanho e
orientação padrão depágina.
Compartilhamento de trabalhos e armazenamento de páginas
em cache
Esta seção forneceumadescrição geraldecomooPageServerarmazenaem
cache e compartilha trabalhos.
Quando um cliente solicita um relatório ainda não solicitado anteriormente,
ocorre o seguinte:
É criado um novo trabalho. Quando isso acontece, é criado um cache. O
cache armazena as páginas do relatório conforme solicitadas. Também é
criada uma referência ao trabalho do relatório. Essa referência tem uma ID
exclusiva (ID de solicitação), utilizada para acessar o trabalho quando
solicitado novamente, mais adiante.
14 Guia do Administrador Web

2 : Visão Geral da Solução Web Reporting
Um intervalo de atualização é associadoaotrabalhodorelatório. Trata-se
do intervalo de tempo (definição Atualizar Banco de Dados no aplicativo
Web Components Manager) após oqualumanovasolicitação parao
mesmo relatório resultará em acessar o banco de dados para obter
informações atualizadas. Em outras palavras, se um novo cliente solicitar
orelatório após o intervalo de atualizaçãodotrabalhodorelatório
existente, será criado um novo trabalho do relatório.
Se um cliente referenciando um trabalho de relatório existente selecionar a
atualização, será criado um novo trabalho de relatório e o cliente receberá
uma referência ao novo relatório.
Compartilhamento de trabalhos
O compartilhamento de trabalho ocorre quando mais de uma pessoa acessa a
mesma instância de um relatório. Um trabalho de relatório pode ser
compartilhado se:
orelatóriocontiverdados gravados e não existiremcomandosdefórmula
de seleção (SF#)oudefórmula de seleção degrupos(GF#)
orelatório não tiver dados gravados e nãoexistiremcomandosdefórmula
de seleção (SF#)oudefórmula de seleção degrupos(GF#)
os comandos de fórmula de seleção (SF#)oudefórmula de seleção de
grupos (GF#) forem idênticos à fórmula de um trabalho existente.
O compartilhamento de um relatório é interrompido nas seguintes situações:
um cliente compartilhando um trabalho de relatório existente clica em
Atualizar. Nesse caso, é criado um novo trabalho de relatórioeocliente
recebe uma referência ao novo trabalho de relatório.
um cliente compartilhando um trabalho de relatório existente submete
uma solicitação depáginaque inclui um dos comandos listados
anteriormente. Nesse caso, é criado um novo trabalho de relatório e o
cliente recebe uma referência ao novo trabalho de relatório.
Armazenamento de páginas em cache
Um cache, associado a cada trabalho de relatório, armazena páginas solicitadas.
As páginas são geradas, passadas para o cliente e armazenadas no cache. Se
outro cliente, que está compartilhando o mesmo trabalho de relatório, solicitar
uma página armazenada no cache, esse cliente receberá apágina em cache. Este
recurso pode reduzir consideravelmente o tempo de acesso.
Guia do Administrador Web 15

Melhorando o desempenho
Melhorando o desempenho
É possível melhorar o desempenho do Web Component Server e aumentar o
número de pessoas autorizadas a acessar relatórios através da Web, ao aplicar
algumas das seguintes sugestões.
Gravar dados com os relatórios
Relatórios com dados gravados
Um relatório, que é salvo com dados e não temfórmulas de seleção oude
seleçãodegruposaeleaplicadas,terá suas páginas compartilhadas por todos
os usuários. Se o relatório tiver fórmulas de seleção oudeseleção degrupos
aplicadas, o armazenamento em cache ficará acritériodousuário, como no
Seagate Crystal Reports 7.
Relatórios sem dados gravados
Um relatório sem dados gravados, que não temfórmula de seleção (SF#),
fórmula de seleção de grupos (GF#), prompt de senha (PASSWORD#),
prompt de id do usuário (USER#), prompt de parâmetro (PROMPT#) ou
prompt de valores em comandos de atualização (promptOnRefresh#), terá
suas páginas compartilhadas por todos os usuários.
Como os relatórios não sãogravados com dados, o administrador deve
especificar o intervalo de atualização dobancodedadosnoaplicativoWeb
Component Manager. Este intervalo indica a freqüência com que o banco de
dados será acessado. Exemplo:
1 O tempo de atualização do banco de dados é definido como 5 minutos.
2 OUsuário A seleciona o relatório A1 (sem dados gravados). Como o
Usuário A é aprimeirapessoaaselecionaresserelatório, o banco de
dados é acessado.
3 Dois minutos depois que o Usuário A solicitou o relatórioA1,oUsuário B
seleciona o relatório A1. Os Usuários A e B compartilharão aspáginas do
relatório porque o relatório foi solicitado antes de terminar o tempo de
atualização do banco de dados. Como resultado, o banco de dados não é
acessado.
4 Seis minutos depois que o Usuário A solicitou o relatórioA1,oUsuário C
seleciona o relatório A1. Como o intervalo de atualizaçãodobancode
dados expirou (a definição é de 5 minutos e já se passaram 6 minutos
desde que o banco de dados foi acessado para obter este relatório), o
banco de dados será acessado e o Usuário C não compartilhará as páginas
com os Usuários A ou B.
16 Guia do Administrador Web

Análise a partir dos dados
2 : Visão Geral da Solução Web Reporting
Um recurso exclusivo do Web Component Server é aanálise a partir dos dados
do relatório, para visualizar os detalhes ocultos nos subtotais e nos valores de
resumo. Os usuários podem clicar ou clicar duas vezes nos valores de resumo,
para que a análise dos dados exiba os valores de detalhes em uma página
separada. É possível expandir um relatório sumário formado apenas por algumas
linhas, de modo a mostrar todos os dados utilizados para originar os sumários.
Como administrador da web, você pode minimizar a sobrecarga no servidor de
banco de dados, elaborando relatórios sumários sucintos que permitam a análise
de dados seletiva por relatórios de GroupBy. O cálculo dos dados adicionais está
limitado às solicitações específicas do usuário. Por exemplo, se um relatório
contiver 10 grupos e cada grupo, 10 valores de detalhe, um relatório elaborado
para exibir todos os valores exigirá imediatamente a obtençãoouacriação de 110
fragmentos de dados (10 x 10 valores de detalhes mais os 10 valores de resumo).
Contudo, se o relatório for elaborado como um relatório de análise e somente os
valores de resumo forem exibidos quando o relatório for criado pela primeira vez,
será necessário enviar apenas 10 valores. Se o cliente preferir analisar por dois
grupos, serão recuperados do banco de dados 20 valores a mais, perfazendo um
total de 30 valores. Essa diferença, 30 versus 110, comprova como os recursos da
rede e do banco de dados podem ser consideravelmente reduzidos, ao elaborar
um relatório de análise para distribuição.
Árvore de Grupos (usando o comando GroupBy SQL)
Se seus relatórios contiverem processamento de instruções GroupBy SQL, no
lado servidor, a Árvore de Grupos da Navegação Inteligente será afetada
quando os relatórios forem exibidos. Nesses casos, somente as informações de
resumo serão retornadas ao cliente. Os registros de detalhes são avaliados
peloservidordeSQLeosvaloresdeagrupamentoederesumosãocalculados
e, em seguida, enviados ao cliente sem os registros de detalhes.
Embora esse método reduza consideravelmente o volume de dados enviados
através da rede, tambémafetaaÁrvore de Grupos. Os nomes dos grupos são
listados na Árvore de Grupos, como sempre. Contudo, se você expandir um
grupo na ÁrvoredeGrupos,asinformações de detalhes não estarão
disponíveis. O servidor envia ao cliente somente os sumários de grupo. Será
exibida uma lupa abaixo do nome do grupo, na ÁrvoredeGrupos,indicando
que os dados de detalhes podem ser recuperados.
Se a lupa for clicada, o Web Component Server recuperará os dados de detalhes
do grupo em questãoeexibirá grupos de detalhes ou os nomes dos registros
abaixo do nome de grupo original. Esse processo exige uma consulta ao banco
de dados. Convémnão utilizar esse recurso, se você previr que as pessoas que
visualizarem o relatório precisarão visualizar sempre os detalhes do sumário.
Guia do Administrador Web 17

Melhorando o desempenho
18 Guia do Administrador Web

Web Component Server
Implementação 3
Este capítulo fornece informações para ajudar você a
instalar e configurar o Web Component Server.
Guia do Administrador Web 19

Implementação do Web Component Server
Implementação do Web Component Server
Para implementar um Web Component Server, complete os cinco processos a
seguir:
Instalar o Web Component Server.
Configurar Serviços NT para reconhecerem a impressora padrão.
Certificar-se de que a instalação teveêxito.
Criar um site da Web de exemplo.
Conector do Web Component
Especificar o Report Viewer.
Nota: Os processos Configurar Serviços NT e Especificar o Report Viewer
são opcionais.
Há dois tipos de conectores do Web Component:
conector WCS CGI (usa padrão CGI)
WCS através de ISAPI\NSAPI (usa as interfaces de programação do
Microsoft e Netscape).
O conector do Web Component usado em seu ambiente dependerá do tipo de
servidor da Web que estiver usando.
Nota: Outra opção é adeinstalaroServidordeAutomação RDC dentro das
Páginas Ativas do Servidor para distribuir relatórios. Essa técnica é bastante
diferente do Web Component Server.
Para obter mais informações sobre o uso das Páginas Ativas do Servidor,
consulte o Servidor de AutomaçãoRDCnoManualdeReferência Técnica do
Seagate Crystal Reports.
O conector WCS CGI
OaplicativodoconectorWCSCGI(wcscgi.exe)foicriadoparasuportaropadrão
CGI. Como a maioria dos servidores da Web suportam CGI, o Web Component
Server pode ser instalado em qualquer servidor da Web compatível.
O servidor da Web Lotus Domino usa a extensão WCSCGI.
20 Guia do Administrador Web

WCS via ISAPI\NSAPI
3 : Web Component Server Implementação
O conector ISAPI/NSAPI para o Web Component Server (wcsinsapi.dll)
implementa as duas interfaces de programação ISAPI e NSAPI. Essas
interfaces fornecem conexões diretas muito potentes com os servidores da
Web Microsoft (ISAPI) e Netscape (NSAPI).
Requisitos do sistema
O Web Component Server suporta os seguintes sistemas operacionais:
Windows NT Server 4.0 ou superior com:
Microsoft Internet Information Server (IIS) 2.0 ou superior
Netscape Enterprise Server 2.0 ou superior.
Windows NT Workstation 4.0 ou superior com:
Microsoft Personal Web Server
Netscape FastTrack 2.0 ou superior.
Windows 2000 com Microsoft Personal Web Server
O Web Component Server suporta os seguintes aplicativos do servidor na
Web:
Microsoft Internet Information Server (IIS) 2.0 ou superior
Microsoft Personal Web Server
Netscape Enterprise Server
Netscape FastTrack 2.0 ou superior.
Aversão CGIdoWebComponentServerécompatível com todos os
servidores da Web compatíveis com CGI.
Instalando o Web Component Server
Esse procedimento assume que você já tenha instalado um servidor da Web e
tenha confirmado que ele está sendo executado corretamente. Você precisa
estar conectado como um administrador na máquina local.
Nota: Antes de iniciar a instalação, certifique-se de que o seu servidor da
Web não esteja sendo executado.
Guia do Administrador Web 21

Implementação do Web Component Server
Para fazer a instalação a partir do CD-ROM
Comece inserindo o CD do Seagate Crystal Reports na unidade de CD-ROM.
1 AjaneladeConfiguração do Seagate Crystal Reports é exibida com uma
informação deBem-Vindo.
Nota: Seatelainicialnãoaparecer, execute o Setup.exe no diretório raiz
do CD.
2 Leia as informações de Bem-Vindo e clique em Próximo. OContratode
Licença é exibido.
3 Leia todo o contrato de licença paraentenderasexigências de
licenciamento do Seagate Crystal Reports. Selecione Eu aceito o Contrato
de Licença se você estiver de acordo com os termos da licença e,depois,
clique em Próximo.Senão estiver de acordo, você nãopoderá instalar o
Seagate Crystal Reports.
22 Guia do Administrador Web

3 : Web Component Server Implementação
4 Na janela Informações do Usuário, digite seu nome completo, empresa e
Código da Chave do CD para instalar o software e, depois, clique em
Próximo.
5 Selecione Completar para instalar todos os componentes, inclusive o Web
Component Server (recomendado) ou Personalizar, paraespecificar
componentes individuais e, depois, clique em Próximo.
Se você escolher Completar, vá para a etapa 8.
Se você escolher Personalizar, continue com a etapa 6.
Nota: Você pode desejar instalar o produto Seagate Crystal Reports
inteiro no seu sistema de servidor da Web. Com o produto inteiro
instalado, problemas com relatórios da Web poderão ser analisados de
forma rápida e fácil. Bastará abri-los diretamente dentro do Report
Designer no sistema do servidor da Web.
6 EscolhacadaumdosrecursosaseguireSerá instalado na unidade de
disco rígido local:
Acesso aos Dados
Componentes do Desenvolvedor
Suporte à Exportação
Mapeamento Geográfico
Relatórios de Exemplo
Exemplos do Desenvolvedor/Web
Web Component Server.
7 Clique em Próximo.
8 Selecione um Grupo de Programas para os ícones do programa Seagate
Crystal Reports e, depois, clique em Próximo.
Aconfiguração começainstalando os arquivos necessários para o Web
Component Server.
Depois de os arquivos terem sido instalados, a caixa de diálogo
Configuração do Web Component Server é exibida.
9 Se você fizer mudanças nas definições de configuração padrão, clique em
Aplicar e, depois, clique em OK.
10 Aconfiguração concluiainstalação.
Guia do Administrador Web 23

Implementação do Web Component Server
Depois que a instalação tiver sido concluída, uma caixa de diálogo é
exibida indicando que sua máquina precisa ser reinicializada antes de as
novas configurações serem executadas.
11 Clique em OK e, depois, reinicialize a máquina.
Arquivos instalados
A seguir, uma lista dos arquivos primários instalados para o Web Component
Server:
wcsinsapi.dll
wcscgi.exe
pagerserver.exe
wcs_xn_crimage.dll
webcompserver.exe
wcs_xn_reportviewer.dll.
Cada um desses arquivos é instalado por padrão noseguintediretório:
C:\Program Files\Seagate Software\WCS
Nota: Consulte a Ajuda do Desenvolvedor on-line do Seagate Crystal
Reports para obter uma lista completa de arquivos instalados com o Web
Component Server.
24 Guia do Administrador Web

3 : Web Component Server Implementação
Configurando Serviços NT para reconhecer a impressora padrão
As etapas abaixo fornecem informações sobre como configurar Serviços NT
para usar uma conta de usuário que possua um driver de impressora instalado.
Esse procedimento é composto de dois processos:
criando um usuário
mudando os serviços.
Nota: Este é um procedimento opcional.
Criando um usuário
1 Enquanto estiver conectado como um Administrador do Windows NT,
abra o Gerenciador de Usuário para o aplicativo Domains.
Se você não estiver familiarizado com esse aplicativo, consulte a
documentação doMicrosoftWindowsNT.
2 No menu Usuário, clique em Novo Usuário.
A caixa de diálogo Novo Usuário é exibida.
3 Digite um novo nome de usuário para ser usado pelo Web Component
Server. Por exemplo: CRWEBUSER.
4 Forneça uma senha da qual vá se lembrar.
5 Limpeacaixadeseleção Usuário Precisa Mudar Senha Quando se
Conectar Novamente.
6 Selecione a caixa de seleção Usuário Não Pode Mudar Senha.
7 Selecione a caixa de seleção Senha Nunca Expira .
8 Clique no botão Grupos e torne esse usuárioummembrodogrupo
Administradores.
Guia do Administrador Web 25

Implementação do Web Component Server
9 Clique em OK, parafecharacaixadediálogo Novo Usuário.
10 Feche o aplicativo Gerenciador de Usuário.
Mudando os serviços
1 AbraajanelaServiços.
Se não tiver certeza de como fazer isso, consulte a documentaçãodo
Microsoft Windows NT.
2 Selecione o Seagate Page Server na lista Serviços e, depois, clique em
Inicialização.
3 Certifique-se de que Automático estejaselecionadocomoTipode
Inicialização.
4 Na área Conectar Como, selecione Esta Conta.
5 Clique no botãoProcurarpróximo ao campo Esta Conta e, depois, localize
ousuário que você acabou de criar (CRWEBUSER).
6 Clique em Adicionar e, depois clique em OK.
Acaixadediálogo Serviço é exibida.
7 Digite a senha correta para o usuário nas caixas de texto apropriadas.
8 Clique em OK, para a caixa de diálogo ConfirmaçãodeServiços.
9 Feche a janela Serviços.
26 Guia do Administrador Web

Garantindo uma instalação bem-sucedida
3 : Web Component Server Implementação
Depois que a Configuração terminarainstalação do Web Component Server
evocêtiver reiniciado o sistema, o servidor da Web reiniciará
automaticamente. Se não reiniciar, consulte a documentação dosoftwaredo
seu servidor da Web.
Depois de confirmar que o servidor da Web reinicializou, verifique se o Web
Component Server está instalado corretamente.
Para garantir uma instalação bem-sucedida
1 No Grupo de Programas do Seagate Crystal Reports, selecione Exemplos
da Web
-ou-
Abra um browser (como o Internet Explorer ou o Netscape Navigator) e
digite o seguinte endereço deURL:
http://localhost/scrsamples
Os Exemplos do Seagate Crystal Reports na Web e Página de Utilitários são
exibidos no browser.
2 Na áreaExemplosdoServidordoRelatório, clique em visualizar os
exemplos.
3 Selecione um Tipo de Servidor:
WCS via extensão ISAPI\NSAPI
ExtensãoWCSCGI
Servidor de Relatórios ASP.
4 Selecione um Report Viewer:
Report Viewer para ActiveX
Report Viewer para Java Viewer usando o Browser JVM
Report Viewer para Java Viewer usando Plug-in Java
Report Viewer para Plug-in Netscape
Report Viewer para HTML Padrão comMolduras
Report Viewer para HTML Padrão.
5 Identifique um relatório e, depois, clique em visualizar exemplo.
Orelatório aparece no visualizador apropriado.
Se você tiver problemas para executar corretamente o Web Component Server
no servidor da Web, talvez precise verificar configuraçãodopróprio servidor
da Web.
Guia do Administrador Web 27

Implementação do Web Component Server
Microsoft Internet Information Server 4.0
Para determinar se o Web Component Server está configurado corretamente
no Microsoft IIS versão 4.0, siga estas etapas:
1 Inicie o Internet Service Manager.
2 Em Raiz da Console, expanda a pasta Internet Information Server para
expor a máquina que você está usando como servidor.
3 Clique com o botão direitodomousenoícone da máquina e clique em
Propriedades no menu de atalho.
A caixa de diálogo Propriedades aparece com a guia Internet Information
Server ativada.
4 Selecione WWW na lista suspensa Propriedades Mestre.
5 Clique em Editar.
Acaixadediálogo Propriedades Mestre do Serviço é exibida.
6 Clique na guia Diretório Home .
7 Clique em Configuração.
Acaixadediálogo Configuração de Aplicação é exibida.
8 Localize a extensão .rpt e certifique-se de que ela está apontada para o
caminho correto para a wcsinsapi.dll.
O caminho padrão é:
C:\Program Files\Seagate Software\WCS\wcsinsapi.dll.
9 Verifiqueseaextensão .cri também estáapontada para o mesmo local.
Servidores Netscape
Para determinar se o Web Component Server está configurado corretamente
nos servidores Netscape na Web, siga estas etapas:
1 LocalizeosarquivosMIME.TYPESeOBJ.CONF.Essesarquivosficam
localizados, normalmente, nos seguintes diretórios:
Netscape Enterprise 3.51:
\Netscape\SuiteSpot\https-\config
Netscape Enterprise 3.0:
\Netscape\SuiteSpot\https-\config
Netscape Enterprise 2.0 e Netscape FastTrack:
\Netscape\server\https-\config
2 Em MIME.TYPES, verifique se as seguintes linhas sãoexibidas:
type=magnus-internal/rptexts=rpt
type=magnus-internal/criexts=cri
3 Em OBJ.CONF, verifique se a seguinte linha é exibida:
28 Guia do Administrador Web

3 : Web Component Server Implementação
Init fn="load-modules" funcs="req_handler"
shlib="C:/Program Files/Seagate Software/WCS/wcsinsapi.dll"
4 Em OBJ.CONF, embaixo do cabeçalho ,
verifiqueseasseguinteslinhassão exibidas:
NameTrans fn="pfx2dir" from="/viewer"
dir="C:/Program Files/Seagate Software/Viewers"
NameTrans fn="pfx2dir" from="/scrsamples"
dir="C:/Program Files/Seagate Software/Crystal
reports/sample"
NameTrans fn="pfx2dir" from="/scrreports"
dir="C:/Program Files/Seagate Software/Crystal
Reports/Reports"
Service fn="req_handler" method="(GET|POST)"
type="magnus-internal/rpt"
Service fn="req_handler" method="(GET|POST)"
type="magnus-internal/cri"
5 Se alguma dessas linhas estiver faltando, adicione-as ao arquivo
apropriado.
6 Desligue o Servidor Netscape e reinicialize seu sistema de servidor da
Web.
Diretórios virtuais
Como parte do processo de instalação, os seguintes diretórios virtuais devem
ser configurados em seu servidor da Web apontando para os caminhos
indicados:
/scrreports
/scrsamples
/viewer.
Criando um site na Web
Depois de ter instalado e configurado o Web Component Server, a próxima
etapa é criar uma página na Web que contenha vínculos de relatório.
Para criar um site na Web
Primeiro, você precisa decidir o local da sua nova página da Web e, depois,
criar um diretóriovirtualparaositequeapontaparaonovodiretório.
1 Crie um diretório onde deseja armazenar seus relatórios. Copie os
relatórios para o diretório.
Esse exemplo usa os relatórios Relatório de Vendas Mundiais e Declaração
de Contas e o diretório:
c:\webroot\newsite
Guia do Administrador Web 29

Implementação do Web Component Server
Nota: Para obter informações sobre o local do diretórioraizdoservidor
da Web, consulte a documentaçãodosoftwaredoseuservidordaWeb.O
diretóriomostradoaquiéapenas um exemplo.
2 Use o software do administrador do seu servidor da Web para criar um
diretóriovirtualqueaponteodiretório físico que você acabou de criar. É
provável que você precise dar a permissão de“executar” a esse diretório
virtual. Para esse exemplo, usaremos o diretório virtual:
mydirectory
3 Usando um editor de texto simples, como o Notepad, ou seu editor HTML
favorito, crie uma página com vínculos aos relatórios do diretório virtual.
Para esse exemplo, use o seguinte código HTML:
Índice de Relatórios
Verifique esses relatórios!
Declaração de Contas
Relatório de Vendas Mundiais
4 Salve o arquivo como reportlist.htm no diretório c:\webroot\newsite.
5 Abra o browser e digite o seguinte URL:
http://localhost/mydirectory/reportlist.htm
30 Guia do Administrador Web

3 : Web Component Server Implementação
6 Clique em um dos dois vínculos da sua nova página da Web para gerar e
exibir o relatóriodentrodoseubrowser.
Nesse exemplo, você especificou dois arquivos .rpt usando endereços de URL
padrão. A extensão.rptéanalisada pelo seu servidor da Web e é determinada
para ser uma extensão que deve ser manipulada pelo aplicativo Web
Component Server. O URL é desativado e o Web Component Server
determina como manipular o .rpt solicitado.
Quando o relatório é exibido dentro do browser, o Web Component Server
analisará otipodebrowserquevocêestiver usando e enviará orelatório
usando um Report Viewer que ele determinar apropriado. Por exemplo, se
você estiver usando o Internet Explorer 4.0, você verá orelatório dentro do
Report Viewer for ActiveX. Se você estiver usando o Netscape Navigator 4.0,
verá orelatóriodentrodoReportViewerpara Java.
Especificando o Report Viewer
Como projetista de site da Web, você pode especificar qual visualizador é
usado quando o relatório é solicitado, substituindo o visualizador padrão
usado de acordo com o browser. Por exemplo, a seguinte URL força oJava
Viewer a ser usado, mesmo se você estiver executando o Internet Explorer ou
qualquer outro browser:
http://localhost/mydirectory/account
statement.rpt?init=java
Nota: Se o browser do usuário não suportar a tecnologia usada pelo
visualizador especificado, nesse caso o Java, ocorrerá um erro ou será exibida
uma página da Web em branco.
Nesse URL, INIT é oparâmetro reconhecido pelo Web Component Server. Ao
definir o parâmetro INIT igual ao Java, você pode forçar o Web Component
Server a usar o Report Viewer para Java quando exibir o relatóriodentrode
um browser. O Web Component Server suporta vários parâmetros para
controlar como os relatórios são gerados e exibidos. Para obter mais
informações, consulte “Comandos do Web Component Server” na página 42.
Guia do Administrador Web 31

Implementação do Web Component Server
32 Guia do Administrador Web

Administração do Web Component
Server 4
Este capítulo apresenta informações sobre como
configurar o Web Component Server utilizando o
aplicativo fornecido.
Guia do Administrador Web 33

Administração do Web Component Server
Administração do Web Component Server
O aplicativo Web Components Manager permite o controle de como os relatórios
são criados e acessados a partir do Web site. Este capítulo contéminformações
sobre as configurações que podem ser alteradas em cada uma das cinco guias que
compõem o aplicativo Crystal Report Web Components Manager.
Acesso ao Crystal Report Web Components Manager
Para acessar o Crystal Report Web Components Manager
1 Localize o arquivo wcmadmin.exe.
2 Clique duas vezes em cmadmin.exe para abrir o aplicativo.
O aplicativo Crystal Report Web Components Manager é exibido. Ele
contém cinco guias:
Web Component Server
Extensões de Arquivos
Visualização deRelatórios
Servidor de Páginas
Configurações do Cache.
Guia Web Component Server
Essa guia é composta das seguintes áreas: Imagens HTML, Caminho Virtual
do Visualizador e Porta do Servidor.
34 Guia do Administrador Web

Imagens HTML
4 : Administração do Web Component Server
O campo Localização dos Arquivos de Imagem Temporários especifica onde
são armazenadas as imagens .CRI apresentadas com o Visualizador de
Relatórios para HTML.
Caminho Virtual do Visualizador
Este campo especifica o caminho virtual a ser utilizado para todos os
visualizadores de relatórios e imagens apresentados pelo Web Component
Server.
Porta do Servidor
Guia Extensões de Arquivos
A área Porta do Servidor contém onúmero da porta que o Web Component
Server utiliza para receber as solicitações de um conector do Web Component
Server.
Nota: Todasasmodificações – exceto as que envolvem a Porta do Servidor,
que são armazenadas no arquivo de serviços – são armazenadasnoRegistro
do Windows. Elas são ativadas somente quando o servidor da Web é
interrompido e reinicializado.
Essa guia é composta das seguintes áreas: Relatório Crystal e Imagem HTML.
Relatório Crystal
Insira ou remova extensões de arquivos que devem ser mapeadas para
visualizaçãodeRelatórios Crystal.
Quando o Web Component Server é instalado, a extensãodearquivopadrão
mapeada para visualizaçãodeRelatórios Crystal é definida como arquivos de
Relatório (.RPT).
Nota: Na maioria dos casos, você não precisaráadicionar uma extensão de
arquivo a menos que esteja atualizando para outro produto da Seagate
Software.
Imagem HTML
A áreaImagemHTMLespecificaaextensão utilizada para as imagens
encontradas nas páginas HTML.
Nota: Todasasmodificações são armazenadas no Registro do Windows.
Elas são ativadas somente quando o servidor da Web é interrompido e
reinicializado.
Guia do Administrador Web 35

Administração do Web Component Server
Guia Visualização de Relatórios
Utilize a guia VisualizaçãodeRelatórios para controlar as opções disponíveis
aos usuários quando visualizam um relatórioemumbrowser.Essaguiaé
composta de três áreas:
Todos os visualizadores
ActiveX e Java
Página HTML.
Também foiincluída nessa guia o botão Plug-inemJava.
Nota: As guias seguintes não se aplicam a Visualizadores de Relatórios
acessados através deumAplicativooudaguiaObjetoemumpágina HTML.
Nessescasos,asopções de visualizador são definidas através deguiasde
parâmetros na página.
Marque e desmarque as caixas de seleção paraativaredesativarasopções.
36 Guia do Administrador Web

Todos os visualizadores
4 : Administração do Web Component Server
Essa área contém caixasdeseleção quepermitemaconcessão de acesso aos
usuários para:
Pesquisar no relatório
Analisar dados no relatório
Gerar ÁrvoredeGrupos
Atualizar relatório.
ActiveX e Java
Essa área contém caixasdeseleção quepermitemaconcessão de acesso aos
usuários para as seguintes funções:
Imprimir relatórios
Exibir logotipo
Controle de zoom
Exibir Árvore de Grupos
Permitir exportação.
Marqueoudesmarqueacaixadeseleção MostrarÁrvoredeGrupospara
controlar se uma Árvore de Grupos é ou não geradaparaNavegação
Inteligente dentro dos Visualizadores de Relatórios.
Nota: Ageraçãodeumaárvoredegruposparaumrelatórioexige que o Web
Component Server passe mais uma vez pelos dados do relatório. Isso pode
causar atrasos na resposta e requer recursos adicionais do sistema,
especialmente se o relatório contiver um grande número de grupos ou vários
grupos dentro de grupos.
Página HTML
Essa área contémumacaixadeseleção que permite a visualização da barra de
ferramentas de Navegação.
Plug-in em Java
Clique nesse botão para modificar a localização, versão e tipo MIME do Plugin
em Java que estiver utilizando. Esse recurso éútil se você desejar utilizar
uma nova versão doPlug-inJava.
Nota: Todasasmodificações são armazenadas no Registro do Windows. Elas
são ativadassomentequandooservidordaWebé interrompido e
reinicializado.
Guia do Administrador Web 37

Administração do Web Component Server
Guia Servidor de Páginas
AguiaServidordePáginas é composta de quatro áreas: Processamento,
Atualização de Banco de Dados, Tempo ocioso, e Porta do Servidor.
Processamento
Essa área permite efetuar modificações no número máximo de
encadeamentos.
Número máximo de encadeamentos
OServidordePáginas é um aplicativo com multiencadeamento (multithread).
Para cada solicitação que recebe, ele gera um novo encadeamento para
processamento.
Os encadeamentos consomem memória e recursos do sistema. Um grande
número de encadeamentos pode reduzir o desempenho geral do sistema.
Ao especificar o número máximo de encadeamentos que podem ser gerados
pelo Servidor de Páginas, você pode controlar os recursos do sistema que
podem se dedicar à resposta de solicitações em um determinado momento. Se
onúmero de solicitações recebidas pelo Servidor de Páginas ultrapassar o
número de encadeamentos especificados, as solicitações adicionais terão que
aguardar até que haja encadeamentos disponíveis.
Ao determinar o número máximo de encadeamentos, considere a memória
disponível no sistema do servidor e o tamanho dos relatórios que geralmente
são acessados. Os relatórios maiores exigem mais tempo e recursos adicionais
do sistema.
38 Guia do Administrador Web

Atualização do Banco de Dados
4 : Administração do Web Component Server
Essa configuração controla com que freqüência os dados dos relatórios
armazenados em cache são atualizados através de consultas ao banco de dados.
Se o Tempo de Atualização do Banco de Dados tiver transcorrido desde que o
relatório foi armazenado em cache pela primeira vez, o Servidor de Páginas
poderá atualizar os dados no relatório em cache da próxima vez que um
usuário solicitar o documento.
Através do controle da freqüência de atualizaçãodosrelatórios, o impacto das
solicitações dos clientes ao banco de dados pode ser minimizado. Os clientes
que tiverem permissão de atualizar os dados por conta própria podem
sobrecarregar o servidor de banco de dados. Em vez disso, como administrador,
você pode controlar a freqüência com que os dados sãoatualizados.
Lembre-se de que os Visualizadores de Relatórios dispõem, por padrão, de
um botão Atualizar. Se você definir um tempo de atualização dobancode
dados e um cliente utilizar o botão Atualizar de um Visualizador de
Relatórios, ele gera uma atualização dorelatório em cache, forçando uma
solicitação ao banco de dados. Pode ser útil desativar o botão de Atualização.
Para obter mais informações, consulte “Guia VisualizaçãodeRelatórios” na
página 36. SeoTempodeAtualização doBancodeDadosforzero,osdados
são atualizados sempre que um relatório for solicitado.
Tambémfoiincluída nessa áreaumacaixadeseleção que permite decidir se o
banco de dados é ou não afetado quando o usuário clica em atualizar a partir
de seu browser.
Tempo ocioso
Otempoociosoé um período de tempo durante o qual não ocorre nenhuma
ação.
Minutos antes do trabalho ocioso ser fechado
Um trabalho refere-se a um relatórioquefoigeradoearmazenadoemcache
no servidor. Se ninguém solicitar o relatórionotempoespecificado,otrabalho
de relatório é fechado e eliminado. Em conseqüência disso, se alguém solicitar
orelatóriodepoisqueotrabalhotiversidofechado,umnovotrabalhoprecisa
ser gerado, provocando um atraso inicial.
Porta do Servidor
IndicaaportautilizadapeloServidordePáginas para receber solicitações.
Todasasmodificações são armazenadasnoRegistrodoWindows.Elassão
ativadas somente quando o servidor da Web é interrompido e reinicializado.
Guia do Administrador Web 39

Administração do Web Component Server
Guia Configurações do Cache
Essa guia é composta das seguintes áreas: Diretório da Memória Cache e
ManutençãodaMemória Cache.
Diretório da Memória Cache
Esse campo especifica onde são armazenados os relatórios em cache no
sistema do servidor. Se forem aceitas as configurações de diretório padrão
durante a instalação, os relatórios são salvosem:
C:\Arquivos de Programa\Seagate Software\WCS\Cache\Temp
Manutenção da Memória Cache
Na área Manutenção daMemória Cache, é possível especificar o Tamanho
Máximo do Cache em KBytes e os Minutos para limpeza do arquivo de cache.
Tamanho Máximo do Cache em KBytes
É oespaçomáximo, em kilobytes, que poderá ser utilizado na unidade do
sistema do Servidor de Páginas para armazenar em cache as páginas dos
relatórios. Se as solicitações de relatórios começarem a ultrapassar esse espaço
em disco, as páginas antigas sãoexcluídas(combaseemumalgoritmoLRU)
do cache até que haja espaçoparaaspáginasmaisnovas.
40 Guia do Administrador Web

Comandos do Web Component Server 5
Este capítulo fornece exemplos de comandos do Web
Component Server que podem ser anexados às
solicitações de URLs. Essas solicitações de URLs
podem ser utilizadas para indicar aos usuários que
insiram informações de segurança ou valores de
campos de parâmetros.
Guia do Administrador Web 41

Comandos do Web Component Server
Comandos do Web Component Server
Os relatórios predefinidos criados com o Seagate Crystal Reports são
disponibilizados instantaneamente a todos os usuários conectados ao seu
Web site através da Internet ou intranet. Como administrador do servidor da
Web, você pode determinar como os dados sãoacessadosdoseuWebsiteea
quantidade exata de dados disponível. O Web Component Server
disponibiliza diversos comandos que podem ser anexados às solicitações de
URLs. Além disso, o Web Component Server oferece a opção de solicitar
automaticamente aos usuários informações de segurança, parâmetros de
procedimentos armazenados e valores de campos de parâmetros.
Nota: Os recursos aqui descritos permitem o controle do acesso às
informações de relatório de forma limitada. Embora os comandos descritos
nesta seção proporcionem um certo nível de personalização, considere o uso
do Servidor de Automação RDC para projetar Web sites se precisar de mais
controle sobre os dados e formatação derelatórios durante a execução. As
informações sobre esse método podem ser encontradas no Guia de
Referência Técnica do Seagate Crystal Reports.
Criação de solicitações de relatórios
Quando você solicitar um relatório do Web Component Server ou configurar
um vínculo com um relatório a partir de outra página da Web, vários
comandos opcionais estarãodisponíveis para personalizaçãodasinformações
apresentadas.
Os comandos são passados com uma solicitaçãoderelatório anexando-se ao
endereçodoURLdorelatórioumponto de interrogação seguido de cada
comando de seqüênciadeconsultaautilizado.
Nota: Os comandos podem ser passados em qualquer ordem e qualquer
combinação. Todos os comandos são opcionais. Se não for especificado
nenhum comando, o visualizador padrão exibeorelatório.
A seguir, apresentamos um exemplo do uso dos comandos de seqüências de
consulta solicitando um relatório:
http:///scrreports/Accounting/
wsale.rpt?sf={cliente.Vendas}>10000
Observe que cada comando é especificado através daseguintesintaxe:
comando=valor
Onde comando é oprimeironomedocomandoevalor é ovalorquevocê atribui
a esse comando.
42 Guia do Administrador Web

5 : Comandos do Web Component Server
Nota: Ocomandoéprecedido de um ponto de interrogação ? eoscomandos
adicionais sãoseparadosporumEcomercial&.
Pode ser mais conveniente incorporar a solicitação aumapágina HTML e
passá-la ao Web Component Server através de uma guia FORM, como no
exemplo a seguir:
O URL resultante e a seqüência de consulta anexada ficarão daseguinte
forma:
http://hostlocal/scrreports/Accounting/
wsale.rpt?sf={cliente.Vendas}>1000&init=html_page&rf=0&p
romptOnRefresh=0
Comando INIT
Especifica o Visualizador de Relatórios. Por exemplo:
init=java
Possíveis valores:
java - Visualizador de Relatórios para Java
actx - Visualizador de Relatórios para ActiveX
html_frame - Visualizador de Relatórios para HTML Padrão com
Quadros
html_page - Visualizador de Relatórios para HTML Padrão
nav_plugin - Visualizador de Relatórios para Plug-in Netscape
java_plugin - Visualizador de Relatórios para Plug-in Java.
Se o comando INIT não for especificado, o Web Component Server detecta o
tipo de browser solicitando um relatório e fornece um visualizador padrão
para esse browser. Por exemplo, se o browser for Netscape Navigator 4.0, o
Web Component Server exibe o relatório utilizando o Visualizador de
Relatórios para Java
Nota: Nem todos os browsers suportam todos os métodos de visualizaçãode
relatórios.
Guia do Administrador Web 43

Comandos do Web Component Server
Considerações
Os visualizadores ActiveX e Java não encontram-sedisponíveis nas
versões 3.02 e anteriores do Internet Explorer.
Você deve instalar o Authenticode 2.0 se estiver utilizando o Internet
Explorer.
O Netscape Navigator não suporta o Visualizador de Relatórios para
ActiveX.
O Netscape Navigator versão3.0eanteriornãosuportaoVisualizadorde
Relatórios para Java.
Modificação das fórmulas de seleção em relatórios da Web
Além de especificar uma fórmula de seleção deregistroougrupoaoprojetar
um relatório, você também pode modificar a fórmula de seleção utilizando
um comando anexado ao URL de um relatório aberto através doWeb
Component Server. Como administrador, você pode criar um relatório e
projetar uma página da Web que permita aos usuários selecionar os critérios
de seleção paraasinformações que eles precisam. O Web Component Server
então, gera dinamicamente, o relatóriosolicitadoapresentandoapenasos
registros selecionados.
Para especificar uma seleção de registros em uma solicitação derelatório da
Web, utilize o comando de parâmetro SF. Por exemplo:
http://server_name/reports/boxoffic.rpt?
sf={estúdio.Estúdio}+%3d+'Universal'
Esse comando cancela todas as fórmulas de seleçãojá contidas em
Boxoffic.Rpt. Porém,anovafórmula de seleçãonão é salva com o arquivo de
relatório original. Só évalida para o trabalho solicitado no momento. O
comando GF (seleção de grupo) pode ser utilizado para modificar uma
fórmula de seleção de grupo em um relatório.
O Web Component Server não verifica a validade das fórmulas de seleçãoque
você envia a um relatório. Se a fórmula de seleção criadanão forválida, o
browser recebe uma mensagem de erro. Se você estiver projetando um Web
site que passa fórmulas de seleção arelatórios, certifique-se de testar as
fórmulas de seleção antes de permitir que os usuários acessem o site.
44 Guia do Administrador Web

Comando GF (Seleção de Grupos)
5 : Comandos do Web Component Server
Especifica uma fórmula de seleção degruposEstecomandoésimilar ao de
fórmulas de seleção.
GF=
« é uma fórmula de seleção em formato de
seqüência.»
Por exemplo:
GF= Sum({cliente.Vendas},{cliente.Região})>10000
«Seleciona todos os grupos no qual a soma de todas as
vendas de clientes em cada região é superior a 10.000.»
Comando SF (Seleção)
Fontes de dados SQL e ODBC
Especifica uma fórmula de seleção.
SF=
« é uma fórmula de seleção em formato de
seqüência.»
Por exemplo:
http://nome_do_servidor/reports/
boxoffic.rpt?sf={estúdio.Estúdio}+%3d+”Universal”
«Seleciona todos os registros nos quais o estúdio seja
Universal.»
Nota: Os relatórios que tiverem exatamente os mesmos comandos SF e GF
aplicados e nãoexigireminformações de logon compartilharão páginas.
O Web Component Server abre relatórios baseados em servidores SQL e
fontes de dados ODBC com a mesma facilidade que abre relatórios baseados
em arquivos pequenos de bancos de dados em um computador pessoal. Se os
dados em um relatório exigirem o acesso a uma fonte de dados segura como
um servidor SQL ou uma fonte de dados ODBC, o Web Component Server
automaticamente solicita ao usuário que forneça umaIDdeusuário e senha
antes de exibir os dados do relatório.
Guia do Administrador Web 45

Comandos do Web Component Server
Nota: Embora o Web Component Server exija o logon dos usuários antes de
exibir relatórios que acessem bancos de dados seguros, podem ocorrer
conflitos de segurança sevárias pessoas tentarem acessar o mesmo relatório
simultaneamente. Para evitar esse tipo de conflito, aumente a segurança do
seu Web site impedindo que os usuários visualizem e acessem os relatórios
seguros. Forçar os usuários a efetuar logon nos sites de intranet é uma
solução comum para proporcionar completa segurança aosistema.
Dependendo do tipo de dados que sirva de base para seus relatórios, a página
de logon exibida pode ser ligeiramente diferente.
Nota: Se o sistema de segurança do banco de dados não tiver senha ou tiver
uma senha em branco, o Web Component Server não solicita aos usuários
que efetuem logon. Para garantir a segurança, certifique-se de que os bancos
de dados disponham de senhas válidas.
Para criar hiperlinks nas páginas da Web que tratam de IDs e senhas de usuários
automaticamente, utilize os comandos User e Password. Esses comandos
permitem a especificaçãodemaisdeumaIDesenhadeusuário se o relatório se
conectar com dois ou mais bancos de dados seguros. Lembre-se de que se for
enviada uma ID de usuário ou senha incorreta, o Web Component Server
restringirá oacessoatéque as informações corretas sejam fornecidas.
Nota: O Web Component Server aplica um algoritmo de criptografia simples
nos nomes de usuário e senhas. Se você estiver empregando um servidor da
Web da Microsoft, certifique-se de que o protocolo de criptografia Secure
Sockets Layer (SSL) esteja instalado e ativado na sua intranet ou extranet para
assegurar total segurança ao acessar as informações de bancos de dados.
Devido a um problema documentado nos servidores da Web da Netscape, o
SSL não é suportado pelo Web Component Server em servidores Netscape.
Para obter mais informações, consulte a documentação do Netscape.
Comando PASSWORD#
Especifica senhas para login em bancos de dados SQL, ODBC ou protegidos
por senha utilizados pelo relatório.
PASSWORD#=
« é uma seqüência.»
Por exemplo:
password0=secret
Se o relatório acessar mais de um banco de dados protegido por senha, várias
senhas podem ser passadas com o aumento do número do índice. Por
exemplo:
password0=secret&password1=mystery&password2=unknown
46 Guia do Administrador Web

5 : Comandos do Web Component Server
PASSWORD# é geralmente utilizada em conjunto com o comando USER#. Por
exemplo:
user0=SmithJ&password0=secret&user1=JohnS&password1=
mystery
Se o relatório contiver sub-relatórios que exijam senhas para login nas fontes
de dados SQL ou ODBC, utilize a seguinte sintaxe no URL.
password@subnome#=
«subnome é o nome do sub-relatório.»
Por exemplo:
user0@TabCruz=jimmys&password0@TabCruz=jimmyz
Nota: Certifique-se de que as senhas constem do URL na mesma ordem em
queosbancosdedadosprotegidosporsenhasãoexibidosnorelatório. Caso
as senhas não sejam passadas através doendereço deURL,ousuário deverá
apresentar as informações de logon no momento da execução.
Comando USER#
Especifica IDs de usuário para logon em bancos de dados SQL ou ODBC
utilizados pelo relatório.
USER#=
« é uma seqüência.»
Por exemplo:
user0=SmithJ
Se o relatório acessar mais de um banco de dados protegido por senha, várias
IDs de usuário podem ser passadas com o aumento do número do índice. Por
exemplo:
user0=SmithJ&user1=JohnS&user2=JSmith
USER# é geralmente utilizada em conjunto com o comando PASSWORD#. Por
exemplo:
user0=SmithJ&password0=secret&user1=JohnS&password1=
mystery
Se o relatório contiver sub-relatórios que exijam IDs de usuário para login nas
fontes de dados SQL ou ODBC, utilize a seguinte sintaxe no URL.
user#@nome_do_sub-relatório
Por exemplo:
user0@TabCruz=jimmys&password0@TabCruz=jimmyz
Guia do Administrador Web 47

Comandos do Web Component Server
Nota:
Se um relatórioexistenteforinseridocomoosub-relatório, o nome do
sub-relatório inclui a extensão doarquivo(porexemplo,
user0@nome_do_sub-relatório.rpt). No entanto, se o sub-relatório tiver
sido criado dentro do relatório principal (com Inserir Sub-relatório e
utilizando o Assistente de Relatórios para criar o novo relatório), então, o
nome do sub-relatório geralmente não contém umaextensãodearquivo
(por exemplo, user0@nome_do_sub-relatório) a menos que a extensãoseja
adicionada na caixa de texto "Nome do Relatório" da caixa de diálogo
Inserir Sub-relatório.
Certifique-sedequeasIDsdeusuário constem do URL na mesma ordem
em que os bancos de dados protegidos por senha são exibidosno
relatório. Além disso, as IDs de usuário dos sub-relatórios devem ser
exibidas na mesma ordem em que os sub-relatórios são exibidosno
relatório. Caso as IDs de usuário não sejam passadas através doendereço
de URL, o usuário deverá apresentar as informações de logon no
momento da execução.
Os relatórios não devem ser compartilhados se houver exigência de logon.
Método alternativo
Além dos exemplos de sintaxe fornecidos acima, essa versão doSeagate
Crystal Reports permite a utilização deummétodo alternativo para solicitar
aos usuários informações de Id de usuário e senha.
Usuário
Usuário-.@
Senha
Senha-.@
Procedimentos armazenados em SQL e campos de parâmetros
O Seagate Crystal Reports suporta o planejamento de relatórios baseado em
procedimentos armazenados em bancos de dados SQL. Além disso, o Report
designer permite a criação decamposdeparâmetros no próprio relatório.
Tanto os procedimentos armazenados quanto os campos de parâmetros
podem solicitar que os usuários, no momento da execução,insiramumvalor
no qual o relatório se baseará. Por exemplo, um vendedor pode desejar
visualizar somente as informações sobre vendas na sua região. Quando o
relatório é solicitado, o sistema pode apresentar um prompt para que o
vendedor insira o nome de uma região. O relatório exibe, então, somente os
dados dessa região.
48 Guia do Administrador Web

5 : Comandos do Web Component Server
Para evitar que os usuários especifiquem seus próprios valores para campos
de parâmetros e procedimentos armazenados, utilize o comando PROMPT#
ao especificar o URL de um relatório. O PROMPT# permite a especificaçãode
valoresparaumoumaiscamposdeparâmetros em um relatório. Outra
alternativa seria projetar seus próprios formulários baseados na Web que
aceitam entradas do usuário e criam dinamicamente o URL que inclui o
parâmetroeovalordePROMPT#.
Nota: Os usuários não devem colocar os valores de parâmetros entre aspas.
Todososvaloressãoenviados para o relatóriocomoseqüências,
independente do tipo de dado. Os parâmetros que utilizam valores
numéricos interpretam a seqüência recebida quando necessário.
O Web Component Server não valida nenhum valor de parâmetro que você
especifica para procedimentos armazenados ou campos de parâmetros. Se o
valor que você passar para o parâmetro for inválido, como, por exemplo, ao
passar uma informação de texto quando deveria ser numérica, nenhuma
mensagem de erro é enviada ao browser. Além disso, o Web Component
Server não permite a modificação do formato exigido pelos parâmetros.
Certifique-se de testar os Web sites que acessam relatórios com procedimentos
armazenados ou campos de parâmetros antes de permitir que os usuários
solicitem esses relatórios.
Nota: Os campos de parâmetros e os procedimentos armazenados limitam a
eficácia do cache de relatórios e o compartilhamento de trabalhos. Como cada
relatório que contém procedimentos armazenados ou campos de parâmetros
pode gerar um conjunto de dados diferente a cada vez que é solicitado, as
várias solicitações a um mesmo relatório podem não serdistribuídas entre
todos os usuários.
Comando Prompt#
Especifica valores para campos de parâmetros no relatório. Os valores de
parâmetros sãoatribuídos aos parâmetrosnaordememqueexistemnorelatório.
PROMPT#=
« é uma seqüência.»
Por exemplo:
prompt0=CA
Nota: Não utilize os valores de parâmetros entre aspas para indicar
seqüências. Todos os valores de parâmetros são passados ao relatório como
seqüências. Os valores numéricos pretendidos são convertidos de seqüências
para números pelo relatório.
Se o relatório contiver mais de um campo de parâmetro, vários valores podem ser
passados aos parâmetroscomoaumentodonúmero do índice. Por exemplo:
prompt0=CA&prompt1=1000
Guia do Administrador Web 49

Comandos do Web Component Server
Nota:
Exportação de relatórios
Certifique-se de que os valores dos parâmetros constem do URL na
mesma ordem em que os campos de parâmetros e procedimentos
armazenados são exibidosnorelatório. Caso os valores dos parâmetros
não sejam passados através doendereço deURL,ousuário que solicita o
relatório deverá fornecer os valores no momento da execução.
Os relatórios que aplicarem o comando PROMPT# nãopodemterpáginas
compartilhadas. O uso de cache será por usuário.
Comando PromptOnRefresh#
Especifica se o relatório deve solicitar valores de campos de parâmetros ao ser
atualizado.
promptOnRefresh#=
« é 0ou1.»
Por exemplo:
promptOnRefresh=1
Nota: Os relatórios que aplicarem o comando promptOnRefresh# não
podem ter páginas compartilhadas. O uso de cache será por usuário.
O servidor de relatórios pode exportar relatórios solicitados para os seguintes
formatos:
HTML 3.2
HTML 4.0
Seagate Crystal Reports (RPT)
Excel 5.0 (XLS)
Excel 5.0 (XLS) Estendido
Rich Text Format (RTF)
Documento do Word (DOC).
O servidor de relatórios atribui ao cabeçalho CONTENT-TYPE (TIPO DE
CONTEÚDO) o MIME-TYPE (TIPO DE MIME) apropriado e, portanto, o
browser pode ser configurado para executar o aplicativo adequado após o
download do arquivo. Para enviar uma solicitação ao servidor de relatórios
para exportar um relatório, a seqüência de consulta deve conter dois
comandos. Os comando são CMD e EXPORT_FMT. O comando CMD deve
sempre receber o valor de EXPORT e o comando EXPORT_FMT deve indicar
o Formato de Exportação desejado. A tabela abaixo lista os formatos de
exportação suportados e sua representação EXPORT_FMT correspondente.
50 Guia do Administrador Web

Comandos CMD# e EXPORT_FMT
5 : Comandos do Web Component Server
Especifica que o relatório deve ser exportado para o formato indicado.
cmd=EXPORT&EXPORT_FMT=
é umadasquesesegue:
Por exemplo:
Formato de Exportação Representação do Export_FMT
Adobe PDF U2FPDF:0
HTML 3.2 U2FHTML:2
HTML 4.0 U2FHTML:3
Seagate Crystal Reports (RPT) U2FCR:0
Excel 5.0 (XLS) U2FXLS:3
Excel 5.0 (XLS) Estendido U2FXLS:4
Rich Text Format (RTF) U2FRTF:0
Documento do Word (DOC) U2FWORDW:0
Se um usuário desejar o download do relatório test.rtp para o seu browser em
formato Microsoft Word, o URL (codificado em Latin - ISO) seria:
http://mycomputer/
test.rpt?cmd=EXPORT&EXPORT_FMT=U2FWORDW%3A0
Atualização de dados de relatórios da Web
Quando um relatório contém dados salvos, ele nãoprecisaacessarobancode
dados. O relatório recupera informações diretamente do Web Component Server.
Isso reduz significativamente o tráfego da rede e a utilização dos recursos do
servidor da rede quando várias pessoas solicitam relatórios com freqüência. Por
essa razão, você pode desejar projetar a maioria dos relatórios de forma que
contenham dados salvos. Alémdisso,osrelatórios que contêmdadossalvos
podem ser facilmente armazenados em cache pelo Web Component Server para
otimizar o compartilhamento do trabalho, servindo a mais usuários com as
mesmas informações simultaneamente. No entanto, se um relatório contiver
dados salvos e forem feitas modificações no banco de dados original, o relatório
nãorefletiráinformações precisas. Para atualizar o relatório, você pode abri-lo no
Seagate Crystal Reports, atualizar os dados e voltar a salvar o documento. Porém,
o Web Component Server também possibilita um meio de efetuar uma
atualizaçãodinâmica dos dados do relatório.
Como administrador do sistema Web, você deve decidir se deseja permitir
que os usuários atualizem os dados do relatório por conta própria ou se deseja
controlar como e com que freqüência eles poderão atualizar esse dados. Cada
Visualizador de Relatórios inclui um botão para atualização dos dados
Guia do Administrador Web 51

Comandos do Web Component Server
durante a visualização. Porém, se houver muitos usuários atualizando dados
de relatório nos sites, pode ocorrer uma diminuição no desempenho da rede
edosistemajáque cada atualização exigeconexãocomumbancodedadose
coleta de dados.
Você pode cancelar ou desativar o recurso de atualização dousuário e criar
outra forma de manter os dados dos relatórios atualizados. Um dos métodos
é definir a atualização automática através daconfiguração da Atualização do
Banco de Dados na guia Servidor de Páginas do aplicativo Crystal Report Web
Components Manager. Para obter mais informações, consulte “Atualização
do Banco de Dados” na página 39.
Ao decidir como os dados serão atualizados no seu Web site, lembre-se de que
as atualizações freqüentesdosdadosdosrelatórios limitam os recursos de
cachederelatórios do Web Component Server. Sempre que um relatório é
atualizado, a versão armazenada em cache desse relatório torna-se obsoleta.
52 Guia do Administrador Web

Report Viewers 6
Este capítulo fornece informações sobre como
configurar os Report Viewers para atender às
necessidades dos usuários.
Guia do Administrador Web 53

Visão Geral do Report Viewer
Visão Geral do Report Viewer
recursos do Report Viewer
AoacessaremumrelatórionoWeb Component Server, os usuários finais
carregam um Report Viewer que trabalha dentro do browser do sistema.
O Seagate Crystal Reports inclui seis Report Viewers distintos:
Report Viewer para ActiveX
Report Viewer para Java usando o Browser JVM
Report Viewer para Java usando o Plug-in em Java
Report Viewer para Plug-in Netscape
Report Viewer para HTML Padrão comMolduras
Report Viewer para HTML Padrão.
É possível instruir o Web Component Server para determinar o Report Viewer
mais adequado ao browser do usuário final ou especificá-lo através do
Microsoft Visual InterDev e o Time ActiveX Control, e selecionar o
visualizador utilizando os Controles de IntegraçãodeRelatórios. O código
adequado é adicionado automaticamente ao site.
O Seagate Crystal Reports dispõe de recursos excelentes de criação de
relatórios para análise e apresentação dos dados. Teoricamente, quando um
usuário acessa um relatório através daWeb,orelatório preserva esses
recursos. Existem vários Report Viewers que podem oferecer essa
funcionalidade, desde que exista no relatório original.
Geralmente, os administradores de rede têm motivos importantes para
preferir uma tecnologia de web a outra, ao apresentar informações em um
web site. Ao escolher a tecnologia do Report Viewer utilizada em seu web site,
examine os recursos de criação derelatórios fornecidos por cada Report
Viewer e leve em consideração os limites que uma tecnologia de web possa
impor sobre o Report Viewers.
54 Guia do Administrador Web

6 : Report Viewers
A tabela a seguir ilustra os principais recursos de criação derelatórios,
disponíveis em cada Report Viewer:
Recursos ActiveX Java
Visualizar
Gráficos
Visualizar
mapas
incorporados
Árvore de
Navegação
Inteligente
Análise de
dados por
gráficos &
dados
resumidos
Exportarpara
Word, Excel,
HTML, RPT
Alterar
Assistente de
Seleção de
Registros
Pesquisar um
valor de dado
específico
Visualizar
sub-relatórios
Analisar
dados por
sub-relatórios
Java
Bean
Plug-in
Netscape
Molduras
HTML
Página
HTML
Sim Sim Sim Sim Sim Sim
Sim Sim Sim Sim Sim Sim
Sim Sim Sim Sim Sim
Sim Sim Sim Sim
Sim Sim Sim Sim
Sim Sim Sim
Sim Sim Sim Sim Sim Sim
Sim Sim Sim Sim Sim Sim
Sim Sim Sim Sim
Guia do Administrador Web 55

Visão Geral do Report Viewer
Padrões do Report Viewer
A tabela a seguir lista o Report Viewer determinado como padrão, quando o
browser de um usuário se conecta ao Web Component Server:
Browser do Usuário
Embora não seja necessário alterar esses padrões, em algumas ocasiões, é
possível que você precise escrever manualmente páginas da web que exibem
um visualizar específico, independentemente do browser utilizado, ou queira
personalizar o web site editando o código criado pelos controles de integração
de relatórios.
Se você desenvolve sites usando o Servidor de Automatização deRDCouse
você se conecta ao Web Component Server no Active Server Pages ou Visual
Basic, encontrará diversas opções para configurar os Report Viewers.
Para obter mais informações sobre como usar o Active Server Pages, consulte
oServidordeAutomatização deRDCnoManualdeReferência Técnica.
Imprimindo em Report Viewers
Visualizador
Padrão
Visualizadores
Opcionais
Internet Explorer 3.02, 4.x, 5.x ActiveX Java, Moldura
HTML, Página
HTML
Netscape Navigator 3.x, 4.x
(32 bits)
Outros Browsers Página HTML
Java Plug-in, Moldura
HTML, Página
HTML
Quando você cria um relatório no Seagate Crystal Reports, o programa analisa
aimpressoraselecionadanosistema,paradeterminarotamanhodafontee
como dimensionar e posicionar objetos, como objetos campo e objetos texto no
relatório. Se, mais tarde, o relatório for impresso em uma impressora diferente
daselecionadaduranteacriaçãodorelatório, podem ocorrer problemas com
o tamanho de fonte, texto recortado e com a paginação.
Sendo assim, pense no que pode acontecer quando um relatório é criado em
uma máquina, atendido através da rede por um servidor web em uma
segunda máquina, e visualizado ou impresso a partir de um browser, por
meio de um Report Viewer em uma terceira máquina. Se cada uma dessas
máquinas estiver conectada a uma impressora diferente, os problemas de
formataçãodorelatório podem se avolumar.
Imagine um relatório elaborado e formatado na primeira máquina, em que as
definições da impressora são aplicadas para determinar o tamanho da fonte e
o tamanho e a posição deobjetosnorelatório. Quando o servidor web gerar
esse relatório, a impressora conectada pode forçar a mudança do tamanho de
56 Guia do Administrador Web

6 : Report Viewers
uma fonte. Contudo, os objetos campo e texto mantêm posição etamanho
fixos. Sendo assim, a criação dorelatório no servidor web pode acarretar o
recortedeumtextooucriarespaçosembrancoadicionais entre os campos.
Entretanto, se alguns objetos do relatório estiverem formatados com a opçãode
formatação Pode Crescer,serãoautomaticamenteredimensionadosàmedida que o tamanho da fonte do texto for redimensionado pela nova impressora.
Uma vez redimensionados, contudo, esses objetos podem alterar a paginação.
OReportViewerparaJavaeoReportViewerparaHTMLexibemorelatório
em um browser à medida que é gerado pelo servidor web, de modo que esses
problemas de formatação podem afetar a exibiçãodosrelatórios para os
usuários. O Report Viewer para Java permite que os usuários do IE 4.0 e
Netscape 4.06 ou superior imprimam relatórios. O Report Viewer para HTML
apenas imprime a página HTML exatamente conforme exibida no browser.
Ao contrário, o Report Viewer para ActiveX permite imprimir um relatório
formatado a partir de um browser. Conseqüentemente, pode surgir um nível
adicional de problemas de formataçãonorelatórioimpresso, se a máquina em
que o browser for executado estiver conectada a uma terceira impressora com
outras configurações.
Ao elaborar relatórios que serão visualizados através deumdosReport
Viewers, use fontes de relatóriocomunsatodosossistemas,paraevitar
problemas de redimensionamento e paginação, e teste sempre os relatórios
em uma máquina cliente antes de distribuí-los aos usuários.
Usando Report Viewers em aplicativos
A visualizaçãoderelatórios não é exclusiva aos web sites e talvez você precise
de aplicativos do lado do cliente que exibem relatórios na tela para os
usuários. O Report Viewer para ActiveX e o Report Viewer para Java são
componentes totalmente funcionais, que podem ser adicionados aos
aplicativos criados no Microsoft Visual Basic, Borland Delphi, Symantec
Visual Cafe e em vários outros ambientes de desenvolvimento com suporte
para controles ActiveX ou o Java Beans.
Nota: O Report Viewer para Java é destinado basicamente ao desenvolvimento
de aplicativos e, portanto, nãoserádiscutido neste capítulo. Em vez disso, este
capítulo se concentra nos Report Viewers destinados ao desenvolvimento de
web sites, que podem ser distribuídos através do Web Component Server ou
adicionados por meio de Controles de IntegraçãodeRelatórios.
Geralmente, os Report Viewers sãousadosnodesenvolvimentodeaplicativos,
ao elaborar aplicativos de N-camadas, que utilizam o Web Component Server e
oServidordeAutomatização de RDC como camada intermediária, e o Report
Viewer como parte da interface cliente do usuário. Para obter mais informações
sobre como usar as versões do ActiveX e Java Bean dos Report Viewers na
criação de aplicativos, consulte o Manual de Referência Técnica.
Guia do Administrador Web 57

Report Viewer para ActiveX
Report Viewer para ActiveX
Certificação AuthentiCode
O Report Viewer para ActiveX é um controle ActiveX que pode ser colocado
em uma página HTML e visualizado por meio de qualquer browser com
suporte para ActiveX. Como padrão, o Microsoft Internet Explorer versão3.02
e superior exibe relatórios com o Report Viewer para ActiveX.
Além disso, o Report Viewer para ActiveX pode ser usado em qualquer
ambiente de desenvolvimento com suporte para controles ActiveX. Para obter
mais informações sobre como usar o visualizador do ActiveX ao desenvolver
aplicativos, consulte o Manual de Referência Técnica.
Nota: O Report Viewer para ActiveX tem suporte para todos os tipos de
objetos (campo, texto, gráfico, OLE, Tabela de Referência Cruzada, subrelatório,
mapa, linha, caixa).
O Report Viewer para ActiveX é certificado pelo Microsoft AuthentiCode 2.0.
Essa certificação requer o Microsoft Internet Explorer 3.02 ou superior, para
abrir o controle ActiveX. Se você não tem uma versão recente do Internet
Explorer, recorra ao web site da Microsoft para atualizar ou use outro Report
Viewer ao elaborar os web sites.
Adicionando o Report Viewer a uma página da web
O browser do Microsoft Internet Explorer tem suporte para a marca OBJECT
em HTML. Essa marca pode ser utilizada para adicionar o Report Viewer para
ActiveX a uma página da web. Use um código semelhante ao seguinte:
Quando você instalar o Web Component Server, o Report Viewer para
ActiveX será instalado em:
\Program Files\Seagate Software\Viewers\ActiveXViewer
Além disso, um diretório virtual chamado:
/viewer
será configurado no servidor web, apontando para:
\Program Files\Seagate Software\Viewers
58 Guia do Administrador Web

Fazendo o download do Report Viewer a partir do servidor
6 : Report Viewers
ParaqueumbrowseruseumcontroleActiveXarmazenadonoservidorda
web, o browser deve fazer o download do controle a partir do servidor e
registrá-lo localmente. O atributo CODEBASE da marca OBJECT permite
especificar a localização do controle ActiveX original, em relação à página
atual. Por exemplo:
A primeira parte do valor do atributo CODEBASE indica a localização eo
nome de arquivo do controle ActiveX como um endereçodeURLemrelação
à página da web atual. O atributo Version, que aparece depois do símbolo #, é
opcional e permite especificar a versão doReportViewerparaActiveXque
será fornecida aos usuários. Se você especificar 1.0.0.0, a versão mais recente
disponível no servidor ou no cliente será automaticamente utilizada pelo
browser.
Ao abrir essa página pela primeira vez, o browser verifica primeiramente o
atributo CLASSID, para confirmar se o controle já está registrado no sistema
do cliente. Se não estiver,ouseonúmero da versão do visualizador for
anterior à do visualizador atual, registrado no sistema, o browser utilizará o
atributo CODEBASE para localizar e fazer o download do controle. Após o
download, o controle pode ser registrado e exibido pelo browser.
Parâmetros
O Report Viewer para ActiveX fornece vários parâmetros opcionais para
personalizar a aparência do visualizador e controlar sua funcionalidade.
Atribuavaloresaessesparâmetros, através da marca PARAM padrãono
código HTML.
DisplayGroupTree
Indica se a Árvore de Grupo será exibida quando o visualizador aparecer pela
primeira vez. Se o parâmetro Has Group Tree for definido como false (falso),
esse parâmetro será ignorado. Se a Árvore de Grupo estiver oculta, o usuário
poderá exibi-la clicando no botãoAlternarÁrvore de Grupo, no visualizador.
Um valor 1 (TRUE - Verdadeiro) exibe a ÁrvoredeGrupo.
Um valor 0 (FALSE - Falso) oculta a ÁrvoredeGrupo.
Guia do Administrador Web 59

Report Viewer para ActiveX
EnableAnimationControl
Indica se o visualizador exibirá o Controle de Animação. O Controle de
Animação é executado durante a criaçãoeodownloaddeumrelatório. Assim
que o relatório alcançar totalmente o browser cliente, a animaçãoserá
interrompida.
Um valor 1 (TRUE - Verdadeiro) exibe o Controle de Animação.
Um valor 0 (FALSE - Falso) impede a exibição doControledeAnimação.
EnableDrillDown
Indica se o usuário poderá analisar dados por valores de resumo em um
relatório de análise. Em um relatório de análise exibido no Report Viewer para
ActiveX, o ponteiro do mouse se transforma em uma lupa quando
posicionadosobrequalquergrupoouvalorapartirdoqualé possível
analisar. Clique duas vezes no grupo ou no valor para exibir uma guia
'Análise de Dados' separada, dentro do visualizador.
Um valor 1 (TRUE - Verdadeiro) indica a possibilidade de analisar pelos
relatórios.
Um valor 0 (FALSE - Falso) indica que o usuário não pode analisar pelos
relatórios.
EnableExportButton
Indica se o botão Exportarseráexibido ou nãonoReportViewer.Seobotão
Exportar for exibido, o usuário poderá exportar o relatório exibido para o
formato do Microsoft Word, Microsoft Excel, HTML 3.2 ou Seagate Crystal
Reports.
Um valor 1 (TRUE - Verdadeiro) exibe o botão Exportar.
Um valor 0 (FALSE - Falso) impede a exibição dobotão Exportar.
EnableGroupTree
Indica se o visualizador criará uma ÁrvoredeGrupoparaorelatório. Não
indica se a ÁrvoredeGruposerá exibida ou não. Se HasGroupTree for
definido com 0, ShowGroupTree será automaticamente definido com 0.
Um valor 1 (TRUE - Verdadeiro) gera uma ÁrvoredeGrupo.
Um valor 0 (FALSE - Falso) impede a criação deumaÁrvore de Grupo.
60 Guia do Administrador Web

6 : Report Viewers
EnablePrintButton
Indica se o usuário poderá imprimir o relatório em uma impressora. Quando
ousuário clicar no botão Imprimir, o relatório será enviado para uma
impressora de acordo com as definições especificadas na caixa de diálogo
Imprimir padrão. Se Has Print Button for definido com 0, não será possível
imprimir. Para obter mais informações, consulte “Imprimindo em Report
Viewers” na página 56.
Um valor 1 (TRUE - Verdadeiro) exibe o botão Imprimir.
Um valor 0 (FALSE - Falso) impede a exibição dobotão Imprimir.
EnableRefreshButton
Indica se existirá um botão Atualizar no visualizador, para que o usuário
atualize os dados do relatório.
Um valor 1 (TRUE - Verdadeiro) permite atualizar os dados do relatório.
Um valor 0 (FALSE - Falso) impede a atualização dos dados do relatório.
EnableSearchControl
O controle e o botão Busca, que aparecem no Report Viewer para ActiveX,
permitem que o usuário pesquise e salte facilmente para as ocorrências de um
valor ou um campo específico, exibido no relatório. O usuário digita o valor
pertinente na lista suspensa e clica no botão Busca para encontrar a primeira
ocorrência desse valor. Clicar no botão novamente localizará ocorrências
sucessivas do valor no relatório.
Um valor 1 (TRUE - Verdadeiro) exibe os controles de Busca.
Um valor 0 (FALSE - Falso) impede a exibição dos controles de Busca.
EnableZoomControl
Use o Controle de Zoom para alternar entre níveis de ampliação noReport
Viewer para ActiveX. Com o Controle de Zoom, é possível aumentar o
relatório em até 400% do tamanho original, ou reduzi-lo para 25% para ver
mais detalhes do relatório de uma vez.
Um valor 1 (TRUE - Verdadeiro) exibe o Controle de Zoom.
Um valor 0 (FALSE - Falso) impede a exibição doControledeZoom.
Guia do Administrador Web 61

Report Viewer para ActiveX
Incorporando o Report Viewer para Active X a uma página da web
Oseguintecódigo HTML demonstra um método de incorporar o Report
Viewer para ActiveX a uma página da web, por meio da marca OBJECT:

6 : Report Viewers
webSource.ReportSource = webBroker
webSource.URL = URL
webSource.PromptOnRefresh = True
CRViewer.ReportSource = webSource
end if
CRViewer.ViewReport
End Sub
-->
Este exemplo exibe uma Árvore de Grupo para permitir a Navegação
Inteligente. Além disso, o usuário pode analisar por relatórios sumário,
atualizar dados do relatório e imprimir o relatório.
Para obter informaçõessobreousodovisualizadordoActiveXdentrode
outros aplicativos e ambientes de desenvolvimento, consulte o Manual de
Referência Técnica.
Report Viewer para Java usando o Browser JVM
O Report Viewer para Java é um applet Java padrão,quepodesercolocado
dentro de uma página HTML e visualizado atravésdequalquerbrowsercom
suporte para Java. O Netscape Navigator (versão 2.0 e superior) exibe
relatórios usando o Report Viewer para Java, como padrão.
Nota: O Report Viewer para Java tem suporte somente para objetos linha
contínua e dupla.
Adicionando o Visualizador a uma página da web
Como um applet Java, o Report Viewer pode ser adicionado a uma página da
web por meio da marca APPLET de HTML padrão. O nome da classe pública
exibido pelo applet é Report Viewer. Portanto, o seguinte código exibe o
Report Viewer para Java:
Quando você instala o Seagate Crystal Reports ou o Web Component Server
Crystal, o visualizador do Java é instalado em:
\Program Files\Seagate Software\Viewers\JavaViewer
Guia do Administrador Web 63

Report Viewer para Java usando o Browser JVM
Além disso, um diretório virtual chamado
/viewer
é configuradonoservidorweb,apontandopara
\Program Files\Seagate Software\Viewers
O Report Viewer para Java fornece vários parâmetros opcionais para personalizar
aaparência do visualizador e controlar sua funcionalidade. Atribua valores a
esses parâmetros por meio da marca padrão PARAM no código HTML.
Parâmetros
O Report Viewer para Java oferece os seguintes parâmetros:
CanDrillDown
Indica se o usuário poderá analisar ou não por dados de resumo, gráficos ou
diagramas no relatório.
TRUE (Verdadeiro) permite análise.
FALSE (Falso) impede a análise.
HasExportButton
Indica se será exibido ou nãoumbotãoExportar no Report Viewer. O botão
Exportar permite exportar os relatórios exibidos no Report Viewer para o formato
do Microsoft Word, Microsoft Excel, HTML 3.2 ou Seagate Crystal Reports.
TRUE (Verdadeiro) permite a exportação.
FALSE (Falso) impede a exportação.
Para ignorar essa definição, use o aplicativo Crystal Report Web Components
Manager. Para obter mais informações, consulte “Guia Visualização de
Relatórios” na página 36.
HasGroupTree
Indica se o visualizador criará ou não umaÁrvore de Grupo para o relatório.
NãoindicaseaÁrvoredeGruposerá exibida ou não.
TRUE (Verdadeiro) cria uma ÁrvoredeGrupo.
FALSE (Falso) impede a criação deumaÁrvoredeGrupo.
HasPrintButton
Indica se o visualizador incluirá ou não umbotão Imprimir para permitir a
impressão dorelatório visualizado.
TRUE (Verdadeiro) permite impressão.
FALSE (Falso) impede a impressão.
Imprimir a partir do Report Viewer para Java requer um browser ou uma
Máquina Virtual Java com suporte para a versão 1.1 ou superior do Java
Developer’s Kit (JDK).
64 Guia do Administrador Web

6 : Report Viewers
HasRefreshButton
Indica se um botão Atualizar estará disponível ou não no visualizador, para
permitir a atualização dosdadosdorelatório.
TRUE (Verdadeiro) permite a atualização dos dados do relatório.
FALSE (Falso) impede a atualizaçãodosdadosdorelatório.
HasTextSearchControls
Indica se o visualizador incluirá controles para permitir a pesquisa de valores
específicos no relatório.
TRUE (Verdadeiro) permite pesquisa.
FALSE (Falso) impede a exibição dos controles de busca.
ReportName
Especifica o relatório a ser exibido no visualizador. O caminho deve ser um
URL existente no mesmo servidor em que se encontra o documento HTML e
deve ser colocado entre aspas.
ShowGroupTree
Indica se a ÁrvoredeGruposeráexibida ou não quandoovisualizadorfor
exibido pela primeira vez. Se o parâmetro HasGroupTree for definido como
FALSE (Falso), esse parâmetro será ignorado. Se a Árvore de Grupo estiver
oculta, o usuário poderá exibi-la clicando no botãoAlternarÁrvoredeGrupo,
no visualizador.
TRUE (Verdadeiro) exibe a ÁrvoredeGrupo.
FALSE (Falso) oculta a Árvore de Grupo.
Exemplo
Ocódigo a seguir demonstra um método de incorporar o Report Viewer para
Java em uma página da web. Esse código do JavaScript determina a versãodo
browser e depois instala a versão adequada do Report Viewer para Java.
=
0 && _info.indexOf("Mozilla/3") >= 0);
var _ns4 = (navigator.appName.indexOf("Netscape") >=
0 && _info.indexOf("Mozilla/4") >= 0 );
//-->

Report Viewer para Java usando o Browser JVM
code=com.seagatesoftware.img.ReportViewer.ReportViewer
codebase="/viewer/JavaViewer" id=ReportViewer
width=100% height=95%
archive="/viewer/JavaViewer/ReportViewer.zip">' );
else if (_ns4 == true)
document.writeln( '' );
else
document.writeln( '' );
//-->
Este exemplo exibe o relatório empprof.rpt na janela do Report Viewer para
Java. É gerada uma Árvore de Grupo para permitir a Navegação Inteligente
mas, inicialmente, ficará oculta. O visualizador não permite atualizar os dados
do relatório.
66 Guia do Administrador Web

Report Viewer para Java usando o Plug-in Java
6 : Report Viewers
O Report Viewer para Java usando o Plug-in Java tem suporte para o Netscape
2.0 e superior, assim como para o Internet Explorer 3.02 e superior.
Nota: O Report Viewer para Java usando o Plug-in tem suporte somente
para objetos linha contínua e dupla.
Report Viewer para Plug-in Netscape
O Report Viewer para Plug-in Netscape suporta o Netscape Navigator 3.0 e
superior.
Nota: O Report Viewer para Plug-in tem suporte somente para objetos linha
contínua e dupla.
Report Viewers para HTML
Limitações do relatório HTML
Há dois Report Viewers HTML distintos: um Report Viewer para HTML
Padrão com Molduras e um Report Viewer para HTML Padrão. Ambos são
utilizados nos padrões de HTML definidos pelo World Wide Web
Consortium (W3C).
Aprincipaldiferençaentre os dois visualizadores é que o Report Viewer para
HTML Padrão com Molduras permite a exibiçãodeumaÁrvoredeGrupoem
uma moldura separada, à esquerda do relatório. Essa ÁrvoredeGrupo
funcionacomoadaguiaPré-visualizar do Report Designer. O restante desta
seção é aplicável aos dois Report Viewers HTML.
Como o formato HTML 3.2 não fornecetodososrecursosdeformatação
disponíveis no formato de relatório do Seagate Crystal Reports, a conversão
de relatórios para HTML apresenta algumas limitações. As limitações serão
descritas a seguir.
Guia do Administrador Web 67

Report Viewers para HTML
Layout/posicionamento de objetos
Aconversão de HTML 3.2 preserva o posicionamento relativo de objetos e
campos. Contudo, o posicionamento absoluto, a altura e a largura dependem
do browser.
Objeto convertidos
Objeto Convertido/Não Convertido
Objetos Campo Sim
Objetos Texto Sim
Objetos Gráfico, Blob, Diagrama Sim, como imagens JPEG
Objetos OLE Sim, como imagens JPEG
Objetos Tabela de Referências
Cruzadas
Sim
Objetos Sub-relatório Sim
Sub-relatórios exigidos Não
Objetos Mapa Sim, como imagens JPEG
Objetos Linha e Caixa Sim com a DHTML
Nota: O HTML 4.0 tem suporte somente para objetos linha contínua e dupla.
As bordas pontilhadas e tracejadas são reconhecidas como linhas contínuas.
Objetos relatórios sobrepostos
AHTML3.2não tem suporte para a sobreposição. Os objetos relatório
parcialmente sobrepostos (até mesmo uma minúscula fração) sãoexibidos
lado a lado.
Bordas de objeto relatório
Se os quatro lados do objeto tiverem borda, será desenha uma caixa HTML ao
redordoobjetorelatório.
Se o lado superior ou inferior do objeto tiver uma borda, será desenhada uma
linha horizontal HTML acima ou abaixo do objeto, adequadamente (as bordas
verticais isoladas não são convertidas).
As linhas pontilhadas são exibidascomolinhassólidas.
As linhas duplas aparecem como linhas sólidas espessas.
Os sombreados são exibidos como uma caixa desenhada ao redor do objeto
relatório.
68 Guia do Administrador Web

6 : Report Viewers
Se a opção Horizontalmente comprimido estivermarcada,alarguradacaixa
HTML será a “larguraaproximadadoobjetorelatório” ou a “largura
aproximada dos dados”.
Se a opção Horizontalmente comprimido não estiver marcada, a largura da linha
horizontal HTML será a “largura do objeto relatório”.
Análise de Dados
Aanálise de dados de grupo é suportada.
Aanálise de dados de diagrama não é suportada.
Aanálise de dados de mapa não é suportada.
Guia do Administrador Web 69

Report Viewers para HTML
70 Guia do Administrador Web

Suporte do produto A
Este apêndice fornece informações sobre como entrar
em contato com a Seagate Software para registrar o
produto e como obter suporte técnico. E tambéminclui
detalhes sobre as políticas de devolução e substituição.
Guia do Administrador Web 71

Registro do Produto
Registro do Produto
Suporte do produto
Quando você utilizar o Seagate Crystal Reports pela primeira vez, será exibida
uma caixa de diálogo solicitando o seu nome, endereço einformações
relacionadas.Emseguida,vocêestará pronto para registrar o produto e
receber o seu Número de Registro.
Métodos de registro:
Se você tem acesso à Internet, preencha o formuláriodeRegistrodo
ProdutonoWebsitedaSeagateSoftwareem:
http://www.seagatesoftware.com/register
Ou acesse o formulário a partir do menu de Ajuda clicando em Registrar/
Modificar Endereço.
Imprima o formuláriodeRegistrodoProdutoeenvieporfaxparao
número de Fax para Registro mais perto de você.ASeagateiráenviar um
fax a você com o seu número de registro que poderá ser informado no
produto quando utilizá-lo da próxima vez.
Números de Fax para Registro
EUA/Canadá +1 (604) 681-5147
Reino Unido +44 (0) 181 231 0649
Austrália+6299557682
Hong Kong +852 2893 2727
Cingapura +65 777 8786
Preencha o Formulário de Registro e envie pelo correio à Seagate
Software. A Seagate irá enviar uma correspondênciaavocêcom o seu
número de registro para informar no produto.
O registro do programa permite que você se mantenha atualizado sobre os
avanços do programa, e permite que a Seagate ofereça suportetécnico de
qualidade para as pessoas que foram registradas adequadamente na Seagate
Software.
ApósinformaroseuNúmero de Registro, você já concluiu o processo de registro.
A Seagate Software se orgulha da qualidade de seus produtos e levou um
tempo considerável tentando tornar o uso desses produtos intuitivo. Se, no
entanto, você precisar de ajuda, consulte o sistema de Ajuda on-line. O sistema
de Ajuda pode ser acessado ao clicar em qualquer botão Ajuda, pressionando
a tecla F1 ou selecionando uma opção a partir do menu Ajuda. O sistema de
Ajuda contém todas as informações do Guia do Usuário, bem como
explicações detalhadas e exemplos de todos os conceitos sobre relatório.
72 Guia do Administrador Web

Suporte via Web
Web site da Seagate Software
A : Suporte do produto
Nota: Os planos de suporte do produto variam de acordo com a região.
Entre em contato com o Escritório/distribuidor da Seagate Software para
obter uma lista dos planos de suporte do produto disponíveis na sua região.
Para conectar-se ao Web site da Seagate Software
1 Clique em Ajuda.
2 Selecione Seagate Software na Web.
3 Clique em Home Page da Seagate Software.
Ou digite o seguinte endereço noseubrowser:
http://support.seagatesoftware.com
Nota: “ support” substitui “www” no endereço daWeb.
Suporte para produtos da Seagate Software
ApáginadaWebdeSuporteparaprodutosdaSeagateSoftwarefornece
vários métodos de suporte, como por exemplo Respostas por E-mail,
Arquivos e Atualizações, Fóruns e a Seagate Knowledge Base.
Para conectar-se à página da Web de Suporte para produtos da
Seagate Software
1 Clique em Ajuda.
2 Selecione Seagate Software na Web.
3 Clique em Suporte On-line.
Ou digite o seguinte endereço noseubrowser:
http://support.seagatesoftware.com/support
Nota: “ support” substitui “www” no endereço daWeb.
Guia do Administrador Web 73

Suporte via E-mail
Suporte via E-mail
E-mail
Suporte via Fax
Suporte técnico
answers@seagatesoftware.com
Para enviar por e-mail uma pergunta ao Suporte Técnico:
Envieume-mailembrancoparaoendereçoacima. Deixe tudo em branco
e o sistema irá retornar a você um formulário para preencher.
Serviço de Newsletter
http://community.seagatesoftware.com/myprofile/subscribe.asp
OServiçodeNewsletter da Seagate Software fornece aos assinantes as
informações sobre atualizações de produtos, eventos e novas versões
dos produtos.
Cada produto selecionado irá adicionar seu endereçodee-mailaum
determinado tópico do grupo de newsletter. Você pode selecionar
vários produtos e também informações técnicas e de marketing. Em
seguida, você visualizará uma página de confirmação que solicita a
verificaçãodesuasinformações. Você pode cancelar a assinatura de
qualquer lista a qualquer momento.
Uma outra forma de receber suporte do Seagate Crystal Reports é enviar um fax
ao suporte técnico. Para isso, preencha primeiro a parte inferior do formulário
de SolicitaçãodeSuporteTécnico incluído no produto. Esse formulário é
exibido quando você seleciona SolicitaçãodeSuporteTécnico a partir do menu
Ajuda. Apóspreencheroformulário, clique em Imprimir Solicitação.
Envie por fax o formulário preenchido à Seagate Software pelo +1 (604) 681-
7163. Esse serviçoestádisponível de segunda à sexta (24 horas por dia).
Um especialista do suporte técnico verifica o seu fax e, em seguida, responde
enviando um fax a você nos próximos dias.
A Seagate Software oferece vários níveis de suporte por telefone para o
Seagate Crystal Reports.
74 Guia do Administrador Web

Suporte Técnico Prioritário
A : Suporte do produto
OSuporteTécnico Prioritário do Seagate Crystal Reports foi projetado para
fornecer respostas de acordo com a fila de prioridades enquanto economiza
seu dinheiro com chamadas interurbanas ou internacionais.
Número para ligação gratuita**
Respostaachamadaprioritária
Chamadas longas **
Serviços on-line para suporte 24 horas
Contrato de um ano
Número para ligação gratuita **
Permite acesso ilimitado a um número para ligação gratuita e economiza
dinheiro de chamadas interurbanas.
Resposta prioritária a chamada
Garantimos respostas o mais rápido possível para incidentes no Suporte
Prioritário.TodasaschamadasparaoSuportePrioritário têm prioridadeem
relação às chamadasaoSuportePadrão.
Chamadas longas **
As chamadas longas permitem que o usuário obtenha as respostas necessárias
no tempo certo. As chamadas longas estãodisponíveis de segunda à sexta de
8:00am - 8:00pm, nos Estados Unidos.
Serviços on-line para suporte 24 horas
A Seagate Software fornece ferramentas para que você sozinho possa obter as
respostas rápidasparaasperguntastécnicas. Nós temosumnúmero de
serviços on-line de suporte ilimitado via e-mail e Web, 24 horas por dias, 7
dias na semana.
Contrato de um ano
Inscreva-se no Suporte Prioritário do Seagate Crystal para obter o contrato de
um ano a partir da data de compra.
**A disponibilidade de números gratuitos e horários de chamadas longas
variam de acordo com a região.
Guia do Administrador Web 75

Suporte técnico
Suporte Técnico padrão
Para entrar em contato conosco
Para obter mais informações, ou para adquirir o Suporte PrioritáriodoSeagate
Crystal, visite nosso Web site em http://www.seagatesoftware.com ou entre
emcontatocomoescritório mais perto de você.
Canadá/EUA: 1-800-877-2340 ou 1-604-681-3435
Europa/Oriente Médio/África: +44-181-566-2330
Ásia/Pacífico: +61-2-9955-4088
A Seagate oferece suporte através deumnúmerode telefone gratuito, e-mail
efaxparaosusuários do Seagate Crystal Reports durante o horário comercial,
de segunda à sexta. O Suporte Padrão é gratuito* para todos os usuários
registrados. É recomendável registrar o seu produto para garantir acesso aos
nossos serviços de suporte técnico.
*O suporte técnico gratuito está disponívelpor60diasapartirdadatade
compra.
Localização Dias Horários
América do Norte
+1 (604) 669-8379
S-S 11:00am - 7:00pm EST
Áustria
+ 43 (0) 1 79 5672 85
S-S 9:30am - 5:00pm CET
Bélgica
+ 32 (0) 2 713 12 35
S-S 9:30am - 5:00pm CET
França
+33 (0) 141 918630
S-S 9:30am - 5:00pm CET
Alemanha
+49 (0) 699 509 6180
S-S 9:30am - 5:00pm CET
Irlanda
+ 353 (0) 1 407 30 30
Holanda
+ 31 (0) 20 346 9201
Suécia
+ 46 (0) 85 87 711 45
Suíça (Alemã)
+ 41 (0) 1 800 9134
Suíça (Francesa)
+ 41 (0) 1 800 9130
Reino Unido
+44 (0) 181 231 0638
S-S 9:00am - 4:00pm GMT
S-S 10:00am - 5:00pm CET
S-S 10:00am - 5:00pm CET
S-S 9:30am - 5:00pm CET
S-S 9:30am - 5:00pm CET
S-S 9:00am - 4:00pm GMT
76 Guia do Administrador Web

A : Suporte do produto
Nota: Podem ser aplicadas taxas de longa distância. Os números dos
telefones variam de acordo com a localização.
Se o paísdoqualvocêestá ligando nãoestánalista acima, ligue para o número
do Suporte Técnico Padrão daAmérica do Norte pelo +1 (604) 669-8379.
Tenha em mãos as seguintes informações:
Número de registro do produto.
Se estiver registrado, você pode localizar o número de registro do produto
selecionando Sobre o Crystal Report Designer a partir do menu Ajuda.
Se você não estiver registrado, será necessário fazer o registro para obter o
número de registro do produto.
Nome do produto e número da versão.
A partir do menu Ajuda, clique em Sobre o Seagate Crystal Reports.
Sistema operacional que você utiliza.
Por exemplo, Windows 95, Windows 98, Windows NT ou Windows 3.11.
Versão do banco de dados e outro software que você utilize com o
Seagate Crystal Reports (se necessário).
Access,Btrieve,SQL,Sybase,Paradoxetc.
Informações sobre a rede, se você estiver conectado a uma rede.
Conteúdo dos arquivos AUTOEXEC.BAT e CONFIG.SYS.
A lista das etapas necessárias para recriar o problema.
Oambientedeprogramação (sehouver).
Seagate Knowledge Link
Os nossos especialistas do suporte técnico do produto da Seagate Software
criaram o Seagate Knowledge Link - nosso banco de dados pesquisável com
artigos de referência técnica. Enviado em CD, esse aplicativo inclui uma
biblioteca básica de artigos que podem ajudar usuários principiantes e
experientes a solucionar problemas técnicos. O Seagate Knowledge Link
inclui 12 meses de Technotes distribuídos quinzenalmente via e-mail.
Para entrar em contato conosco
Para obter mais informações, ou para adquirir o Seagate Knowledge Link,
visite o nosso Web site em http://www.seagatesoftware.com ou entre em
contatocomoescritório mais perto de você.
Guia do Administrador Web 77

Política de devolução do produto
Política de devolução do produto
Se você não estiver satisfeito com o Seagate Crystal Reports por qualquer
motivo, você pode devolvê-lo ao local original de compra para reembolso
dentro de 30 dias da data de compra.
Política de substituição do produto
Se o CD ou a documentação do Seagate Crystal Reports estiver com problema,
entre em contato com a Seagate Software, Inc., dentro de 30 dias da data de
compra. Envie um fax descrevendo o problema e a Seagate irá solucioná-loomais
rápido possível. Envie um fax com a descrição do defeito para +1 (604) 681-2934.
Nota: As políticas de substituição variamdeacordocomaregião. Entre em
contato com o distribuidor local para obter uma lista das políticas de
substituição disponíveis na sua região.
78 Guia do Administrador Web

Índice
A
acesso
Crystal Report Web Components Manager......34
ActiveX
Report Viewer......................................................58
administração
Guia Configurações do Cache ..........................40
Guia Extensões de Arquivos ..............................35
Guia Servidor de Páginas ...................................38
Guia Visualização de Relatórios .......................36
Guia Web Component Server ...........................34
aplicativos
registrar ................................................................72
usando Report Viewers em ................................57
arquivos instalados.....................................................24
Árvore de Grupos.......................................................16
atalhos de teclado ........................................................3
AuthentiCode
certificação ..........................................................58
B
bancos de dados
ODBC...................................................................45
seguros .................................................................45
SQL .......................................................................45
C
certificação AuthentiCode.........................................58
comandos
exportação de relatórios.....................................50
formato de exportação de relatório ..................51
GF .........................................................................45
INIT.......................................................................43
nova sintaxe.........................................................48
Password#............................................................46
Prompt#................................................................49
PromptOnRefresh# .............................................50
SF ..........................................................................45
solicitações de relatórios....................................42
USER# ..................................................................47
Web Component Server .....................................42
combinações de teclas ................................................3
configuração
Microsoft Internet Information Server 4.0 ........28
Servidor Netscape ...............................................28
controles de caixa de diálogo.....................................3
convenções
botões .................................................................... 3
comandos.............................................................. 3
controles................................................................ 3
Crystal Report Web Components Manager
acesso .................................................................. 34
Guia Configurações do Cache.......................... 40
Guia Extensões de Arquivos.............................. 35
Guia Servidor de Páginas .................................. 38
Guia Visualização de Relatórios ...................... 36
Guia Web Component Server........................... 34
D
dados
salvar com relatório ........................................... 16
dados de relatórios da Web
atualização.......................................................... 51
diretórios virtuais
Web Component Server .................................... 29
E
especificando
Report Viewer..................................................... 31
F
Formato de Relatório HTML..................................... 13
fórmulas de seleção de grupos
comando GF ....................................................... 45
comando SF ........................................................ 45
modificar relatórios da Web ............................. 44
G
Guia Configurações do Cache................................. 40
Guia Extensões de Arquivos..................................... 35
Guia Servidor de Páginas ......................................... 38
Guia Visualização de Relatórios.............................. 36
Guia Web Component Server.................................. 34
H
HTML
Report Viewer para ............................................ 67
I
IDs de usuário
comando USER# ................................................ 47
impressão
Web Reporting Administrator’s Guide Índice-79

no Report Viewers ..............................................56
impressora padrão
configurando usando Serviços NT ....................25
instalação
arquivos instalados .............................................24
garantindo êxito ..................................................27
Web Component Server .....................................21
J
Java usando browser JVM
adicionar visualizador a uma página da web..63
Java usando o browser JVM
Report Viewer......................................................63
Java usando o Plug-in Java
Report Viewer......................................................67
K
Knowledge Link..........................................................77
L
logon
comando Password# ..........................................46
comando USER# .................................................47
M
Microsoft
AuthentiCode ......................................................58
Microsoft Internet Information Server 4.0
configuração........................................................28
P
padrões
Report Viewer......................................................56
Page Server
armazenamento de páginas em cache .............14
compartilhamento de trabalhos ........................14
Formato do Page Server .....................................14
visão geral............................................................14
página da web
adicionando um Report Viewer ........................58
incorporar Report Viewer para ActiveX a ........62
parâmetros
comando GF........................................................45
comando Prompt# ..............................................49
Report Viewer para ActiveX ..............................59
Report Viewer para Java.....................................64
Plug-in Netscape
Report Viewer para.............................................67
política de devolução ................................................78
política de substituição..............................................78
procedimentos armazenados, SQL
consulte SQL .......................................................48
R
recursos
na Versão 8 ........................................................... 8
Report Viewer..................................................... 54
registro do produto .................................................... 72
relatório HTML
limitações ............................................................ 67
relatórios
exportar ............................................................... 50
relatórios da Web
atualização de dados ......................................... 51
modificar fórmulas de seleção em ................... 44
Report Viewer
adicionando a uma página da web.................. 58
download a partir do servidor .......................... 59
especificando...................................................... 31
imprimindo em................................................... 56
padrões ................................................................ 56
para ActiveX........................................................ 58
para ActiveX, incorporar a uma página da web62
para HTML .......................................................... 67
para Java usando o browser JVM...................... 63
para Java usando o Plug-in Java ....................... 67
para Plug-in Netscape........................................ 67
parâmetros do ActiveX....................................... 59
parâmetros para Java.......................................... 64
recursos ............................................................... 54
usando em aplicativos ....................................... 57
visão geral ..................................................... 12, 54
requisitos do sistema
Web Component Server .................................... 21
S
senhas
comando Password#.......................................... 46
Serviços NT
configurando para a impressora padrão .......... 25
Servidor Netscape
configuração ....................................................... 28
Servidor web
visão geral ........................................................... 12
site na Web
criando................................................................. 29
software
registrar................................................................ 72
solicitação de relatórios
etapas................................................................... 11
visão geral ........................................................... 10
SQL
bancos de dados e Web Report Server ............ 45
procedimentos armazenados............................ 48
suporte técnico
e-mail................................................................... 74
fax......................................................................... 74
telefone................................................................ 74
Web site............................................................... 73
Índice-80 Web Reporting Administrator’s Guide

T
teclas
combinações .........................................................3
V
visualizador
Java usando o browser JVM...............................63
W
Web Component Server ............................................12
administração ......................................................34
comandos ............................................................42
diretórios virtuais ................................................29
implementação....................................................20
instalação.............................................................21
requisitos do sistema ..........................................21
visão geral............................................................12
Web site ......................................................................73
Web Reporting Administrator’s Guide Índice-81

Índice-82 Web Reporting Administrator’s Guide