RepWiz - Teknisk dokumentasjon

Innhold

Introduksjon

Systemoversikt

Programargumenter

Oppsett av .INI-fil

Oppsett av .SQL-fil

Dynamisk SQL

Datofunksjoner i SQL

Flerlagsrapporter

Flere eksempler på dynamisk SQL

Introduksjon

RepWiz er en rapportgenerator hvor det for sluttbruker er lagt stor vekt på et intuitivt og enkelt brukergrensesnitt. Med RepWiz kan man enkelt gjøre uttrekk fra alle typer ODBC-datakilder og få data presentert på en oversiktlig måte. RepWiz kan også eksportere til andre verktøy som f.eks Excel. Oppbygning av rapporter krever noe teknisk kompetanse. Denne tekniske dokumentasjonen vil gi en oversikt over mulighetene for bygging av rapporter i RepWiz.

Systemoversikt

RepWiz består av tre filer. En .exe-fil som er selve programfilen. En .ini-fil og en .sql-fil som sammen definerer rapportene. I .ini-filen angir man datakilden til rapporten og setter hvordan rapporten skal presenteres for sluttbruker. I .sql-filen lages spørringen som danner datagrunnlaget for rapporten.

Programargumenter

Synopsis:
RepWiz.exe
[[-h]/[--help]/-?]
[-inifile <path>]
[-report <name> -type [file|excel|print] -output <path|printername>]
[-timeout <seconds to timeout when connecting to db>]

Dersom ingen programargumenter blir angitt forsøker RepWiz å lese inn og starte med filene RepWiz.ini og RepWiz.sql

Elsempel med programargumenter:
RepWiz.exe -inifile myIni.ini -report REP1 excel -output c:\repports\

Oppsett av .INI-fil

Med en oppsett-.ini-fil setter man opp hvilke rapporter som er tilgjengelig og formateringen på disse.

Oppsett av .SQL-fil

I .sql-filen angir man spørringene som skal danne datagrunlaget for rapportene.

Dynamisk SQL

Ved å bruker følgende syntaks kan SQL setningene bestemmes av bruker ved kjøring. Bruker får da opp dialogbokser ved kjøring for spesifikasjon endelig SQL.

Syntaks:
{ <Dialogboks tekst > | [Rapport tekst] | [Default verdi eller funksjon] | [Lokal konstant/ global variabel] }

<Dialogboks tekst > Teksten som vises i dialogboksen når bruker blir bedt om å spesifiesere en verdi ved kjøring av rapporten.
[Rapport tekst] Denne teksten vises på utskrifter og annet sammen med verdien som brukeren har angitt.
[Default verdi eller funksjon] Tekst eller verdi som kommer som forhåndsvalgt verdi i feltet hvor brukeren skal angi en verdi under kjøring av rapporten. Se de forskjellige funksjoner i seksjonene under.
[Lokal konstant/ global variabel] Dersom denne ikke er definert i .ini.filen som en global variabel, under [VARIABLES], vil denne verdien fungere som en lokal konstant for inneværende rapport og kan kun gjenbrukes innenfor samme rapport for å ungå at man spør etter samme verdi flere ganger. Er den derimot definer i .ini-filen fungerer den som en global variabel og kan settes og gjenbrukes i senere spørringer for andre rapporter, se eksempeler.

Kommenrarer:
Linjer kommenteres vekk ved bruk av --innefor sqlsetningen. På samme måte som i isql.

Datofunksjoner i SQL

Datofunksjoner kan brukes i en dynamsik-sql.

Synopsis:
<date_func(…)>;<datoformat>

Funksjoner:
CurDate([days=0]);
FirstInMonth(year, month, year_corr, month_corr, [days=0]);
LastInMonth(year, month, year_corr, month_corr, [days=0]);
FirstInWeek(year, week, year_corr, week_corr, [days=0]);
LastInWeek(year, week , year_corr, week_corr, [days=0]);

- Hvis year, month eller week blir satt til 0 vil inneværende dato bli brukt.
- xxxx_corr argumentene blir brukt for å korrigere i forhold til datoen spesifisert ved year, month(+/-12) eller week.
- Days argumentet er valgfritt.

Eksempel:
...
WHERE dato > '{Angi ordre dato| Dato > |$FirstInMonth (2005, 4, 0 );&Y.&m.&d; }'

Flerlagsrapporter (drilldown)

Det er mulig å lage flerlagsrapporter i RepWiz, så kalt drilldowns. Dette gjøres ved at rapporter kan åpne andre rapporter med argumenter fra egne kolonner. Det er ingen begrensninger på antall nivåer i en flerlagsrapport.

Eksempel:
Ved dobbeltklikk i rapport 'Ordre' vil den hente opp sin SUB_REPORT som er 'Detaljer' og bruke verdien i kolonne 1 som utvalgskriterie angitt med '{@@C1}'.

Flere eksempler på dynamisk SQL

Cosmo Scientific Consultant AS © 2005

Forskningsparken, Gaustadalléen 21, 0349 Oslo,

Tlf. 22 95 86 45, Fax. 22 60 44 27, E-post: csc@csc.no