Rio de Janeiro, janeiro de 2007.

Transcrição

1 INTERNO ORACLE DEVELOPER 6i REPORTS Rio de Janeiro, janeiro de As informações contidas neste documento pertencem à Value Team Brasil S/C Ltda e ao destinatário do documento. Cópia, publicação ou distribuição não-autorizada deste material são práticas estritamente proibidas e podem ser ilegais. Value Team Brasil S/C Ltda V A L U E P A R T N E R S G R O U P Rua da Cadenlária Tel º andar Fax Rio de Janeiro RJ - Brasil

2 CAPÍTULO 1: O ORACLE DEVELOPER 6I... 1 SOBRE O PACOTE...1 RESUMINDO...2 SOBRE A FERRAMENTA...3 CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6I... 4 CONCEITOS INICIAIS...4 O NAVEGADOR DE OBJETOS (OBJECT NAVIGATOR)... 5 EXPANDIR OU CONTRAIR...6 CRIAR OU DELETAR...6 EXECUTAR, IMPRIMIR E MENSAGEM...7 ABRIR E SALVAR...7 LOCALIZAR...8 NAVEGANDO NA HIERARQUIA...8 PAINÉIS DO NAVEGADOR...8 ALTERANDO O NOME DE UM ELEMENTO...8 O MENU DO REPORT BUILDER...9 CRIANDO UMA APLICAÇÃO...9 ESTABELECENDO CONEXÃO COM O BANCO DE DADOS...9 ESTILO DO RELATÓRIO...9 QUERY BUILDER - TABELAS...10 QUERY BUILDER DIÁLOGO PRINCIPAL...11 QUERY BUILDER COLUNAS...11 QUERY BUILDER SQL...12 QUERY BUILDER DEFININDO UMA COLUNA...13 QUERY BUILDER ORDENANDO O RESULTADO...13 QUERY BUILDER ALIAS...14 QUERY BUILDER - INCLUINDO UMA RESTRIÇÃO...14 PASTA CAMPOS(FIELDS)...15 PASTA TOTAIS (TOTALS)...15 PASTA ETIQUETAS (LABELS)...16 PASTA GABARITO (TEMPLATE)...16 CAPÍTULO 3: O DATA MODEL COMPONENTES DE UM RELATÓRIO O EDITOR DO MODELO DE DADOS A PALETA DE FERRAMENTAS...18 A BARRA DE FERRAMENTAS...19 A BARRA DE STATUS...19 CRIANDO UMA CONSULTA CONSULTA (QUERY)...20 GRUPO (GROUP)...21 COLUNAS DO BANCO DE DADOS...22 CRIANDO UM LAYOUT CRIANDO UM GRUPO DE QUEBRA RELACIONANDO DADOS CRIANDO UM RELATÓRIO A PARTIR DE UMA VARIÁVEL CURSOR...28 CAPÍTULO 4: SUMÁRIOS E FÓRMULAS SUMÁRIOS DETERMINANDO A FREQÜÊNCIA DE IMPRESSÃO...29 DETERMINANDO A FUNÇÃO DO SUMÁRIO...31 DETERMINANDO A COLUNA ORIGEM DO SUMÁRIO...31 QUANDO ZERAR O SUMÁRIO...32 DETERMINANDO O GRUPO DE TOTALIZAÇÃO...33 FÓRMULAS DETERMINANDO A FREQÜÊNCIA DE IMPRESSÃO...34 DETERMINANDO O TIPO DE RETORNO...34 DETERMINANDO A FUNÇÃO DA FÓRMULA...35 ÍNDICE I

3 CAPÍTULO 5: PARÂMETROS CONCEITUAÇÃO...37 PARÂMETROS DE SISTEMA BACKGROUND...37 COPIES...37 CURRENCY...37 DECIMAL...37 DESFORMAT...37 DESNAME...38 DESTYPE...38 MODE...38 ORIENTATION...38 PRINTJOB...38 THOUSANDS...38 PARÂMETROS DE USUÁRIO BIND REFERENCE...39 LISTA DE VALORES...40 LEXICAL REFERENCE...42 CRIANDO UMA TELA DE PARÂMETROS USANDO UM CRIADOR AUTOMÁTICO...44 CAPÍTULO 6: OS PRIMEIROS OBJETOS DO LAYOUT INTRODUÇÃO QUADROS DE REPETIÇÃO (REPEATING FRAMES) CAMPOS (FIELDS) BOILERPLATES...51 CAMADAS DE IMPRESSÃO FREQÜÊNCIA DE IMPRESSÃO ELASTICIDADE CAPÍTULO 7: O EDITOR DO LAYOUT MODEL A JANELA DO EDITOR DE LAYOUT WORKSPACE...58 BARRA DE TÍTULO (TITLE BAR)...58 RÉGUAS (RULERS)...58 GUIAS...58 GRID...58 LINHA INDICATIVA DE SITUAÇÃO (STATUS LINE)...59 AS BARRAS DE FERRAMENTAS A BARRA DE FERRAMENTAS HORIZONTAL SUPERIOR...60 A BARRA DE FERRAMENTAS HORIZONTAL INFERIOR (BARRA DE ESTILO)...61 A BARRA DE FERRAMENTAS VERTICAL OU PALETA DE FERRAMENTAS...62 MANIPULANDO OBJETOS NO EDITOR DE LAYOUT CRIANDO OBJETOS...64 MOVER OBJETOS...64 REDIMENSIONANDO UM OBJETO...64 REDIMENSIONANDO DIVERSOS OBJETOS...64 ALINHANDO OBJETOS...64 OBTER AS PROPRIEDADES DE UM OBJETO...65 MANIPULANDO BOILERPLATES NO EDITOR DE LAYOUT BOILERPLATE DE TEXTO...65 BOILERPLATE GRÁFICO...65 AÇÕES COMUNS AOS OBJETOS DE LAYOUT ATRIBUINDO FONTE...66 MODIFICANDO A LINHA...66 ALINHAMENTO E ESPACEJAMENTO...66 SELEÇÃO DE UM OU VÁRIOS OBJETOS...66 OPERAÇÕES...66 GRUPANDO OBJETOS...67 ÍNDICE II

4 NAVEGANDO PELAS DIVERSAS PARTES DE UM RELATÓRIO...68 MÚLTIPLOS LAYOUTS...69 INCLUINDO DATA / HORA E NUMERAÇÃO DE PÁGINA...70 IMPORTANDO ARQUIVOS PARA O LAYOUT ADICIONANDO UM BOILERPLATE POR UM ARQUIVO DE LIGAÇÃO (LINKED FILE)...71 CAPÍTULO 8: PL/SQL NO RELATÓRIO CONCEITOS INICIAIS...72 EDIÇÃO DE PL/SQL INDENTAÇÃO AUTOMÁTICA...73 INDENTAÇÃO MANUAL...73 CORES...73 SELEÇÃO...73 CÓPIA E MOVIMENTAÇÃO DE TEXTOS...73 SPLIT DA ÁREA DE EDIÇÃO...74 IMPRESSÃO, EXPORTAÇÃO E IMPORTAÇÃO...74 OPÇÃO DESFAZER...74 PALETA DE SINTAXE PL/SQL INTRÍNSECA FILTROS DE GRUPO (GROUP FILTERS)...75 GATILHOS DE VALIDAÇÃO (VALIDATION TRIGGERS)...76 FÓRMULA (FORMULA)...77 GATILHOS DE FORMATO (FORMAT TRIGGER)...77 PL/SQL INTERNA PL/SQL EXTERNA ROTINAS ARMAZENADAS NO BANCO DE DADOS...80 ROTINAS ARMAZENADAS EM BIBLIOTECAS (LIBRARIES)...81 GATILHOS DE RELATÓRIO (REPORT TRIGGERS) EMPACOTAMENTO DA LÓGICA DATABASE TRIGGERS CAPÍTULO 9: MAIS OBJETOS DO LAYOUT INTRODUÇÃO VISUALIZANDO AS INFORMAÇÕES DE ANCORAGEM ÂNCORAS (ANCHORS) QUADROS (FRAMES) BOTÕES (BUTTONS) CAPÍTULO 10: PACOTES EMBUTIDOS O NÓ PACOTES EMBUTIDOS SRW...92 OLE DDE...92 ORA_FFI...93 ORA_DE...93 ORA_PROF ORA_NLS...95 TEXT_IO...95 TOOL_ENV...96 TOOL_RES TOOL_ERR...96 STPROC...97 LIST...97 DEBUG...97 STANDARD ÍNDICE III

5 CAPÍTULO 11: VARIÁVEIS NO REPORT BUILDER INTRODUÇÃO VARIÁVEIS LOCAIS COLUNA DE ESPAÇO RESERVADO (PLACEHOLDER) VARIÁVEIS DE PACOTE PARÂMETROS CAPÍTULO 12: FORMATAÇÃO DINÂMICA CONCEITOS INICIAIS ALGUMAS ROTINAS DO PACOTE SRW COR CAPÍTULO 13: CARACTERÍSTICAS GERAIS PREFERÊNCIAS PASTA GERAL PASTA ACESSAR PASTA ASSISTENTES PASTA VALORES DE RUNTIME PASTA DEFINIÇÕES DE RUNTIME ESTUDANDO O MÓDULO RELATÓRIO (REPORT) JANELA DE FORM DE PARÂMETROS (PARAMETER FORM WINDOW) ESCAPES DE RELATÓRIO (REPORT ESCAPES) MODO CARACTER (CHARACTER MODE) CAPÍTULO 14: DISTRIBUINDO E DELIMITANDO CAPACIDADE DE DISTRIBUIÇÃO USO DE DELIMITADORES USANDO O REPORT BUILDER USANDO A LINHA DE COMANDO CAPÍTULO 15: RELATÓRIOS MATRICIAIS CONCEITOS SIMPLE MATRIX COM UMA QUERY SIMPLE MATRIX COM TRÊS QUERIES SIMPLE MATRIX COM SUMÁRIO NESTED MATRIX CROSS PRODUCT MASTER/DETAIL MODELO DE DADOS LAYOUT MATRIX BREAK MODELO DE DADOS LAYOUT CAPÍTULO16: O ORACLE 8I E O REPORT BUILDER 6I SUPORTE A LARGE OBJECTS (LOBS) SUPORTE A OBJETOS DO ORACLE CARACTERÍSTICAS DE PERFORMANCE PERFORMANCE COM O ORACLE SUPORTE AO PL/SQL INTEGRAÇÃO COM FERRAMENTAS DE SUPORTE A DECISÃO CAPÍTULO 17: O MÓDULO LIBRARY INTRODUÇÃO CRIANDO UMA BIBLIOTECA (LIBRARY) ASSOCIANDO UMA BIBLIOTECA A UMA APLICAÇÃO CONSIDERAÇÕES SOBRE ARMAZENAMENTO CAPÍTULO 18: GABARITOS (TEMPLATES) ÍNDICE IV

6 DESCRIÇÃO A ESTRUTURA DE UM GABARITO MODELO DE DADOS PL/SQL NO GABARITO LAYOUT AS SEÇÕES DO CORPO SEÇÃO DEFAULT SEÇÃO DE SOBREPOSIÇÃO (OVERRIDE SECTION) PROPRIEDADES DE UMA SEÇÃO GRUPO LAYOUT GRUPO ESPAÇAMENTO GRUPO ESTILO PROPRIEDADES DO NÓ CABEÇALHO DA SEÇÃO PROPRIEDADES DO NÓ CORPO DA SEÇÃO PROPRIEDADES DO NÓ SUMÁRIO DA SEÇÃO MONTANDO UM GABARITO (TEMPLATE) SEÇÃO DEFAULT CABEÇALHOS(HEADINGS) CORPO (BODY) SUMÁRIOS (SUMMARY) USANDO O GABARITO CRIADO CAPÍTULO 19: INTERPRETER DESCRIÇÃO A JANELA DE DEPURAÇÃO MARCANDO UM PONTO DE INTERRUPÇÃO BREAKPOINT TRIGGER ACOMPANHANDO UMA DEPURAÇÃO DEPURANDO COM UM PONTO DE INTERRUPÇÃO CAPÍTULO 20: HTML / PDF DESENVOLVENDO UM RELATÓRIO PARA WEB O PREVISUALIZADOR DA WEB HTML PAGE STREAMING NAVEGAÇÃO FORMATO DOS ARQUIVOS GERADOS PARÂMETRO EXEMPLO USANDO SCRIPT DEFAULT EXEMPLO USANDO NOSSO SCRIPT OUTRAS ROTINAS DO PACOTE SRW CHART HYPERLINKS CAPÍTULO 21: INTERFACE FORMS REPORT USANDO O REPORT BUILDER A PARTIR DO FORM BUILDER ACIONANDO UM REPORT A PARTIR DO FORM ÍNDICE V

7 CAPÍTULO 1: O ORACLE DEVELOPER 6I Neste curso estudaremos a ferramenta de desenvolvimento Report Builder 6i que faz parte do pacote de ferramentas para desenvolvimento chamado Oracle Developer 6i. Iniciaremos nosso estudo com informações sobre este pacote, em seguida informações gerais sobre a ferramenta ora em estudo e, na seqüência, trabalharemos com a ferramenta em diversos exemplos e exercícios. Sobre o Pacote O Report Builder faz parte do mesmo pacote de desenvolvimento de sistemas que o Form Builder. O nome deste pacote, como sabemos, é Oracle Developer 6i. Resumiremos as ferramentas que compõem este pacote: Form Builder É a ferramenta para a construção de aplicações online para acesso e atualização de uma base de dados Oracle. Report Builder É a ferramenta para a construções de relatórios que façam acesso a uma base de dados Oracle. Os relatórios podem ser construídos em uma diversidade de formatos desde tabular (como uma tabela) até matricial, passando por etiqueta, carta, formulário, master/detail ou uma combinação de estilos. Procedure Builder É a ferramenta que nos auxilia no desenvolvimento de programas PL/SQL, tanto no ambiente cliente (em bibliotecas de programas compartilhadas por aplicações Forms ou Reports) quanto no ambiente servidor (criação de procedures, functions, packages e database triggers), permitindo uma depuração passo a passo das aplicações criadas. Graphics Builder É a ferramenta que permite que visualizemos os dados do banco de dados de forma gráfica. Os produtos gerados por esta ferramenta podem ser utilizados em aplicações Forms ou Reports. Project Builder Esta é uma ferramenta integradora e organizadora. Permite que associemos as diversas aplicações que componham um projeto de desenvolvimento em uma hierarquia manipulável. Projetos são associações de arquivos com as ferramentas usadas para editá-los. Estes arquivos podem ser de qualquer tipo : forms, reports, displays (gráficos), módulos de 3GL, documentação e scripts de teste. O grupamento e visualização de todos os componentes de um projeto é apenas uma das vantagens. A ferramenta permite também ações coletivas, como por exemplo uma compilação. Query Builder É uma ferramenta auxiliar na construção de consultas ao banco de dados. Possui uma interface gráfica e intuitiva que nos permite rápida e facilmente a montagem de queries para a recuperação de informações. CAPÍTULO 1: O ORACLE DEVELOPER 6.0-1

8 Schema Builder Esta ferramenta nos auxilia na criação, cópia, modificação e remoção de objetos (e relacionamentos) do banco de dados. Translation Builder Esta é uma ferramenta para suporte e gerenciamento no processo de conversão de aplicações Oracle para uma das linguagens suportadas. Suporta a conversão de arquivos do tipo.fmb,.ogd,.rdf,.res e.msg. RESUMINDO O pacote Oracle Developer 6i contém ferramentas que abrangem todas as áreas necessárias ao desenvolvimento de um sistema: aplicações online, batch, relatórios, gráficos e, ainda, uma ferramenta para controle do ambiente. CAPÍTULO 1: O ORACLE DEVELOPER 6.0-2

9 Sobre a Ferramenta Ao desenvolvermos um relatório, em qualquer ferramenta, claramente identificamos duas áreas principais de trabalho: a parte de obtenção dos dados e a parte de especificação do layout. A ferramenta que estudaremos a seguir possui estas duas área ou estes dois conceitos bastante bem definidos, o que nos facilitará bastante o estudo. Da mesma forma que o Form Builder, o Report Builder não é uma ferramenta isolada, é composta de vários executáveis com finalidades diversas. Destacaremos aqueles que mais afetam o nosso estudo: Report Builder 6i (RWBLD60.EXE) - Este é o aplicativo para desenvolvimento e compilação individual de um relatório. Gera arquivos de quatro categorias: RDF / REP (fonte e executável Report), SQL (fonte de uma consulta externa), PLL (PL/SQL Library) e TDF (Template). Report Compiler 6i (antigo Convert RWCON60.EXE) - Este aplicativo permite a conversão de relatórios construídos em Reports 2.5 ou 3.0 para Report 6i (versão atual), convertendo a PL/SQL versão 1.0 ou 2.3 para a versão 8. Permite também a compilação em batch de lotes de programas e, finalmente, a conversão da forma de armazenamento (fonte de relatório armazenado no banco de dados para fonte, template ou executável de relatório em disco; fonte no disco para fonte armazenado no banco de dados). Os fontes tanto podem ser de relatórios quanto de bibliotecas. Report Runtime 6i (RWRUN60.EXE) Este é o aplicativo para execução dos relatórios desenvolvidos (Reports e Libraries PL/SQL). Durante este curso trataremos da construção, compilação e teste de relatórios. Desta forma trabalharemos basicamente com o Report Builder e o Report Runtime. O curso será todo desenvolvido através de exemplos distribuídos aos alunos. CAPÍTULO 1: O ORACLE DEVELOPER 6.0-3

10 CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6I Conceitos Iniciais A ferramenta Report Builder é capaz de construir quatro tipos de módulos diferentes: Módulo Report Que consiste do relatório em si, contendo áreas para obtenção dos dados, definição do layout, parâmetros, etc. O fonte de um módulo Report possui a extensão RDF e o executável REP. Consulta SQL Externa Que consiste de um comando de SQL Select armazenado externamente ao relatório e que pode ser utilizado como fonte de obtenção de dados para mais de um relatório. O arquivo contendo este comando possui a extensão SQL. Módulo PL/SQL Library Que consiste de um conjunto de programas PL/SQL que podem ser compartilhados por diversas aplicações Report ( ou Form ) que executam no ambiente. Possui apenas um tipo de arquivo cuja extensão é PLL. Módulo Template Que consiste de um esqueleto de relatório a ser utilizado como origem para diversos relatórios padronizados da instalação. É um gabarito utilizado como origem para outros relatórios. Durante este estudo trataremos de cada um destes módulos individualmente a fim de analisarmos suas características e usos. Ativando o Report Builder Para acionarmos a execução do Report Builder, devemos usar o botão Iniciar do Windows, pasta Programas, pasta Oracle Developer 6i e escolher a opção Report Builder. A primeira tela apresentada contém um conjunto de opções para iniciarmos a construção dos relatórios sob o grupo "Projetando" e um outro conjunto de opções de apresentação da ferramenta sob o grupo "Fixando na memória". Antes de construirmos nosso primeiro relatório veremos como navegar dentro da ferramenta. Por este motivo escolheremos a opção Desenvolver um novo relatório manualmente. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-4

11 O Navegador de Objetos (Object Navigator) Ao escolhermos a opção Criar um novo relatório manualmente, nos é apresentada uma tela com duas janelas: uma janela do Editor de Relatórios Modelo de Dados e uma segunda janela chamada de Navegador de Objetos ou Object Navigator. Estudaremos, inicialmente, o Navegador de Objetos, que nos dá uma visão de todos os componentes da ferramenta e das aplicações criadas. Fecharemos, portanto, a janela do Editor de Relatórios Modelo de Dados e nos concentraremos na janela do Navegador. A cada objeto criado por esta ferramenta daremos o nome genérico de Módulo, portanto, um relatório será tratado ou considerado um módulo (ou aplicação) assim como uma biblioteca de programas de PL/SQL. Na figura acima, se encontram presentes os nós principais do navegador : Relatórios (Reports) subordinado a este nó estarão os módulos de relatório que viermos a desenvolver. Na figura acima aparece uma aplicação de nome Sem Título. Observe que o nó Relatórios está preenchido com o símbolo ( - ) indicando que o nó está expandido. O nó do módulo Sem Título está preenchido com o símbolo ( + ), indicando que o nó está contraído, ou seja, existem elementos subordinados a este nó que não estão visíveis. Gabaritos (Templates) subordinado a este nó estarão os módulos de Gabarito (Template) que viermos a desenvolver. Na figura não existe nenhum módulo aberto ( o nó está vazio ). Portanto, não tem nenhum símbolo preenchendo o nó. Consultas SQL Externas (External Query) subordinado a este nó incluiremos comandos de SQL Select armazenados em arquivos. Estes comandos Select podem ser compartilhados por diversos relatórios, caracterizando uma origem de dados e diversos layouts. Não incluímos ainda nenhum módulo subordinado a este nó. Bibliotecas PL/SQL (PL/SQL Libraries) subordinado a este nó estarão os módulos de bibliotecas de PL/SQL que viermos a desenvolver. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-5

12 Na figura anterior também não existe nenhum módulo aberto, portando o nó está vazio. Ações de Depuração (Debug Action) e Stack nestes nós não serão cadastrados módulos. Serão incluídas ações temporárias, criadas para efeito de depuração. Pacotes Embutidos (Built-in Packages) subordinado a este nó existem diversos pacotes (packages) contendo diversas rotinas que poderemos utilizar no desenvolvimento da aplicação. Observe que este nó está contraído ( + ). Objetos do Banco de Dados (Database Objects) subordinado a este nó serão visualizados os diversos objetos do banco de dados que o usuário ao qual estamos conectados tem acesso. Atualmente o nó está vazio pois não estabelecemos, ainda, conexão com o banco. A seguir veremos as diversas ações que podemos realizar no Navegador de Objetos. Se você já estudou o Form Builder não encontrará diferenças nas ações Expandir ou Contrair, porém, verifique as ações Criar ou Deletar. EXPANDIR OU CONTRAIR Para expandir um nó ou contraí-lo basta que pressionemos o mouse sobre o símbolo + (para expandi-lo) ou sobre o símbolo (para contrai-lo). A figura ao lado representa o navegador da figura anterior com o nó Sem Título expandido. Esta mesma ação pode ser feita com os botões expandir e contrair da barra de ferramentas. A figura ao lado apresenta os botões que realizam as ações de expansão e contração na barra de ferramentas. Como teste utilize o botão de Expandir Tudo sobre o nó Pacotes Embutidos. Você verificará que a expansão se dará em todos os nós subordinados ao nó principal. Todos serão expandidos simultaneamente. A ação inversa é obtida com o botão Contrair Tudo. CRIAR OU DELETAR Diferentemente do Form Builder, no Report Builder nem todos os objetos podem ser criados no navegador. Para determinados objetos devemos utilizar o editor adequado para sua manipulação. Quando o objeto puder ser criado pelo Navegador, o botão Criar (presente na Barra de Ferramentas) ficará habilitado. Caso contrário ficará desabilitado. Na figura ao lado mostramos os botões Criar e Deletar habilitados. Para realizarmos esta ação basta que selecionemos o nó ou um objeto do mesmo tipo daquele que desejamos criar e pressionemos o botão Criar. Como teste selecione o nó Consultas SQL Externas (corresponde a um elemento do tipo SQL) e pressione o botão Criar. Você observará que será criado um novo módulo de nome Sem Título (2). CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-6

13 Outra forma de realizar a mesma operação é realizarmos um click duplo sobre o nó que desejamos criar um elemento. Teste sobre o nó Parâmetros de Usuário (subordinado ao nó Modelo de Dados do relatório). Com estes testes verificamos que podemos manipular com mais de um módulo ao mesmo tempo usando a ferramenta, uma vez que criamos Sem Título e Sem Título (2). Isto se aplica a todos os nós principais (Reports, Gabaritos, SQL Externas e Libraries). Porém, enquanto não tivermos prática no desenvolvimento de aplicações com esta ferramenta trabalharemos com um módulo por vez. Para removermos um elemento, devemos selecioná-lo e pressionar a ferramenta Deletar ou pressionar o botão Del do teclado. EXECUTAR, IMPRIMIR E MENSAGEM A execução do módulo Report ativo, ou seja, aquele em que temos algum elemento selecionado ocorre quando pressionamos o botão Executar, o botão Imprimir ou o botão Mensagem. Na figura ao lado apresentamos os três botões ligados à execução da aplicação. Quando pressionamos um dos três botões de execução, acionamos o Report Runtime para execução da aplicação corrente. A diferença entre os três é que o botão Executar apresenta a saída no vídeo por default, o botão Imprimir apresenta a saída na impressora por default e o botão Mensagem envia o resultado do relatório através de para os usuários. ABRIR E SALVAR Este último conjunto de botões realiza ações sobre os módulos. A ação se dá de acordo com o elemento que tivermos selecionado no momento. Por exemplo, se tivermos selecionado um módulo Report ou qualquer elemento subordinado a ele e pressionarmos o botão Salvar efetuaremos a salva do módulo corrente e se pressionarmos o botão Abrir serão apresentados outros arquivos com extensão RDF (Report) para que façamos a escolha daquele que desejamos abrir. Como exemplo vamos salvar o módulo atual. Uma vez que o Report Builder pode ser salvo tanto no banco de dados quanto no disco e é a primeira vez que salvamos este módulo, o Report Builder apresenta um diálogo para que indiquemos o meio de armazenamento. Quando optamos por disco, o Report Builder apresenta um novo diálogo para que determinemos o diretório onde efetuaremos a salva e o nome desejado para o módulo. A partir do momento que definirmos o diretório e o nome do módulo, o Report Builder não mais apresentará este diálogo nas próximas vezes que pressionarmos o botão Salvar. Como teste salve o módulo ativo com o nome de Teste. Observe após a salva que no navegador o nome do módulo é alterado para teste. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-7

14 LOCALIZAR Podemos usar o pesquisador do Navegador para encontrar elementos e nós dentro do Navegador. Para iniciarmos uma busca devemos digitar a string que desejamos procurar no campo Localizar que fica posicionado no canto superior direito da janela do Navegador. A cada caracter que digitamos o Report Builder movimenta o cursor para o próximo elemento que as letras digitadas sejam compatíveis. Por exemplo, selecionemos o módulo Teste. Ao posicionarmos o cursor sobre o campo Localizar e digitarmos a letra A, o Report Builder posicionará o cursor sobre o nó After Report (nó subordinado a Gatilhos do Relatório). Quando necessário podemos utilizar as duas lanternas posicionadas ao lado do campo Localizar para efetuar uma busca para frente ou para trás. NAVEGANDO NA HIERARQUIA Da lado esquerdo da janela do Navegador existe um campo que apresenta o nome do elemento atualmente selecionado. Ao abrirmos a lista deste campo, verificaremos que ele contém todos os ancestrais hierarquicamente superiores em relação ao objeto selecionado. Ele apresenta a árvore de subordinação do elemento selecionado. Podemos selecionar qualquer elemento desta hierarquia, bastando que façamos a seleção do elemento desejado, clicando o mouse sobre o nome do elemento na lista. PAINÉIS DO NAVEGADOR Podemos dividir o navegador em múltiplos painéis horizontalmente ou verticalmente. Para tal devemos pressionar e arrastar o mouse sobre o ponto de divisão horizontal ou vertical mostrado na figura ao lado. Só podemos dividi-lo num sentido (vertical ou horizontal) de cada vez. Podemos realizar múltiplas subdivisões, desde que num mesmo sentido. ALTERANDO O NOME DE UM ELEMENTO A modificação do nome de qualquer elemento poderá ser feita através de sua janela de propriedades, porém esta ação também pode ser feita no navegador. Devemos efetuar um click simples no nome do elemento selecionado para que seja habilitada a digitação no próprio local. Observe na figura ao lado que algumas letras da palavra parame estão selecionadas e parte da palavra foi removida. Compare com o nome completo do nó no campo referente à hierarquia (canto superior esquerdo da janela do Navegador). Para efetivarmos a modificação basta pressionarmos o mouse sobre qualquer outro nó para que seja encerrado o estado de digitação. Se desejarmos desistir devemos pressionar a tecla Esc para encerrar desfazendo as modificações. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-8

15 O MENU DO REPORT BUILDER Muitas das ações realizadas com os botões estão presentes nos menus apresentados pelo Report Builder. Freqüentemente realizaremos uma ação já conhecida com um menu em vez de utilizarmos o botão correspondente. Durante o estudo usaremos as ações à medida que forem sendo necessárias. CRIANDO UMA APLICAÇÃO Para esta primeira aplicação utilizaremos o Assistente de Relatórios para nos auxiliar na construção. Verifique novamente a figura do item "Ativando o Report Builder", o Assistente de Relatórios corresponde à primeira opção do diálogo Bem Vindo ao Report Builder. Uma vez que já não estamos mais com este diálogo ativo, usaremos a opção Assistente de Relatórios do menu Ferramentas para acionar o assistente desejado. ESTABELECENDO CONEXÃO COM O BANCO DE DADOS Antes de acioná-lo, porém, devemos estabelecer conexão com o banco de dados. No menu Arquivo (File) escolha a opção Conectar (Connect) para que o diálogo de conexão seja apresentado. Neste diálogo devemos informar o código do usuário e sua senha além da string de conexão com o banco de dados (no nosso caso todos os campos devem ser preenchidos com Desenv). Agora sim, com a conexão estabelecida acionaremos o Assistente de Relatórios (Report Wizard), presente no menu Ferramentas (Tools). ESTILO DO RELATÓRIO A primeira tela apresentada está presente na figura abaixo. Neste diálogo são apresentadas diversas opções de relatório. Como teste, sem pressionar o botão próximo, marque uma opção de cada vez e observe no painel à esquerda um exemplo do estilo de relatório correspondente. Durante nosso estudo teremos oportunidade de testar todos os estilos. Iniciemos, então, com o estilo Tabular. Em seguida, pressione o botão próximo. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER 6.0-9

16 No segundo diálogo somos questionados sobre o tipo de consulta a ser criada. São apresentadas duas opções: Instrução SQL ou Consulta Express. Se optarmos por Consulta Express, será apresentado um diálogo para que façamos a conexão com o servidor Express. Neste diálogo poderemos informar dados para a conexão (UserId, Password e Id do Express) e dados para a autenticação no servidor Express (Domínio, UserId e Password). Após o preenchimento destas informações outro diálogo será apresentado contendo: Os bancos disponíveis atualmente ( para que façamos a escolha de um deles para associação). As dimensões disponíveis para que façamos a escolha daquelas que desejamos selecionar. Além de outras informações a serem preenchidas passo a passo para a montagem do relatório. Uma vez que não estamos estudando o Oracle Express, interromperemos a seqüência de análise deste desenvolvimento. Ficamos, apenas, com a informação de que o Report Builder já é capaz de desenvolver relatórios para o produto Oracle Express, certamente conhecido dos desenvolvedores para Data Warehouse. Sendo assim, optaremos por Instrução SQL e seguiremos pressionando o botão Avançar. O terceiro diálogo, referente aos dados (observe os botões abaixo da área de digitação) nos possibilita três opções: Podemos digitar o comando Select que contenha os dados desejados no espaço Instrução de Consulta. Podemos acionar o Query Builder para a construção passo a passo do comando SQL ao pressionarmos o botão Consultar Builder. Podemos desenvolver este relatório a partir de uma consulta previamente armazenada em um arquivo.sql existente no disco, pressionando o botão Importar Consulta de SQL. Esta opção utiliza uma Consulta SQL Externa (External Query). QUERY BUILDER - TABELAS Uma vez que estamos estudando e testando, utilizaremos o botão do Query Builder para a construção da consulta passo a passo. A figura ao lado nos mostra o primeiro diálogo apresentado pelo Query Builder. Neste diálogo devemos indicar de que objetos desejamos obter dados. Na parte superior do diálogo devemos indicar se os objetos de onde virão os dados são: Tabelas (Tables), Views, Snapshots, Sinônimos (Synonyms) ou uma combinação de tipos diferentes (podemos marcar mais de uma opção simultaneamente). Na parte central é apresentada uma lista com três opções: Desenv (que é o usuário ao qual estabelecemos conexão), <Local>(se estivermos trabalhando com um banco de dados local - Pesronal) e Bancos de Dados (se estivermos pretendendo a conexão a um banco de dados da rede). Se os objetos pertencerem ao usuário Desenv, eles serão apresentados na caixa de diálogo inferior. Se desejarmos obter dados de objetos pertencentes a outros usuário do banco local (ou atual), devemos escolher a opção <Local> (ou o banco de dados ao qual você estiver conectado). Neste caso a caixa de diálogo inferior apresentará a lista de usuários e você poderá selecionar aquele que interessa. A opção Bancos de Dados (Databases), quando selecionada, mostrará a lista de objetos Database Links presentes no banco de dados atual que permitirão a conexão com outros bancos (não exploraremos esta opção neste material). CAPÍTULO 2: A FERRAMENTA REPORT BUILDER

17 QUERY BUILDER DIÁLOGO PRINCIPAL Suponhamos que desejássemos criar um Join entre a tabela de Funcionário e a de Departamento. Neste caso selecionaremos a tabela Depto e pressionaremos o botão Incluir (Include). Em seguida selecionaremos a tabela Func e pressionaremos, novamente, o botão Incluir (Include). Estas operações que fizemos separadamente podem ser realizadas de uma única vez se mantivermos a tecla CTRL pressionada enquanto selecionamos as tabelas desejadas. Para encerrar este diálogo, pressione o botão Fechar (Close). A tela apresentada corresponde ao diálogo principal do Query Builder. Observe que aparecem em cinza os dois relacionamentos existentes entre as tabelas selecionadas. Este diálogo principal se subdivide em duas áreas: Do lado direito encontra-se a área de objetos selecionados. Do lado esquerdo se encontra a área de restrições da consulta. Além das áreas, esta janela apresenta uma barra de ferramentas superior com todas as ações disponíveis no Query Builder. Testaremos as funções e utilizaremos os botões da barra passo a passo. Até este momento, apesar de termos selecionado as tabelas Func e Depto, ainda não estabelecemos quais as colunas farão parte desta consulta. QUERY BUILDER COLUNAS Para selecionarmos as colunas que farão parte da consulta, temos duas opções: Efetuar um click duplo sobre a coluna apresentada no desenho (lado direito do painel) ou click simples sobre o retângulo à esquerda do nome da coluna. Pressionar o botão seqüência de colunas (column sequence) da barra de ferramentas. Selecionaremos via click a coluna nm_depto da tabela Depto. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER

18 Concentremos nossa atenção na imagem da tabela Depto apresentada na página anterior. Nesta imagem encontramos: Do lado direito a indicação do tipo de coluna: Alfanumérica (símbolo A), Numérica (símbolo contendo os números 7, 8 e 9), Data (símbolo contendo o número 31). Do lado esquerdo o indicador (checado ou não checado) de coluna selecionada (click duplo sobre uma das colunas para que este indicador apareça). Do lado direito da coluna cd_depto_ctb aparece uma seta curva, indicando que esta coluna representa um auto relacionamento na tabela (sabemos que cd_depto_ctb possui relacionamento com a coluna cd_depto). Do lado esquerdo do nome do objeto um símbolo indicando que se trata de uma tabela ( T ). Ainda do lado esquerdo do nome do objeto aparece o indicador (checado ou não checado) para tabela. Pressionaremos a seguir o botão Seqüência de Colunas (Column Sequence), destacado na barra de ferramentas da figura da página anterior, para escolher as colunas cd_mat e nr_cargo. A figura anterior nos mostra o diálogo para escolha das colunas que serão incluídas na cláusula Select do comando. Do lado esquerdo aparecem as colunas disponíveis. Observe que as colunas que possuem o mesmo nome nas duas tabelas já aparecem prefixadas com o nome do owner (usuário) e do objeto. Para incluirmos uma coluna no comando Select, devemos selecioná-la no lado esquerdo e pressionar o botão Copiar (Copy). Se quisermos retirar uma coluna da lista devemos selecioná-la no lado direito e pressionar o botão Remover(Remove). Se desejarmos que o comando Select seja apresentado em uma determinada ordem, devemos selecionar as colunas na ordem desejada. QUERY BUILDER SQL Para que possamos acompanhar o comando Select que está sendo gerado passo a passo, podemos pressionar o botão Show SQL (da barra de ferramentas). Observe que os relacionamentos entre as duas tabelas são incluídos a partir do momento que escolhermos colunas das duas tabelas. Nosso próximo passo será adicionar uma concatenação das colunas nome e sobrenome do funcionário. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER

19 QUERY BUILDER DEFININDO UMA COLUNA Para esta tarefa usaremos o botão Definir Coluna (Define Column) da barra de ferramentas (este botão está ao lado direito do botão Seqüência de Colunas - Column Sequence usado anteriormente). No diálogo apresentado existem dois locais para preenchimento de informação: No campo colunas definidas (defined columns) devemos incluir um texto que corresponderá ao nome da coluna criada (ou seja um alias). No campo definidas como (defined as) devemos escrever a expressão associada (no nosso caso nm_func nm_sobrenome). Neste diálogo existem, ainda, dois botões para auxílio na montagem da expressão: Colar coluna (paste column) se clicarmos neste botão será apresentada a lista das colunas para seleção, basta você selecionar a coluna da lista e ok. Colar func..(paste function) se clicarmos neste botão será apresenta a lista de funções de sql que poderemos utilizar na expressão montada. Para efeito de teste, escreveremos então quatro expressões: Concatenação de nome e sobrenome, já explicada acima. Formatação de data de nascimento, ou seja, to_char(dt_nasc, dd/mm/yyyy ). Formatação de data de admissão, ou seja, to_char(dt_adm, dd/mm/yyyy ). Formatação de sexo, ou seja, decode (in_sexo, f, feminino, m, masculino, indeterminado ) Para criarmos uma nova coluna sem sair deste diálogo, devemos pressionar o botão Definir (Define), portanto, mãos à obra. O resultado destas quatro novas colunas está apresentado no diálogo ao lado. Quando você fechar este diálogo observará que as quatro colunas foram acrescentadas à lista de colunas da tabela Func (com um indicador de função), porém não apresentam o símbolo indicativo de que estão selecionadas. Faça um click duplo sobre cada uma delas. Para cada uma marcada, a coluna original, presente na expressão também será considerada selecionada. Antes de prosseguir verifique novamente o comando Select montado. QUERY BUILDER ORDENANDO O RESULTADO Desejamos que o relatório seja ordenado por data de nascimento em ordem decrescente, isto é, do mais novo para o mais velho. Para que o diálogo que estabelece a ordenação seja acionado devemos clicar no botão Classificar (Sort) da barra de ferramentas (ao lado direito do botão Definir Coluna). No diálogo apresentado, do lado esquerdo, estão listadas todas as colunas disponíveis para ordenação. Selecionamos, então, a coluna dt_nasc e pressionamos o botão Copiar (Copy). Para determinar que a ordenação seja descendente, selecionamos a coluna dt_nasc do lado direito do diálogo e marcamos a opção Descendente (Descending). Em seguida dê OK e verifique o comando SQL. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER

20 QUERY BUILDER ALIAS O comando SQL apresentado já está suficientemente complexo. Para limparmos um pouco este comando, incluiremos alias para as tabelas a fim de diminuir a qualificação das colunas. Portanto pressione o botão Rename Table (passe o mouse lentamente sobre a barra de ferramentas para que o nome do botão seja apresentado). Quando você abrir este diálogo, na janela superior aparecerá o nome da tabela para a qual você definirá o Alias. Na parte inferior do diálogo você deve escrever D (para Depto), pressionar o botão Define. Em seguida selecione a tabela Func e escolha como alias a letra F. Na parte central aparecerá o alias escolhido para cada uma das tabelas. Dê OK. Antes de seguir, verifique novamente o comando Select. Ficou melhor, não? QUERY BUILDER - INCLUINDO UMA RESTRIÇÃO Nosso próximo passo será incluir uma restrição. Usaremos, então a área esquerda do Diálogo Principal. Para uma melhor visualização desta sintaxe, aumente o tamanho desta área da tela, da seguinte forma: Na parte inferior da tela existe uma marca preta ao lado do botão (seta para esquerda) da barra de rolagem. Clique sobre esta marca e arraste-a para a direita para aumentar a área à esquerda. Para iniciar a montagem da restrição, clique sobre a área de texto (corresponde ao retângulo presente nesta área de desenho). Observe que na barra de ferramentas do lado direito, diversos botões foram habilitados. Estes botões serão utilizados para a montagem da restrição. Nosso objetivo é incluir duas restrições: cd_mat > 20 e cd_depto = D11 Como primeiro passo usaremos o botão Paste Column da barra de ferramentas para obter a coluna cd_mat. Em seguida escreveremos > 20 na linha de texto. Para incluir a segunda restrição pressionaremos a tecla Enter e uma nova caixa de restrição será aberta. Como próximo passo selecionaremos a coluna cd_depto (pressione o botão Paste Column) e digitaremos o restante da restrição. Quando clicarmos novamente na primeira restrição, o operador AND será acrescido (automaticamente) para ligar as duas condições. O resultado é apresentado na figura abaixo. CAPÍTULO 2: A FERRAMENTA REPORT BUILDER