Raporttien muokkaaminen itse

Voit muokata Stimulsoft raporttipohjia itsekin. Löydät ohjeen raporttien muokkaamiseen löydät tästä Raportointipalvelu - lemonsoft - Lemonsoft ohjeet

Raporttien tekemisessä on huomioitava muuta asia, jotka on kuvattu seuraavaksi. Normaalisti luot raportit vakioraportista, jolloin asiat ovatkin jo kunnossa.

Huomaathan että raporttien muokkauksen neuvonta ei kuulu Service Deskin palveluun.

Datasource

Datasource on raportille tallennettava tietovaranto, jolla raportti lataa datan itseensä.

Lemonsoftin raporteissa käytetään datasourcena MS SQL -objektia, eli data haetaan Microsoft SQL -serveriltä. Kun datasource luodaan, editori pyytää connection string:ä. Tämä korvataan ohjelman koodissa myöhemmin käyttäjän ympäristöä vastaavaksi, joten arvo voi olla raportin tekijän omaa SQL-serveriä vastaava connection string.

Esimerkki connection string:stä:

Server=LEMON;Initial Catalog=LemonDB1;TrustServerCertificate=True;Integrated Security=True;User ID=<username>;Password=<password>

Korvaa <username> SQL-käyttäjän käyttäjätunnuksellasi ja <password> salasanalla. Catalog tieto on tietokanta, jonka dataa haluat käyttää.

Muuttujat (variables)

Jos käyttäjä voi rajata raportilla esitettävää dataa, niistä tehdään muuttujia. Muuttujilla on tiettyjä perusasetuksia, jotka pitää olla aina oikeassa asennossa. Alla esimerkki muuttujasta, jolla raportille voidaan vaihtaa raportilla esitettävä tuotekoodi.

Muuttujan tekninen nimi. Tämä on sama, mitä SQL-parametrin nimenä käytetään ja on vastattava rajattavan tietokantakentän nimeä.
Muuttujan käyttöliittymässä esitettävä termi. Tämä on aina suomeksi.
Muuttujan tyyppi.
"Request from user" vaikuttaa siihen, että luodaanko muuttujasta parametrikenttä raportin parametripaneeliin.
"Allow using as SQL parameter" -valinnalla annetaan muuttuja käytettäväksi SQL:ssä, eli muuttujaan annettu arvo toimii esim. SQL:n WHERE-ehdossa (kunhan vastaava SQL-parametri on luotu).
Parametripaneelissa näytettävän kentän datasource ja sen asetukset.
1. Muutujille tehdään aina oma datasource.

Initial Selection

Kun tehdään raporttipohjaa, joka avataan tulostukseen (ns. "lomake"), muuttujan "Initial Selection" -arvo on tärkeä jättää arvoksi "From Variable". Jos tähän asettaa "Nothing", ohjelman asettamat arvot kuten laskun numero tai nimike eivät tule voimaan raportille eikä raportti lataudu alussa niitä käyttäen.

Muuttujaa vastaava SQL-parametri

Kun muuttujaa halutaan käyttää SQL-kyselystä, sille on luotava sitä vastaava parametri. Parametrin tyypin ja nimen on vastattava muuttujan tyyppiä ja nimeä. Alla esimerkki yllä esitetyn product_code:n parametristä.

Vakiomuuttujat

Joillain raporteilla on tarve vakiomuuttujiin, joihin lisätään tieto ohjelman koodista. Niiden on aina oltava saman nimisiä, jotta ohjelman koodi osaa käsitellä niitä.

Nimi	Tyyppi	Selite	Pakollisuus

Nimi	Tyyppi	Selite	Pakollisuus
LoginPersonNumber	string	Kirjautuneen käyttäjän person_number
object_id_filter	string	Muuttuja, jonka arvo osoittaa sen muuttujan (tietokannan kentän) nimen, johon raportin päätietueen avainarvo sijoitetaan. Tämä muuttuja alustetaan siis aina arvolla (Init by -> Value). Tämän muuttujan tulee aina olla read only eikä sitä koskaan pyydetä käyttäjältä vaan se on täysin puhtaasti tekninen muuttuja, jota koodi käyttää. Esimerkki: Raportin datan avainarvo on product_code -nimisessä muuttujassa, object_id_filter -muuttujan oletusarvoksi tallennetaan "product_code".	Pakollinen, jos käytetään raportin täytyy tykea massatulostusta, eli filterin arvo on pilkkueroteltu lista.
ds_for_locale	string	DataSourcen sekä sarakkeen nimi, jota käytetään raportin lokalisointiin datasta luetulla arvolla. Täytyy olla aina muotoa: <datasource name>;<column name> Eli jos raportilla on DataSource, jonka nimi on esim. "Main" ja sillä sarake, jonka nimi on "language_code", muuttujan arvoksi tallennetaan: Main;language_code	Pakollinen, jos raportti halutaan lokalisoida datasta luetulla kielellä (oletuksena käyttäjän UI-kieli).
UserLanguageTwoPart	string	Käyttäjän UI-kieli kaksiosaisessa muodossa (esim. "fi-FI")
UserLanguageThreeLetter	string	Käyttäjän UI-kieli kolmikirjaimisessa muodossa (esim. "FIN")
ReportLanguageTwoPart	string	Raportille valittu tulostuskieli kaksiosaisessa muodossa (esim. "fi-FI"). Jos valinta on "oletus", käytetään UI-kieltä, muuten valinnan mukaista.
ReportLanguageThreeLetter	string	Raportille valittu tulostuskieli kolmikirjaimisessa muodossa (esim. "FIN"). Jos valinta on "oletus", käytetään UI-kieltä, muuten valinnan mukaista.

Muuttujat, joita ei näytetä käyttäjälle

Raportille voidaan tehdä muuttujia, joita ei näytetä käyttäjälle käyttöliittymässä, mutta joiden arvo esim. lisätään koodista käsin (esim. vakiomuuttujat). Näille muuttujille on aina asetettava "Read Only" -asetus päälle.

Globalisointi

Raportin termit käännetään erikseen raporttipohjasta, erillisessä käännösprosessissa. Raporttia luodessa kaikki raportille sisäänkirjoitetut termit tulee kirjoittaa suomeksi ja raportin perusasetuksiin on annettava kulttuuriksi fi-FI (esimerkkikuva alla).

Yleisiä asetuksia

Alla on ohjeita raporttipohjan yleisille asetuksille.

Request parameters

Kun tehdään raporttipohjia, joita käytetään tulosteina (ns. "lomake"), on tärkeä jättää "Request Parameters" -arvoksi "False". Esim. nimikerekisteristä avattu tuotetarra ei avaudu ohjelman asettamaan nimikkeeseen vaan esikatselija jää tyhjäksi odottamaan käyttäjän syötettä. Tämä ei ole tarkoituksen mukaista, vaan ohjelma syöttää muutujan automaattisesti ja avaa esikatselun suoraan objektille, jolta tulostusikkuna avattiin.