IBM TRIRIGA Application Platform változat 3 alváltozat 5.2
Jelentéskészítési felhasználói kézikönyv
IBM
Megjegyzés A kiadvány és a tárgyalt termék használatba vétele előtt olvassa el a “Nyilatkozatok” oldalszám: 31 szakasz tájékoztatását.
Ez a kiadás az IBM TRIRIGA Application Platform 3-as verzió, 5. kiadás, 2. módosítására, továbbá minden ezt követő verzióra és módosításra vonatkozik mindaddig, amíg újabb kiadások ezt másképp nem jelzik. © Szerzői jog IBM Corporation 2011, 2016. © Copyright IBM Corporation 2011, 2016.
Tartalom 1. fejezet IBM TRIRIGA jelentéskezelő . . 1 Jelentéstípusok . . . . . . . . . . . . Jelentések összeállítása. . . . . . . . . . Jelentések létrehozása . . . . . . . . . Üzleti objektumok hozzáadása jelentésekhez . Kapcsolódó jelentések hozzáadása . . . . Biztonsági hozzáférés beállítása a jelentésekhez Jelentésoszlopok meghatározása . . . . . Szűrők alkalmazása a jelentéshez. . . . . Rekordok szűrése társítások alapján . . . . Jelentés-felülvizsgálatok összehasonlítása . . Összesítési beállítások megadása a mutatószám jelentésekhez. . . . . . . . . . . . . Lekövetés a mutatószám jelentéseken . . . . . Rendszerjelentések . . . . . . . . . . .
. . . . . . . . . .
. . . . . . . . . .
1 1 1 2 2 3 3 3 4 4
. . .
. 4 . 5 . 5
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban . . . . . . . . 7 BIRT alkalmazás telepítése . . . . . . . . . BIRT folyamatkiszolgálók konfigurálása . . . . . IBM TRIRIGA plug-in for BIRT telepítése . . . . . IBM TRIRIGA bedolgozó frissítése . . . . . . . BIRT jelentésfolyamat . . . . . . . . . . . Kezdő jelentések az IBM TRIRIGA rendszerben . . Kezdeti jelentések létrehozása a lekérdezési jelentésekből . . . . . . . . . . . . Kezdeti jelentések létrehozása az űrlapokból . . Kezdeti jelentések importálása a BIRT alkalmazásba . BIRT jelentések létrehozása . . . . . . . . Adatforrások hozzáadása . . . . . . . . Adathalmazok . . . . . . . . . . . Adattípusok. . . . . . . . . . . . Paraméterek . . . . . . . . . . .
© Szerzői jog IBM 2011, 2016
. . . . . .
7 7 8 8 9 9
. 9 . 9 . 9 . 10 . 10 . 10 . 11 . 14
Adatkérések kontextusa . . . . . . . . Rendszermezők . . . . . . . . . . Globalizáció . . . . . . . . . . . Részjelentések . . . . . . . . . . . Egyéni funkciók . . . . . . . . . . . BIRT jelentések előképének megjelenítése . . . BIRT jelentések exportálása . . . . . . . . BIRT jelentések csomagolása . . . . . . Jelentések feltöltése az IBM TRIRIGA alkalmazásba . . . . . . . . . . . Jelentéskönyvtárak . . . . . . . . . Dokumentumok társítása az IBM TRIRIGA alkalmazással . . . . . . . . . . . . Dokumentumok társítása lekérdezési jelentésekkel Dokumentumok társítása űrlapokhoz . . . . Tömeges nyomtatási műveletek beállítása az objektum átállítása után . . . . . . . . . . . . Tömeges nyomtatási műveletek beállítása a karbantartási űrlapokon . . . . . . . . Tömeges nyomtatási műveletek beállítása a számla űrlapokon . . . . . . . . . . . . Jelentés karbantartása . . . . . . . . . . Jelentések módosítása adathalmaz módosítások nélkül . . . . . . . . . . . . . Jelentések módosítása adathalmaz módosításokkal Szűrőoperátorok . . . . . . . . . . . . Speciális értékek . . . . . . . . . . . . Speciális nevek a rekordmezőben . . . . . . .
. . . . . . . .
14 15 16 17 18 19 20 20
. 20 . 20 . 21 21 . 21 . 21 . 21 . 23 . 23 . 24 24 . 25 . 26 . 28
Nyilatkozatok . . . . . . . . . . . . 31 Védjegyek . . . . . . . . . . . . . . . 33 A termékdokumentációra vonatkozó feltételek és kikötések 33 IBM online adatvédelmi nyilatkozat . . . . . . . 34
iii
iv
© Copyright IBM Corp. 2011, 2016
1. fejezet IBM TRIRIGA jelentéskezelő A Jelentéskezelővel szűrheti, keresheti és rendezheti a jelentéseket. Ezenkívül más jelentésekhez is csatolhatja őket. A Jelentéstervező eszközzel pedig előállíthatja és módosíthatja a jelentéseket. Az IBM® TRIRIGA alkalmazásban a műveletgombokhoz a hivatkozások helyett, állítsa be a SYSTEM_ACTION_STYLE tulajdonságot a TRIRIGAWEB.properties mappában.
Jelentéstípusok A Jelentéskezelőben létrehozhat olyan jelentéseket, amelyeket felhasználhat a kereséshez, szűréshez és rendezéshez, valamint más jelentésekhez csatolhatja őket. A jelentéseket használhatja adatok megjelenítésére. A következő lista a jelentéstípusokat ábrázolja: Jelentés Alapszintű táblázatos jelentés. Grafika A lekérdezést és az információkat CAD rajzokon alapuló webes grafikákból használja. Diagram Az adatokat diagramon jeleníti meg, például kör-, vonal- és rétegezett oszlopdiagramon. Összegzés Táblázatos jelentés, amely az összesítéseket jeleníti meg a részletrekordok nélkül. Hierarchia Lekérdezést használ az információk megjelenítését egy hierarchikus struktúrában. Mutatószám A példányadatokat vagy a ténytáblákat egy táblázatba vagy diagramba összesíti, amely rendelkezik lekövetési útvonalakkal, szűrőkkel és kapcsolódó jelentésekkel.
Jelentések összeállítása A Jelentéskészítő segítségével létrehozhat olyan jelentéseket, amelyekkel szűrést, rendezést és keresést végezhet. Ha Ön hozta létre a jelentést, vagy ha a jelentést olyan csoport osztja meg, amelynek Ön is tagja, akkor a jelentés megjelenik a Saját jelentések lapon.
Jelentések létrehozása A jelentéseket létrehozhatja a Saját jelentések lapon. A jelentéseknek több típusa is van.
Eljárás 1. A Saját jelentések lapon adja meg a jelentés nevét. A névkezelési megállapodás szerint hárombetűs előtagot kell használni, mint például: tri_myreport vagy cst_myreport. 2. Adja meg az azonosítót. Használja az Egyéni vagy a vállalat számkezelési szabványait a jelentésekhez. 3. Adja meg a fejlécet. 4. adjon meg egy címkét egy extra csoportosítás használatához a szűréshez. © Szerzői jog IBM 2011, 2016
1
5. Töltse ki a jelentés leírását. 6. Válassza ki a jelentés típusát. 7. Választható: Jelölje be az Előzmény nyomkövetése jelölőnégyzetet a jelentéselőzmény megtekintéséhez az Előzmény lapon. 8. Választható: A Sorrend & csoport lapon rendszerezze a jelentés elrendezését.
Üzleti objektumok hozzáadása jelentésekhez A jelentésben szereplő üzleti objektumok azonosítják a jelentéshez elérhető adatokat. A jelentés csak a megadott üzleti objektumból származó adatokat kezeli.
Eljárás 1. Az Üzleti objektum allapon válassza ki az Üzleti objektum hozzáadása elemet. 2. Válasszon ki egy modult. 3. Válasszon ki legalább egy üzleti objektumot. 4. Válasszon ki válassza ki űrlapot. Csak a megadott lapokhoz társított adatok kerülnek bele a jelentésbe. 5. Mentse a jelentést. 6. Választható: Leszármazott üzleti objektum hozzáadásához válassza ki a szülő üzleti objektumot, majd válassza ki az Üzleti objektum hozzáadása elemet. 7. Válasszon ki legalább egy társítási beállítást. 8. Választható: A jelentésben megjelenő adatok kibontásához szüntesse meg a Csak az adatmodellezőben meghatározott társítások megjelenítése jelölőnégyzet kijelölését. 9. Az objektum megjelöléséhez az elsődleges társított üzleti objektumként, jelölje be az Elsődleges társított üzleti objektum jelölőnégyzetet. Az elsődleges társított üzleti objektum van a hierarchikus struktúra tetején. Ha megszünteti a jelölőnégyzet kijelölését, akkor a hierarchikus struktúrában a következő társított üzleti objektum az elsődleges társított üzleti objektum. 10. Mentse a jelentést.
Kapcsolódó jelentések hozzáadása A kapcsolódó jelentés egy olyan önálló jelentés, amelynek saját meghatározása és formátuma van. Olyan további információkat jelenít meg, amelyek a megjelenítő számára relevánsak lehetnek. A fő jelentéshez több kapcsolódó jelentés is tartozhat. A kapcsolódó jelentéshez nem tartozhat további kapcsolódó jelentés.
Erről a feladatról Ha másodlagos űrlapot tartalmazó lekérdezés szakaszhoz kapcsolódó jelentést ad hozzá, akkor a kapcsolódó jelentés a másodlagos űrlapot fogja használni. Ha például a lekérdezés szakaszban található eredeti lekérdezés alkalmazottakra vonatkozik és a kiválasztott jelentés alkalmazottakkal kapcsolatos, akkor a kapcsolódó jelentés a másodlagos űrlapot fogja használni. Ha azonban a kiválasztott kapcsolódó jelentés épülettel kapcsolatos, akkor a kapcsolódó jelentés a rekordhoz meghatározott űrlapot fogja használni.
Eljárás 1. A Kapcsolódó jelentések allapon kattintson a Hozzáadás gombra. 2. Válassza ki a modult. 3. Válassza ki a kapcsolódó jelentéseket, majd kattintson az OK gombra. 4. Mentse a jelentést.
2
© Copyright IBM Corp. 2011, 2016
Biztonsági hozzáférés beállítása a jelentésekhez A Biztonság allapon adhatók meg azok a csoportok, amelyek hozzáférhetnek a jelentéshez. A jelentés tulajdonosának teljes hozzáférési jogosultsága van.
Eljárás 1. A Biztonsági hozzáférés szakaszban kattintson a Hozzáadás gombra. 2. Válassza ki azokat a csoportokat, amelyek hozzáférhetnek a jelentéshez, majd válassza ki az Elfogadás lehetőséget. Azoknak a csoportoknak a felhasználói, ahol a leginkább megengedő hozzáférés a Saját jelentésekhez az Olvasás, csak futtathatják a jelentéseket kivéve, ha a jelentés Biztonság lapján a Szerkesztés beállítás ki van jelölve, amely esetben a felhasználók szerkeszthetik is a jelentést. 3. Kattintson a Mentés gombra.
Jelentésoszlopok meghatározása Az Oszlopok lap meghatározza a jelentésben használandó mezőket. A kiválasztott mezők oszlopként jelennek meg a jelentésben.
Erről a feladatról Az Oszlopok lapon szereplő információk szakaszokba vannak rendszerezve. Az Üzleti objektum szakasz jelzi a forrás üzleti objektumokat. Az Oszlopok szakasz azonosítja, hogy a kiválasztott üzleti objektumban mely mezőket kell belefoglalni a jelentésbe. A Megjelenítés oszlopok szakasza adja meg azt a sorrendet, amelyben a kiválasztott mezők megjelennek és az azonosításukra használt címkéket.
Eljárás 1. Válassza ki az üzleti objektumokat. 2. Az Oszlopok szakaszban jelölje be minden egyes mező jelölőnégyzetét, amelyet bele kíván foglalni a jelentésbe. 3. Az Oszlopok megjelenítése szakaszban módosítsa a Jelentéscímke szövegmező szövegét. 4. A mező megjelenítési területe százalékának megadásához adjon meg egy numerikus értéket a Szélesség szövegmezőben. 5. Kattintson a Mentés gombra.
Szűrők alkalmazása a jelentéshez A Szűrők lapon adja meg a mezőket, operátorokat és értékeket, amelyek meghatározzák a jelentésben megjelenítendő eredményeket. A kiválasztott szűrők sorrendben futnak. A jelentések gyorsabban futnak, ha a legtöbb rekordot kiszűrő szűrő kerül először megadásra, majd azt a következő legtöbb rekordot kiszűrő szűrő követi.
Eljárás 1. Válasszon ki egy üzleti objektumot. 2. Az Oszlopok szakaszban minden egyes szűrőként használt mezőhöz jelölje be a jelölőnégyzetet a Felhasználó vagy a Rendszer oszlopban. 3. A Felhasználó szűrő oszlopok szakaszban és a Rendszer szűrő oszlopok szakaszban válasszon ki egy mezőt, majd módosítsa a szűrők alkalmazásának sorrendjét. 4. A szűrőhöz megjelenő címke módosításához változtassa meg a szöveget a Jelentéscímke szövegmezőben. Ha a mező az idő mező, akkor az időt ezredmásodpercben adja meg vagy karaktersorozatként óó:pp:mm formátumban. 5. A Szűrőoperátor legördülő menüben válassza ki az összehasonlítás szűrőoperátort,
1. fejezet IBM TRIRIGA jelentéskezelő
3
6. A Feltételes legördülő listáról válassza ki a feltételes beállítást. Ha az Igen lehetőséget választja, a rendszerszűrő figyelmen kívül marad a lekérdezési eredményekben, ha a szűrő bemenete üres. 7. A futási idő értékkel rendelkező rendszerszűrőkhöz adja meg az egyeztetendő értéket. A Logikai mező szűréséhez használja a TRUE vagy a FALSE értéket. 8. Válassza ki az Összefésülés operátort a rendszerszűrők készletekbe rendezéséhez a sorrend további finomításához, amelyben a szűrők alkalmazva vannak. 9. Kattintson a Mentés gombra.
Rekordok szűrése társítások alapján A Speciális lapon meghatározhatja a társított rekordok típusát, amelyeket a jelentés eredményeinek szűrésére kíván felhasználni.
Eljárás 1. A Társítási szűrők szakaszban kattintson a Hozzáadás gombra. 2. Válassza ki a modult. 3. Válassza ki az üzleti objektumot. 4. Válassza ki a társítás típusát. 5. A szűréshez használandó rekordok megadásához használja a Szűrő típusa és a Rekord/lekérdezés mezőt. Megadhat egy szűrési rekordot speciális névértékekkel. 6. Mentse a jelentést.
Jelentés-felülvizsgálatok összehasonlítása A jelentések mentésekor a rendszer létrehoz egy felülvizsgálatot a jelentés számára. A felülvizsgálat segítségével követheti nyomon a jelentésben eszközölt módosításokat.
Eljárás 1. A jelentés felülvizsgálatainak áttekintéséhez válassza a Felülvizsgálatok lehetőséget. 2. Válassza ki a jelentés két felülvizsgálatát, majd azok összehasonlításához kattintson az Összehasonlítás lehetőségre. 3. Az Összehasonlítás eredményei szakaszban tekintse át az eredményeket.
Összesítési beállítások megadása a mutatószám jelentésekhez A mutatószám jelentések az adatokat táblázatba vagy diagramba összesítik.
Eljárás 1. Nyissa meg a mutatószám jelentést. 2. Az Oszlopok lapon az Összesítési beállítások szakaszban kattintson a Hozzáadás gombra. 3. Adja meg a jelentés címkéjét. 4. Válasszon ki egy függvényt. 5. Adja meg a sorozatszámot. 6. Válassza ki a Field1 elemet a mező meghatározásához, ahol az összesítés történjen. 7. Válasszon ki egy céltengelyt az összesített adatok megjelenítési helyének azonosításához. 8. Válasszon ki egy színt az összesítés ábrázolásához. 9. Kattintson a Mentés gombra.
4
© Copyright IBM Corp. 2011, 2016
Lekövetés a mutatószám jelentéseken Létrehozhat egy mutatószám grafika jelentést a ráközelítéshez az alapul szolgáló adatokra a jelentésben. Miután létrehozza az alapul szolgáló rekordokat ábrázoló mutatószám jelentést, a mutatószám jelentést társíthatja a mutatószám grafika jelentéssel. Létrehozhat egy mutatószám jelentést egy mutatószám típusú jelentés létrehozásával. Amikor a jelentésben kiválaszt egy adatpontot, a rendszer szűri a jelentést az adott adatpont alapján. Készíthet például olyan mutatószám grafika jelentést, amely az eredeti költségvetés összegét ábrázolja státusz szerint. Ha kiválasztja az Aktív státusz adatpontot a mutatószám grafika diagramon, csak az Aktív státuszú alapul szolgáló rekordok jelennek meg. Ezután ráközelíthet a mutatószám jelentés diagramból az alaprekordra. A mutatószám grafika jelentést ugyanúgy hozhatja létre, mint a mutatószám jelentést. A mutatószám jelentés meghatározása után társítsa a jelentést a cél mutatószám grafika jelentéssel. A jelentések társításához nyissa meg a cél grafika jelentést, majd lépjen a Rendelés & Csoport lapra.
Rendszerjelentések A jelentéskezelőben a rendszerjelentések IBM TRIRIGA általános jelentések. A rendszeradminisztrátor megjelölheti a rendszerjelentéseket közösségi jelentésekként. A rendszerjelentéseket a Rendszerjelentések lapon hozhatja létre és jelenítheti meg. Ha egy rendszerjelentés közösségi jelentésként van meghatározva, akkor a Közösség lapon is meg lehet tekinteni. A rendszerjelentést bármelyik alapszintű jelentéstípusban létre lehet hozni, mint például a diagram vagy a mutatószám, vagy a rendszerjelentés létrehozható a következő típusok egyikében is: Külső
Olyan jelentés, amely külső szoftverrel lett létrehozva, mint például a BIRT.
Örökség megtartása Olyan lekérdezés, amely csak az elérhető erőforrások eredményeit adja vissza. Megtartás Olyan lekérdezés, amely úgy viselkedik, mint az Örökség megtartása lekérdezés, de egy naptárt is felhasznál az erőforrások elérhetőségének megállapítására.
1. fejezet IBM TRIRIGA jelentéskezelő
5
6
© Copyright IBM Corp. 2011, 2016
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban A jelentések megjelenítéséhez használja az IBM TRIRIGA Advanced Reporting alkalmazást. Az IBM TRIRIGA Advanced Reporting az Eclipse BIRT alkalmazást és az IBM TRIRIGA bedolgozót használja a BIRT alkalmazáshoz. Az űrlapjelentések egyetlen rekord tartalmát jelenítik meg. A lekérdezési jelentések többrekordos jelentéseket jelenítenek meg. A BIRT alkalmazás elrendezése rács alapú, és minden elemnek a BIRT elrendezésrács egy elemében kell lennie. A rácsos elrendezések a jelentéselemeket sorokba igazítják, az elemeket függőlegesen oszlopokba rendezik, és a tartalomnak megfelelően méretezik az oszlopot. A rácsok segítségével létrehozhat jelentést, az elemek behúzásával a jelentéstervbe. Fontos: Bonyolult jelentések futtatása esetén követnie kell a BIRT és az IBM TRIRIGA jelentéskészítési irányelveket, továbbá figyelembe kell vennie a memóriakiosztásokat. A Java kupacméret fontos paraméter jelentések tervezése, összeállítása és futtatása esetén. Mielőtt BIRT jelentéseket fejleszthetne egy IBM TRIRIGA alkalmazáshoz, telepítse a BIRT jelentéstervezőt, majd állítsa be az IBM TRIRIGA kezelésére.
BIRT alkalmazás telepítése A BIRT jelentéstervezőt egyszer kell telepíteni. Mielőtt elkezdi a telepítést győződjön meg róla, hogy a Java™ JRE támogatott verziója helyileg telepítve van.
Erről a feladatról A támogatott verziókért tekintse meg az IBM Support Matrix Ügyfélkompatibilitás szakaszát.
Eljárás 1. Lépjen a BIRT 4.3.1 elemre az IBM Integrated Service Management (ISM) függvénytár webhelyén. 2. Töltse le a BIRT Report Designer - Minden egyeben verzióját egy helyi könyvtárba. A könyvtárnév nem tartalmazhat szóközöket. 3. A mappában, ahova letöltötte a BIRT terméket, bontsa ki a birt-report-designer-all-inone-4_3_1.zip fájlt, nyissa meg az Eclipse mappát, majd válassza ki az eclipse.exe fájlt. 4. Válassza ki azt a munkaterületet, ahol az Eclipse tárolja a projektfájlokat, majd kattintson az OK gombra.
BIRT folyamatkiszolgálók konfigurálása Beállíthat egy második IBM TRIRIGA kiszolgálót a tehermentesítéshez és a BIRT jelentések feldolgozásához egy különálló BIRT folyamatban. Ha nem állít be egy különálló folyamatkiszolgálót, akkor a BIRT jelentés feldolgozása az alkalmazáskiszolgálón kerül végrehajtásra.
Eljárás 1. Keresse meg a TRIRIGAWEB.properties fájlt.
© Szerzői jog IBM 2011, 2016
7
2. Állítsa be a BIRT_PROCESS_SERVER_LISTENING_PORT tulajdonságot arra a TCP portra, amely a két IBM TRIRIGA kiszolgálóval kommunikál. A kiszolgáló felismeri a BIRT kéréseket ezen a portot. 3. Állítsa be a BIRT_PROCESS_SERVER_HOST_NAME tulajdonságot a BIRT folyamatkiszolgáló hosztnevére vagy IP címére. 4. Állítsa be a BIRT_PROCESS_SERVER_PORT tulajdonságot arra a figyelőportra, amelyet a BIRT folyamatkiszolgálón beállított. 5. Mentse a TRIRIGAWEB.properties fájlt. 6. Indítsa újra a BIRT folyamatkiszolgálót.
IBM TRIRIGA plug-in for BIRT telepítése Az IBM TRIRIGA Advanced Reporting használatához az IBM TRIRIGA plug-in for BIRT alkalmazásnak telepítve kell lenni.
Eljárás 1. Nyissa meg a BIRT alkalmazást, majd válassza ki a Súgó > Új szoftver telepítése menüpontot. 2. A Kezelés mezőben adja meg a következő URL címet az IBM TRIRIGA bedolgozó szoftver webhelyéhez: http://[server:port]/[context path]/eclipse. A [context path] értéket csak akkor használja, ha a kiszolgáló kontextus útvonallal lett beállítva. 3. Válassza ki az IBM TRIRIGA BIRT összetevők elemet. 4. Válassza ki a részleteket, majd kattintson a Tovább gombra. 5. Tekintse meg és fogadja el a licenceket, majd kattintson a Befejezés gombra. 6. Indítsa újra a BIRT alkalmazást. 7. A Munkaterület mezőben válassza ki a munkaterületet, majd kattintson az OK gombra. 8. Az Eclipse alkalmazásban válassza ki az Ablak > Beállítások > IBM TRIRIGA BIRT beállítások elemet, majd adja meg az információkat az IBM TRIRIGA kiszolgáló csatlakoztatásához. 9. válassza ki a Kapcsolat tesztelése lehetőséget, majd a Csatlakoztatva párbeszédablakban kattintson az OK gombra. 10. Választható: Konfigurálja a frissítési értesítéseket. a. Válassza ki az Ablakok > Beállítások menüpontot, bontsa ki a Telepítés/frissítés mappát, majd válassza ki az Automatikus frissítések elemet. b. Válassza ki az Új frissítések automatikus keresése, majd az Értesítsen engem elemet. c. Válassza ki a Frissítés ütemezése, Letöltés és a Ha frissítések találhatók elemet. d. Kattintson az Alkalmaz > Frissítés gombra.
IBM TRIRIGA bedolgozó frissítése Ha elérhető egy új IBM TRIRIGA kiadás, frissítse az IBM TRIRIGA bedolgozót a BIRT Eclipse környezetben.
Eljárás 1. Nyissa meg a BIRT alkalmazást, majd válassza ki a Súgó > Eclipse névjegye elemet. 2. Válassza ki a Telepítési részletek lehetőséget. 3. A Telepített szoftver lapon válassza ki az IBM TRIRIGA BIRT összetevő elemet. 4. Kattintson a Frissítés gombra.
8
© Copyright IBM Corp. 2011, 2016
BIRT jelentésfolyamat A jelentésírók hozzák létre a BIRT jelentéseket. A BIRT jelentések a fejlett jelentéseknek egy típusa a jelentések megjelenítéséhez. A következő lépések bemutatják a BIRT jelentésfolyamatot. 1. Hozzon létre egy kezdeti jelentést az IBM TRIRIGA alkalmazásban. 2. Importálja a kezdeti jelentést a BIRT jelentéstervezőbe. 3. Fejlesszen BIRT jelentést. 4. Jelenítse meg a BIRT jelentés előképét. 5. Exportálja a BIRT jelentést. 6. Töltsön fel egy BIRT jelentést az IBM TRIRIGA alkalmazásba. 7. Társítsa a BIRT jelentést egy IBM TRIRIGA hozzáférési ponttal.
Kezdő jelentések az IBM TRIRIGA rendszerben A kezdő jelentésfájlok az IBM TRIRIGA alkalmazásból kerülnek letöltésre. A jelentéseket létrehozhatja meglévő jelentésekből, lekérdezési jelentésekből vagy űrlapokból.
Kezdeti jelentések létrehozása a lekérdezési jelentésekből Az új vagy meglévő IBM TRIRIGA lekérdezési jelentésből kezdeti jelentést hozhat létre. A lekérdezési lekérdezések tartalmazhatnak adatokat a felső szintű rekordokból. Ezenkívül több részletszintet is tartalmazhatnak, amelyek a társított üzleti objektumok és rekordok használatával érhetők el. A lekérdezési jelentések legtöbbször többrekordos jelentéseket jelenítenek meg.
Eljárás 1. Az IBM TRIRIGA jelentéskezelőben lépjen a modellként használandó jelentésre vagy lekérdezésre. 2. Válassza ki a Speciális elemet, majd válassza ki a BIRT jelentés hivatkozást. 3. Kattintson a Mentés gombra. 4. Válassza ki a helyet a kezdeti fájl letöltéséhez, majd kattintson a Mentés gombra.
Kezdeti jelentések létrehozása az űrlapokból Az új vagy meglévő IBM TRIRIGA űrlapból kezdeti jelentést hozhat létre. Az űrlapjelentések jellemzően a felső szintű rekordból tartalmaznak adatokat. Ezek több társított rekordból is tartalmazhatnak adatokat. A rekord Jelentések lapján választhatja ki az űrlapjelentéseket. Az űrlapjelentést az űrlap megjelenítéséhez is futtathatja több felső szintű rekordból.
Eljárás 1. Az IBM TRIRIGA Űrlapkészítőben válassza ki az Elrendezés elemet, majd kattintson a BIRT jelentés hivatkozásra. 2. Kattintson a Mentés gombra. 3. Válassza ki a kezdeti fájl letöltési helyét, majd kattintson a Mentés gombra.
Kezdeti jelentések importálása a BIRT alkalmazásba A kezdeti jelentéseket az IBM TRIRIGA alkalmazásból a BIRT jelentéstervezőbe importálhatja.
Erről a feladatról Ha a tömörített fájl kibontási eszköze lehetővé teszi, a .zip fájlt megnyithatja a BIRT Report Designer Navigator panelen, majd a fájlokat az adott jelentésprojektbe húzhatja. 2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
9
Eljárás 1. A BIRT alkalmazásban válassza ki a Fájl > Új > Projekt menüpontot. 2. Válassza ki az Business Intelligence mappát, majd válassza ki a Jelentésprojekt > Következő elemet. 3. Adja meg a projekt nevét, majd kattintson a Befejezés gombra. 4. A Jelentésterv ablakban válassza ki a Navigátor elemet, kattintson a jobb egérgombbal a projektre, majd válassza az előugró menü Importálás menüpontját. 5. Jelölje ki a tömörített fájlt, amelyet akkor töltött le, amikor a kezdeti jelentést létrehozta az IBM TRIRIGA alkalmazásban, majd kattintson a Befejezés gombra. 6. Ellenőrizze, hogy a kezdeti jelentés megjelenik a Navigátor lapon.
BIRT jelentések létrehozása A BIRT jelentés létrehozásához használja a BIRT jelentéstervezőt az importált .rptdesign fájl módosítására. A BIRT jelentések IBM TRIRIGA információkat tartalmaznak.
Adatforrások hozzáadása A BIRT jelentésekben az összes adat az adatforrásokon keresztül érhető el. A kezdeti jelentés egyetlen TRIRIGA nevű adatforrást tartalmaz. A TRIRIGA parancsfájlokat tartalmazó adatforrás. Minden olyan adatforrásnak, amely az adatokat az IBM TRIRIGA kiszolgálóról kérdezi le, ezt az adatforrást kell használnia.
Erről a feladatról Ha a TRIRIGA adatforrás nem adja meg az összes szükséges adatot, akkor használhatja a BIRT által támogatott alábbi hozzáférési metódusokat, beleértve a JDBC-t és az XML-t. A JDBC adatforrást kézzel kell hozzáadni és a TRIRIGA_DB nevet kell neki adni. Futás közben a jelentés módosításra kerül, hogy együttműködjön az IBM TRIRIGA adatbázissal, amely társítva van a jelentést futtató kiszolgálóval.
Eljárás 1. A BIRT alkalmazásban válassza ki a Data Explorer elemet. 2. Kattintson a jobb egérgombbal az Adatforrások elemre, majd válassza az előugró menü Új adatforrás menüpontját. 3. Válassza ki a JDBC adatforrás elemet, majd az Adatforrás neve mezőben adja meg a TRIRIGA_DB nevet. 4. Kattintson a Tovább gombra. 5. Választható: Válassza ki az Illesztőprogram osztály elemet, majd adja meg az adatbázis URL címét, felhasználónevét és a jelszót. 6. Adja meg az adatbázis URL címét, felhasználónevét és a jelszót. 7. A JNDI URL ,ezőben adja meg a jdbc/local/Datasource-TRIRIGA-data értéket, majd kattintson a Befejezés gombra. 8. Kattintson a jobb egérgombbal az Adathalmazok elemre, majd válassza ki az új adathalmaz nevét. 9. Adja meg az SQL utasítást. 10. Választható: Adja hozzá a paramétereket. 11. Kattintson a Befejezés gombra.
Adathalmazok A kezdeti jelentés legalább egy adathalmazt tartalmaz. Az adathalmaz modellezi az IBM TRIRIGA jelentést vagy az űrlapot, amelyet eredetileg a BIRT jelentés hozott létre.
10
© Copyright IBM Corp. 2011, 2016
Az adathalmaz neve ábrázolja az IBM TRIRIGA jelentést vagy űrlapot. Például a triFiscalPeriods_-_Find_-_Years jelentést modellező adathalmaz neve [v2QRY]Classification_triFiscalPeriods_triFiscalPeriods_-_Find_-_Years. Az IBM TRIRIGA lekérdezésből exportált kezdeti jelentésnek egy adathalmaza van. Az adathalmazban olyan oszlopok vannak, amelyek az IBM TRIRIGA lekérdezésben tartalmazott oszlopokra vonatkoznak. Például az IBM TRIRIGA triFiscalPeriods - Keresés Év jelentés a következő oszlopokat kérdezi le: Név, Kezdő dátum, Befejező dátum és Hierarchia-útvonal. Az IBM TRIRIGA űrlapból exportált kezdeti jelentés több adathalmazzal is rendelkezhet. Az egyik, [v2BO] előtaggal rendelkező adathalmaz létezik a kezdeti jelentésben. Az adathalmaz az űrlap felső szintű adatait ábrázolja és olyan oszlopokkal rendelkezik, amely az üzleti objektum mezőire vonatkozik az űrlap felső szintű üzleti objektumához. Az űrlap üzleti objektumában minden intelligens szakasz a [v2SS] előtaggal van ábrázolva. Ezek az Intelligens szakasz adathalmazok olyan oszlopokat tartalmaznak, amelyek az üzleti objektum mezőkre vonatkoznak az adott szakaszokban. A system__parentRecordId bemeneti paraméter megadja az adathalmazhoz lekérendő adatokat. Az űrlapon minden lekérdezési szakasz normál lekérdezési adathalmazként van ábrázolva és az előtagja [v2QRY]. A beépített system__parentRecordId bemeneti paraméter megadja az adathalmazhoz lekérendő adatokat. A kezdeti jelentésben a system__parentRecordId bemeneti paraméterek nincsenek a felső szintű üzleti objektum adathalmazhoz kötve. A paramétereket a jelentés elrendezésében kell összekötni.
Adattípusok Az IBM TRIRIGA rendszerből származó adatok megőrzéséért a rendszer visszaad minden üzleti objektum mezőadatot az IBM TRIRIGA alkalmazásból Java objektumok formájában. Minden kezdeti jelentésnek van olyen kimeneti oszlop, amely Java objektumként van modellezve. A Java objektumokhoz használja a következő irányelveket: v Amikor a jelentésben egy értéket használ, ismernie kell a BIRT típust a leképezéshez. v Ha gyakran használ értékeket, több parancsfájlkészítésre van szükség. v Amikor áthúz egy IBM TRIRIGA elemet közvetlenül a jelentésbe, az elem megjelenik a jelentésben. Ha a kimenet oszlopot valami másra szeretné használni a megjelenítésen kívül, akkor az SQL értéket elérheti a kimeneti oszlopból bármelyik BIRT kifejezésben az objektum getNativeValue() metódusának használatával. Például a Kifejezéstervezőben adja meg a következő értéket: row["Classification_triFiscalPeriods_triStartDA"].getNativeValue(). Ha a Java objektumnak további metódusai is vannak, akkor elérheti őket bármelyik BIRT kifejezés használatával. Amikor az alábbi kifejezéseredmények egyikét egy jelentéselemhez csatolja, válassza ki a megfelelő BIRT típust az összes beépített BIRT funkció eléréséhez. Amikor a kimeneti oszlopot a jelentésre helyezi, a BIRT automatikusan a toString() metódust használja. Az érték eléréséhez használja a következő fő parancsfájlt: row["Classification_triFiscalPeriods_triStartDA"].getNativeValue().
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
11
A kezdeti jelentések exportálásakor minden adat leképezésre kerül Java objektumokra a BIRT jelentésben. Minden Java objektum tartalmazza minimálisan a getNativeValue() és a toString() metódust. Java objektumok: A kezdeti jelentések exportálásakor minden adat leképezésre kerül Java objektumokra a BIRT jelentésben. Minden Java objektum rendelkezik a getNativeValue() és a toString() metódussal. A következő táblázat a Java objektum és az üzleti objektum mezőtípus további metódusairól nyújt információkat. 1. táblázat: Java objektumok
Üzleti objektum mezőtípus
getNativeValue() eredmény
toString() megfontolásai
További metódusok
Javasolt BIRT kötések a natív érték használata esetén
Szöveg
java.lang.String
N/A
N/A
Karaktersorozat
Szám
java.math.Big Decimal
UOM metaadatok és BO mezőmaszkok
getUom().getUom TypeCode()
Decimális
Pénzügyi göngyölítés
getUom.getUom Value() A Has Uom() hibás értéket ad vissza, ha nincs UOM.
12
Osztályozásösszesítés
java.math.Big Decimal
BO mezőmaszkok
N/A
Decimális
Dátum
java.sql.Date
Felhasználó időzónája és preferált megjelenítési formátuma
N/A
Dátum
Dátum/időpont
java.sql.Date
Felhasználó időzónája és preferált megjelenítési formátuma
N/A
Dátum és időpont
Időpont
java.sql.Time
A megjelenítése óra/perc/ másodperc időzóna tényező nélkül.
N/A
Az időpontért ebből az értékből használjon GMT naptárt.
Helymeghatározó
java.lang.String
N/A
N/A
Karaktersorozat
Időtartam
java.lang.Long
N/A
Decimális
© Copyright IBM Corp. 2011, 2016
Olyan formátumok, Egy érték, amely az amelyek az IBM Időtartam TRIRIGA komponenseket egyetlen preferált értékbe kódolja. Az IBM formátumát TRIRIGA adatbázisban használják és kerül tárolása és egy figyelembe veszik adott időtartam értéket a felhasználó ábrázol. Ez az érték nyelvét. valószínűleg ábrázolja az ezredmásodpercek összesített számát az adott időtartamhoz.
1. táblázat: Java objektumok (Folytatás)
További metódusok
Javasolt BIRT kötések a natív érték használata esetén
BO mező beállítása teljes hierarchia-útvonal és felhasználói nyelv
N/A
Karaktersorozat
java.lang.String (nem lefordított)
Felhasználó nyelve
N/A
Karaktersorozat
Logikai
java.lang.Boolean
N/A
N/A
Logikai
Kép
byte[]
Visszaadja a kép N/A elérési útját, ahogy az IBM TRIRIGA adatbázisban tárolva van
Kép
Bináris
byte[]
A tartalomazonosító karaktersorozatos ábrázolása, a DM_CONTENT tábla kulcsa
N/A
Blob
UOM
java.lang.String
getUomValue() lefordítva az aktuális felhasználó nyelvére
getUom().getUom TypeCode()
Karaktersorozat
Üzleti objektum mezőtípus
getNativeValue() eredmény
toString() megfontolásai
Osztályozás
java.lang.String (nem lefordított érték)
Lista
(Nem lefordított érték)
getUom.getUom Value() getUomValue() értéke NULL, ha nincs érték
Jelszó
java.lang.String
N/A
N/A
Karaktersorozat
SystemField_Bo RecordId
java.lang.Long
N/A
N/A
Decimális
SystemField_
java.lang.Long
N/A
N/A
Decimális
SystemField_ ModifiedDate Time
java.sql.Date
Felhasználó időzónája és preferált megjelenítési formátuma.
N/A
Dátum és időpont
SystemField_ CreatedDate Time
java.sql.Date
Felhasználó időzónája és preferált megjelenítési formátuma
N/A
Dátum és időpont
SystemField_ Modified DateTimeNumber
java.sql.Date
Felhasználó időzónája és preferált megjelenítési formátuma
N/A
Dátum és időpont
SystemField_ ProjectId
java.lang.Long
N/A
N/A
Decimális
SystemField_ BoTypeId
java.lang.Long
N/A
N/A
Decimális
SystemField_Parent
java.lang.Long
N/A
N/A
Decimális
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
13
Paraméterek Az IBM TRIRIGA alkalmazásban a lekérdezések és a jelentések olyan paraméterekkel rendelkeznek, amelyek szűrik a lekérdezésekből visszaadott adatokat. A Jelentéskezelőben a szűrők segítségével állíthatja be a lekérdezés- és a jelentésszűrőket. Ha egy BIRT adathalmaz IBM TRIRIGA lekérdezést használ, és a lekérdezésben felhasználói bemeneti szűrők vannak megadva, akkor minden egyes szűrő megjelenik a kezdeti jelentésben. A szűrők a Data Explorer lapon jelennek meg a Jelentésparaméterek mappa felső szintű bejegyzéseként. A jelentésparaméterek adják meg a felhasználói parancssort a jelentés futtatása előtt. A szűrők a Paraméterek szakaszban jelennek meg, annak az adathalmaznak a paramétereként, amely az IBM TRIRIGA lekérdezést modellezi. A bejegyzés átadja az adathalmazhoz megadott jelentésparaméter értékét. Amikor szűrőre van szükség, az IBM TRIRIGA lekérdezés a felhasználói szűrővel felhasználói parancssorként jelenik meg és az eredményeket az IBM TRIRIGA lekérdezés meghatározása alapján szűri. A mező alapértelmezett címkéje az Üzleti objektum mező címkéje. Ezekhez a jelentésekhez hozzáadhat egyéni címkét és súgószöveget. Ha egy jelentésben több felhasználói szűrő szerepel ugyanabban a mezőben, akkor az összes szűrő megjelenik a jelentésben. A BIRT egy olyan utótaggal azonosítja a paramétereket, amely a pozíciójukra vonatkozik a lekérdezésben. A BIRT nem biztosít eszközöket a megkülönböztetéshez a figyelmen kívül hagyandó szűrők és a NULL szűrőérték között. Ha a NULL értéket választja ki a jelentésparaméterhez, amely egy IBM TRIRIGA lekérdezésszűrőre képeződik le, akkor a szűrő nem kerül felhasználásra. A szöveges paramétertípusokhoz megadhat NULL értéket és az IBM TRIRIGA lekérdezési alrendszer a NULL értéket használja szűrőértékként. Az IBM TRIRIGA BIRT integráció csak akkor dolgozza fel helyesen az Idő paraméterszűrőt, ha karaktersorozat adattípust használ az Idő paraméterhez. Ha az Idő paraméterszűrőhöz az Idő adattípust használja, akkor a TRIRIGA BIRT megjelenítő nem jelenít meg hibát, de nem szűri megfelelően az eredményeket. Az IBM TRIRIGA BIRT integráció csak akkor dolgozza fel megfelelően a nem angol nyelvű dátum, valamint dátum és idő formátumot a Dátum és a Dátum/időpont paraméteren, ha ezek karaktersorozat adattípusként vannak beállítva.
Adatkérések kontextusa Az IBM TRIRIGA alkalmazásban az adatkérésekhez kontextusadatokat kell hozzáadni. A kontextust meg kell adni az aktuális felhasználóhoz, a rekordhoz és a projekthez. A BIRT előkép környezet adja meg a felhasználói kontextust az IBM TRIRIGA BIRT beállításokból. Az IBM TRIRIGA futási környezet a bejelentkezett felhasználóktól kéri le az adatokat. A BIRT előképben és az IBM TRIRIGA futási környezetben is, a rekordkontextus egy jelentésparaméterként megy át a BIRT jelentésen és le az adathalmazokhoz. A lekérdezéshez a kezdeti jelentésnek van egy nem kötelező, rejtett system__parentRecordId jelentésparamétere. A lekérdezési adathalmazhoz egy system__parentRecordId bemeneti paraméterrel rendelkezik, A jelentés futtatásakor, ha
14
© Copyright IBM Corp. 2011, 2016
egy nullától különböző érték kerül átadásra a paraméteren keresztül az IBM TRIRIGA alkalmazásba, akkor $$RECORDID$$ értékké válik az IBM TRIRIGA lekérdezés futtatásakor. Az űrlap kezdeti jelentésében a system__recordIds paraméter kötelezően megadandó jelentésparaméter. A system__recordIds paraméter az űrlapjelentés által előállított rekordazonosítók vesszővel tagolt listája. A tömeges jelentési követelményekhez több azonosítót is használhat. A BIRT előkép környezetben a rendszer parancssort használt a system__recordIdsérték begyűjtéséhez az űrlapjelentés előképének megjelenítéséhez. A következő system__recordIds egy példa: system_recordIds 1590609, 1345105, 1295530. A jelentésmeghatározásban, akkor is, ha a jelentésnek van olyan paramétere, amely nem rejtettként van beállítva, a parancssor nem jelenik meg az IBM TRIRIGA futási környezetben, mert a futási környezet adja meg az értéket. A BIRT előkép környezetben adjon meg egy projektkontextust az IBM TRIRIGA BIRT Beállítások szakaszában a projektazonosító bemenettel. A BIRT előképkörnyezet a projektazonosító bemenetet használja a projektkontextus megadására mindegyik IBM TRIRIGA kéréshez.
Rendszermezők Néhány olyan mező, amely be van építve a BIRT jelentésbe, nincs beépítve az IBM TRIRIGA üzleti objektum mezőibe. Az alábbi táblázat tartalmazza a speciális nevekkel rendelkező rendszermezőket, amelyeknek speciális jelentésük van az IBM TRIRIGA-BIRT integrációhoz. 2. táblázat: Rendszermezők Rendszermező
Használat
system__recordIds
Az üzleti objektum adathalmazok adathalmaz-bemeneti paramétere.
system__recordId
Az üzleti objektum adathalmazok adathalmaz-bemeneti paramétere.
Leírás
Az Űrlap jelentésekből visszaadott rekordokat vezérlő rekordazonosítók vesszővel határolt listája. A megadása kötelező, ha nem használja a Űrlapjelentések jelentésbemeneti system_recordId bemeneti paramétere. paramétert. Számérték, amely az Üzleti objektum adathalmazból visszaadandó egyetlen rekordot ábrázolja. A lekérdezés jelentéshez ennek a mezőnek a kitöltése kötelező. Az űrlap jelentés esetében ennek a mezőnek a kitöltése akkor kötelező, ha nem használja a system_recordIds bemeneti paramétert.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
15
2. táblázat: Rendszermezők (Folytatás) Rendszermező
Használat
Leírás
system_parentRecordId
Lekérdezési adathalmazok adathalmaz-bemeneti paramétere.
A jelentések és adathalmazok rekordkontextusát adja meg.
Az intelligens szakasz adathalmazok adathalmaz-bemeneti paramétere.
Az intelligens szakaszokhoz a system_parentRecordId érték megadása kötelező, ez vezérli a visszaadandó rekord szakaszadatait.
Lekérdezés jelentés jelentésbemeneti paramétere.
A Lekérdezési adathalmazok esetében a $$RECORDID$$ és a $$PARENT változó kerül felhasználásra az IBM TRIRIGA lekérdezés meghatározásában.
system__recordId
Kimeneti oszlop az IBM TRIRIGA adathalmazok összes típusához.
Minden IBM TRIRIGA adathalmaznak van egy system_recordId nevű kimeneti oszlopa. Az oszlop tartalmazza a visszaadott rekord azonosítóját. Az egyetlen eset, amikor ez az oszlop NULL értékkel kerül visszaadásra, annál a hivatkozásnál fordul elő, amely nem jelentkezik át módosított intelligens szakasszal. Ebben az esetben nincs beépített IBM TRIRIGA rekord.
system__sourceRecordId
Intelligens szakasz adathalmazok Minden intelligens szakasz adathalmaz kimeneti oszlopa. adathalmaznak van egy system_sourceRecordId nevű kimeneti oszlopa. Az érték tartalmazza azokat az adatokat, amelyekből az intelligens szakasz rekord inicializálva lett, amelynek neve forrásrekord. A system_sourceRecordId segít megkülönböztetni a szakaszrekordot a forrásrekordtól.
Globalizáció A kezdeti jelentés és az IBM TRIRIGA-BIRT integráció olyan szolgáltatásokat biztosít, amelyek segítenek a jelentések globalizálásában. Mielőtt exportálja a BIRT jelentések címkéit, győződjön meg róla, hogy ezek a jelentések be vannak állítva az IBM TRIRIGA alkalmazásban. Az IBM TRIRIGA-BIRT integráció a dátumok honosításához. A megjelenítési karaktersorozat az összes IBM TRIRIGA Dátum és Dátum/időpont mezőhöz a felhasználó preferált dátumformátumába kerül formázásra. Ezenkívül a formatDate() egyéni függvény és a formatDateTime() egyéni függvény egy BIRT Dátum vagy Dátum/időpont mezőt ábrázol az IBM TRIRIGA felhasználók preferált dátumformátumában. Az IBM TRIRIGA minden címkét lefordít a BIRT jelentésben. A kezdeti jelentés az összes olyan címkét tartalmazza, amelyet le kell fordítani a jelentés üzleti objektum mezőcímkéire.
16
© Copyright IBM Corp. 2011, 2016
A kezdeti jelentés egy erőforrás tulajdonságfájlhoz kerül társításra tririgalabels.properties kiterjesztéssel. Ezt a társítást megtekintheti az Erőforrás szakaszban a Tulajdonságszerkesztő – Jelentés lapon. Ez a jelentés erőforrás arra a tulajdonságfájlra mutat, amely a címkekulcsokat tartalmazza a jelentésben összeállított minden üzleti objektum mezőhöz. A kezdeti jelentésben minden egyes kulcs már társítva van a megfelelő adathalmaz kimeneti oszlopával a BIRT jelentésben. Ha vászonként a Data Explorer-t használja, akkor az elemeket anélkül húzhatja a vászonra, hogy újra társítani kellene ezeknek az elemeknek a megjelenítési kulcsát. Ha nem húzza az elemeket a vászonra, akkor is használhatja még a tulajdonságfájlban található összes címkét minden jelentéselemen. A tulajdonságfájlban akkor használja a címkéket, amikor az elrendezésben kiválaszt egy jelentéselemet, majd a Honosítási tulajdonságok szakaszba lép a Tulajdonságszerkesztő – Címke lap Tulajdonságok lapján. Futás közben a kulcsokat használó szöveg az aktuális felhasználó nyelve alapján kerül lefordításra. Ha a jelentésben olyan címkét igényel, amely nem érhető el a kezdeti jelentés tulajdonságfájljában, akkor a fájlhoz kulcsokat és címkéket adhat hozzá. A kulcsnév nem kezdődhet a [FIELD] speciális előtaggal. Az IBM TRIRIGA bármilyen felhasználó által létrehozott címkét le tud fordítani. A BIRT jelentéskönyvtára tartalmazhat újrahasználható jelentéselemeket, beleértve a címkéket. Hozzon létre egy tulajdonságfájlt tririgalabels.properties kiterjesztéssel, majd könyvtár-erőforrásként hivatkozzon az adott tulajdonságfájlra. A BIRT jelentéskönyvtár tulajdonságfájljának megtekintéséhez válassza ki a könyvtárt a BIRT navigátorban, majd tekintse meg a tulajdonságait a Tulajdonságszerkesztő – Könyvtár lapon. A könyvtár olvasásához minden egyes BIRT jelentésnek hivatkozni kell a könyvtárra, mielőtt exportálja és feltölti a jelentést az IBM TRIRIGA alkalmazásba.
Részjelentések Részjelentéseket állíthat össze egy adott jelentés felső szintjébe vagy különálló .rptdesign fájlokba teheti őket. Egy jelentés például megjeleníthet beszerzési megrendelés fejléceket. Minden egyes fejlécben a jelentés megjeleníti a sorcikkeket az adott beszerzési megrendeléshez. Ebben az esetben beszerzési megrendelés sorcikke a beszerzési megrendelés fejlécadatainak részjelentéseként jelenik meg. A részjelentéseket az .rptdesign fájlba állítsa össze a fő jelentésként. Egyetlen jelentés megjelenítheti a pénzügyi éveket és a pénzügyi negyedéveket, ahol a pénzügyi évek a szülőrekordok és a pénzügyi negyedévek az egyes pénzügyi évek pénzügyi negyedévei. Az egyedülálló jelentésekhez használja a következő irányelveket: v A rekordrekord visszaadásra kerül minden egyes szülő adathalmaz eredményéhez. v A leszármazott IBM TRIRIGA lekérdezés az eredményeket a szülőrekord alapján szűri. v A leszármazott adathalmaz a szülőazonosítót veszi fel paraméterként. Ha a BIRT elküld egy system_parentRecordId paramétert 0 alapértelmezett értékkel, akkor az IBM TRIRIGA rendszer figyelmen kívül hagyja. v A jelentés elrendezésének leszármazott táblájában a Paraméterkötés adathalmaz összeköti a szülőrekord azonosítóját a leszármazott adathalmaz bemeneti paraméterével. A részjelentéseket különböző .rptdesign fájlokba állíthatja össze. Megjelenítheti például az összes pénzügyi évet egyetlen listán, amely hiperhivatkozásokat használ a felhasználó átviteléhez a kiválasztott év negyedéveire. Ebben az esetben a pénzügyi negyedévek önálló .rptdesign fájlok. 2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
17
Az önálló jelentésfájlokhoz használja a következő irányelveket: v Mindegyik tömörített fájl felső szintjén, amelyet az IBM TRIRIGA alkalmazásba importál, lennie kell legalább egy .rptdesign fájlnak. A részjelentéseknek a többi .rptdesign fájlban az alkönyvtárban kell lenni. v Amikor beállítja a hiperhivatkozást, a felső szintű jelentésből a system__recordId paramétert a részjelentés system__parentRecordId jelentésparaméteréhez kell kötni. Erre példák a pénzügyi évek és a pénzügyi negyedévek.
Egyéni funkciók Az egyéni funkciók adott használati esetekben segítenek. Az egyéni funkciók a BIRT Expression Builder TRIRIGA kategóriájában találhatók. A következő táblázat az egyéni funkciókat mutatja be: 3. táblázat: Egyéni funkciók. Egyéni funkciók Név
Leírás
Bemenet
Visszatérés
formatNumber
Az IBM TRIRIGA a számok formázására használja.
number - BigDecimal: Formázandó számérték
Karaktersorozat: a formázott szám
unitOfMeasure TriResultUom: A szám formázásához használt mértékegység. Használhat NULL értéket, ha nincs elérhető UOM, de az encodedBoFieldName bemenetet kell használni. encodedBoFieldName Karaktersorozat [nem kötelező]: Az a BO mező, amelyből a szám jön. Ott használja, ahol alkalmazható, mert a mező metaadatai befolyásolhatják a számformázást.
18
formatDate
Az IBM TRIRIGA a dátum formázására használja. A felhasználói profilrekordban megadott preferált formátumot használja.
date - java.util.Date: Formázandó dátum
Karaktersorozat: a formázott dátum
formatDateTime
Az IBM TRIRIGA a dátum/időpont formázására használja. A felhasználói profilrekordban megadott preferált formátumot használja.
dateTime java.util.Date: Formázandó dátum/időpont
Karaktersorozat: a formázott dátum/időpont
© Copyright IBM Corp. 2011, 2016
3. táblázat: Egyéni funkciók (Folytatás). Egyéni funkciók Név
Leírás
Bemenet
Visszatérés
getProjectIdFor-Record
Visszaadja a projekt rekordazonosítóját, amelyben a rekord benne van. NULL értéket ad vissza, ha a rekord nincs benne a projektben.
A rekord azonosítója. Jellemzően egy IBM TRIRIGA eredményrekord system__recordId értéke.
Decimális: annak a projektnek az azonosítója, amelyben a rekord benne van.
getRootOrganiza-tionId Visszaadja a fő szervezet rekordazonosítóját.
N/A
Decimális: Az IBM TRIRIGA fő szervezetrekordjának azonosítója.
getCompany-LogoId
Visszaadja a vállalati logó dokumentum azonosítóját.
N/A
Decimális: a vállalati logó dokumentum azonosítója.
getProjectLogoId
Visszaadja a projekt logó dokumentumának azonosítóját.
N/A
Decimális: az aktuális projekt logó dokumentumának azonosítója.
getUserId
Visszaadja a jelenleg bejelentkezett felhasználó azonosítóját.
N/A
Decimális: az aktuális felhasználó azonosítója.
getProjectId
Visszaadja az aktuális N/A projekt azonosítóját. NULL értéket ad vissza, ha a felhasználó jelenleg nincs benne a projektben.
Decimális: az aktuális projekt azonosítója.
BIRT jelentések előképének megjelenítése A jelentések előképét megtekintheti a BIRT jelentéstervező Előkép lapján. A BIRT alkalmazásban állítsa be az értékeket az IBM TRIRIGA BIRT Beállítások szakaszában a kontextus átadására az IBM TRIRIGA alkalmazásból a BIRT jelentésbe az előkép megjelenítésének végrehajtása közben. A beállítási értékeket akkor adja meg, amikor megadja a csatlakozási információkat az IBM TRIRIGA kiszolgálóhoz. A következő kontextustípusok adhatók át: Aktuális felhasználó Az IBM TRIRIGA alkalmazáskiszolgáló, felhasználónév és jelszó mező értékének megadásakor állítsa be. Aktív projekt Egy adott projekt rekordazonosítójának megadásakor állítsa be. Az aktív projekt miatt az előkép szimulálja a végrehajtást a megadott tőkeprojekt kontextusában. Bemeneti paraméterek A BIRT alkalmazás kérdez rá. Amikor megjeleníti egy jelentés előképét, a BIRT alkalmazás felszólítja a jelentésen megadott bemeneti paraméterek megadására. Ezek az értéket kontextusként is szolgálnak a jelentés futtatásához.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
19
BIRT jelentések exportálása A BIRT jelentéseket visszaexportálhatja az IBM TRIRIGA alkalmazásba, így az IBM TRIRIGA környezet használni tudja a jelentéseket.
BIRT jelentések csomagolása Mielőtt a BIRT jelentést visszaexportálja az IBM TRIRIGA alkalmazásba, csomagolja a jelentést egy .zip fájlba.
Eljárás 1. A BIRT alkalmazásban Kattintson a jobb egérgombbal a jelentésprojektre, majd válassza az előugró menü Exportálás menüpontját. 2. Bontsa ki az általános mappát, majd válassza ki a Fájl archiválása elemet, ezután kattintson a Tovább gombra. 3. Válassza ki a Jelentés összeállítása elemet. 4. Jelölje ki az .rptdesign és a tririgalabels.properties fájlt. 5. Az Archív fájlba mezőben nevezze el az új .zip fájlt, majd válassza ki a feltöltés helyét. 6. Válassza ki a használni kívánt beállításokat. 7. Kattintson a Befejezés gombra.
Jelentések feltöltése az IBM TRIRIGA alkalmazásba Használja a Dokumentumkezelőt a csomagolt .zip fájl feltöltéséhez az IBM TRIRIGA alkalmazásba.
Eljárás 1. Az IBM TRIRIGA alkalmazásban nyissa meg a Dokumentumkezelőt. 2. Bontsa ki az IBM TRIRIGA mappát. 3. Válassza ki vagy hozza létre a feltöltési mappát. Használhat olyan mappanevet, amely a kezdeti jelentés moduljára és az IBM TRIRIGA lekérdezésre vonatkozik. 4. Válassza ki az Új dokumentum elemet, kattintson a Tallózás gombra, majd válassza ki a BIRT jelentésfájlt. 5. Adjon meg egy dokumentumnevet. 6. Választható: Adja meg a mezőértékeket. 7. Válassza ki a Feltöltés elemet, majd kattintson az OK gombra.
Jelentéskönyvtárak A jelentéskönyvtár egy BIRT összeállítás, amely több jelentésen keresztül megosztható, újrafelhasználható összetevőket tartalmaz. A jelentéskönyvtárat ugyanúgy lehet feltölteni, mint a jelentést. A jelentéskönyvtárakat feltöltheti az IBM TRIRIGA dokumentumkezelő rendszerbe és a \ROOT\TRIRIGA\BIRT Libraries mappába. Ha ez a mappastruktúra nem létezik a rendszeren, akkor hozza létre a mappát. A jelentéskönyvtár feltölthető egyetlen .rptlibrary fájlként vagy .zip fájlként. Az IBM TRIRIGA dokumentum nevének meg kell egyezni az .rtplibrary fájl nevével. Ha a jelentéskönyvtár címkékat tartalmaz, akkor a .rptlibrary fájl hivatkozhat olyan tririgalabels.properties fájlra, amely lefordítható címkékkel rendelkezik.
20
© Copyright IBM Corp. 2011, 2016
Dokumentumok társítása az IBM TRIRIGA alkalmazással A BIRT jelentés használatához társítsa az IBM TRIRIGA dokumentumot egy IBM TRIRIGA hozzáférési ponttal. A hozzáférési pont lehet lekérdezési jelentés vagy űrlapjelentés.
Dokumentumok társítása lekérdezési jelentésekkel Az IBM TRIRIGA lekérdezést létrehozhatja külső lekérdezésként. A lekérdezés hivatkozásként viselkedik a Dokumentumkezelőbe betöltött BIRT .rpt fájlhoz. A Dokumentumkezelőben válassza ki a BIRT jelentést. A jelentést több helyen is felhasználhatja az IBM TRIRIGA alkalmazásban, például az űrlapszakaszokban és a portálszakaszokban.
Eljárás 1. Az IBM TRIRIGA alkalmazásban nyissa meg a jelentéskezelőt. 2. Kattintson a Rendszerjelentések > Új elemre. 3. Adja meg az információkat. 4. Kattintson a Mentés, majd a Bezárás gombra.
Dokumentumok társítása űrlapokhoz A jelentéseket sok helyen használhatja az IBM TRIRIGA alkalmazásban, például az űrlap szakaszokban, a portál szakaszokban és a Jelentések lapon.
Erről a feladatról A BIRT jelentés használatához az űrlap szakaszban, adja hozzá a jelentést az űrlap Elrendezés lapjához és a Tartalmazások/űrlapok lapjához. A Tartalmazások/űrlapok lapon társítsa a BIRT jelentést az IBM TRIRIGA űrlappal. Ennek eredményeként a BIRT jelentésben az összes címke exportálható fordításra a globalizációkezelőből.
Eljárás 1. Az IBM TRIRIGA alkalmazásban lépjen az Űrlapkészítőre, majd válassza ki az Általános elemet. 2. Nyissa meg azt az űrlapot, amelyhez fejlesztette az űrlapjelentést. 3. Választható: Módosítsa az űrlapot. 4. Válassza ki az Elrendezés elemet, majd válassza ki a Jelentések megjelenítése elemet és győződjön meg róla, hogy a jelentés megjelenik az űrlap Jelentések lapján. 5. Válassza ki a Tartalmazások/űrlapok elemet, majd kattintson a Hozzáadás gombra. 6. Válassza ki a dokumentumkezelőbe feltöltött jelentésfájlt, majd kattintson az OK gombra. 7. Az űrlapok szakaszban válassza ki a jelentésfájlt. 8. Válassza ki az Elrendezés menüpontot, majd kattintson a Közzététel elemre.
Tömeges nyomtatási műveletek beállítása az objektum átállítása után Az IBM TRIRIGA alkalmazásban a jelentés tömeges nyomtatása műveletek olyan URL címeket használnak, amelyek programba kódolt numerikus dokumentumazonosítókkal rendelkeznek. Az objektumátállítási csomag alkalmazása után a dokumentumok dokumentumazonosítója megváltozhat, és a tömeges nyomtatási művelet többé már nem működik. Kézzel frissítheti a dokumentumazonosítókat és minden egyes dokumentumot társíthat a kapcsolódó űrlappal.
Tömeges nyomtatási műveletek beállítása a karbantartási űrlapokon A karbantartási űrlapokon beállíthatja a műveleteket a tömeges nyomtatáshoz. 2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
21
Eljárás 1. Jelentkezzen be az IBM TRIRIGA alkalmazásba adminisztrátorként. 2. A Dokumentumkezelőben kattintson a TRIRIGA > Feladat elemre. 3. Kattintson a jobb egérgombbal az egyik dokumentumra az alábbi táblázatban, majd válassza az előugró menü Tulajdonságok menüpontját a dokumentumazonosító lekérdezéséhez. Ismételje meg ezt a lépést minden egyes dokumentumnál a következő táblázatban: Dokumentum neve
Tömeges nyomtatási művelet
Állapotfelmérési munkafeladat rekord (BIRT)
Nyomtatási állapotfelmérés munkafeladat
Szerződés felülvizsgálata rekord (BIRT)
Szerződés felülvizsgálatának nyomtatása
Vizsgálati feladat rekord (BIRT)
Vizsgálati feladat nyomtatása
Készletszám munkafeladat rekord (BIRT)
Készletszám munkafeladat nyomtatása
Készletkiemelési munkafeladat rekord (BIRT)
Készletkiemelési munkafeladat nyomtatása
Kulcs-munkafeladat rekord (BIRT)
Kulcs-munkafeladat nyomtatása
Anyagrendelési feladat rekord (BIRT)
Anyagrendelési feladat nyomtatása
Hiánylista-feladat rekord (BIRT)
Hiánylista-feladat nyomtatása
Tartalék munkafeladat rekord (BIRT)
Tartalék munkafeladat nyomtatása
Ütemezési feladat rekord (BIRT)
Ütemezési feladat nyomtatása
Előterjesztési feladat rekord (BIRT)
Előterjesztési feladat nyomtatása
Munkafeladat rekord (BIRT)
Munkafeladat nyomtatása
4. Az Eszközök menüben válassza ki a Tervezőeszközök > Űrlapkészítő menüpontot. 5. Válassza ki a triMaintenance modult, válassza ki a triMaintenanceManager űrlapot, majd vizsgálja felül az űrlapot. 6. Az űrlap navigációjában válassza ki a triSchedule > Munka > Saját feladatok elemet. 7. Válassza ki a tömeges nyomtatási műveletet. A művelet tulajdonságaiban írja felül a régi dokumentumazonosítót az új dokumentumazonosítóval. Ismételje meg ezt a lépést minden egyes műveletnél az előző táblázatban. 8. Az összes dokumentumazonosító-érték frissítése után, tegye közzé az űrlapot. 9. Az Eszközök menüben válassza ki a Tervezőeszközök > Űrlapkészítő menüpontot. 10. Válassza ki a triTask modult. Nyisson meg egy feladatűrlapot a következő táblázatból és vizsgálja felül az űrlapot. 11. Válassza ki a Tartalmazások/űrlapok elemet, majd az űrlapok részben kattintson a Hozzáadás gombra. Keresse meg a dokumentumot, majd tegye közzé az űrlapot. Ismételje meg ezt a lépést minden egyes űrlapnál a következő táblázatban.
22
Feladat űrlap
Dokumentum neve
triConditionAssessmentWorkTask
Állapotfelmérési munkafeladat rekord (BIRT)
triContractReviewTask
Szerződés felülvizsgálata rekord (BIRT)
triInventoryCountWorkTask
Készletszám munkafeladat rekord (BIRT)
triInventoryPickWorkTask
Készletkiemelési munkafeladat rekord (BIRT)
triKeyWorkTask
Kulcs-munkafeladat rekord (BIRT)
triMaterialOrderTask
Anyagrendelési feladat rekord (BIRT)
triPunchlistTask
Hiánylista-feladat rekord (BIRT)
triReserveWorkTask
Tartalék munkafeladat rekord (BIRT)
© Copyright IBM Corp. 2011, 2016
Feladat űrlap
Dokumentum neve
triScheduleTask
Ütemezési feladat rekord (BIRT)
triSubmittalTask
Előterjesztési feladat rekord (BIRT)
triWorkTask
Munkafeladat rekord (BIRT)
Tömeges nyomtatási műveletek beállítása a számla űrlapokon A tömeges nyomtatási műveleteket kézzel állíthatja be a számla űrlapokon.
Eljárás 1. Jelentkezzen be az IBM TRIRIGA alkalmazásba adminisztrátorként. 2. A Dokumentumkezelőben lépjen a TRIRIGA > Szerződés elemre. 3. Kattintson a jobb egérgombbal egy dokumentumra az alábbi táblázatból, majd válassza az előugró menü Tulajdonságok menüpontját a dokumentumazonosító lekéréséhez. Ismételje meg ezt a lépést minden egyes dokumentumnál a következő táblázatban: Dokumentum neve
Tömeges nyomtatási művelet
Eszközszámla összegzése tömeges nyomtatás (BIRT)
Eszközszámlák tömeges nyomtatása
Ingatlanszámla összegzése tömeges nyomtatás (BIRT)
Ingatlanszámlák tömeges nyomtatása
4. Az Eszközök menüben válassza ki a Tervezőeszközök > Űrlapkészítő menüpontot. 5. Lépjen a triPayment modulba, válassza ki a triProcessInvoices elemet, majd vizsgálja felül az űrlapot. 6. Az űrlap navigációjában válassza ki a triGeneral > AR számlák elemet. 7. Az AR számlák tulajdonságaiban válassza ki az egy tömeges nyomtatási műveletet. A művelet tulajdonságaiban írja felül a régi dokumentumazonosítót az új dokumentumazonosítóval. Ismételje meg ezt a lépést minden egyes műveletnél az előző táblázatban. 8. Az összes dokumentumazonosító-érték frissítése után, tegye közzé az űrlapot. 9. Lépjen az Eszközök menübe és válassza ki a Tervezőeszközök > Űrlapkészítő menüpontot. 10. Válassza ki a triPayment modult. Nyisson meg egy számlaűrlapot an következő táblázatból és vizsgálja felül az űrlapot. 11. Válassza ki a Tartalmazások/űrlapok elemet, majd az űrlapok részben kattintson a Hozzáadás gombra. Keresse meg a dokumentumot, majd tegye közzé az űrlapot. Ismételje meg ezt a lépést minden egyes űrlapnál a következő táblázatban: Számla űrlap
Dokumentum neve
triAssetInvoice
Eszközszámla összegzése tömeges nyomtatás (BIRT)
triREInvoice
Ingatlanszámla összegzése tömeges nyomtatás (BIRT)
Jelentés karbantartása Módosíthatja azokat a meglévő jelentéseket, amelyek nem foglalnak magukban adathalmazokat és azokat, amelyek igen.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
23
Jelentések módosítása adathalmaz módosítások nélkül Olyan BIRT jelentés módosításához, amely nem foglal magában adathalmaz módosításokat, a Dokumentumkezelővel kérheti le a jelentésfájlt, módosíthatja a fájlt és újraimportálhatja a jelentésfájlt.
Eljárás 1. A Dokumentumkezelőben válassza ki a fájlt, adjon meg egy megjegyzést, majd válassza ki a Kiiktatás lehetőséget. 2. Hozzon létre egy kezdeti jelentést az IBM TRIRIGA termékbe, majd importálja a kezdeti jelentést a BIRT alkalmazásba. 3. Végezzen el minden szükséges módosítást a jelentésben, majd mentse a fájlt. Ha egy általános BIRT jelentést módosít, akkor nevezze át a jelentést, mielőtt betölti a dokumentumkezelőbe az egyéni verzió védelme érdekében arra az esetre, ha IBM TRIRIGA frissítés történik. 4. Töltse vissza a fájlt a Dokumentumkezelőbe.
Jelentések módosítása adathalmaz módosításokkal A Dokumentumkezelővel lekérheti, módosíthatja és újraimportálhatja a jelentésfájlt.
Eljárás 1. Előállíthat egy kezdeti jelentést, amely ugyanazon a modellen alapul, amelyet a meglévő BIRT jelentéshez használt. 2. Végezze el az alábbi beállítások egyikét: Beállítások
Jelentések módosítása adathalmaz módosításokkal
Frissítések kiválasztása a parancsfájl-adathalmaz elemekből
Kiválaszthatja a frissítéseket belefoglalásra a parancsfájl-adathalmaz elemekből a BIRT jelentésben és az új .rtpdesign fájlban.
Parancsfájl-adathalmaz elemek felülírása
Felülírhatja az aktuális .rptdesign fájl parancsfájl-adathalmaz elemeit az új parancsfájl-adathalmaz elemekkel, amelyek az új .rptdesign fájlban lettek előállítva. Importálja a kezdeti jelentést egy projektbe, másolja az adathalmazt az új kezdeti jelentésből, majd illessze be a meglévő .rptdesign fájl adathalmazába.
Mi a következő lépés? Ha mezőket vagy felhasználói szűrőket ad hozzá az IBM TRIRIGA lekérdezéshez, akkor a jelentést is módosítani kell. Az adathalmaz frissítése után, ha ez az adathalmaz szolgál az összefésülésre a BIRT alkalmazásban, akkor újra össze kell fésülni az adathalmazt és újra össze kell rendelni az elemeket a BIRT jelentésben.
24
© Copyright IBM Corp. 2011, 2016
Szűrőoperátorok A szűrőoperátorok értékei a kiválasztott mező mezőtípusától függenek. A következő táblázat felsorolja és bemutatja a felhasználható értékeket: 4. táblázat: Szűrőoperátorok. Mezőoperátorok Operátor
Leírás
Utána
Elérhető a dátum, dátum és idő, valamint az időpont mezőhöz. Ha a megadott mező értéke a megadott érték utánra esik, akkor igaz.
Előtte
Elérhető a dátum, dátum és idő, valamint az időpont mezőhöz. Ha a megadott mező értéke a megadott érték előttre esik, akkor igaz.
Tartalmaz
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke tartalmazza a megadott értéket, akkor igaz.
Tartalmaz – betűnagyság érzékeny
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke tartalmazza a megadott értéket, beleértve a betűnagyság érzékenységet, akkor igaz.
Nem tartalmaz
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke nem tartalmazza a megadott értéket, akkor igaz.
Nem tartalmaz – betűnagyság érzékeny
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke nem tartalmazza a megadott értéket, beleértve a betűnagyság érzékenységet, akkor igaz.
Befejeződik a következővel
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke a megadott értékkel fejeződik be, akkor igaz.
Befejeződik a következővel – betűnagyság érzékeny
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke a megadott értékkel fejeződik be és betűnagyság érzékeny, akkor igaz.
Egyenlő
Ha a megadott mező értéke egyenlő a megadott értékkel, akkor igaz.
Közötte van
Ha a megadott mező értéke a megadott értékek egyike, akkor igaz. Karaktersorozat értékek és számértékek esetében a megadott értékeknek vesszővel tagolt literál értékeknek kell lenni, amelyek egyszeres idézőjelekkel vannak tördelve, például: 'Tom','Jerry','Paul','1','2','3'.
Kisebb, mint
A számmezőkhöz érhető el. Ha a megadott mező értéke kisebb, mint a megadott érték, akkor igaz.
Kisebb, mint vagy egyenlő
Elérhető a szám, dátum, dátum és idő, valamint az időpont mezőhöz. Ha a megadott mező értéke kisebb vagy egyenlő a megadott értékkel, akkor igaz.
Nagyobb, mint
A számmezőkhöz érhető el. Ha a megadott mező értéke nagyobb, mint a megadott érték, akkor igaz.
Nagyobb, mint vagy egyenlő
Elérhető a szám, dátum, dátum és idő, valamint az időpont mezőhöz. Ha a megadott mező értéke nagyobb vagy egyenlő a megadott értékkel, akkor igaz.
Nem egyenlő
Ha a megadott mező értéke nem egyenlő a megadott értékkel, akkor igaz.
Nincs közötte
Ha a megadott mező értéke nem a megadott értékek egyike, akkor igaz. Karaktersorozat értékek és számértékek esetében a megadott értékeknek vesszővel tagolt literál értékeknek kell lenni, amelyek egyszeres idézőjelekkel vannak tördelve. Például: 'Tom','Jerry','Paul','1','2','3'.
Kezdődik a következővel
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke a megadott értékkel kezdődik, akkor igaz.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
25
4. táblázat: Szűrőoperátorok (Folytatás). Mezőoperátorok Operátor
Leírás
Kezdődik a következővel – betűnagyság érzékeny
A szöveges, UOM és logikai mezőkhöz érhető el. Ha a megadott mező értéke a megadott értékkel kezdődik és betűnagyság érzékeny, akkor igaz. Ha olyan lekérdezéssel rendelkezik, amely helymeghatározó mezőben vagy intelligens szakaszban van használatban, és azt veszi észre, hogy az automatikus végrehajtás hosszú ideig fut, akkor fontolja meg a szűrőoperátor módosítását tartalmaz értékről kezdődik a következővel értékre.
Speciális értékek Az Érték mezőben a számok és a szöveg használatán kívül speciális értékeket is használhat. A megelőző speciális értékeket követheti + vagy - jel és egész szám. Például a $$TODAY$$+1 a holnap, a $$THISWEEK$$-1 a múlt hét és a $$THISYEAR$$+5 5 évvel a jelenlegi év után. A következő táblázat felsorolja és bemutatja a speciális értékeket: 5. táblázat: Speciális értékek, amelyeket követhet + és -.. Speciális értékek Érték
Leírás
$$TODAY$$
Az aktuális dátum és a megadott dátum összehasonlítására szolgál. Ha például nem szeretné megjeleníteni a régebbi képzéseket, akkor adja meg a következőt: General::Start Date After $$TODAY$$
$$THISWEEK$$
Az aktuális hét és a megadott dátum összehasonlítására szolgál. Például az indít héten kezdődő képzések megtekintéséhez adja meg a következőt: General::Start Date Equals $$THISWEEK$$
$$THISMONTH$$
Az aktuális hónap és a megadott dátum összehasonlítására szolgál.
$$THISYEAR$$
Az aktuális év és a megadott dátum összehasonlítására szolgál.
A következő táblázat további speciális értékeket sorol fel és mutat be:
26
© Copyright IBM Corp. 2011, 2016
6. táblázat: Speciális értékek. Speciális értékek Érték
Leírás
$$RUNTIME$$
A $$RUNTIME$$ speciális érték lehetővé teszi a felhasználó számára a szűrő értékének megadását, amikor a jelentés fut. Ha a felhasználó nem ad meg értéket, akkor a szűrő figyelmen kívül marad. A $$RUNTIME$$ speciális érték jól működik a legtöbb adattípussal és összehasonlító operátorral. Azonban a szöveges adatok esetében a $$RUNTIME$$ speciális érték a Contains operátort kezeli. A $$RUNTIME$$ speciális érték használata helyett úgy azonosíthatja a mezőket a felhasználói adatbevitelhez, ha bejelöli a Felhasználó jelölőnégyzetet a Szűrők lapon.
$$USERID$$
A $$USERID$$ speciális érték egy érvényes mező szűrő a lekérdezésben.
$$USERID::SectionName::FieldName$$
A $$USERID::SectionName::FieldName$$ speciális érték egy érvényes szűrő a lekérdezésekben. Az értékmező beállítása a $$USERID::SectionName::FieldName$$ speciális értékre azt jelzi, hogy az érték összehasonlításra kerül a FieldName mezőnévvel a rekord SectionName szakaszában.
$$PERSONID$$
A $$PERSONID$$ speciális érték egy érvényes mező szűrő a lekérdezésben. A $$PERSONID$$ speciális érték használatakor az érték feloldódik annak a személynek az intelligens objektumazonosítójára, amely az aktuális felhasználóval társítva van. Ha az aktuális felhasználó nincs társítva személlyel, akkor hiba jelenik meg. A $$USERID$$ speciális értékhez hasonlóan, a szakasz és mező hozzáféréséket támogatja. A következő példa egy érvényes jelölésmód az aktuális személy keresztnevének feloldásához: $$PERSONID::Detail::triFirstNameTX$$.
$$PARENT::SectionName$$
A $$PARENT::SectionName$$ speciális érték egy érvényes mező szűrő a lekérdezésben. Az Érték mező beállítása a $$PARENT::SectionName$$ speciális értékre azt jelzi, hogy az érték összehasonlításra kerül a rekord SectionName szakaszával, amely a lekérdezés szakaszt vagy az intelligens szakaszt tartalmazza.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
27
6. táblázat: Speciális értékek (Folytatás). Speciális értékek Érték
Leírás
$$PARENT::SectionName ::FieldName$$
Megadhat egy szűrőt, amely összehasonlít egy értéket a rekordban, amely az intelligens szakaszt tartalmazó rekordban szereplő értékkel lett szűrve. Annak jelzésére, hogy az érték összehasonlításra kerül a FieldName mezővel a rekord SectionName szakaszában, amely a lekérdezési szakaszt vagy az intelligens szakaszt tartalmazza, használja a következő értékmezőt: $$PARENT::SectionName::FieldName$$. Ha a $$PARENT speciális érték értéke nincs megadva, akkor az IS NULL feltételre kerül feloldásra.
Speciális nevek a rekordmezőben A rekordmezőben használhat speciális neveket a speciális rekordokkal rendelkező társítások szűréséhez. A rekord- vagy lekérdezésmező értékének meg kell egyeznie a másik lekérdezés nevével. Ha a szűrőtípus mező értéke lekérdezés, akkor állítsa be a megfelelő rekordot vagy lekérdezést. Ha a szűrtípus értéke mező, akkor a rekord vagy a lekérdezés mező értéke határozza meg, hogy a szűrő által igényelt társítás közvetlen a kontextusrekorddal, a kontextusrekorddal társított másik rekorddal vagy egy nem társított rekorddal. A következő táblázat a rekordmező speciális neveit tartalmazza: 7. táblázat: Speciális nevek a rekordmezőben Érték
Leírás
$$USERID$$
A lekérdezés futtatásakor a $$USERID$$ érték feloldódik a lekérdezést indító felhasználó rekordazonosítójára.
$$PERSONID$$
A lekérdezés futtatásakor a $$PERSONID$$ érték feloldódik a lekérdezést indító felhasználóhoz tartozó Személy rekord rekordazonosítójára.
$$RECORDID$$
A lekérdezési szakaszokban használt lekérdezésekhez és az adatszakaszok keresési művelet lekérdezéseihez hasznos. A lekérdezési szakaszokban használt lekérdezéseknek és a keresési lekérdezéseknek gyakran csak azokat a rekordokat kell visszaadni, amelyek a szakaszt tartalmazó rekorddal vannak társítva. Amikor a rekordmezőt $$RECORDID$$ értékre állítja be, ha a felső szintű rekordok közvetlenül a kontextusrekorddal vannak társítva, akkor a felső szintű rekordok ezt a szűrőt adják át.
$$GROUPID$$
Amikor a rekordmezőt a $$GROUPID$$ értékre állítja be, ha a felső szintű rekordok olyan rekorddal vannak társítva, amely azt a csoportot ábrázolja, amelynek a felhasználó tagja, akkor a felső szintű rekordok átadják a szűrőt. Ha a rekordmező a $$GROUPID$$ értékre van beállítva, akkor a modul mező Group és az Üzleti objektum mező All értékre kerül beállításra.
28
© Copyright IBM Corp. 2011, 2016
7. táblázat: Speciális nevek a rekordmezőben (Folytatás) Érték
Leírás
$$PROJECTID$$
Amikor a rekordmező értékét $$PROJECTID$$ értékre állítja be, és ha a felső szintű rekordok az aktív projektet ábrázoló rekorddal vannak társítva, akkor a felső szintű rekordok átadják a szűrőt. Ha a rekordmező a $$PROJECTID$$ értékre van beállítva, akkor a modul mező triProject és az Üzleti objektum mező All értékre kerül beállításra. Az IBM TRIRIGA termékben a projektek lehetőséget biztosítanak az adatok osztályozására a feladatokhoz, amelyeken az emberek dolgoznak. A $$PARENT$$ értékkel megadhatja, hogy a felső szintű rekordok akkor adják át ezt a szűrőt, ha olyan rekorddal vannak társítva, amely közvetlen vagy közvetett társítással rendelkezik a kontextusrekordhoz. Az útvonal megadásával működik a kontextusrekordtól egy másik rekordhoz rekordszakaszokon vagy helymeghatározó mezőkön keresztül.
$$PARENT$$
Ha például egy kontextusrekord egy alkalmazott rekord, akkor a jelentésnek olyan alkalmazott rekordokat kell tartalmazni az alkalmazottakhoz, amelyeknek ugyanaz a felügyelőjük, mint a kontextusrekordnak. Egy szűrő megadásához azokat az alkalmazott rekordokat használja, amelyek helymeghatározó mezőjének neve triReportsToTX, amely arra a rekordra hivatkozik, amely egy alkalmazott felügyelőjéra vonatkozik. Ha a triReportsToTX az általános szakaszban található, akkor a rekordmező értéke: $$PARENT::General::triReportsToTX$$. Ha a hivatkozás egy intelligens szakasz volt, akkor a rekordmező értéke: $$PARENT::triReportsTo$$. Ha a $$PARENT$$ értéke üres, akkor az IS NULL feltételre kerül feloldásra. $$PARENT::SECTIONNAME$$
A keresés szakasz szűrésére szolgál egy másik szakasz értékei alapján. A PARENT mindig a PARENT szó. A SECTIONNAME annak a szakasznak a neve, amely a szűrni kívánt értékeket tartalmazza. Gondoskodjék róla, hogy a szakasznak a nevét és ne a címkéjét használja.
$$PARENT::SECTIONNAME::FIELDNAME$$
A keresés szakasz szűrésére szolgál egy másik szakasz értéke alapján. A PARENT mindig a PARENT szó. A SECTIONNAME annak a szakasznak a neve, amely a szűrni kívánt mezőt tartalmazza. A FIELDNAME annak a mezőnek a neve, amely alapján szűrni kíván. Gondoskodjék róla, hogy a szakasznak és a mezőnek a nevét és ne a címkéjét használja.
$$ORGANIZATIONID$$
A portállekérdezés szakasz szűrésére szolgál a bejelentkezett felhasználó szervezete alapján.
$$ORGANIZATIONIDWITHCHILDREN$$
A portállekérdezés szakasz szűrésére szolgál a bejelentkezett felhasználó szervezete alapján, beleértve az összes leszármazott szervezetet.
$$GEOGRAPHYID$$
A portállekérdezés szakasz szűrésére szolgál a bejelentkezett felhasználó földrajzi elhelyezkedése alapján.
$$GEOGRAPHYIDWITHCHILDREN$$
A portállekérdezés szakasz szűrésére szolgál a bejelentkezett felhasználó földrajzi elhelyezkedése és minden leszármazott földrajzi elhelyezkedése alapján.
2. fejezet Fejlett jelentéskészítés az IBM TRIRIGA alkalmazásban
29
30
© Copyright IBM Corp. 2011, 2016
Nyilatkozatok Ezek az információk az Egyesült Államokban forgalmazott termékekre és szolgáltatásokra vonatkoznak. Ezt az anyagot az IBM más nyelveken is elérhetővé teszi. Azonban szükség lehet arra, hogy a termék vagy termékverzió saját példányával rendelkezzen az adott nyelven ahhoz, hogy el tudja érni. Elképzelhető, hogy a dokumentumban tárgyalt termékeket, szolgáltatásokat vagy lehetőségeket az IBM más országokban nem forgalmazza. Az adott országokban rendelkezésre álló termékekről és szolgáltatásokról az IBM helyi képviseletei szolgálnak felvilágosítással. Az IBM termékeire, programjaira vagy szolgáltatásaira vonatkozó utalások sem állítani, sem sugallni nem kívánják, hogy az adott helyzetben csak az adott IBM termék, program vagy szolgáltatás alkalmazható. Minden olyan működésében azonos termék, program vagy szolgáltatás alkalmazható, amely nem sérti az IBM szellemi tulajdonjogát. A nem IBM termékek, programok és szolgáltatások működésének megítélése és ellenőrzése azonban a felhasználó felelőssége. A dokumentum tartalmával kapcsolatban az IBM bejegyzett vagy bejegyzés alatt álló szabadalmakkal rendelkezhet. Jelen dokumentum nem ad semmiféle jogos licencet e szabadalmakhoz. A licenckérelmeket írásban a következő címre küldheti: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 USA Ha a duplabyte-os karakterkészlet (DBCS) információival kapcsolatban van szüksége licencre, akkor lépjen kapcsolatba országában az IBM szellemi tulajdon osztályával, vagy írjon a következő címre: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan AZ INTERNATIONAL BUSINESS MACHINES CORPORATION A KIADVÁNYT "JELENLEGI FORMÁJÁBAN", BÁRMIFÉLE KIFEJEZETT VAGY VÉLELMEZETT GARANCIA NÉLKÜL ADJA KÖZRE, IDEÉRTVE, DE NEM KIZÁRÓLAG A JOGSÉRTÉS KIZÁRÁSÁRA, A KERESKEDELMI ÉRTÉKESÍTHETŐSÉGRE ÉS BIZONYOS CÉLRA VALÓ ALKALMASSÁGRA VONATKOZÓ VÉLELMEZETT GARANCIÁT. Bizonyos fennhatóságok nem engedélyezik egyes tranzakciók kifejezett vagy vélelmezett garanciáinak kizárását, így elképzelhető, hogy az előző bekezdés Önre nem vonatkozik. Jelen dokumentum tartalmazhat technikai pontatlanságokat és sajtóhibákat. A kiadványban leírt információk bizonyos időnként módosításra kerülnek; a módosításokat a kiadvány új kiadásai tartalmazzák. Az IBM mindennemű értesítés nélkül fejlesztheti és/vagy módosíthatja a kiadványban tárgyalt termékeket és/vagy programokat. A kiadványban a nem az IBM által üzemeltetett webhelyek megjelenése csak kényelmi célokat szolgál, és semmilyen módon nem jelenti ezen webhelyek előnyben részesítését © Szerzői jog IBM 2011, 2016
31
másokhoz képest. Az ilyen webhelyeken található anyagok nem képezik az adott IBM termék dokumentációjának részét, így ezek felhasználása csak saját felelősségre történhet. Az IBM belátása szerint bármilyen formában felhasználhatja és továbbadhatja a felhasználóktól származó információkat anélkül, hogy a felhasználó felé ebből bármilyen kötelezettsége származna. A programlicenc azon birtokosai, akik (i) a függetlenül létrehozott programok vagy más programok (beleértve ezt a programot is) közti információcsere, illetve (ii) a kicserélt információk kölcsönös használata céljából szeretnének információkhoz jutni, a következő címre írjanak: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 USA Az ilyen információk bizonyos feltételek és kikötések mellett állnak rendelkezésre, ideértve azokat az eseteket is, amikor ez díjfizetéssel jár. Az IBM a dokumentumban tárgyalt licencprogramokat és a hozzájuk tartozó licenc anyagokat IBM Vásárlói megállapodás, IBM Nemzetközi programlicenc szerződés vagy a felek azonos tartalmú megállapodása alapján biztosítja. A teljesítményadatok és az ügyfélpéldák csak illusztrációs célból lettek megadva. A tényleges teljesítményeredmények a specifikus konfigurációktól és az üzemeltetési feltételektől függően eltérhetnek. A nem IBM termékekre vonatkozó információk a termékek szállítóitól, illetve azok publikált dokumentációiból, valamint egyéb nyilvánosan hozzáférhető forrásokból származnak. Az IBM nem tesztelte ezeket a termékeket, így a nem IBM termékek esetében nem tudja megerősíteni a teljesítményre és kompatibilitásra vonatkozó, valamint az egyéb állítások pontosságát. A nem IBM termékekkel kapcsolatos kérdéseivel forduljon az adott termék szállítóihoz. Az IBM jövőbeli tevékenységére vagy szándékaira vonatkozó összes állítást az IBM mindennemű értesítés nélkül módosíthatja, azok csak célokat jelentenek. Az információk között példaként napi üzleti tevékenységekhez kapcsolódó jelentések és adatok lehetnek. A valóságot a lehető legjobban megközelítő illusztráláshoz a példákban egyének, vállalatok, márkák és termékek nevei szerepelnek. Minden ilyen név a képzelet szüleménye, és valódi személyi vagy üzleti vállalkozások neveivel való bármilyen hasonlóságuk teljes egészében a véletlen műve. Szerzői jogi licenc: A kiadvány forrásnyelvi alkalmazásokat tartalmaz, amelyek a programozási technikák bemutatására szolgálnak a különböző működési környezetekben. A példaprogramokat tetszőleges formában, az IBM-nek való díjfizetés nélkül másolhatja, módosíthatja és terjesztheti fejlesztés, használat, eladás vagy a példaprogramot futtató operációs rendszer alkalmazásprogramozási felületének megfelelő alkalmazásprogram terjesztésének céljából. Ezek a példák nem kerültek minden körülmények között tesztelésre. Ennek megfelelően az IBM nem tudja garantálni a programok megbízhatóságát, használhatóságát és működését. A
32
© Copyright IBM Corp. 2011, 2016
példaprogramok "JELENLEGI FORMÁJUKBAN", bármiféle garancia vállalása nélkül kerülnek közreadásra. Az IBM a példaprogramok használatának következtében fellépő semmilyen kárért nem vállal felelősséget. A mintaprogramok minden egyes példányának és részének, valamint a származékos munkáknak tartalmazniuk kell a szerzői jogi nyilatkozatot az alábbiak szerint: © (saját vállalat neve) (év). A kódrészek az IBM Corp. mintaprogramjaiból származnak. © Copyright IBM Corp. _adja meg az évet vagy éveket_.
Védjegyek Az IBM, az IBM logó és az ibm.com az International Business Machines Corporationnek a világ számos országában regisztrált védjegye. Más termékek és szolgáltatások neve is az IBM vagy más vállalatok védjegye lehet. Az IBM védjegyek aktuális listája elérhető a weben a "Copyright and trademark information" című részben a www.ibm.com/legal/copytrade.shtml webhelyen. A Java, valamint minden Java alapú jelzés és logó az Oracle és/vagy társvállalatainak védjegye vagy bejegyzett védjegye. A Linux Linus Torvalds védjegye az Egyesült Államokban és/vagy más országokban. A Microsoft, a Windows, a Windows NT és a Windows logó a Microsoft Corporation védjegye az Egyesült Államokban és/vagy más országokban. A UNIX a The Open Group bejegyzett védjegye az Egyesült Államokban és más országokban. Más termékek és szolgáltatások neve is az IBM vagy más vállalatok védjegye lehet.
A termékdokumentációra vonatkozó feltételek és kikötések A jelen kiadványok használatára vonatkozó jogosultságok adományozása az alábbi feltételek és kikötések alapján lehetséges.
Alkalmazhatóság A jelen feltételek és kikötések kiegészítik az IBM webhelyének mindenkori használati feltételeit.
Személyes használat A kiadványok másolhatók személyes, nem kereskedelmi célú felhasználásra, feltéve, hogy valamennyi tulajdonosi feljegyzés megmarad. Az IBM kifejezett hozzájárulása nélkül nem szabad a kiadványokat vagy azok részeit terjeszteni, megjeleníteni, illetve belőlük származó munkát készíteni.
Kereskedelmi használat A kiadványok másolhatók, terjeszthetők és megjeleníthetők, de kizárólag a vállalaton belül, és csak az összes tulajdonosi feljegyzés megtartásával. Az IBM kifejezett hozzájárulása nélkül nem készíthetők olyan munkák, amelyek a kiadványokból származnak, továbbá a vállalaton kívül még részeikben sem másolhatók, terjeszthetők vagy jeleníthetők meg.
Nyilatkozatok
33
Jogok A jelen engedélyben foglalt, kifejezetten megadott hozzájáruláson túlmenően a kiadványokra, illetve a bennük található adatokra, szoftverekre vagy egyéb szellemi tulajdonra semmilyen más kifejezett vagy hallgatólagos engedély nem vonatkozik. Az IBM fenntartja magának a jogot, hogy jelen engedélyeket saját belátása szerint bármikor visszavonja, ha úgy ítéli meg, hogy a kiadványokat az IBM érdekeit sértő módon használják fel, vagy a fenti előírásokat nem megfelelően követik. Jelen információk kizárólag valamennyi vonatkozó törvény és előírás betartásával tölthetők le, exportálhatók és reexportálhatók, beleértve az Egyesült Államok exportra vonatkozó törvényeit és előírásait is. AZ IBM A KIADVÁNYOK TARTALMÁRA VONATKOZÓAN SEMMIFÉLE GARANCIÁT NEM NYÚJT. A KIADVÁNYOK "JELENLEGI FORMÁJUKBAN", BÁRMIFÉLE KIFEJEZETT VAGY VÉLELMEZETT GARANCIA VÁLLALÁSA NÉLKÜL KERÜLNEK KÖZREADÁSRA, IDEÉRTVE TÖBBEK KÖZÖTT A KERESKEDELMI ÉRTÉKESÍTHETŐSÉGRE, A SZABÁLYOSSÁGRA ÉS AZ ADOTT CÉLRA VALÓ ALKALMASSÁGRA VONATKOZÓ VÉLELMEZETT GARANCIÁKAT.
IBM online adatvédelmi nyilatkozat Az IBM szoftvertermékek a szoftverszolgáltatási megoldásokat is ideértve (gyűjtőnéven "Szoftverajánlatok") cookie-k és egyéb technikák segítségével adatokat gyűjthetnek a termék felhasználásáról a felhasználói élmény javítása, személyre szabott interakció nyújtása és további célok érdekében. A Szoftverajánlatok számos esetben nem gyűjtenek személyes azonosításra alkalmas információkat. Egyes Szoftverajánlatok lehetővé tehetik személyes azonosításra alkalmas információk gyűjtését is. Ha jelen Szoftverajánlat személyes azonosításra alkalmas információk gyűjtésére használ cookie-kat, akkor a cookie-knak az adott ajánlatban való használatáról az alábbiakban tájékozódhat. Jelen Szoftverajánlat nem használ cookie-kat vagy más technikákat személyes azonosításra alkalmas információk gyűjtésére. Ha jelen Szoftverajánlat konfigurációja lehetővé teszi önnek, mint vásárlónak, hogy cookie-k vagy egyéb technikák révén személyes azonosításra alkalmas információkat gyűjtsön a végfelhasználóktól, akkor kérjen jogi tanácsot az ilyen adatok gyűjtésére vonatkozó jogszabályok tekintetében, például a nyilatkozatra és beleegyezésre vonatkozó esetleges követelményekről. Az e célra használható különféle technikákról, például a cookie-król további információkat az IBM adatvédelmi oldalán (http://www.ibm.com/privacy), az IBM online adatvédelmi tájékoztató (http://www.ibm.com/privacy/details) "Cookie-k, webjelzők és egyéb technológiák" című szakaszában, illetve az "IBM Software Products and Software-as-a-Service Privacy Statement" című dokumentumban (http://www.ibm.com/ software/info/product-privacy/) talál.
34
© Copyright IBM Corp. 2011, 2016
Nyilatkozatok
35
IBM®
Nyomtatva Dániában