Opplæring 1: Bygge en enkel listerapport
Denne delen inneholder trinnvise instruksjoner for hvordan du bygger en rapport som viser kundenavn, telefonnumre og kontaktnavn. Rapporten bruker data fra eksempeldatabasen Classic Models, som følger med BIRT Report Designer. Figur 1-1 viser en del av den ferdige rapporten.
Figur 1-1 Rapport med kundenavn, telefonnumre og kontakter
I denne opplæringen utfører du disse oppgavene:
Oppgave 1: Opprette et nytt prosjekt
Eclipse organiserer filene i prosjekter. Du kan opprette et prosjekt for å organisere alle rapportene eller opprette flere prosjekter for å organisere rapportene i kategorier. For hvert prosjekt som du oppretter, oppretter Eclipse en katalog i filsystemet.
Hvis du bruker BIRT RCP Report Designer, gjelder ikke denne oppgaven for deg.
- Velg Fil->Ny(tt)->Prosjekt. Nytt prosjekt, som vises i Figur 1-2, viser prosjekttypene som du kan opprette.
Figur 1-2 Nytt prosjekt
- Utvid Business Intelligence and Reporting Tools, velg Rapportprosjekt og velg Neste.
- Under Prosjektnavn i Nytt rapportprosjekt oppgir du følgende tekst, som vist i figur 1-3:
- Hvis du vil legge til prosjektet, velger du Fullfør. Nå kan du se prosjektet i Navigator-visningen, som vist i figur 1-4.
Figur 1-4 Et prosjekt i Navigator-visningen
Oppgave 2: Opprette en ny rapport
Du kan opprette en rapport på disse måtene:
- Begynn med en tom rapportdesign.
- Bruk en forhåndsdefinert rapportmal.
For hver mal har BIRT Report Designer en jukselapp som inneholder trinnvise instruksjoner, som hjelper deg med å opprette rapporten.
For denne opplæringen begynner du med en tom rapportdesign.
- Velg Fil->Ny(tt)->Rapport. Ny rapport vises. Figur 1-5 viser vinduet som vises i BIRT Report Designer. Ny rapport er litt annerledes i BIRT RCP Report Designer.
Figur 1-5 Ny rapport i BIRT Report Designer
- Velg prosjektet som du opprettet, under Oppgi eller velg overordnet mappe i BIRT Report Designer. Dette trinnet gjelder bare for brukere av BIRT Report Designer.
- Oppgi følgende tekst som filnavn:
- Velg Neste. Ny rapport inneholder alternativer for å starte med en tom rapport og flere rapportmaler, som vist i figur 1-6.
Figur 1-6 Rapportmaler i Ny rapport
- Velg Tom rapport, og velg deretter Fullfør. Den nye rapporten vises i hovedvinduet. Dette vinduet vises i layoutredigeringsprogrammet, som vist i figur 1-7. Layoutredigeringsprogrammet viser en tom rapportside.
Resten av denne opplæringen inneholder detaljerte trinn for oppretting av kunderapporten.
Figur 1-7 Tom rapportdesign
Oppgave 3: Bygge en datakilde
Før du begynner å designe rapporten i layoutredigeringsprogrammet, bygger du en BIRT-datakilde for å knytte rapporten til en database eller andre typer datakilder. Når du bygger en datakilde, oppgir du driverklassen, datakildenavnet og annen tilkoblingsinformasjon, for eksempel brukernavn og passord. For denne opplæringen bruker du eksempeldatabasen, Classic Models, som allerede er konfigurert for bruk med BIRT Report Designer. Du trenger ikke å angi tilkoblingsinformasjonen for denne eksempeldatabasen.
- Velg Datautforsker. Hvis du bruker standard rapportdesignperspektiv, blir Datautforsker utelatt fra layoutredigeringsprogrammet, ved siden av paletten, som vist i figur 1-8. Hvis den ikke er åpen, velger du Vindu->Vis visning->Datautforsker.
Figur 1-8 Datautforsker
- Høyreklikk på Datakilder og velg Ny datakilde fra hurtigmenyen. Ny datakilde viser datatypene som du kan opprette, som vist i figur 1-9.
Figur 1-9 Ny datakilde
- Velg eksempeldatabasen Classic Models Inc. fra listen over datakildetyper. Bruk standard datakildenavn, og velg deretter Neste. Tilkoblingsinformasjon om den nye datakilden vises.
- Velg Fullfør. BIRT Report Designer oppretter en ny datakilde som kobler seg til eksempeldatabasen. Den vises i Datakilder i Datautforsker, som vist i figur 1-10.
Figur 1-10 Datakilder i Datautforsker
Oppgave 4: Bygge et datasett
Nå er du klar til å bygge datasettet. Et datasett identifiserer dataene som skal hentes fra datakilden. Hvis rapporten kobler seg til en JDBC-datakilde, bruker du en SQL SELECT-setning til å identifisere dataene som skal hentes.
- I Datautforsker høyreklikker du på Datasett og velger Nytt datasett fra hurtigmenyen.
- Under Navn på datasett i Nytt datasett oppgir du følgende tekst, som vist i figur 1-11:
- Bruk standardverdiene for de andre feltene:
- Datakilde viser navnet på datakilden som du opprettet tidligere.
- Datasettype angir at datasettet bruker en SQL SELECT-spørring.
- Velg Neste.
Spørring viser informasjonen som hjelper deg med å opprette en SQL-spørring. Tilgjengelige elementer viser alle tabellene i databasen Classic Models. Du kan klikke på plusstegnet (+) ved siden av en tabell for å vise kolonnene i tabellen. Tekstområdet til høyre i Rediger datasett viser de nødvendige nøkkelordene til en SQL SELECT-setning:
- I tekstområdet skriver du følgende SQL SELECT-setning for å definere dataene som skal hentes:
Selv om redigeringsprogrammet for datasett viser tabell- og kolonnenavn i store bokstaver, kan du skrive disse navnene slik du ønsker, fordi SQL ikke skiller mellom små og store bokstaver. Hvis du ikke vil skrive spørringen, kan du dra kolonner og tabeller fra Tilgjengelige elementer til tekstområdet.
SELECT-setningen som du opprettet, som vises i
figur 1-12, henter verdier fra kolonnene CUSTOMERNAME, CONTACTLASTNAME, CONTACTFIRSTNAME og and PHONE i CUSTOMERS-tabellen.
Figur 1-12 SQL SELECT-setning i Rediger datasett
- Velg Fullfør for å lagre datasettet. Rediger datasett viser kolonnene som du oppgav i spørringen, og alternativer for redigering av datasettet.
- Velg Forhåndsvis resultater for å kontrollere at spørringen er gyldig, og at den returnerer de riktige dataene. Hvis du skrevet SELECT-setningen riktig, skal du kunne se resultatene som vises i figur 1-13. Dette er dataradene som spørringen returnerer.
Figur 1-13 Datarader returnert av en SQL SELECT-setning
- Velg OK.
Oppgave 5: Ordne rapporten
I denne fremgangsmåten setter du inn elementer på rapportsiden for å vise dataene fra datasettet som du opprettet tidligere. Du starter med å sette inn et tabellelement, og deretter setter du inn dataelementer i tabellen. Det er viktig å forstå funksjonaliteten til tabellen:
- Tabellen itererer gjennom alle dataradene som datasettet returnerer.
- Det gjør at du enkelt kan ordne data i rad- og kolonneformat.
- Velg Palett. Paletten viser alle elementene som du kan plassere i en rapport.
- Dra et tabellelement fra paletten, og slipp det i rapporten i layoutredigeringsprogrammet. Sett inn tabell ber deg om å oppgi antall kolonner og detaljrader som skal opprettes for tabellen.
- Oppgi 3 kolonner og 1 detaljrad, og velg deretter OK. Det blir vist en tabell med tre kolonner og én detaljrad i layoutredigeringsprogrammet. Nå er du klar til å sette inn data i tabellen.
- Velg Datautforsker.
- I Datautforsker utvider du Datasett og deretter Kunder. Kolonnene som du oppgav i spørringen, vises under Kunder.
- Dra CUSTOMERNAME fra Datautforsker, og slipp det i den første cellen i tabellens detaljrad, som vist i figur 1-14. Detaljraden viser hoveddataene i rapporten. I den ferdige rapporten blir detaljraden gjentatt for å vise alle dataradene fra datasettet.
Figur 1-14 Dra en kolonne fra Datautforsker, og slipp den i en tabellcelle
BIRT Report Designer oppretter en navngitt kolonne, som er bundet til datasettfeltet. Velg Databinding, som vises i
figur 1-15, for å vise denne databindingen.
Figur 1-15 En navngitt kolonne som er bundet til et datasettfelt
- Velg OK for å akseptere standard databindingsdefinisjon.
I layoutredigeringprogrammet inneholder tabellcellen som du slapp CUSTOMERNAME-feltet i, et dataelement som viser [CUSTOMERNAME]. Over dette dataelementet er det et etikettelement som layoutredigeringsprogrammet automatisk la til i topptekstraden. Denne etiketten viser feltnavnet som statisk tekst. Det fungerer som kolonneoverskrift.
Figur 1-16 viser data- og etikettelementene.
Figur 1-16 Data- og etikettelementer i en tabell
- Dra PHONE fra Datautforsker, og slipp den i den andre cellen i detaljraden. Velg OK for å akseptere standard databinding.
- Dra CONTACTFIRSTNAME, og slipp det i den tredje cellen i detaljraden. Velg OK for å akseptere standard databinding.
- Dra CONTACTLASTNAME, og slipp det i den tredje cellen i detaljraden, under CONTACTFIRSTNAME. Velg OK for å akseptere standard databinding. Rapportsiden skal se ut som den som vises i figur 1-17.
Figur 1-17 Kunde- og kontaktinformasjon lagt til i en tabell
- Velg Forhåndsvisning, flippen nederst i layoutredigeringsprogrammet. BIRT Report Designer genererer rapporten i HTML-format, som vist i figur 1-18. Bla nedover for å se hele rapporten. Du kan også forhåndsvise en rapport i PDF. Det gjør du ved å velge Fil->Vis rapport som PDF fra hovedmenyen.
Som
figur 1-18 viser er dataene riktige, men de blir vist i tilfeldig rekkefølge. Det gir mer mening å sortere dataene alfabetisk etter kundenavn. Utseendet til rapporten bør også forbedres.
Figur 1-18 Forhåndsvisning av rapportdata
Oppgave 6: Sorter dataene
Når du først oppretter og forhåndsviser en rapport, viser rapporten dataradene i den rekkefølgen som spørringen returnerer dem. Rekkefølgen kan variere, avhengig av mange faktorer, for eksempel av hvordan dataene ble lagt inn i datakilden. I de fleste tilfeller
ønsker du å endre rekkefølgen for visning av data i rapporten.
- Velg Layout for å gå tilbake til layoutredigeringsprogrammet.
- Åpne Redigeringsprogram for egenskap om nødvendig. Hvis du bruker standard rapportdesignperspektiv, vises redigeringsprogrammet for egenskaper under layoutredigeringsprogrammet. Hvis det ikke er åpent, velger du Vindu->Vis visning->Redigeringsprogram for egenskap.
- Velg tabellen i layoutredigeringsprogrammet ved å velge flippen Tabell i nedre venstre hjørne. Denne flippen vises når du beveger musepekeren over dette området. Redigeringsprogrammet for egenskaper viser egenskapene for tabellen, som vist i figur 1-19.
Figur 1-19 Redigeringsprogram for egenskap
- Velg flippen Sortering.
- Velg Legg til for å opprette et sorteringsuttrykk. Det blir vist en rad under sorteringsnøkkelen.
- Klikk på raden under sorteringsnøkkelen, og velg pilknappen som vises, og velg CUSTOMERNAME fra rullegardinlisten.
- Bruk standardverdien Stigende for Sorteringsretning, som vist i Figur 1-20.
Figur 1-20 Stigende sorteringsretning
- Forhåndsvis rapporten. De sorterte dataene vises i stigende rekkefølge etter kundenavn, som vist i figur 1-21.
Figur 1-21 Data sortert etter kundenavn
Legg merke til at navn med store bokstaver blir vist øverst på listen. BIRT sorterer strengdata etter UCS2-kodepunktverdier. I ASCII-baserte tegnsett har store bokstaver lavere kodepunktverdier enn små bokstaver. Derfor blir store bokstaver vist før små bokstaver.
- Hvis du vil sortere kundenavnene uavhengig av små og store bokstaver, slik at ANG Resellers vises etter American Souvenirs Inc., i stedet for før, kan du endre sorteringsnøkkeluttrykket på siden Sortering til følgende uttrykk:
Dette uttrykket bruker funksjonen JavaScript toUpperCase( ) til å konvertere alle kundenavnverdiene til store bokstaver før sortering. JavaScript-funksjonsnavn skille mellom små og store bokstaver, så du må skrive toUpperCase( ) nøyaktig som vist. Referanser til kolonnenavn skille også mellom små og store bokstaver. I dette uttrykket er row["CUSTOMERNAME"] det riktige navnet å bruke. Hvis du skriver row["customername"] for eksempel, viser BIRT Report Designer en feil når du kjører rapporten. Du kan verifisere store bokstaver i et kolonnenavn ved å se på navnet som vises i Datautforsker.
- Forhåndsvis rapporten. Kundenavnene vises i en annen rekkefølge. Navn med store bokstaver blir ikke vist øverst på listen.
Oppgave 7: Formater rapporten
Nå som du har verifisert at rapporten viser de riktige dataene i riktig rekkefølge, kan du fokusere på å forbedre utseendet til rapporten. Du kan utføre følgende oppgaver i denne delen:
- Rediger teksten i kolonneoverskriftene.
- Formater kolonneoverskriftene for å skille dem fra dataradene.
- Vis kontaktenes for- og etternavn på samme linje.
- Øk avstanden mellom rader.
Rediger kolonneoverskriftene
- Velg Layout for å gå tilbake til layoutredigeringsprogrammet.
- Dobbeltklikk på den første kolonneoverskriften, CUSTOMERNAME. Kolonneoverskriften er i den første raden, topptekstraden, i tabellen.
- Hvis du vil erstatte all uthevet tekst, begynner du å skrive og trykker på Enter når du er ferdig. Hvis du vil redigere teksten, klikker du en gang for å oppheve merkingen av teksten. Deretter plasserer du markøren der du vil slette eller legge til tegn.
Erstatt CUSTOMERNAME med følgende tekst:
- Gjenta trinn 2 og 3 for å endre den andre og tredje kolonneoverskriften til følgende tekst:
Rapportdesignen skal se ut som den som vises i
figur 1-22.
Figur 1-22 Reviderte kolonneoverskrifter i en rapportdesign
Formater kolonneoverskriftene
Hvis du vil formatere et rapportelement, definerer du egenskapene. Du kan fullføre denne oppgaven på to måter:
- Definer egenskapene til et element ved hjelp av redigeringsprogrammet for egenskaper.
- Definer en stil som inneholder de ønskede egenskapene, og bruk stilen på et element. Bruk denne metoden til å definere formategenskaper én gang og bruk dem på mer enn et element.
I denne fremgangsmåten bruker du den første metoden til å definere fet for kolonneoverskriftene, og den andre metoden til å legge til farge i topptekstraden.
- Slik definerer du fet for kolonneoverskriftene ved hjelp av redigeringsprogrammet for egenskaper:
- Velg alle kolonneoverskriftene. Hvis du vil velge flere elementer, trykker du på Skift-tasten mens du klikker på hvert element. Redigeringsprogrammet for egenskaper viser egenskapene til de valgte elementene, som vist i figur 1-23.
Figur 1-23 Egenskaper for valgte elementer i redigeringsprogrammet for egenskaper
- Velg B for å formatere kolonneoverskriftene som fet tekst.
- Hvis du vil oppheve valget av kolonneoverskrifter, klikker du i det hvite området utenfor tabellen.
- Slik legger du til en bakgrunnsfarge i topptekstraden ved hjelp av en stil:
- Velg Element->Ny stil fra hovedmenyen.
Ny stil vises, som vist i
figur 1-24. Venstre side viser egenskapskategoriene. Høyre side viser egenskapene til kategorien som du velger.
Figur 1-24 Ny stil
- For Egendefinert stil definerer du følgende navn for stilen:
- Velg Bakgrunn fra listen over egenskapskategoriene. Ny stil viser bakgrunnsegenskapene som du kan definere.
- Definer en farge for egenskapen Bakgrunnsfarge på en av disse måtene:
- Velg knappen ved siden av egenskapen, og velg deretter en farge fra fargepaletten som blir vist.
- Velg en farge fra rullegardinlisten.
Velg OK.
- Velg tabellen i layoutredigeringsprogrammet ved å velge flippen Tabell i nedre venstre hjørne. Denne flippen vises når du beveger musepekeren over dette området. Hjelpeceller blir vist øverst og til venstre for tabellen, som vist i figur 1-25.
Figur 1-25 Hjelpeceller øverst og til venstre for en tabell
- Velg hjelpecellen ved siden av topptekstraden. Redigeringsprogrammet for egenskaper viser egenskapene for den valgte raden.
- Velg Egenskaper og Generelt for å vise de generelle egenskapene for raden.
- Bruk stilen som du nettopp har opprettet, ved å velge table_header_row fra rullegardinlisten ved siden av Stil. BIRT Report Designer bruker stilen på topptekstraden, og den blir vist i farge.
- Forhåndsvis rapporten. Rapporten skal se ut som den som vises i figur 1-26.
Figur 1-26 Forhåndsvisning av rapport, visning av stil for topptekstrad
Så langt er den største forbedringen at overskriftene er lett synlige og definert.
Vis fornavn og etternavn på samme linje
Når du plasserer flere elementer i en enkelt celle, oppretter BIRT Report Designer elementer på blokknivå. Hvis du kjenner til HTML, vet du at hvert blokkelement begynner på en ny linje. Hvis du vil vise flere elementer på samme linje, må du definere dem som innebygde elementer. Alternativt kan du slå sammen verdiene for det første og det siste navnet for å vise dem i et enkelt dataelement, som beskrevet i denne fremgangsmåten.
- Velg Layout for å gå tilbake til layoutredigeringsprogrammet.
- Slett dataelementet som viser kontaktens etternavn.
- Dobbeltklikk på dataelementet som viser kontaktens fornavn.
Velg databinding viser alle databindingene som brukes i rapporten. En hake ved siden av CONTACTFIRSTNAME angir databindingen som brukes av dataelementet du har valgt.
- Klikk i cellen som viser uttrykket dataSetRow["CONTACTFIRSTNAME"], og velg deretter ellipse-knappen (...) .
Uttrykksbygger viser følgende uttrykk i tekstområdet øverst i vinduet:
- Hvis du vil slå sammen for- og etternavnene, bruker du følgende uttrykk:
Figur 1-27 viser dette uttrykket i Uttrykksbygger. De tomme anførselstegnene (" ") legger til et mellomrom mellom for- og etternavnet. Du kan skrive inn uttrykket i tekstområdet eller dobbeltklikke på et element nederst til høyre i vinduet for å sette inn uttrykket.
Figur 1-27 Sammenslåtte data i Uttrykksbygger
- Velg OK for å lukke Uttrykksbygger, og velg deretter OK i Velg databinding for å lagre det endrede uttrykket.
- Forhåndsvis rapporten. Rapporten skal se ut som den som vises i figur 1-28.
Figur 1-28 Forhåndsvisning av rapport, viser sammenslåtte kontaktnavn
Øk mellomrommet mellom rader
Standardlayouten legger til et minimumsmellomrom mellom tabellradene. Vanligvis ønsker du å justere mellomrommet mellom radene.
- Velg Layout for å gå tilbake til layoutredigeringsprogrammet.
- Merk alle cellene i detaljraden, den midtre raden. Hvis du vil velge flere celler, bruker du skift-klikk. Pass på at du merker cellene, ikke dataelementene i cellene. Det blir vist en boks rundt de valgte cellene, som vist i figur 1-29.
Figur 1-29 Valgte celler i layoutredigeringsprogrammet
Redigeringsprogrammet for egenskaper viser egenskapene for cellene. Tittelen som vises i redigeringsprogrammet for egenskaper, viser hvilken elementtype du velger, så du skal se Redigeringsprogram for egenskap - Celle.
- Velg utfylling. Redigeringsprogrammet for egenskaper viser egenskaper for utfylling. Disse egenskapene gjør at du kan angi hvor mye plass som skal legges til øverst, nederst, til venstre og til høyre for elementet.
- Oppgi 12 punkter for Utfylling øverst.
Du lurer kanskje på hvorfor du ikke bare valgte raden for å justere radmellomrom i stedet for å velge de enkelte cellene i raden. BIRT Report Designer støtter ikke radutfylling fordi noen nettlesere ikke støtter denne funksjonen.
- Forhåndsvis rapporten. Rapporten skal se ut som den som vises i figur 1-30. Det er flere mellomrom mellom dataradene.
Figur 1-30 Forhåndsvisning av rapport, vise radmellomrom
Oppgave 8: Opprett en rapporttittel
Alt rapportene trenger nå, er en tittel. Hvis du vil vise en tittel, kan du bruke et etikettelement, et tekstelement eller et dataelement:
- Etikettelementet egner seg for kort, statisk tekst, for eksempel kolonneoverskrifter.
- Dataelementet egner seg for visning av dynamiske verdier fra et datasettfelt eller et beregnet felt.
- Tekstelementet egner seg for tekst over flere linjer som inneholder ulik formatering eller dynamiske verdier.
I denne fremgangsmåten bruker du et tekstelement og HTML-koder til å formatere teksten. Legg merke til at du ikke trenger å bruke HTML til å opprette formatert tekst. Hvis du imidlertid er kjent med HTML eller webdesign, kan det hende at du foretrekker å bruke HTML til å opprette en blokk med formatert tekst.
- Velg Layout for å gå tilbake til layoutredigeringsprogrammet.
- Velg Palett.
- Dra tekstelementet fra paletten, og slipp det over tabellen.
- I Rediger tekstelement velger du HTML/dynamisk tekst fra rullegardinlisten som viser Ren tekst.
Når du velger HTML eller dynamisk tekst, kan du bygge inn HTML-koder eller CSS-egenskaper i teksten. Du kan skrive inn kodene, eller du kan sette inn vanlige HTML-koder som fra tekstredigeringsprogrammet.
- Oppgi følgende tekst i tekstområdet, som vist i figur 1-31:
- Velg OK, og forhåndsvis deretter rapporten. Rapporten skal se ut som den som vises i figur 1-32.
Figur 1-32 Forhåndsvisning av rapport, vise formatert rapporttittel
Som du kan se, gjør bruk av tekstelementer med innebygd HTML deg i stand til å
- bruke forskjellig formatering for hver linje i en tekstblokk over flere linjer
- sette inn dynamiske verdier, for eksempel gjeldende dato
Alternativt kan du bruke dette:
- To etikettelementer til å vise den første og andre linjen med statisk tekst
- Et dataelement til å vise den tredje linjen som inneholder den dynamiske verdien
Neste trinn
Du har nettopp bygd din første rapport og arbeidet med noen av de grunnleggende verktøyene og funksjonene i BIRT Report Designer. Det er mange flere oppgaver som du kan fullføre for å bygge mer avanserte rapporter. Noen av disse oppgavene, som blir beskrevet i andre kapitler i denne boken, omfatter:
- Koble til din egen datakilde
- Opprette diagrammer
- Opprette rapportparametere for brukerinndata
- Bygge rapporter som inneholder underrapporter
- Formatere rapportelementer basert på betingelser
- Skjule rapporter basert på betingelser
- Legge til hyperlinker for å linke rapporten til webplasseringer eller linke en rapportdel til en annen
