Forrige emneNæste emne


Øveprogram 1: Opret enkel listerapport

Dette afsnit indeholder en trinvis vejledning i, hvordan du opretter en rapport med en liste over kundenavne, telefonnumre og navne på kontaktpersoner. Til rapporten anvendes data fra eksempeldatabasen Classic Models, der leveres med BIRT Report Designer. Figur 1-1 viser et udsnit af den færdige rapport.

Figur 1-1 Rapport, der viser en liste med kundenavne, telefonnumre og kontaktpersoner

I øveprogrammet indgår følgende opgaver:

Opgave 1: Opret et nyt projekt

Filer er organiseret i projekter i Eclipse. Du kan oprette ét projekt, hvor du vil samle alle dine rapporter, eller du kan oprette flere projekter for at inddele rapporterne i kategorier. Eclipse opretter et bibliotek i filsystemet for hvert projekt, du opretter.

Spring opgaven over, hvis du bruger BIRT RCP Report Designer.

  1. Vælg Fil->Ny->Projekt. I Nyt projekt, som vises i Figur 1-2, vises de typer projekter, du kan oprette.
  2. Figur 1-2 Nyt projekt
  3. Udvid BIRT(Business Intelligence and Reporting Tools), vælg Rapportprojekt, og vælg derefter Næste.
  4. Skriv følgende tekst som vist i Figur 1-3 i Projektnavn i Nyt rapportprojekt:
  5. My Reports 
     

    Figur 1-3 Nyt rapportprojekt
  6. Vælg Afslut for at tilføje projektet. Projektet vises nu i oversigten Navigator som vist i Figur 1-4.
  7. Figur 1-4 Et projekt i oversigten Navigator

Opgave 2: Opret en ny rapport

Du kan oprette en rapport på følgende måder:

I dette øveprogram skal du begynde med et tomt rapportdesign.

  1. Vælg Fil->Ny->Rapport. Ny rapport vises. Figur 1-5 viser det vindue, der åbnes i BIRT Report Designer. Vinduet Ny rapport ser lidt anderledes ud i BIRT RCP Report Designer.
  2. Figur 1-5 Ny rapport i BIRT Report Designer
  3. Vælg det projekt, du oprettede, i Angiv eller vælg den overordnede folder i BIRT Report Designer. Trinet gælder kun for brugere af BIRT Report Designer.
  4. Skriv følgende tekst som filnavn:
  5. Customers.rptdesign 
    
  6. Vælg Næste. Ny rapport giver mulighed for at begynde med en tom rapport og indeholder desuden en række rapportskabeloner som vist i Figur 1-6.
  7. Figur 1-6 Rapportskabeloner i Ny rapport
  8. Vælg Tom rapport, og klik derefter på Afslut. Den nye rapport vises i hovedvinduet. Vinduet består af layouteditoren som vist i Figur 1-7. Der vises en tom rapportside i layouteditoren.

Resten af dette øveprogram beskriver de detaljerede trin, du skal udføre for at oprette kunderapporten.

Figur 1-7 Tomt rapportdesign

Opgave 3: Opret en datakilde

Før du begynder at designe rapporten i layouteditoren, skal du oprette en BIRT-datakilde for at skabe forbindelse mellem rapporten og en database eller en anden type datakilde. Når du skal oprette en datakilde, skal du angive styreprogramklassen, datakildenavnet og andre oplysninger om forbindelsen, f.eks. brugernavn og kodeord. I dette øveprogram skal du bruge eksempeldatabasen Classic Models, der allerede er konfigureret til brug sammen med BIRT Report Designer. Du behøver ikke angive oplysninger om forbindelsen til denne eksempeldatabase.

  1. Vælg Data Explorer. Hvis du bruger standardperspektivet til rapportdesign, vises Data Explorer til venstre for layouteditoren ved siden af paletten som vist i Figur 1-8. Vælg Vindue->Vis oversigt->Data Explorer, hvis oversigten ikke er åben.
  2. Figur 1-8 Data Explorer
  3. Højreklik på Datakilder, og vælg Ny datakilde på kontekstmenuen. Ny datakilde viser de typer datakilde, du kan oprette, som vist i Figur 1-9.
  4. Figur 1-9 Ny datakilde
  5. Vælg Eksempeldatabasen Classic Models Inc. på listen med datakildetyper. Brug standarddatakildenavnet, og vælg derefter Næste. Der vises oplysninger om forbindelsen til den nye datakilde.
  6. Vælg Afslut. BIRT Report Designer opretter en ny datakilde, der opretter forbindelse til eksempeldatabasen. Den vises under Datakilder i Data Explorer som vist i Figur 1-10.
  7. Figur 1-10 Datakilder i Data Explorer

Opgave 4: Opret et datasæt

Du er nu klar til at oprette datasættet. Et datasæt identificerer de data, som skal hentes fra datakilden. Hvis rapporten skal oprette forbindelse til en JDBC-datakilde, skal du bruge en SQL SELECT-sætning til at angive de data, der skal hentes.

  1. Højreklik i Data Explorer på Datasæt, og vælg Nyt datasæt på kontekstmenuen.
  2. Skriv følgende tekst som vist i Figur 1-11 i Datasætnavn i Nyt datasæt:
  3. Customers 
     

    Figur 1-11 Nyt datasæt
  4. Brug standardværdien til de andre felter:
    • I Datakilde vises navnet på den datakilde, du oprettede før.
    • I Datasættype vises, at datasættet bruger en SQL SELECT-forespørgsel.
  5. Vælg Næste.
  6. Under Forespørgsel vises oplysninger, som hjælper dig med at oprette en SQL-forespørgsel. I Tilgængelige elementer vises alle tabellerne i Classic Models-databasen. Du kan klikke på plustegnet (+) ved siden af en tabel, hvis du vil se alle kolonnerne i tabellen. I tekstområdet til højre for Redigér datasæt vises de påkrævede nøgleord til en SQL SELECT-sætning:
    select 
    from 
    
  7. Skriv følgende SQL SELECT-sætning i tekstområdet for at angive de data, der skal hentes:
  8. select customerName, 
    contactLastName, 
    contactFirstName, 
    phone 
    from Customers 
    
    I datasæteditoren vises tabel- og kolonnenavne med store bogstaver, men du kan skrive navnene, som du vil, da SQL ikke skelner mellem store og små bogstaver. I stedet for at skrive forespørgslen kan du trække kolonner og tabeller fra Tilgængelige elementer til tekstområdet.
    Den SELECT-sætning, du har oprettet, og som vises i Figur 1-12, henter værdier fra kolonnerne CUSTOMERNAME, CONTACTLASTNAME, CONTACTFIRSTNAME og PHONE i tabellen CUSTOMERS.

    Figur 1-12 SQL SELECT-sætning i Redigér datasæt
  9. Vælg Afslut for at gemme datasættet. I Redigér datasæt vises de kolonner, du har angivet i forespørgslen, og indstillinger til redigering af datasættet.
  10. Vælg Vis resultater for at kontrollere, at forespørgslen er gyldig og returnerer de rigtige data. Hvis du har skrevet SELECT-sætningen rigtigt, bør du få vist samme resultat som i Figur 1-13. Det er de datarækker, som forespørgslen returnerer.
  11. Figur 1-13 Datarækker, der returneres af en SQL SELECT-sætning
  12. Vælg OK.

Opgave 5: Definér rapportlayoutet

I denne fremgangsmåde skal du indsætte elementer på rapportsiden for at få vist data fra det datasæt, du oprettede før. Først skal du indsætte et tabelelement, og derefter skal du indsætte dataelementer i tabellen. Det er vigtigt at forstå tabellens funktionalitet:

  1. Vælg Palet. Paletten viser alle de elementer, du kan placere i en rapport.
  2. Træk et tabelelement fra paletten, og placér det på rapporten i layouteditoren. Du bliver af Indsæt tabel bedt om at angive det antal kolonner og oplysningsrækker, der skal oprettes til tabellen.
  3. Angiv 3 kolonner og 1 oplysningsrække, og vælg derefter OK. Der vises en tabel med tre kolonner og én oplysningsrække i layouteditoren. Du er nu klar til at indsætte data i tabellen.
  4. Vælg Data Explorer.
  5. Udvid Datasæt i Data Explorer, og udvid derefter Customers. De kolonner, du har angivet i forespørgslen, vises under Customers.
  6. Træk CUSTOMERNAME fra Data Explorer, og placér feltet i første celle i tabellens oplysningsrække som vist i Figur 1-14. Oplysningsrækken vil vise rapportens primære data. I den færdige rapport gentages oplysningsrækken, så alle datarækkerne fra datasættet vises.
  7. Figur 1-14 Træk en kolonne fra Data Explorer, og placér den i en tabelcelle
    BIRT Report Designer opretter en navngivet kolonne, som er bundet til datasætfeltet. Denne databinding vises i Vælg databinding, som vises i Figur 1-15.

    Figur 1-15 En navngivet kolonne, der er bundet til et datasætfelt
  8. Vælg OK for at acceptere standarddefinitionen af databindingen.
  9. I den tabelcelle i layouteditoren, hvor du placerede feltet CUSTOMERNAME, vises et tabelelement med teksten [CUSTOMERNAME]. Over dataelementet findes et etiketelement, som layouteditoren automatisk har tilføjet til toptekstrækken. I etiketten vises feltnavnet som statisk tekst. Den fungerer som kolonneoverskriften. Figur 1-16 viser data- og etiketelementerne.

    Figur 1-16 Data- og etiketelementer i en tabel
  10. Træk PHONE fra Data Explorer, og placér feltet i anden celle i oplysningsrækken. Vælg OK for at acceptere standarddatabindingen.
  11. Træk CONTACTFIRSTNAME, og placér feltet i tredje celle i oplysningsrækken. Vælg OK for at acceptere standarddatabindingen.
  12. Træk CONTACTLASTNAME, og placér feltet i tredje celle i oplysningsrækken neden under CONTACTFIRSTNAME. Vælg OK for at acceptere standarddatabindingen. Rapportsiden skulle nu se ud som den, der vises i Figur 1-17.
  13. Figur 1-17 Kunde- og kontaktoplysninger tilføjet til en tabel
  14. Vælg skillebladet Vis resultat nederst i layouteditoren. BIRT Report Designer genererer og viser rapporten i HTML-format som vist i Figur 1-18. Blad ned for at se hele rapporten. Du kan også se rapportresultatet i PDF-format. Det gør du ved at vælge Fil->Vis rapport som PDF på hovedmenuen.
  15. Som det ses i Figur 1-18, er dataene rigtige, men de vises i tilfældig rækkefølge. Det giver mere mening at sortere data alfabetisk efter kundenavn. Rapportens udseende skal også forbedres.

    Figur 1-18 Vis resultat for rapportdata

Opgave 6: Sortér dataene

Når du lige har oprettet en rapport og fremviser den, er datarækkerne i rapporten placeret i den rækkefølge, som forespørgslen returnerer dem i. Rækkefølgen kan variere afhængigt af mange faktorer, f.eks. af hvordan data blev indsat i datakilden. Du vil nok for det meste foretrække at ændre dataenes rækkefølge i rapporten.

  1. Vælg Layout for at vende tilbage til layouteditoren.
  2. Åbn Egenskabseditor, hvis den ikke allerede er åben. Hvis du bruger standardperspektivet til rapportdesign, vises egenskabseditoren under layouteditoren. Vælg Vindue->Vis oversigt->Egenskabseditor, hvis oversigten ikke er åben.
  3. Vælg tabellen ved at vælge skillebladet Tabel i nederste venstre hjørne i layouteditoren. Skillebladet vises, når du placerer musens markør over området. Egenskaberne for tabellen vises i egenskabseditoren som vist i Figur 1-19.
  4. Figur 1-19 Egenskabseditor
  5. Vælg skillebladet Sortering.
  6. Vælg Tilføj for at oprette et sorteringsudtryk. Der fremkommer en række under Sorteringsnøgle.
  7. Klik på rækken under Sorteringsnøgle, klik på den pilknap, der vises, og vælg CUSTOMERNAME på listen.
  8. Brug standardværdien Stigende for Sorteringsretning som vist i Figur 1-20.
  9. Figur 1-20 Stigende sorteringsretning
  10. Fremvis rapporten. De sorterede data vises i stigende rækkefølge efter kundenavn som vist i Figur 1-21.
  11. Figur 1-21 Data sorteret efter kundenavn
    Bemærk, at navne, der kun består af store bogstaver, står øverst på listen. BIRT sorterer strengdata ud fra UCS2-tegnværdier. I ASCII-baserede tegnsæt har store bogstaver en lavere tegnværdi end små bogstaver. Store bogstaver vises derfor før små bogstaver.
  12. Du kan sortere kundenavne uden forskel på store og små bogstaver, så ANG Resellers vises efter American Souvenirs Inc., ved at ændre udtrykket i Sorteringsnøgle på siden Sortering til følgende udtryk:
  13. row["CUSTOMERNAME"].toUpperCase( ) 
    
    I udtrykket bruges JavaScript-funktionen toUpperCase( ) til at konvertere alle kundenavnværdier til store bogstaver inden sorteringen. Der skelnes mellem store og små bogstaver i navne på JavaScript-funktioner. Du skal skrive toUpperCase( ) nøjagtigt som vist. Der skelnes også mellem store og små bogstaver i referencer til kolonnenavne. I dette udtryk er row["CUSTOMERNAME"] det korrekte navn. Hvis du f.eks. skriver row["customername"], viser BIRT Report Designer en fejl, når du udfører rapporten. Du kan kontrollere sammensætningen af store og små bogstaver i et kolonnenavn ved at se på det navn, der vises i Data Explorer.
  14. Fremvis rapporten. Kundenavnene vises i en anden rækkefølge. Navne, der kun består af store bogstaver, står ikke øverst på listen.

Opgave 7: Formatér rapporten

Efter du nu har kontrolleret, at de rigtige data vises i den rigtige rækkefølge i rapporten, kan du koncentrere dig om at forbedre rapportens udseende. I dette afsnit beskrives følgende opgaver:

Redigér kolonneoverskrifterne

  1. Vælg Layout for at vende tilbage til layouteditoren.
  2. Dobbeltklik på første kolonneoverskrift, CUSTOMERNAME. Kolonneoverskriften er den første række i tabellen - toptekstrækken.
  3. Hvis du vil erstatte hele den fremhævede tekst, skal du begynde at skrive og derefter trykke på Enter, når du er færdig. Hvis du vil redigere teksten, skal du klikke én gang for at fjerne markeringen af teksten og derefter placere markøren der, hvor du vil slette eller tilføje tegn.
  4. Erstat CUSTOMERNAME med følgende tekst:
    Customer 
    
  5. Gentag trin 2 og 3 for at ændre anden og tredje kolonneoverskrift til følgende tekst:
  6. Phone 
    Contact 
    
    Rapportdesignet skulle nu se ud som det, der vises i Figur 1-22.

    Figur 1-22 Reviderede kolonneoverskrifter i et rapportdesign

Formatér kolonneoverskrifterne

Du formaterer et rapportelement ved at angive dets egenskaber. Det kan du gøre på to måder:

I denne fremgangsmåde bruges første metode til at vælge fed skrift for kolonneoverskrifterne, og den anden metode bruges til at angive toptekstrækkens farve.

  1. Sådan angiver du fed skrift for kolonneoverskrifterne vha. egenskabseditoren:
    1. Vælg alle kolonneoverskrifterne. Du kan vælge flere elementer ved at holde skiftetasten nede, mens du klikker på de enkelte elementer. Egenskaberne for de valgte elementer vises i egenskabseditoren som vist i Figur 1-23.
    2. Figur 1-23 Egenskaber for valgte elementer i Egenskabseditor

    3. Vælg B for at formatere kolonneoverskrifterne som fed tekst.
    4. Klik på et tomt område uden for tabellen for at fjerne markeringen af kolonneoverskrifterne.
  2. Sådan tilføjer du en baggrundsfarve til toptekstrækken vha. en typografi:
    1. Vælg Element->Ny typografi på hovedmenuen.
    2. Ny typografi åbnes som vist i Figur 1-24. I venstre side vises egenskabskategorierne. I højre side vises egenskaberne for den kategori, du vælger.

      Figur 1-24 Ny typografi
    3. Angiv følgende navn på typografien i Tilpasset typografi:
    4. table_header_row 
      
    5. Vælg Baggrund på listen med egenskabskategorier. I Ny typografi vises de baggrundsegenskaber, du kan angive.
    6. Angiv en farve for egenskaben Baggrundsfarve på en af følgende måder:
      • Vælg knappen ud for egenskaben, og vælg derefter en farve på den farvepalet, der vises.
      • Vælg en farve på listen.
      Vælg OK.
    7. Vælg tabellen ved at vælge skillebladet Tabel i nederste venstre hjørne i layouteditoren. Skillebladet vises, når du placerer musens markør over området. Der vises hjælpeceller øverst og til venstre i tabellen som vist i Figur 1-25.
    8. Figur 1-25 Hjælpeceller øverst og til venstre i en tabel
    9. Vælg hjælpecellen ved siden af toptekstrækken. Egenskaberne for den valgte række vises i egenskabseditoren.
    10. Vælg Egenskaber og derefter Generelt for at få vist rækkens generelle egenskaber.
    11. Anvend den typografi, du lige har oprettet, ved at vælge table_header_row på listen ved siden af Typografi. BIRT Report Designer anvender typografien til toptekstrækken, som derefter vises i farve.
  3. Fremvis rapporten. Rapporten skulle nu se ud som den, der vises i Figur 1-26.
  4. Figur 1-26 Rapportfremvisning med typografi for toptekstrække
    Den største forbedring indtil nu er, at overskrifterne er klart definerede og synlige.

Vis for- og efternavn på samme linje

Hvis du placerer flere elementer i en enkelt celle, opretter BIRT Report Designer blokniveauelementer. Hvis du kender til HTML, ved du, at hvert blokelement begynder på en ny linje. Hvis du vil have vist flere elementer på samme linje, skal du placere dem som fortløbende (inline) elementer. Du kan i stedet kombinere værdierne for for- og efternavn i et enkelt dataelement som beskrevet i denne fremgangsmåde.

  1. Vælg Layout for at vende tilbage til layouteditoren.
  2. Slet det dataelement, som viser kontaktpersonens efternavn.
  3. Dobbeltklik på det dataelement, der viser kontaktpersonens fornavn.
  4. I Vælg databinding vises alle de databindinger, der er anvendt i rapporten. Et hak ud for CONTACTFIRSTNAME angiver den databinding, som anvendes af det dataelement, du har valgt.
  5. Klik på cellen med udtrykket dataSetRow["CONTACTFIRSTNAME"], og vælg derefter knappen (...).
  6. Opret udtryk viser følgende udtryk i tekstområdet øverst i vinduet:
    dataSetRow["CONTACTFIRSTNAME"] 
    
  7. Brug følgende udtryk til at kombinere for- og efternavnet:
  8. dataSetRow["CONTACTFIRSTNAME"]+" "+ 
    dataSetRow["CONTACTLASTNAME"] 
    
    Figur 1-27 viser udtrykket i Opret udtryk. De tomme anførselstegn (" ") indsætter et mellemrum mellem fornavnet og efternavnet. Du kan skrive udtrykket i tekstområdet eller dobbeltklikke på et element nederst til højre i vinduet for at indsætte det i udtrykket.

    Figur 1-27 Kombinerede data i Opret udtryk
  9. Vælg OK for at lukke Opret udtryk, og vælg derefter OK i Vælg databinding for at gemme det ændrede udtryk.
  10. Fremvis rapporten. Rapporten skulle nu se ud som den, der vises i Figur 1-28.
  11. Figur 1-28 Rapportresultat, der viser sammenkædede kontaktpersonnavne

Forøg afstanden mellem rækker

I standardlayoutet er der den mindst mulige afstand mellem tabelrækker. Du vil nok ofte vælge at justere afstanden mellem rækkerne.

  1. Vælg Layout for at vende tilbage til layouteditoren.
  2. Vælg alle cellerne i oplysningsrækken (den midterste række). Brug Skift-klik til at vælge flere celler. Sørg for at vælge cellerne, ikke dataelementerne i cellerne. Der vises en boks om de valgte celler som vist i Figur 1-29.
  3. Figur 1-29 Valgte celler i layouteditoren
    Egenskaberne for cellerne vises i egenskabseditoren. Den titel, der vises i Egenskabseditoren, viser den type element, du vælger, så Egenskabseditor - celle burde blive vist.
  4. Vælg Udfyldning. Udfyldningsegenskaberne vises i egenskabseditoren. Med disse egenskaber kan du angive, hvor meget plads der skal tilføjes oven over, neden under, til venstre eller til højre for elementet.
  5. Angiv Udfyldning - Top til 12 punkt.
  6. Du undrer dig måske over, hvor du ikke blot skulle vælge rækken for at justere rækkeafstanden i stedet for at vælge de individuelle celler i rækken. BIRT Report Designer understøtter ikke rækkeudfyldning, da visse browsere ikke understøtter funktionen.
  7. Fremvis rapporten. Rapporten skulle nu se ud som den, der vises i Figur 1-30. Der er mere plads mellem rækkerne med data.
  8. Figur 1-30 Rapportfremvisning med afstand mellem rækkerne

Opgave 8: Opret en rapporttitel

Nu mangler rapporten bare en titel. Du kan enten bruge et etiketelement, et tekstelement eller et dataelement til at få vist en titel:

I denne fremgangsmåde skal du bruge et tekstelement og HTML-koder til at formatere teksten. Bemærk, at brug af HTML ikke er påkrævet for at oprette formateret tekst. Men hvis du kender en del til HTML eller webdesign, vil du måske foretrække at bruge HTML til at oprette en blok med formateret tekst.

  1. Vælg Layout for at vende tilbage til layouteditoren.
  2. Vælg Palet.
  3. Træk tekstelementet fra paletten, og placér det oven over tabellen.
  4. Vælg HTML/dynamisk tekst på den liste i Redigér tekstelement, der viser Almindelig tekst.
  5. Når du vælger HTML eller dynamisk tekst, kan du indbygge HTML-koder eller CSS-egenskaber i teksten. Du kan skrive koderne, eller du kan indsætte de gængse HTML-koder, som er til rådighed i teksteditoren.
  6. Angiv følgende tekst, der vises i Figur 1-31, i tekstområdet:
  7. <CENTER><B><span style="font-size: larger"> 
    Customer List 
    </B></span><BR> 
    <FONT size="small">For internal use only</FONT><BR><BR> 
    Report generated on <VALUE-OF>new Date( )</VALUE-OF> 
    </CENTER><BR><BR> 
     

    Figur 1-31 Tekst med HTML-koder
  8. Vælg OK, og fremvis derefter rapportresultatet. Rapporten skulle nu se ud som den, der vises i Figur 1-32.
  9. Figur 1-32 Rapportfremvisning med formateret rapporttitel

Som det fremgår, giver brug af et tekstelement med indbygget HTML mulighed for følgende:

Du kan i stedet bruge:

Næste trin

Du har nu oprettet din første rapport og arbejdet med nogle af de grundlæggende værktøjer og funktioner i BIRT Report Designer. Du kan oprette mere avancerede rapporter ved at udføre en række andre opgaver. Nogle af opgaverne er beskrevet i andre kapitler i denne bog:


(c) Copyright Actuate Corporation 2006

Forrige emneNæste emne