IBM TRIRIGA Application Platform változat 3 alváltozat 4.2
Alkalmazáskészítés az IBM TRIRIGA Application Platform rendszerben: Adatkezelés
Megjegyzés A kiadvány és a tárgyalt termék használatba vétele előtt olvassa el a “Nyilatkozatok” oldalszám: 63 szakasz tájékoztatását.
E kiadás az IBM TRIRIGA Application Platform 3.4.2 változatára, továbbá minden ezt követő változatra és módosításra vonatkozik mindaddig, amíg az újabb kiadások ezt másképp nem jelzik. © Szerzői jog IBM Corporation 2011, 2015. © Copyright IBM Corporation 2011, 2015.
Tartalom 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel . . . . . . . . 1 A TRIRIGA Adatcsatlakozási folyamat áttekintése . . . 1 Objektumátállítási csomagok . . . . . . . . . 1 Állomásoztatásitábla-beállítások . . . . . . . . 1 Üzleti objektumok közzététele . . . . . . . 3 Üzletiobjektum-törlés . . . . . . . . . . 3 Feladatok üzleti objektumai . . . . . . . . . 3 Az adatok táblákba való áthelyezésének mechanizmusai 4 Az állomásoztatási táblák mezői . . . . . . . 5 A DC_JOB tábla mezői . . . . . . . . . 7 ETL leképezések . . . . . . . . . . . 9 Az adatok rekordokba való áthelyezésének munkafolyamatai . . . . . . . . . . . . 9 Munkafolyamat-feladatok beállításai . . . . . 10 Munkafolyamat-hívások . . . . . . . . . 13 Futás közbeni adatérvényesítések . . . . . . 13 Iterációs státuszok . . . . . . . . . . . 14 Ideiglenes adatok . . . . . . . . . . . 14 Az Adatcsatlakozási ügynök . . . . . . . . 19 Munkafolyamat-feldolgozás . . . . . . . . 19 A Tisztítási ügynök . . . . . . . . . . . 20 Az Adatcsatlakozás általános problémái . . . . . . 21 Tippek az Adatcsatlakozási eszköz üzemeltetéséhez . . . 24
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel . . . . . . . 27 A TRIRIGA adatintegrátor-folyamat áttekintése . . . Mezőtípusok . . . . . . . . . . . . Követelmények . . . . . . . . . . . Funkcionális követelmények. . . . . . . Használhatósági követelmények. . . . . . Tabulátorral tagolt értékeket tartalmazó fájlok . . Fejlécfájlok . . . . . . . . . . . . Nem hierarchikus modulokhoz tartozó fejlécfájlok Hierarchikus modulokhoz tartozó fejlécfájlok. . Fejlécfájlok létrehozása . . . . . . . . . . Társítási feltöltések előkészítése . . . . . . .
© Szerzői jog IBM 2011, 2015
. . . . . . .
27 28 33 33 34 35 36 37 . 37 . 37 . 39
Társítási karaktersorozatok . . . . . . Társítások azonosítása . . . . . . . Társítási szabályok ellenőrzése . . . . . Társítások hozzáadása a fejlécfájlokhoz . . Munkafolyamat-feladatok előkészítése társítási feltöltésekhez . . . . . . . . . . Adatok feltöltése . . . . . . . . . . Adatok kézi feltöltése . . . . . . . . Adatok feltöltése kötegelt feltöltésekkel . . A kötegelt feltöltés beállításai . . . . Kötegelt feltöltések ütemezése . . . . A kötegelt feltöltés leállítása . . . . . Tippek az Adatintegrátor eszköz használatához .
. . . .
. . . .
. . . .
39 39 39 40
. . . . . . . .
. . . . . . . .
. . . . . . . .
40 42 42 43 43 43 45 45
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével . . . . . . . . . . . . . 49 Adatbetöltési készletek . . . . . . . . . . Adatbetöltési készletek és adatbetöltési elemek . . Adatbetöltési készletek feldolgozása az Adatbetöltés-kezelő eszközben . . . . . . . Táblázatok előállítása az Adatbetöltés-kezelő eszközben Adatbetöltési táblázatok létrehozása . . . . . Adatbetöltési táblázatok érvényesítési makrói. . Mintaadatok feldolgozása és betöltése az Adatbetöltés-kezelő eszközzel . . . . . . . . Mintaadatok feldolgozása . . . . . . . . A mintaadatok beállítása . . . . . . . . Az adatforrás módosítása. . . . . . . . Adatbetöltési módosítások megvalósítása . . . Mintaadatok betöltése. . . . . . . . . Portfólió-mintaadatok. . . . . . . . . .
. 49 . 50 . 51 52 . 53 . 53 . . . . . . .
58 58 58 59 59 59 60
Nyilatkozatok . . . . . . . . . . . . 63 Adatvédelmi szempontok. Védjegyek . . . . .
. .
. .
. .
. .
. .
. .
. .
. .
. .
. 64 . 65
iii
iv
© Copyright IBM Corp. 2011, 2015
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel A DataConnect eszköz révén állomásoztatási táblákkal és munkafolyamat-feladatokkal adatokat importálhat külső rendszerekből az IBM® TRIRIGA adatbázisba.
A TRIRIGA Adatcsatlakozási folyamat áttekintése Az IBM TRIRIGA DataConnect eszköz a külső adatok IBM TRIRIGA adatbázisba való importálására szolgál. Az adatok kezdeti betöltése mellett az adatok ismétlődő jellegű, kötegelt beszúrása és kötegelt frissítése számára egyaránt hasznos. A DataConnect eszköz segítségével külső forrásokból közvetlenül képes adatokat írni az IBM TRIRIGA állomásoztatási táblákba. Ezt követően munkafolyamatok igénybevételével dolgozhatja fel az adatokat az IBM TRIRIGA üzleti objektumokba történő beszúrásuk céljából. Az adatok beillesztésén túl nyelvi táblákban is tárolhatja az adatokat. Az Adatcsatlakozási folyamat megvalósítása a következő alaplépéseket foglalja magában: v Az üzleti objektumokhoz tartozó állomásoztatási táblák előkészítése, amelyek a külső forrásból kerülnek feltöltésre vagy frissítésre. v Az Adatcsatlakozási feladatvezérlő üzleti objektum előkészítése. Ez az üzleti objektum vezérli az integrációs példányt. v Az adatok külső forrásból a megfelelő üzletiobjektum-állomásoztatási táblákba, valamint az Adatcsatlakozási feladatvezérlő táblába való áthelyezésére szolgáló mechanizmus előkészítése. Ehhez ETL leképezéseket vagy SQL kódot vehet igénybe. v Az üzletiobjektum-állomásoztatási táblákból származó adatok új vagy frissített rekordokba való áthelyezésére szolgáló munkafolyamatok előkészítése. Az Adatcsatlakozási ügynök által indított munkafolyamatok a bemeneti adatok érvényesítését, valamint egyéb üzleti funkció megvalósítását is végre tudják hajtani.
Objektumátállítási csomagok IBM TRIRIGA alkalmazásváltozatától függően bizonyos Adatcsatlakozási objektumátállítási csomagokat kell alkalmaznia a frissítésekre. A triDataConnectJob.zip és triDataConnectJobLog.zip nevű csomag az IBM TRIRIGA telepítési könyvtár \userfiles\upgrades mappájában található. Ha a triDataConnectJob üzleti objektum nem érhető el a telepítési környezetében, akkor a triDataConnectJob modulban alkalmaznia kell a triDataConnectJob objektumátállítási csomagot. Ha a triDataConnectJobLog üzleti objektum nem érhető el a telepítési környezetében, akkor a triLog modulban alkalmaznia kell a triDataConnectJobLog objektumátállítási csomagot. Az Adatcsatlakozás eszköz TRIRIGA 8.x alkalmazás-adatbázissal működik együtt. A triDataConnectJob objektumátállítási csomag importálása után a triCreatedBy mező üres. Ez az állapot nem számít problémának, és nem szabad módosítani. Az Adatcsatlakozási ügynök tölti fel a mezőt az Adatcsatlakozási feladatbejegyzésből származó IBM TRIRIGA felhasználóval.
Állomásoztatásitábla-beállítások Ahhoz, hogy az üzleti objektumok hozzájuk társított állomásoztatási táblával rendelkezzenek, be kell kapcsolni az adott üzleti objektum Állomásoztatási táblával rendelkezik tulajdonságát. Emellett az üzleti objektumon belüli mezőket állomásoztatásitábla-mezőként © Szerzői jog IBM 2011, 2015
1
kell azonosítani, amit a hozzájuk tartozó Állomásoztatásitábla-mező tulajdonság bekapcsolásával lehet elvégezni. Az üzleti objektumok közzététele létrehozza vagy frissíti a hozzájuk társított állomásoztatási táblát. Az üzleti objektum csak egy állomásoztatási táblával rendelkezhet.
Állomásoztatási táblákkal rendelkező üzleti objektumok Az IBM TRIRIGA adminisztrátori konzolon válassza ki az Adatcsatlakozási felügyelt objektumot, majd az Állomásoztatási táblával rendelkező üzleti objektumok lehetőséggel tekintse meg az állomásoztatási táblával ellátott üzleti objektumok felsorolását. Ha egy adott bejegyzés állomásoztatásitábla-mezőit szeretné látni, akkor jelölje ki a sorelemet, majd kattintson az Adatok kibontása lehetőségre. A Mezők oszlop ezután megjeleníti a mező IBM TRIRIGA nevét, egy kötőjelet, majd a mező adatbázisbeli nevét. Ha a mező egy beszúrási és frissítési (Upsert) műveletben használt kulcsmező, akkor a mező nevében csillag látható. Az Adatcsatlakozási intelligensszakasz-kulcsok a szakasz nevét, majd azután a mező nevét jelenítik meg. A meződefiníciók a bejövő adatokhoz tartozó megfelelő állomásoztatásitábla-mezők azonosításához hasznosak. További információkért forduljon az IBM TRIRIGA Application Platform 3 - Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz.
Állomásoztatási táblával rendelkezik Az Állomásoztatási táblával rendelkezik tulajdonság azokat az üzleti objektumokat azonosítja, amelyek esetében az IBM TRIRIGA rendszer állomásoztatási táblákat tart fenn. Ha a tulajdonság be van kapcsolva, valamint megtörtént az üzleti objektum közzététele, akkor a rendszer létrehozza vagy frissíti az állomásoztatási táblát. Amennyiben a tulajdonság ki van kapcsolva, és ekkor történik meg az üzleti objektum közzététele, úgy a közzétételi folyamat törli az állomásoztatási táblát, ha az létezik. Alapértelmezésben az Állomásoztatási táblával rendelkezik tulajdonság ki van kapcsolva. Amikor az üzleti objektum behozatala objektumátállításon keresztül került végrehajtásra, és az objektumátállítás közzéteszi az üzleti objektumot, akkor a rendszer állomásoztatási táblát készít az üzleti objektum számára bekapcsolt Állomásoztatási táblával rendelkezik tulajdonsággal.
Állomásoztatásitábla-mező Az Állomásoztatásitábla-mező tulajdonság az üzleti objektum állomásoztatási táblájába befoglalni kívánt mezőket azonosítja. Ha a tulajdonság be van kapcsolva, akkor a mező bekerül az állomásoztatási táblába. Ha a tulajdonság az állomásoztatási tábla létrejötte után módosul, akkor az addig nem tükröződik az állomásoztatási táblában, amíg újra közzé nem teszik az üzleti objektumot. Alapértelmezésben az Állomásoztatásitábla-mező tulajdonság ki van kapcsolva, hacsak nem kötelező mezőről van szó. Az Állomásoztatásitábla-mező tulajdonság a következő mezőtípusok esetében támogatott: Logikai, Üzleti objektum, Osztályozás, Szín, Dátum, Dátum és időpont, Időtartam, Lista, Helymeghatározó, Szám, Jelszó, Szöveg, Időpont, Mértékegység és URL. Csak az Általános szakaszban lévő mezők támogatottak állomásoztatásitábla-mezőként. Az intelligens szakaszban szereplő mezők hozzáadhatók az állomásoztatási táblához. Minden kötelező mező bekapcsolt Állomásoztatásitábla-mező tulajdonsággal rendelkezik. Ha egy számmezőhöz tartozó Állomásoztatásitábla-mező tulajdonságot egy üzleti objektumban szereplő kapcsolódó mértékegységmezővel állítja be, akkor ügyeljen rá, hogy a kapcsolódó Mértékegység mező Állomásoztatásitábla-mező tulajdonságát is kötelező beállítania. Be kell állítania a kapcsolódó mértékegységhez tartozó Állomásoztatásitábla-
2
© Copyright IBM Corp. 2011, 2015
mező tulajdonságot is, ha az importált mértékegység eltér az alapmértékegységtől. Ha például a terület alapmértékegysége a négyzetláb, az importált mértékegysége pedig az acre, akkor állítsa be az importálni kívánt mértékegység Állomásoztatásitábla-mező tulajdonságát. Formázott értékeket is befoglalhat az állomásoztatási táblákba a Dátum, Dátum és időpont, Időtartam és Időpont mező esetében. Ha ezen Adatcsatlakozási formátummezők tulajdonsága be van kapcsolva, akkor a mező bekerül az állomásoztatási táblába. A mező nevéhez az állomásoztatási táblában hozzáfűzésre kerül az _F utótag. Ha például a TRIDATEDA nevű dátummező Állomásoztatásitábla-mező tulajdonsága be van kapcsolva, akkor a TRIDATEDA_F mező kerül be az állomásoztatási táblába. Ezen mezők formátumát a felhasználóhoz tartozó felhasználói beállítások határozzák meg. Az említett formátummezők használata nem kötelező. Ha azonban bele kívánja foglalni ezeket a formátummezőket az állomásoztatási táblába, akkor a módosítás alkalmazásához közzé kell tennie az üzleti objektumot.
Állomásoztatásitábla-kulcs Az Állomásoztatásitábla-kulcs tulajdonság azon kulcsként használandó mezőket azonosítja, amelyekkel a rekordok megkereshetők a beszúrási és frissítési (Upsert) vagy frissítési (Update) műveletek révén. A beszúrási (Insert) művelet nem használja ezt a tulajdonságot. Alapértelmezésben az Állomásoztatásitábla-kulcs tulajdonság ki van kapcsolva. Csak akkor jelölhető be, ha az Állomásoztatásitábla-mező tulajdonság be van kapcsolva. Az Állomásoztatásitábla-kulcs tulajdonság a következő mezőtípusok esetében támogatott: Logikai, Üzleti objektum, Osztályozás, Szín, Dátum, Dátum és időpont, Időtartam, Lista, Helymeghatározó, Szám, Jelszó, Szöveg, Időpont, Mértékegység és URL.
Üzleti objektumok közzététele Amikor az Üzleti objektum közzététele műveletet választja egy olyan üzleti objektum esetében, amely bekapcsolt Állomásoztatási táblával rendelkezik tulajdonsággal rendelkezik, a rendszerben bizonyos ellenőrzések aktiválódnak. Ha léteznek olyan Feldolgozás alatt vagy Kész állapotú feladatok, amelyek az állomásoztatási táblát és az üzleti objektumot használják, akkor a közzététel sikertelen lesz, és a rendszer azonnal megjelenít egy üzenetet a felhasználónak. Az üzletiobjektum-közzétételt egy ügynök kezeli, és ez nem egy azonnali művelet. A Közzétételi ügynök így ismét ellenőrzi a feladatokat új feladat indításakor, illetve abban az esetben, amikor egy meglévő feladat állapota időközben megváltozott. Ha léteznek olyan Feldolgozás alatt vagy Kész állapotú feladatok, amelyek az állomásoztatási táblát és az üzleti objektumot használják, akkor az üzleti objektum közzététele meghiúsul. Ezután az IBM TRIRIGA rendszer értesítést küld a felhasználónak, kiírva a server.log fájlba a részleteket arról, hogy a közzététel miért lett sikertelen.
Üzletiobjektum-törlés Amikor az Üzleti objektum törlése műveletet választja egy olyan üzleti objektum esetében, amely bekapcsolt Állomásoztatási táblával rendelkezik tulajdonsággal rendelkezik, a rendszerben bizonyos ellenőrzések aktiválódnak. Ha létezik olyan Feldolgozás alatt állapotú feladat, amely az állomásoztatási táblát és az üzleti objektumot használja, akkor a törlés sikertelen lesz, és a rendszer azonnal megjelenít egy üzenetet a felhasználónak. Ha Várakozás állapotú feladat létezik, akkor az üzleti objektum és az állomásoztatási tábla törlésre kerül, a feladat állapota pedig Elavult értékre módosul.
Feladatok üzleti objektumai Az Adatcsatlakozási feladatvezérlő tábla (DC_JOB) az adatokat az állomásoztatási táblákból az IBM TRIRIGA adatbázisba áthelyező feladatokat kezeli. Minden egyes integrációs 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
3
folyamathoz léteznie kell üzleti objektumnak a triDataConnectJob modulban. Az üzleti objektum triDataConnectJob modulbeli létrehozása az integrációs folyamat egyszeri feladata. Minden egyes integrációs folyamat számára szükség van Adatcsatlakozási feladatvezérlő üzleti objektumra. Ha például beszerzési megrendeléseket tölt fel egy külső forrásból, akkor előfordulhat, hogy egy cstPurchaseOrderJob üzleti objektummal rendelkezik Adatcsatlakozási feladatvezérlő üzleti objektumként. Ezután a feldolgozás a cstPurchaseOrderBody és a cstPurchaseOrderLine üzleti objektum adatait kérheti le (mindkettő bekapcsolt Állomásoztatási táblával rendelkezik tulajdonsággal rendelkezik). Az üzleti objektumokat általánosan a következő lépésekkel hozhatja létre: v Az Adatmodellező eszközön keresztül nyissa meg a triDataConnectJob modult. v Hozza létre az üzleti objektumot a triDataConnectJob modulban. Miután létrehozta az új üzleti objektumot, létrehozhat egy űrlapot és menünavigációt a számára. Az Adatcsatlakozási eszköz az alapvető triDataConnectJob üzleti objektumhoz kapcsolódó alapszintű űrlappal és menüvel kerül szállításra. Az új üzleti objektum állapotátmenetei az alapvető üzleti objektumtól öröklődnek, és nem szabad azokat módosítani. Az alapvető triDataConnectJob üzleti objektum a következő állapotátmeneteket biztosítja: v Null -> triDCStartProcessing -> Folyamatban v Folyamatban -> triDCCompleted -> Befejezett v Folyamatban -> triDCFailed -> Sikertelen Az első szakaszban minden mező csak olvasható. A második szakasz az adott Adatcsatlakozási feladat naplóbejegyzéseit tartalmazza. A naplóbejegyzések triLog modulbeli triDataConnectLog rekordok. Az adott sorelemre kattintva megtekintheti a kérdéses esemény részleteit. Alapértelmezésben a második szakasz az Adatcsatlakozási eszköz futása során talált problémákat mutatja be. Ha azonban bejelöli az Adatcsatlakozási futási környezet lehetőséget az IBM TRIRIGA adminisztrátori konzol Platformnaplózás felügyelt objektumában, akkor a második szakasz a beszúrt vagy frissített rekordokkal kapcsolatos pozitív információkat is megjeleníti. A különféle ügynökök naplózási szintjeit a platformnaplózási beállítások mellett azon kiszolgáló log4j beállításai határozzák meg, ahol az ügynök futtatásra kerül. Az Adatcsatlakozási eszköz két ügynököt használ. Az egyik az Adatcsatlakozási ügynök, amely létrehozza a feladatobjektumokat és eseményeken keresztül aszinkron módon átadja azokat a Munkafolyamat ügynöknek. Feladata véget ér, amikor a feladatobjektum létrehozásra, az esemény pedig elküldésre kerül. A második, Munkafolyamat nevű ügynök az üzleti funkciót (a munkafolyamatokat) futtatja, majd az Adatcsatlakozási feladatok hozzák létre és frissítik az objektumokat az IBM TRIRIGA adatbázisban. Ha felmerült problémák hiányában is jelentést kíván kapni a feladatobjektumokról, akkor be kell állítania a Munkafolyamat ügynök kiszolgálójára vonatkozó Adatcsatlakozási futási környezet naplózását. Az Adatcsatlakozási ügynök kiszolgálójára vonatkozó beállításnak nincs hatása, mivel a Munkafolyamat ügynök futtatja a munkafolyamatot, valamint hozza létre vagy frissíti az objektumokat az állomásoztatási táblákból.
Az adatok táblákba való áthelyezésének mechanizmusai Meg kell határoznia azt a mechanizmust, amely egy ETL eszközön vagy közvetlen SQL utasításokon keresztül elvégzi a külső forrásból származó adatok áthelyezését az IBM TRIRIGA adatbázis megfelelő tábláiba. Ezek a táblák az üzletiobjektum-állomásoztatási táblákat, valamint az Adatcsatlakozási feladatvezérlő táblát foglalják magukban.
4
© Copyright IBM Corp. 2011, 2015
A mechanizmusnak az Adatcsatlakozási feladatvezérlő táblán, valamint az üzletiobjektum-állomásoztatási táblákon belüli hivatkozáshoz egyaránt létre kell hoznia egy egyedi feladatszámot. Ezenkívül a mechanizmus legalább egy korrelációs és sorszámot is belefoglalhat. Bár a feladatszámhoz nem kapcsolódik jelentés, az értéknek egyedi azonosítónak kell lennie. A feladatszám létrehozásának egyik megközelítése a globálisan egyedi azonosítók (GUID) vagy általánosan egyedi azonosítók (UUID) előállító eszközének használata. Ezután a módszer kísérletet tehet az Adatcsatlakozási feladatvezérlő tábla bejegyzésének Új állapottal történő beillesztésére. Ha a kísérlet sikeres, akkor használja azt az állomásoztatási táblákba írt bejegyzések feladatszámaként. Amennyiben a kísérlet ismétlődő kulcs hibával meghiúsul, úgy állítson elő egy másik GUID/UUID/FUID értéket, majd próbálkozzon újra. Igénybe veheti a Adobe Kettle Spoon eszközét. Ez a módszer hasonló ahhoz, ahogy az IBM TRIRIGA Workplace Performance Management és az IBM TRIRIGA Real Estate Environmental Sustainability termék használja a Spoon eszközt a ténytáblák ETL leképezéseinek létrehozásához, amit az adatok IBM TRIRIGA táblákból való lekérésével hajtanak végre.
Az állomásoztatási táblák mezői Az Állomásoztatásitábla-mező tulajdonsággal megadott mezőkön kívül minden állomásoztatási tábla tartalmaz bizonyos mezőket. 1. táblázat: Az állomásoztatási táblák mezői Alapértelmezett érték Nullképes Leírás
Oszlop neve
Kulcs Típus
DC_JOB _NUMBER
I
NUMBER (20)
N
A feladat azonosítószáma.
DC_CID
I
NUMBER (20)
N
Korrelációs azonosítószám, amely az állomásoztatási táblákból származó szülő-utód viszonyokhoz kerül felhasználásra.
DC _SEQUENCE _ID
I
NUMBER (20)
N
Bejegyzéscsoport sorszáma.
DC_STATE
N
NUMBER (4)
0
N
Állapotazonosító, amely az adott bejegyzés aktuális állapotát jelzi az Adatcsatlakozási feladat feldolgozása során. Az értékek: 0 - Új, 1 - Kész, 2 - Feldolgozás alatt, 3 - Befejezett, 4 Sikertelen, 5 - Elavult.
DC_ACTION
N
NUMBER (4)
1
N
A végrehajtott művelet. Az értékek: 1 - Beszúrás (Insert), 2 - Frissítés (Update), 4 - Beszúrás és frissítés (Upsert).
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
5
1. táblázat: Az állomásoztatási táblák mezői (Folytatás) Alapértelmezett érték Nullképes Leírás
Oszlop neve
Kulcs Típus
DC_PATH
N
VARCHAR ()
I
Azon objektum elérési útvonala (a rekordnévvel együtt), amelyen a művelet zajlik. Beszúrás esetén ez a mező azt jelezheti az Adatcsatlakozási feladatnak, hogy hol kell a hierarchiában elhelyezni a rekordot. Az utódoknak rendelkezniük kell a szülőútvonallal a DC_PATH oszlopban. Ha az objektum a hierarchia csúcsán található, vagy nem hierarchiában helyezkedik el, akkor a DC_PATH oszlopnak üresnek kell lennie. Ha frissítés esetén nem léteznek kulcsok, akkor ezt a mezőt a frissíteni kívánt rekordra, a frissítendő rekord IBS_SPEC.OBJECT_PATH értékére kell beállítani.
DC_GUI _NAME
N
VARCHAR (100)
I
Az új vagy frissített sor által használni kívánt űrlap neve. Ha beszúrás esetén az űrlap nincs beállítva, akkor a rendszer az üzleti objektum alapértelmezett űrlapját használja, ha van ilyen. Ellenkező esetben az objektum nem rendelkezik társított űrlappal. Ha frissítés esetén az űrlap nincs beállítva, akkor a rendszer nem módosítja az aktuális űrlap beállítását.
DC_PROJECT
N
VARCHAR (100)
I
Beszúrás vagy frissítés esetén beállítja a rekord projektjét, ha az nem üres. Az érték a portál menüsorában a projekt kiválasztásakor megjelenő értéknek felel meg. A DC_PROJECT érték által kötelezően használandó formátum: projektazonosítóprojektnév. Csak a beszúrásban vagy frissítésben érintett rekord projektje módosul. A rekord utódai esetében nem történik változás. Ha szülő-utód viszonnyal rendelkező adatok beszúrását vagy frissítését hajtja végre, akkor ügyeljen rá, hogy a módosítani kívánt összes adat számára megfelelő projektet állítsa be.
6
© Copyright IBM Corp. 2011, 2015
1. táblázat: Az állomásoztatási táblák mezői (Folytatás) Oszlop neve
Kulcs Típus
N Az oszlopneveket az IBM TRIRIGA Application Platform rendszer határozza meg. Az állomásoztatási tábla és az adatbázis nevét az Adminisztrátori konzol segítségével keresheti meg.
Az IBM TRIRIGA Application Platform oszloptípustól függ.
Alapértelmezett érték Nullképes Leírás I
Az üzleti objektum bejelölt (bekapcsolt) Állomásoztatásitáblamező tulajdonsággal rendelkező mezői. Kiegészítő oszlop kerül hozzáadásra az állomásoztatási táblában a Dátum, Dátum és időpont, Időtartam és Időpont típusú mezők esetében. Ezen mezők neve _F utótagot kap. Az Állomásoztatásitábla-kulcs tulajdonság alapján a mezők kulcsok lehetnek. A beszúrás és frissítés (Upsert) és a frissítés (Update) művelet használja. A beszúrási és frissítési (Upsert) műveletek esetén az Adatcsatlakozási feladat a kijelölt kulcsértékek állomásoztatási táblabeli alkalmazásával állítja elő az SQL kódot, hogy ellenőrizze, létezik-e a rekord. Ha a rekord létezik (azaz található ilyen rekord), akkor az állomásoztatási táblában lévő adatokkal a rendszer frissíti a rekordot. Ha több rekord létezik, akkor az állomásoztatási tábla sora Sikertelen jelölést kap. Ha a rekord nem létezik (nem található ilyen rekord), akkor a rendszer az állomásoztatási tábla adatainak alkalmazásával új rekordot szúr be. Ha frissítési (Update) műveletek esetén meghatározott kulcsok kapcsolódnak az állomásoztatási táblához, akkor az Adatcsatlakozási feladat az állomásoztatási táblában szereplő kulcsértékek alkalmazásával állítja elő az SQL kódot, hogy ellenőrizze a rekord létezését. Ha a rekord létezik (azaz található ilyen rekord), akkor az állomásoztatási táblában lévő adatokkal a rendszer frissíti a rekordot. Ha több rekord létezik, akkor az állomásoztatási tábla sora Sikertelen jelölést kap. Ha a rekord nem létezik (nem található ilyen rekord), akkor az állomásoztatási tábla sora Sikertelen jelölést kap.
A DC_JOB tábla mezői A DC_JOB tábla feltöltését a külső folyamat, frissítését az Adatcsatlakozási ügynök és az azon tevékenységet végző aszinkron munkafolyamatok, törlését pedig a Tisztítási ügynök hajtja végre. A DC_JOB tábla meghatározott mezőket tartalmaz. 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
7
2. táblázat: A DC_JOB tábla mezői Oszlop neve
Kulcs Típus
JOB _NUMBER
I
NUMBER (20)
JOB_TYPE
I
NUMBER (4)
JOB_NAME
N
JOB_RUN _CTL
Alapértelmezett érték Nullképes Leírás N
A feladat azonosítószáma.
N
A feladattípus azonosítója. Értéke: 1 IBM TRIRIGA rekordok, bejövő adatok létrehozása/frissítése.
VARCHAR (100)
I
A feladat neve.
N
VARCHAR (100)
N
A párhuzamosságot irányítja. Az Adatcsatlakozási ügynök a JOB_RUN_CTL mezőt a JOB_NAME értékkel együtt használja saját maga szabályozásához. Ha a feladat egyszálú, akkor az adott JOB_NAME értékkel más feladat nem futhat addig, amíg az éppen futó feladat be nem fejeződik vagy meg nem hiúsul. Az értékek: 1 - egyszálú, 2 többszálú.
BO_NAME
N
VARCHAR (100)
I
A feladat ábrázolása céljából létrehozott rekord üzletiobjektum-neve. Ezt az üzleti objektumot a triDataConnectJob modulban kell létrehozni.
USER_ID
N
NUMBER (20)
I
A feldolgozáshoz alkalmazandó felhasználói azonosító. Érvényes IBM TRIRIGA felhasználói azonosítónak (T_MYPROFILE ID) kell lennie.
STATE
N
NUMBER (4)
N
Állapotazonosító a feladat aktuális állapotának jelzésére. Az értékek: 0 Új, 1 - Kész, 2 - Feldolgozás alatt, 3 Befejezett, 4 - Sikertelen, 5 - Elavult.
SOURCE _SYS_ID
N
VARCHAR (100)
I
A feladatot létrehozó rendszer azonosítója (információs jelentéskészítéshez használatos).
PROCESS _SYS_ID
N
VARCHAR (100)
I
A feladatot (éppen) feldolgozó rendszer azonosítója (információs jelentéskészítéshez használatos). Nem kell megadnia ezt az információt.
CREATED _DATE
N
DATETIME
N
A bejegyzés hozzáadásának dátuma/időpontja (alapértelmezés szerint).
UPDATED _DATE
N
DATETIME
I
A bejegyzés legutóbbi módosításának dátuma/időpontja. Nem kell megadnia ezt az információt.
1
0
Dátum
Az Adminisztrátori konzol segítségével tekintheti meg a DC_JOB tábla tartalmát. Válassza az Adminisztrátori konzol Adatcsatlakozási felügyelt objektumában az Adatcsatlakozási feladatok lehetőséget. Az Adminisztrátori konzollal és az Adatcsatlakozási felügyelt
8
© Copyright IBM Corp. 2011, 2015
objektummal kapcsolatban további információkért forduljon az IBM TRIRIGA Application Platform 3 - Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz.
ETL leképezések Az Adatcsatlakozási integráció Ön általi megvalósítása határozza meg, hogyan helyezi át adatait az állomásoztatási táblákba - hogy ETL eszközt vagy közvetlen SQL utasításokat vesz-e ebből a célból igénybe. Azonban az adatok külső forrásból állomásoztatási táblákba való áthelyezési módjától függetlenül a leképezés futtatása előtt kell az adatokat a külső forrásban feltölteni. Ha ETL eszközt használ, akkor az integráció határozza meg, hogy milyen ETL leképezéseket kell fejlesztenie az adatok külső forrásból állomásoztatási táblákba való áthelyezéséhez. A külső forrás és az állomásoztatási táblák közötti ETL leképezés meghatározásához egy alkalmas eszközt kell igénybe vennie. Ezek egyike a Pentaho Kettle Spoon eszköze. Emellett igény szerint más eszközöket is használhat. Futásakor a leképezésnek a következő feladatokat kell elvégeznie: v Egyedi feladatszám létrehozása. v Bejegyzés készítése az Adatcsatlakozási feladatvezérlő táblában (DC_JOB), Új értékre állítva be annak állapotát. v Az üzleti objektumokhoz kapcsolódó állomásoztatási táblák feltöltése, az esetleges leszármazott állomásoztatási táblákat is beleértve. A bejegyzések a feladatszámot, legalább egy korrelációs számot és a műveletet tartalmazzák. A meghatározott kulcs nélküli Frissítés műveletek esetén az útvonalat is kötelező megadni, amely elhagyható a Beillesztés műveletek esetén. v Választható: Az Adatcsatlakozási feladatvezérlő táblában (DC_JOB) szereplő bejegyzés frissítése az állapot Kész értékre való módosításával. Ezt a frissítést saját kezűleg az Adminisztrátori konzolon keresztül lehet elvégezni: az Adatcsatlakozási felügyelt objektum és az Adatcsatlakozási feladat kiválasztása után a Kész feladat műveletet vegye igénybe.
Az adatok rekordokba való áthelyezésének munkafolyamatai Az IBM TRIRIGA rendszerből származó munkafolyamat-képességek segítségével adatokat helyezhet át az állomásoztatási táblákból a tényleges üzletiobjektum-rekordokba. A pontos munkafolyamat-funkció vállalata üzleti szabályaitól és a feltölteni kívánt üzleti objektumtól függ. Az Adatcsatlakozást vezérlő munkafolyamatokat a triDataConnectJob modulban kell létrehozni. Az Adatcsatlakozási munkafolyamat-feladat segítségével lekérheti az állomásoztatási rekordokat, majd végighaladhat az állomásoztatott bejegyzéseken, létrehozva vagy frissítve az egyes bejegyzésekhez tartozó intelligens rekordokat. Az Adatcsatlakozási munkafolyamat-feladatok beágyazásával támogathatók a szülő-utód viszonyok és az üzleti funkció. Az Adatcsatlakozási feladat tevékenysége két részre osztható: v Az Adatcsatlakozási feladat tulajdonságbeállításaiban meghatározott módon lekéri a megfelelő állomásoztatási táblából a kezelni kívánt rekordok halmazát. v Iterátorként viselkedik az alábbi feladatok tekintetében: – Létrehozza vagy frissíti az állomásoztatási táblából származó egyes adatsorok rekordját. – Az egyes sorokra futtatja az Adatcsatlakozási feladat törzsét. Az egyéb feladatlépések az Adatcsatlakozási feladat törzsében helyezhetők el. Az Adatcsatlakozási munkafolyamat-feladat belsejében a feladat felülvizsgálat státusza INSERT (beillesztés), UPDATE (frissítés) vagy FAILED (sikertelen) lehet - a feladatiteráció aktuális művelete alapján. Az Adatcsatlakozási munkafolyamat-feladatból való kilépés során 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
9
a Státusz értéke Befejezett vagy Sikertelen lehet (ha az állomásoztatási tábla bármely sora sikertelen).
Példa Adatcsatlakozási feladattal rendelkező munkafolyamatra A következő példa egy beszerzési megrendelést (BM) és annak BM sorcikkeit használja fel szemléltetés céljából. Elsőként tekintse meg a teljes munkafolyamatot.
1. ábra: Adatcsatlakozási feladatot magában foglaló munkafolyamat
Munkafolyamat-feladatok beállításai A Munkafolyamat-készítő eszközben hozzon létre egy munkafolyamatot a triDataConnectJob modulban. A munkafolyamat-minta számos kulcsfontosságú feladatot és feladatbeállítást kezel.
10
© Copyright IBM Corp. 2011, 2015
Indítási feladat A triDataConnectJob modulhoz és a SYSTEM DC PROCESS JOB eseményhez kapcsolódó objektumtípus azonosítja az Adatcsatlakozási ügynök megfelelő munkafolyamatát. Az Adatcsatlakozási ügynök lekéri a BO_NAME mezőt, amelynek a feladathoz tartozó DC_JOB bejegyzésből származó objektumtípus nevének kell lennie. 3. táblázat: Az Indítási feladat beállításai Mező
Leírás
Név
A munkafolyamat Indítási feladatában az IBM TRIRIGA rendszer névképzési szabványainak alkalmazásával adja meg a munkafolyamat Név értékét.
Párhuzamosság, Integráció
Állítsa a Párhuzamosság tulajdonságot Aszinkron értékűre. Jelölje be az Integráció jelzőparamétert, amely lehetővé teszi az Adatcsatlakozási feladatoknak, hogy a munkafolyamat részévé váljanak.
Modul
Állítsa a Modul tulajdonságot triDataConnectJob értékre.
Objektumtípus
Állítsa be az Objektumtípus értékét a triDataConnectJob modulban létrehozott üzleti objektumra.
Esemény
Állítsa be az Esemény tulajdonságot a következő értékre: SYSTEM DC PROCESS JOB. Ez az Adatcsatlakozási esemény.
Integrációs státusz terjesztése, Integráció
Jelölje be az Integrációs státusz terjesztése jelzőparamétert, amely meghatározza, hogy terjeszteni kell az Integráció jelzőparamétert, amikor ez a munkafolyamat meghív egy másikat.
Adatcsatlakozási feladat Az Adatcsatlakozási feladat rekordokat kér le az állomásoztatási táblából, majd végighalad az állomásoztatott bejegyzéseken, létrehozva vagy frissítve az egyes bejegyzések intelligens rekordját. 4. táblázat: Az Adatcsatlakozási feladat beállításai Mező
Leírás
Címke, Leírás
A munkafolyamat törzsének létrehozása az Adatcsatlakozási feladat segítségével, ahol megfelelő. Adja meg a Címke és a Leírás értékét.
Modul, Üzleti objektum
Határozza meg azon Modul és Üzleti objektum értékét, amelyen az Adatcsatlakozási feladat működik.
Kiinduló állapot
Állítsa a Kiinduló állapot tulajdonságot arra az értékre, amely állapotban létre kell hozni az új rekordot. Az Adatcsatlakozási feladat figyelmen kívül hagyja a Kiinduló állapot értékét, ha a rekord frissítésre kerül. A listamezőben szereplő választási lehetőségek az üzleti objektum számára meghatározott állapotok. A rekord az adott állapotban jön létre; nem átmenettel kerül a kérdéses állapotba. Ha állapotátmenetet kíván végezni az adott rekordon, akkor az Adatcsatlakozási feladattal Null állapotban hozza létre az objektumot. Ezután az Adatcsatlakozási feladat törzsén belüli Műveletaktiválási feladat segítségével valósítsa meg a rekord átmenetét a kívánt állapotba.
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
11
4. táblázat: Az Adatcsatlakozási feladat beállításai (Folytatás) Mező
Leírás
Ideiglenes adatok használata
Akkor válassza az Ideiglenes adatok használata tulajdonságot, ha az Adatcsatlakozási feladatnak ideiglenes adatokat kell igénybe vennie. Amikor a bejelölt Ideiglenes adatok használata tulajdonsággal rendelkező Adatcsatlakozási feladat bejövő adatokat alkalmaz, akkor a platform az állandó adatok helyett az ideiglenes adatokon végez beszúrást vagy frissítést. Példákért és további részletekért forduljon az Ideiglenes adatok használatával foglalkozó témakörhöz.
Sorrendben, Feladatlépés
A Korreláció szakaszban: v A Sorrendben tulajdonság azt jelzi, hogy az állomásoztatási bejegyzésre vonatkozó korreláció és a sorszám kerül felhasználásra a rekordok feldolgozási sorrendjének megállapításához. Ez az alapértelmezett és leggyakoribb példahelyzet, kivéve, ha egymásban lévő Adatcsatlakozási feladatokkal rendelkezik. v A Feladatlépés tulajdonság azt jelzi, hogy a korrelációnak egy befoglaló Adatcsatlakozási feladatból kell származnia, továbbá fel kell használni a WHERE részkifejezésben a feldolgozandó bejegyzések meghatározásához. Például: Feladatszám + Korrelációs szám, Sorszám szerint rendezve. A Feladatlépés tulajdonság lehetővé teszi az Adatcsatlakozási feladatnak a korrelációs szám egyik befoglaló Adatcsatlakozási feladatból való lekérdezését.
Nincs, X iterációnként, Minden iteráció
Válassza ki a hatókört a Tranzakció szakaszban. v Nincs: A rekord közvetlenül a létrehozását vagy frissítését követően véglegesítésre kerül. v X iterációnként: Minden X. iterációban kerül új kontextus létrehozásra és véglegesítésre, amikor az adott számú iteráció befejeződött. v Minden iteráció: Új kontextus kerül létrehozásra, mielőtt a feladat megkezdené a feldolgozást, a véglegesítésre pedig az összes iteráció befejezését követően kerül sor.
Műveletaktiválási feladat A munkafolyamat utolsó lépésének egy Műveletaktiválási feladatnak kell lennie, amely Befejezett vagy Sikertelen jelzéssel látja el a feladatot. 5. táblázat: A Műveletaktiválási feladat beállításai Mező
Leírás
Címke, Művelet
A Műveletaktiválási feladat tulajdonságai között adja meg a Feladat megjelölése befejezettként értéket a Címke mezőben, valamint válassza ki a triDCCompleted értéket a Művelet mezőben.
Következő beolvasása, A Rekordok szakaszban válassza ki a Következő beolvasása mező Feladat esetében, Következő üzleti objektumát, majd Válassza ki az Indítás (loDCPurchaseOrder) használata, Objektumtípus lehetőséget a Feladat esetében mezőben. Jelölje be a Következő használata beállítást, majd válassza a loDCPurchaseOrder értéket az Objektumtípus mező számára.
Megszakítás feladat A tranzakciók visszagörgetése vagy véglegesítése érdekében helyezzen el egy Megszakítás (vagy Folytatás) feladatot az Adatcsatlakozás törzsében. A Megszakítás (vagy Folytatás) feladattal ellenőrizheti az Adatcsatlakozási feladat státuszát, valamint meghatározhatja, hogy mely blokkra kell átlépni. Eldöntheti továbbá, hogy folytatni kell-e az iterálást (Folytatás vagy
12
© Copyright IBM Corp. 2011, 2015
Megszakítás), illetve véglegesítést vagy visszagörgetést kell-e végezni (Sikeres vagy Sikertelen). Az Adatcsatlakozási feladatra vonatkozó tranzakciós beállítás együttműködik a Megszakítás (vagy Folytatás) feladat beállításaival. A Megszakítás feladat az ideiglenes adatok felügyeletéhez is rendelkezik beállításokkal. További részletekért és példákért forduljon az ideiglenes adatok használatával foglalkozó témakörhöz. Ha az Adatcsatlakozási feladat nem használ tranzakciókat, akkor a sorok minden feladatlépésben véglegesítésre kerülnek. Ha nem éri el a feldolgozási folyamot megváltoztató és tranzakciókat használó Megszakítás (vagy Folytatás) feladatot, akkor sor kerül a véglegesítésre az Adatcsatlakozási feladat beállításai alapján. Ha az Adatcsatlakozási feladat tranzakciókat használ és a munkafolyamat megszakításra (vagy folytatásra) kerül, akkor a rendszer visszagörgeti vagy véglegesíti a tranzakciókat a Megszakítás feladat Sikeres vagy Sikertelen beállítása alapján. A feldolgozás a Megszakítás (vagy Folytatás) feladatban jelzett hatókörben folytatódik. Az aktuális hatókör azt az Adatcsatlakozási feladatot jelenti, amelyben éppen tartózkodik. A Megszakítás folyamtípusa a feldolgozás folytatását jelenti az Adatcsatlakozási utáni feladattól kezdődően. A Folytatás folyamtípusa a feladathoz tartozó állomásoztatásitábla-köteg következő sorával történő folytatást jelenti. A Kiválasztott blokk az adott Adatcsatlakozási feladat Megszakítás (vagy Folytatás) feladatát jelenti.
Munkafolyamat-hívások Ha az Adatcsatlakozási feladattal rendelkező munkafolyamat más munkafolyamatokat is meghív, akkor előfordulhat, hogy az Integráció beállítás bejelölésével, valamint az Integrációs státusz terjesztése jelzőparaméter megfelelő módosításával frissíteni kell a kérdéses munkafolyamatokat. Elemezheti azokat a meglévő munkafolyamatokat, amelyeket a munkafolyamat adatmozgatás céljából hívhat meg. Ha a munkafolyamaton belül vannak olyan lépések, amelyeket az integrációs munkafolyamatból való hívás során nem szabad aktiválni, akkor egy kapcsolófeladattal vagy egy indítási feladatban jelölje be az Integráció beállítást. Ha a munkafolyamatnak nem szabad terjesztenie az Integráció státuszt, akkor az indítási feladatban szüntesse meg az Integrációs státusz terjesztése jelzőparaméter jelölését. Az Integráció jelzőparaméter 1 értéke azt jelzi, hogy a jelzőparaméter be van kapcsolva.
Futás közbeni adatérvényesítések Az Adatcsatlakozási futási környezet végez némi adatérvényesítést. Ha például mértékegységmező található az állomásoztatási táblában, előfordulhat, hogy az értéke érvénytelen. Amikor az Adatcsatlakozási feladat hibás sort talál, akkor leállítja a feldolgozást, és sikertelenné teszi az Adatcsatlakozási iterációt (nem a teljes Adatcsatlakozási feladatot). A rendszer Sikertelen értékkel jelöli meg a sort az állomásoztatási táblában. Ezen a ponton választhat: folytatja a feldolgozást a következő iterációval, vagy kilép a feladatból. Helyezzen el egy megszakítási műveletet a munkafolyamatban, hogy közölje, hogyan kell folytatnia a feldolgozást. Ha nem ad hozzá megszakítási műveletet, akkor az Adatcsatlakozási feladat folytatja a feldolgozást. Az Adatcsatlakozási eszköz a következő beépített futás közbeni adatérvényesítéseket tartalmazza: v A mértékegység- és helymeghatározó értékek érvényesek-e. v Az adattípus érvényes-e a mező esetében. v Az űrlapnév érvényes-e az objektum esetében. 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
13
v Ha meg van adva, akkor a projektnév érvényes-e a rendszer számára. További adatérvényesítéseket és tisztítást vehet fel az Ideiglenes adatok használata tulajdonsággal.
Iterációs státuszok A legtöbb feladatiterátor esetéhez hasonlóan az Adatcsatlakozási feladat is emlékszik a legutóbbi iterációjából származó információkra, így többek között a státuszra is. Például előfordulhat, hogy két Adatcsatlakozási feladattal rendelkező munkafolyamatot állít össze, ahol az egyik feladat a másikban található. Ha egy sor meghiúsul a belső iterációban, és be szeretné állítani a megfelelő státuszt a végén, akkor mentse az adott sort egy változóba. Ez a gyakorlat biztosítja, hogy a státusz nem vész el.
Ideiglenes adatok Amikor az Adatcsatlakozási feladatokban kiválasztja az Ideiglenes adatok használata tulajdonságot, azzal lehetővé teszi az adott Adatcsatlakozási feladatban szereplő munkafolyamat-feladatoknak az állomásoztatási táblából érkező bejövő rekordok munkamenet keretében történő feldolgozását. Máshogy fogalmazva: lehetővé válik az adatok adatbázisbeli mentés előtti kezelése. Az Ideiglenes rekord lekérése feladat segítségével kérje le az ideiglenes rekordot, majd az Állandó rekord mentése feladattal végezze el az aktuális munkamenet módosításainak mentését. A Megszakítás feladat képes eltávolítani az adott iterációt a munkamenetből, vagy teljes egészében kiüríteni a munkamenetet. A Megszakítás feladat képes továbbá egy adott állomásoztatásitábla-sort, illetve a legutóbbi Állandó rekord mentése művelet óta feldolgozott összes állomásoztatásitábla-sort is sikertelenné tenni. Az Ideiglenes adatok használata tulajdonság bejelölésekor a munkafolyamat feldolgozása során az Adatcsatlakozási feladat rekordja az állomásoztatási táblából származó módosítások nélküli állandó rekord. Az Ideiglenes rekord lekérése feladat rekordja szolgáltatja pedig az állomásoztatási táblából a frissített vagy bejövő értékeket. Ez a folyamat lehetővé teszi az adatérvényesítést, a munkafolyamaton belüli bejövő értékek megtisztítását, valamint még a frissítés adatleképezését is, ha a mezők üresek az állomásoztatási táblákban.
Példa ideiglenes adatokkal rendelkező egyetlen Adatcsatlakozási feladatra A következő munkafolyamat-kivonat egyetlen Adatcsatlakozási feladatot mutat be, amely ideiglenes adatokat dolgoz fel.
14
© Copyright IBM Corp. 2011, 2015
2. ábra: Egyetlen ideiglenes adatokat feldolgozó Adatcsatlakozási feladat 6. táblázat: Az Adatcsatlakozási feladat beállításai Mező
Leírás
Ideiglenes adatok használata
Bejelölve
7. táblázat: A Megszakítás feladat beállításai Mező
Leírás
Folyamtípus
Folytatás
Feladat státusza
Sikeres
Megszakítás hatóköre
Aktuális hatókör
Ideiglenes adatok megszüntetése
Minden
Állomásoztatási sorok sikertelenné tétele
Bejelölve, amely a Minden értéket állítja be
Az Adatcsatlakozási feladat végighalad az állomásoztatásitábla-rekordokon, elhelyezve a beszúrt vagy frissített rekordokat a munkamenetben. Minden egyes iteráció esetén a munkafolyamat lekér egy ideiglenes rekordot, valamit tesz vele, majd dönt róla, hogy megtartsa-e. A rekord megtartásához végezze el a rekord végleges mentését az Állandó rekord mentése feladattal. A Kapcsoló feladat sikertelen feltétele a Megszakítás/Folytatás feladat beállításait használja az összes munkamenetadat megszüntetéséhez. A sikertelen feltétel a 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
15
munkamenetbeli rekord előállításához használt állomásoztatási sorokat is sikertelenné teszi, majd az iteráció következő rekordjával folytatja a feldolgozást. Az egyetlen Adatcsatlakozási feladatot tartalmazó példában a Megszakítás feladat Ideiglenes adatok megszüntetése tulajdonságának Minden helyett Aktuális értékre való beállítása ugyanazzal az eredménnyel jár.
Példa ideiglenes adatokkal rendelkező több Adatcsatlakozási feladatra A következő munkafolyamat-kivonat egy második, leszármazott Adatcsatlakozási feladatot tartalmazó Adatcsatlakozási feladatot mutat be. Ez a kivonat a korábban látott beszerzésimegrendelés-példa kiterjesztése.
16
© Copyright IBM Corp. 2011, 2015
3. ábra: Több ideiglenes adatokat feldolgozó Adatcsatlakozási feladat 8. táblázat: A külső Adatcsatlakozási feladat beállításai Mező
Leírás
Ideiglenes adatok használata
Bejelölve
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
17
9. táblázat: A külső Megszakítás feladat beállításai Mező
Leírás
Folyamtípus
Folytatás
Feladat státusza
Sikeres
Megszakítás hatóköre
Aktuális hatókör
Ideiglenes adatok megszüntetése
Minden
Állomásoztatási sorok sikertelenné tétele
Bejelölve, amely a Minden értéket állítja be
A külső Adatcsatlakozási feladat végighalad a POBody állomásoztatási táblán. Minden egyes iteráció esetén a munkafolyamat lekér egy ideiglenes rekordot, valamit tesz vele, majd dönt róla, hogy megtartsa-e. Ha a POBody rekorddal kapcsolatban probléma merül fel, akkor a munkafolyamat futtatja a Megszakítás/Folytatás feladatot, valamint az összes munkamenetadatot megszünteti, sikertelenné teszi a sort és áttér a következő POBody rekordra. Ha a POBody rekord áthalad a Kapcsoló feladaton, akkor a feldolgozás a belső Adatcsatlakozási feladattal folytatódik a POBody rekordhoz tartozó POLine sorok kezelése céljából. Előfordulhat, hogy a talált elemektől és a Megszakítás beállításától függően a munkafolyamat több cselekvés egyikét hajtja végre. Több Megszakítás/Folytatás feladattal rendelkezhet, és a feldolgozástól függően a munkafolyamat sikertelenné teheti akár a sorok mindegyikét/egyikét is. A következő példahelyzetek a Megszakítás különböző felhasználásait, valamint a feldolgozással és a munkamenettel kapcsolatos történéseket mutatja be: v Az aktuális POLine sor sikertelenné tétele, az általa létrehozott vagy módosított rekord eltávolítása a munkamenetből, valamint csak az adott állomásoztatásitábla-sor sikertelenné tétele. A feldolgozás a POBody következő POLine sorával folytatódik. A belső Adatcsatlakozási feladat Megszakítás feladata a következő tulajdonságokat használja: 10. táblázat: A belső Megszakítás feladat beállításai Mező
Leírás
Folyamtípus
Folytatás
Feladat státusza
Sikeres
Megszakítás hatóköre
Aktuális hatókör
Ideiglenes adatok megszüntetése
Aktuális
Állomásoztatási sorok sikertelenné tétele
Bejelölve, amely az Aktuális értéket állítja be
v Az aktuális POBody iteráció törlése, az általa létrehozott vagy módosított rekord eltávolítása a munkamenetből, a POBody állomásoztatásitábla-sor sikertelenné tétele, a POLine sorok törlése, valamint a POLine állomásoztatásitábla-sorok sikertelenné tétele. A feldolgozás a következő POBody elemmel folytatódik. A belső Adatcsatlakozási feladat Megszakítás feladata a következő tulajdonságokat használja: 11. táblázat: A belső Megszakítás feladat beállításai
18
Mező
Leírás
Folyamtípus
Folytatás
© Copyright IBM Corp. 2011, 2015
11. táblázat: A belső Megszakítás feladat beállításai (Folytatás) Mező
Leírás
Feladat státusza
Sikeres
Megszakítás hatóköre
Kiválasztott blokk, folyamat bejövő POBody eleme
Ideiglenes adatok megszüntetése
Minden
Állomásoztatási sorok sikertelenné tétele
Bejelölve, amely a Minden értéket állítja be
v Semmi (nincs Megszakítás feladat a belső Adatcsatlakozási feladatban). Ha a belső (POLine) Adatcsatlakozási feladat vége után szerepel az Állandó rekord mentése feladat, azzal biztosítható, hogy a platform elvégezze a POBody elemhez tartozó POBody és POLine elemek mentését.
Az Adatcsatlakozási ügynök Az Adatcsatlakozási ügynök az Adatcsatlakozási feladatvezérlő táblában található bejegyzéseket ellenőrzi, valamint futtatja közülük az Kész állapotú bejegyzéseket. A TRIRIGAWEB.properties fájlban az Adatcsatlakozási ügynököt futtató alkalmazáskiszolgáló DATACONNECT_SLEEP_TIME tulajdonsága vezérli, hogy az ügynök milyen gyakran ellenőrzi az Adatcsatlakozási feladatvezérlő táblát. Amikor Kész állapotban lévő feladatot talál az Adatcsatlakozási feladatvezérlő táblában (DC_JOB), akkor az Adatcsatlakozási ügynök a következő lépéseket hajtja végre: v Létrehoz egy rekordot az Adatcsatlakozási feladat bejegyzésében jelzett rekord számára. Ez a rekord a triDataConnectJob modulban létrehozott feladatvezérlő üzleti objektum példánya. v Feltölti a rekordot a feladatbejegyzéssel kapcsolatos információkkal, így többek között a feladatszám, feladattípus, forrásrendszer-azonosító, feldolgozásirendszer-azonosító, létrehozási dátum, frissítési dátum, felhasználó és állapot értékével. v Feldolgozás alatti értékre állítja az Adatcsatlakozási feladatvezérlő tábla bejegyzésének állapotát. v A rekorddal együtt elküldi a SYSTEM DC PROCESS JOB munkafolyamat-eseményt, amely aktiválja a munkafolyamatot. v Ha az Adatcsatlakozási feladatvezérlő tábla bejegyzésével vagy a feladatvezérlő üzleti objektum létrehozásával kapcsolatban problémák merülnek fel, akkor a DC_JOB táblabejegyzés állapota Sikertelen értékre kerül beállításra. A sikertelenség okát a rendszer a server.log fájlban naplózza. A probléma kijavítása után megpróbálhatja ismét futtatni a feladatot az Adminisztrátori konzolról. v Az Ügynökkezelő eszközzel kapcsolatban további információkért forduljon az IBM TRIRIGA Application Platform 3 - Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz. Ha a TRIRIGAWEB.properties fájllal kapcsolatban van további információkra szüksége, akkor tekintse meg az IBM TRIRIGA Application Platform 3 - Telepítési és megvalósítási kézikönyv című kiadványt.
Munkafolyamat-feldolgozás Amikor egy SYSTEM DC PROCESS JOB eseménnyel és feladatvezérlő üzleti objektummal rendelkező munkafolyamat kerül aktiválásra, akkor a munkafolyamatban található Adatcsatlakozási feladat elvégzi bizonyos lépések futtatását. Ez a folyamat azt feltételezi, hogy a munkafolyamat bekapcsolt (true értékű) Integration tulajdonsággal került meghatározásra. 1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
19
Az Adatcsatlakozási feladat a következő lépéseket futtatja: v A beállított információk segítségével megállapítja a feldolgozandó rekord típusát, az új rekord megőrzendő állapotát, a korreláció típusát és a tranzakciós beállítást. A használandó feladatszám forrásaként az indítási feladathoz tartozó rekord kerül felhasználásra. v Az Adatcsatlakozási feladatban a feldolgozandó rekordhoz tartozó állomásoztatási tábla nevének lekérése, valamint a megfelelő feladatszámmal rendelkező sorok lekérdezése. A korrelációs számhoz tartozó konfigurációs beállítástól függően a korrelációs szám használata rendezési szempontként, vagy WHERE részkifejezésben bejegyzések keresése a korrelációs számmal. Az állomásoztatási tábla bejegyzéseinek lekérése a feladatszám, korrelációs szám, sorszám, művelet és útvonal alapján. v Minden egyes lehívott sor esetén az intelligens rekord létrehozása vagy frissítése. A rekord olyan állapotba helyezése, amelyet az Adatcsatlakozási feladat meghatározása ír elő (nem kerül sor az adott állapotba való átmenetre). Az állomásoztatási táblában lévő sor állapotának módosítása. A projekt és űrlap beállítása. Az Ideiglenes adatok használata jelzőparamétertől függően a módosítások állandóak lehetnek, vagy munkamenet keretében kerülhet rájuk sor. Az iterátorban megadott lépések futtatása, szülő-utód viszonyok létrehozása és az üzletifunkció-feldolgozás követése. v A létrehozás előtti munkafolyamat futtatása az új rekordokon. Ha nem szeretné futtatni a létrehozás előtti munkafolyamatot, akkor az Integráció jelzőparaméter bejelölésével frissítse a létrehozás előtti munkafolyamatot, így amikor egy integrációs munkafolyamat meghívja azt, akkor a művelet kihagyásra kerül. v Ha más munkafolyamatra vonatkozó hívás érkezik, akkor az integrációs státusz beállításának ellenőrzése a feldolgozás módosításához az alapján, hogy a munkafolyamat egy integrációs folyamatból került-e meghívásra. v Ha esemény érkezik, a FROM_INTEGRATION oszlop ellenőrzése annak megállapításához, hogy az integrációs státusz be van-e állítva a munkafolyamat kontextusában. v A tranzakció feldolgozása az Adatcsatlakozási feladat konfigurációs beállítása alapján.
A Tisztítási ügynök A Tisztítási ügynök az Adatcsatlakozási feladatok automatikus tisztítását dolgozza fel. Az Adminisztrátori konzol Ügynökkezelő eszköze segítségével határozhatja meg a Tisztítási ügynököt futtató feldolgozó nevét. A TRIRIGAWEB.properties fájlban állítsa be a DC_HISTORY_RETENTION_DAYS tulajdonságot. Amikor a Adatcsatlakozási feladatvezérlő tábla egyik Adatcsatlakozási bejegyzése már a DC_HISTORY_RETENTION_DAYS tulajdonságban megadott számú napja Elavult vagy Befejezett állapotban van, akkor a rendszer aktiválja a Tisztítási ügynököt. Ezután a Tisztítási ügynök az alábbi lépéseket hajtja végre: v Megkeresi a bejegyzés feladatvezérlési számát, majd törli az állomásoztatási táblák adott feladatvezérlési számhoz tartozó bejegyzéseit. v Törli az Adatcsatlakozási feladatvezérlő tábla (DC_JOB) bejegyzését. A Tisztítási ügynök nem törli a feladatvezérlő üzleti objektum bejegyzéseit (a triDataConnectJob üzleti objektumát). A már szükségtelen triDataConnectJob bejegyzések kezelésével kapcsolatban kövesse vállalata üzleti szabályait. A bejegyzéseket közvetlenül vagy egy létrehozott menü segítségével törölheti a rendszerből. Az Ügynökkezelő eszközzel kapcsolatban további információkért forduljon az IBM TRIRIGA Application Platform 3 - Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz. Ha a TRIRIGAWEB.properties fájllal kapcsolatban van további információkra szüksége, akkor tekintse meg az IBM TRIRIGA Application Platform 3 - Telepítési és megvalósítási kézikönyv című kiadványt.
20
© Copyright IBM Corp. 2011, 2015
Az Adatcsatlakozás általános problémái Az általános IBM TRIRIGA adatcsatlakozási problémák közé tartoznak a hiányzó állomásoztatási táblák vagy táblamezők, az érvénytelen táblaoszlopok, valamint az esetleg ismételt közzétételt igénylő megváltozott üzleti objektumok. 12. táblázat: Az Adatcsatlakozás általános problémái Hibaüzenet
Előfordulási hely
Az üzleti objektum: XX nem rendelkezik állomásoztatási táblával.
Az XX üzleti objektum esetében A munkafolyamat futtatásakor az hiányzik az állomásoztatási tábla. A Adatcsatlakozási feladat feladat sikertelen a munkafolyamatban. futási környezetében WFRuntimeException kivétel kerül naplózásra a server.log fájlban.
[XX = üzleti objektum neve]
Hiba történik az állomásoztatási rekordok feldolgozása közben: XX.
A munkafolyamat futtatásakor az Adatcsatlakozási feladat futási környezetében.
Az Adatcsatlakozási feladat végrehajtása során valamilyen helytelen esemény történt. Az egyik lehetséges probléma, hogy a DC_PATH frissítése nem határozott meg pontosan egy frissítendő intelligens objektumot.
Felhasználói felület
A feldolgozó Adatcsatlakozási feladatnak be kell fejeződnie ahhoz, hogy törölni lehessen az üzleti objektumot. Törölje azt, miután a feldolgozó feladat befejeződött.
[XX = állomásoztatási tábla rekordmezői] Az üzleti objektum nem törölhető, mivel függőben lévő Adatcsatlakozási feladatok találhatók.
Javítás módja
Felhasználói felület Az üzleti objektum jelenleg nem tehető közzé. WAITING (várakozás) vagy PROCESSING (feldolgozás alatt) állapotú Adatcsatlakozási feladatok találhatók a rendszerben. A közzététel végrehajtásához ezeknek először be kell fejeződniük.
A Feldolgozás alatt vagy Várakozás állapotú Adatcsatlakozási feladatnak véget kell érnie ahhoz, hogy az objektum közzététele sikeres legyen. Mindkettőnek beavatkozás nélkül kell véget érnie. Végezze el az ismételt közzétételt, ha már nincsenek függőben lévő feladatok.
Adatcsatlakozási ügynök - A triDataConnectJob üzleti objektum nem található. Győződjön meg róla, hogy az importálást az Adatcsatlakozási ügynök használata előtt végrehajtotta.
Az Adatcsatlakozási ügynökben PlatformRuntime Exception kivétel történik és kerül rögzítésre a server.log fájlban.
Az Adatcsatlakozás futtatása vagy használata előtt alkalmazza a legújabb triDataConnectJob objektumátállítási csomagot.
Adatcsatlakozási ügynök - A triDataConnectJob üzleti objektum változata nem megfelelő. Győződjön meg róla, hogy az importálást az Adatcsatlakozási ügynök használata előtt végrehajtotta.
Az Adatcsatlakozási ügynökben PlatformRuntime Exception kivétel történik és kerül rögzítésre a server.log fájlban.
Az Adatcsatlakozás futtatása vagy használata előtt alkalmazza a legújabb triDataConnectJob objektumátállítási csomagot.
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
21
12. táblázat: Az Adatcsatlakozás általános problémái (Folytatás) Hibaüzenet
Előfordulási hely
Javítás módja
DataConnectTaskHandler A(z) XX állomásoztatási tábla nem tartalmazza a(z) YY állomásoztatási mezőt.
A munkafolyamat végrehajtásakor az Adatcsatlakozási feladat futási környezetében figyelmeztető bejegyzés kerül naplózásra a server.log fájlban.
Az állomásoztatási táblából várt mezők hiányoznak. Ez az eredmény akkor állhat elő, ha az állomásoztatási tábla nincs összhangban az üzleti objektummal. Az Adatcsatlakozási feladat befejezésekor tegye ismét közzé az üzleti objektumot.
A munkafolyamat végrehajtásakor az Adatcsatlakozási feladat futási környezetében figyelmeztető bejegyzés kerül naplózásra a server.log fájlban.
A futási környezet nem találja a DC_PATH állomásoztatásitáblamezőben azonosított szülőt. A rendszer létrehozza az intelligens objektumot, csak annak szülője nem kerül beállításra.
A munkafolyamat végrehajtásakor az Adatcsatlakozási feladat futási környezetében WFRuntimeException kivétel kerül naplózásra a server.log fájlban.
Ellenőrizze a feladat üzleti objektumához tartozó állapotátmeneteket, hogy meggyőződjön róla, hogy az állapotátmenetek megadásra kerültek az alapvető triDataConnectJob üzleti objektumban.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
A DC_JOB tábla BO_NAME oszlopa az YY feladat esetén érvénytelen üzleti objektum. Ellenőrizze, hogy a név megfelelő és szerepel a triDataConnectJob modulban. Javítsa ki a bejegyzést és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
A(z) YY feladat JOB_RUN_CTL oszlopa érvénytelen a DC_JOB táblában. Csak a 0 (egyszálú) vagy az 1 (többszálú) számít érvényes bejegyzésnek. Javítsa ki a bejegyzést és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
A(z) YY feladat JOB_TYPE oszlopa érvénytelen a DC_JOB táblában. Csak az 1 (bejövő) érték érvényes. Javítsa ki a bejegyzést és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
[XX = állomásoztatási tábla neve] [YY = mező neve] DataConnectTaskHandler: A szülő intelligens objektum nem található, amelynek objektumútvonala: XX. [XX = DC_PATH az állomásoztatási táblából] DataConnectTaskHandler: Állapotátmenet-művelet kerül a(z) XX érvénytelen állapottal a(z) YY intelligens objektumon végrehajtásra. [XX = állapot] [YY = intelligens objektum azonosítója] A(z) YY feladat XX üzleti objektuma érvénytelen. A DC_JOB táblában [XX = BO_NAME] [YY = JOB_NUMBER] A(z) XX JOB_RUN_CTL érték a(z) YY feladat esetében érvénytelen. A DC_JOB táblában [XX = JOB_RUN_CTL] [YY = JOB_NUMBER] A(z) XX JOB_TYPE érték a(z) YY feladat esetében érvénytelen. A DC_JOB táblában [XX = JOB_TYPE] [YY = JOB_NUMBER]
22
© Copyright IBM Corp. 2011, 2015
12. táblázat: Az Adatcsatlakozás általános problémái (Folytatás) Hibaüzenet
Előfordulási hely
Javítás módja
A(z) BB felhasználói azonosító nem társítható a(z) XX üzleti objektum segítségével a(z) YY feladathoz.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
Az ügynök nem tudta a USER_ID oszlop segítségével a felhasználóhoz társítani az újonnan létrehozott Adatcsatlakozási feladatot. Győződjön meg róla, hogy a USER_ID érvényes T_MYPROFILE spec_id azonosító. Javítsa ki a bejegyzést és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
Az ügynök nem tudta létrehozni az Adatcsatlakozási feladat intelligens objektumát. Ellenőrizze, hogy a név megfelelő és szerepel a triDataConnectJob modulban. Javítsa ki a bejegyzést és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
Az ügynök nem tudta leképezni a szükséges mezőket az újonnan létrehozott Adatcsatlakozási feladatra. Ellenőrizze, hogy a(z) XX üzleti objektum az összes mezőt meghatározta az alapvető triDataConnectJob üzleti objektumban. Javítsa ki a bejegyzést vagy az üzleti objektumot - az üzleti objektum megváltozása esetén valószínűleg ismét közzé kell tennie azt, majd állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
Az ügynök nem tudta elküldeni az újonnan létrehozott Adatcsatlakozási feladat munkafolyamat-eseményét. Ennek oka lehet, hogy nem tartozik közzétett munkafolyamat a SYSTEM DC PROCESS JOB eseményhez és a(z) XX üzleti objektumhoz. Ellenőrizze, hogy a munkafolyamat közzétételre került az esemény és a(z) XX üzleti objektum esetében. Javítsa ki a bejegyzést vagy a munkafolyamatot, és állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
A Közzétételi ügynökben PlatformRuntime Exception kivétel történik és kerül rögzítésre a server.log fájlban.
The Feldolgozás alatt vagy Várakozás állapotú Adatcsatlakozási feladatnak véget kell érnie ahhoz, hogy az objektum közzététele sikeres legyen. Mindkettőnek beavatkozás nélkül kell véget érnie. Végezze el az ismételt közzétételt, ha már nincsenek függőben lévő feladatok.
A DC_JOB táblában [BB = USER_ID] [XX = BO_NAME] [YY = JOB_NUMBER] A(z) XX üzleti objektum segítségével nem hozható létre a(z) YY feladathoz tartozó üzleti objektum. A DC_JOB táblában [XX = BO_NAME] [YY = JOB_NUMBER] A(z) YY feladat esetében a(z) XX üzleti objektum felhasználásával nem lehet leképezni a mezőket az Adatcsatlakozási feladat megfelelő működéséhez. A DC_JOB táblában [XX = BO_NAME] [YY = JOB_NUMBER] A(z) XX üzleti objektum segítségével a SYSTEM DC PROCESS JOB munkafolyamat-esemény nem küldhető el a(z) YY feladat esetében. A DC_JOB táblában [XX = BO_NAME] [YY = JOB_NUMBER]
Nem lehet közzétételt végezni, mivel jelenleg az üzleti objektumon feldolgozást végző vagy arra várakozó meglévő Adatcsatlakozási feladatok találhatók a rendszerben.
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
23
12. táblázat: Az Adatcsatlakozás általános problémái (Folytatás) Hibaüzenet
Előfordulási hely
Javítás módja
A(z) XX üzleti objektum segítségével nem végezhető átmenet a triDCStartProcessing állapotba a(z) YY feladat esetében.
Az Adatcsatlakozási ügynökben információs bejegyzés kerül rögzítésre a server.log fájlban.
Ellenőrizze a(z) XX üzleti objektum állapotátmeneteit, hogy meggyőződjön arról: a(z) XX meghatározta az állapotátmeneteket a triDataConnectJob modul alapvető triDataConnectJob üzleti objektumában. Javítsa ki a bejegyzést vagy az üzleti objektumot az üzleti objektum megváltozása esetén valószínűleg ismét közzé kell tennie azt, majd állítsa vissza a STATE tulajdonságot READY (vagy 1) értékre.
A DC_JOB táblában [XX = BO_NAME] [YY = JOB_NUMBER]
Tippek az Adatcsatlakozási eszköz üzemeltetéséhez A következő tippek segítségével kiterjesztheti az IBM TRIRIGA adatcsatlakozási eszköz vállalata általi üzemeltetésének módját. 13. táblázat: Tippek az Adatcsatlakozási eszköz üzemeltetéséhez Tipp
Leírás
Jóváhagyási feladat
A Jóváhagyási feladatot nem lehet Adatcsatlakozási feladatból futtatni.
Az Adatcsatlakozási feladat Feldolgozás alatt állapotban marad; a munkafolyamat valószínűleg nem tartalmaz Aktiváló műveletet a feladat Sikertelen vagy Befejezett állapotba való áthelyezéséhez.
Ha az Adatcsatlakozási feladat Feldolgozás alatt státuszban marad, akkor ellenőrizze a feladat munkafolyamat-példányát. Lehetséges, hogy a munkafolyamat befejeződött, de nem létezik munkafolyamat-feladat a feladat Befejezett vagy Sikertelen állapotba való átviteléhez.
A beillesztésre vonatkozó hierarchia beállítására az állomásoztatási tábla DC_PATH oszlopa vehető igénybe. A frissítés során a DC_PATH oszlopnak a frissítendő rekordnak kell lennie.
Az állomásoztatási táblában szereplő DC_PATH oszlopot kell használni a frissítés során. A DC_PATH értékét a frissíteni kívánt rekordra kell beállítani. A frissítendő rekord IBS_SPEC.OBJECT_PATH értékének kell lennie.
Végrehajtási ütemezés
Az adatbázis-kapcsolatokra és az alkalmazáskiszolgálón elérhető szálakra gyakorolt hatás elkerülése érdekében csúcsidőszakon kívüli időpontra ütemezze az Adatcsatlakozási feladatok futtatását.
Az Adatcsatlakozási ügynök által talált problémák a server.log fájlban kerülnek naplózásra.
Az Adatcsatlakozási táblában (DC_JOB) szereplő bejegyzésekkel kapcsolatos általános problémák többségét az Adatcsatlakozási ügynök kezeli. A probléma a server.log fájlban kerül naplózásra, a rendszer pedig Sikertelen értékre állítja az Adatcsatlakozási feladat bejegyzését. További információk is lekérdezhetők, ha az Adatcsatlakozási ügynökben bekapcsolja a hibakeresési naplózást.
A beszúrás művelettel használt DC_PATH érték jelezheti az Adatcsatlakozási feladatnak, hogy hol kell a hierarchiában elhelyezni a rekordot. Az utódoknak a szülő elérési útvonalát kell tartalmazniuk a DC_PATH oszlopban. Az Adatcsatlakozási feladat ezzel az útvonallal állítja be a hierarchiát. A hierarchia tetején lévő vagy nem hierarchiában lévő objektumok nem tartalmazhatnak értéket a DC_PATH oszlopban.
A probléma megoldása után ismét meg lehet próbálni a feladat végrehajtását az Adminisztrátori konzolon elérhető Újrapróbálkozás a feladat végrehajtásával hivatkozással.
24
© Copyright IBM Corp. 2011, 2015
13. táblázat: Tippek az Adatcsatlakozási eszköz üzemeltetéséhez (Folytatás) Tipp
Leírás
Feladatvezérlő üzleti objektum
Az Adatcsatlakozási feladatot tartalmazó munkafolyamathoz tartozó üzleti objektumnak a triDataConnectJob altípusának kell lennie, vagyis azt a triDataConnectJob modulban kell létrehozni. Ha nem így történik, akkor a rendszer hibát állít elő.
Számmező mértékegysége
Ha egy számmezőhöz tartozó Állomásoztatásitábla-mező tulajdonságot egy üzleti objektumban meghatározott kapcsolódó mértékegységmezővel állítja be, akkor a kapcsolódó Mértékegység mező Állomásoztatásitábla-mező tulajdonságát is kötelező beállítania.
Az állomásoztatásitáblamezők az Általános szakaszból származnak
Csak az Általános szakaszban lévő mezők támogatottak állomásoztatásitábla-mezőként. Ha más szakaszokból kíván adatokat lekérni, akkor használjon ideiglenes mezőket az üzleti objektumban, majd a munkafolyamat-alrendszer segítségével helyezze át az adatokat a megfelelő nem általános mezőkbe. Ellenkező esetben egy üzleti segédobjektummal kérje le az összes adatot, majd a munkafolyamat-alrendszerrel helyezze át az adatokat a valós üzleti objektumba.
Az állomásoztatási tábla neve Az Adminisztrátori konzol Adatcsatlakozási felügyelt objektuma segítségével határozhatja meg az állomásoztatási tábla nevét. Kattintson az Állomásoztatási táblával rendelkező üzleti objektumok lehetőségre. Az adatbázismező neve ekkor megjelenik az egyéb információkkal együtt. Az Adatok kibontása hivatkozás további információkat biztosít a kijelölt sorokról, így például megadja az állomásoztatási táblában szereplő mezőneveket, valamint az állomásoztatási táblát használó feladatokat. Felfüggesztett munkafolyamat A munkafolyamat addig nem függeszthető fel, amíg egy Adatcsatlakozási feladat feldolgozását végzi. Az Adatcsatlakozási folyamat képes kezelni az intelligensszakasz-társítással rendelkező üzleti objektumokat.
Ha az üzleti objektum kötelezően integráción keresztül feltöltendő intelligens szakasszal rendelkezik, akkor állomásoztatásitáblamezőként vegyen fel egy kiegészítő mezőt az üzleti objektumba. Az állomásoztatási táblában szereplő mezőt a lekérdezhető azonosítóval töltse fel, amellyel megtalálhatja az új intelligens objektumhoz társítani kívánt rekordot. A munkafolyamatban használja a Lekérdezés lehetőséget a rekord lekérdezéséhez, a Társítás lehetőséget pedig a rekord új intelligens objektumhoz való társításához.
A kiinduló állapot az, amelyben az intelligens objektum létrehozásra kerül; ebből az állapotból nincs átmenet.
Ha az integráció állapotátmenetet kíván végrehajtani az intelligens objektumon, akkor állítsa a kiinduló állapotot Null értékűre az Adatcsatlakozási feladatban. Az Adatcsatlakozási feladat törzsében az Aktiváló művelet segítségével valósítsa meg az objektum kívánt állapotba való átmenetét.
1. fejezet Adatok integrálása a TRIRIGA DataConnect eszközzel
25
13. táblázat: Tippek az Adatcsatlakozási eszköz üzemeltetéséhez (Folytatás) Tipp
Leírás
Hibák nyomkövetése
Érdemes lehet létrehozni egy rekordot a munkafolyamatérvényesítések során felmerülő hibák nyomkövetése érdekében. Az egyik megközelítés egy egyéni cstDataMigrationError üzleti objektumot hoz létre a triIntermediate modulban. Ez az üzleti objektum a következő mezőket tartalmazhatja: v triCreatedSY: A rendszer általi létrehozás dátuma és időpontja. v triNameTX [hibatípus]: A hibát okozó átállítást tárolja. v triLinkedRecordTX: Helymeghatározó mező, amely a sikertelen érvényesítésű tényleges rekordhoz vezet. Ne feledje meghatározni a hiba üzleti objektuma és az érvényesítésben szereplő minden egyéb üzleti objektum közötti társítást. v triDescriptionTX [hibaüzenet]: Az adott hiba részleteit tartalmazza. v Ezután hozza létre az adatátállítási hibarekord űrlapját.
26
Felhasználói művelet feladat
A Felhasználói művelet feladatot nem lehet Adatcsatlakozási feladatból futtatni.
Munkafolyamat-kivételek
Az Adatcsatlakozási feladat meghiúsul, ha a munkafolyamat kivételbe ütközik a munkafolyamat feldolgozása során.
© Copyright IBM Corp. 2011, 2015
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel Lehetősége van arra, hogy a Data Integrator eszköz segítségével külső rendszerekből tabulátorral elválasztott adatokat importáljon az IBM TRIRIGA üzleti objektumokba. A Data Integrator eszközzel emellett a meglévő adatok tömeges frissítését is elvégezheti.
A TRIRIGA adatintegrátor-folyamat áttekintése Az IBM TRIRIGA rendszer Adatintegrátor eszköze technikai parancsfájlok összeállítása nélkül teszi lehetővé az adatok üzleti objektumokba való importálását. A rekordadatok bármely forrásból, például adatbázisokból, Microsoft Excel fájlokból és külső rendszerekből egyaránt származhatnak. Az adatforrástól függetlenül az Adatintegrátor eszköz csak tabulátorral elválasztott formátumú .txt fájlokat fogad el. Az Adatintegrátor eszköz képessé teszi a rekordcsoportok rögzítésére és IBM TRIRIGA rendszerbe való feltöltésére, anélkül, hogy az egyes rekordokat egyenként, saját kezűleg kellene megadnia. Az előzetesen meglévő adatbázis importálása időt takarít meg, valamint elkerüli a rekordok kézi beírásához kapcsolódó adatsértetlenségi és -minőségi problémák felmerülését. Az Adatintegrátor eszköz mindig az IBM TRIRIGA rendszer alapvető nyelvi tábláiba importálja az adatokat. A lefordított adatok honosított táblákba való importálása nem támogatott. Az Adatintegrátor eszköz képes társításokat létrehozni két rekord között. A szülőrekordnak léteznie kell a rendszerben ahhoz, hogy a társítás létrehozható legyen. A modulok IBM TRIRIGA rendszerben történő megtervezésének módja határozza meg az importálható és egymáshoz társítható adatok körét. Az Adatintegrátor eszköz segítségével a meglévő rekordok tömeges frissítése is végrehajtható. Az üzletiobjektum-értékek több meglévő rekordban történő frissítéséhez az Adatintegrátor segítségével tömegesen változtathatja meg a mezők értékét. Ez a módszer elkerüli a felhasználói felülettel való együttműködést az egyes rekordok egyenkénti frissítése érdekében. Minden Adatintegrátor-feltöltéssel a rendszer értesítést küld a feltöltést kezdeményező felhasználónak. Az értesítés tájékoztatja a felhasználót a sikeres feltöltésről, vagy arról, hogy hibák történtek. Az értesítés fogadásához a felhasználónak rendelkeznie kell Értesítések portálszakasszal saját Kezdőlap portálján. Az adatok megfelelő importálásának biztosításához rendelkezésre áll néhány rendszerirányelv. A tabulátorral tagolt értékeket tartalmazó (.txt) fájl vagy a fejlécfájl első sorának tartalmaznia kell azon üzleti objektum minden egyes mezőnevének oszlopát, amelybe importálja vagy ahol frissíti az adatokat. A fejlécfájl létrehozásának elősegítése érdekében az Adatintegrátor rendelkezik egy beépített eszközzel a Microsoft Excel alkalmazással kompatibilis fájlok készítéséhez, amelyekben a mezőnevek az első sorban helyezkednek el. Ez a fejlécfájl válik azzá a feltöltési sablonná, amelyben minden rekord bevitelre kerül.
© Szerzői jog IBM 2011, 2015
27
Mezőtípusok Az Adatintegrátor eszközzel bizonyos mezőtípusok használhatók, és azok is kizárólag a rekordadatok elfogadott mezőformázásával. Az irányelvek követésének elmulasztása a rekordok részlegesen sikeres vagy meghiúsult feltöltéséhez vezet. Ha egy mezőtípus nem rendelkezik példával a táblázatban, akkor az azt jelzi, hogy az Adatintegrátor eszköz nem támogatja a kérdéses mezőtípust. Ennek okáért forduljon a megjegyzésekhez. 14. táblázat: Rekordmezők típusai Mezőtípus
Utótag
Használat
Művelet gomb
AB
Képernyőn megjelenő kép, amely kattintható gombként kerül felhasználásra.
Logikai
BL
Olyan érték tárolására szolgál, amely TRUE (igaz) vagy FALSE (hamis) lehet.
Üzleti objektum
BO
Importálási formátum
Példa
Megjegyzések Nem az Adatintegrátor eszközzel való használatra szolgál. Csak az Űrlapkészítő eszközben kerül meghatározásra. Módosítás szükséges.
FALSE = nincs kiválasztva
triReservableBL = TRUE
TRUE = kiválasztva
Helyek, szervezetek vagy földrajzi elhelyezkedések rekordokhoz társítására szolgál.
BOTypeName (üzleti objektum típusa) FullPath (teljes elérési útvonal)
Nem az Adatintegrátor eszközzel való használatra szolgál. A munkafolyamat a rendszer által állítja elő.
RecordName (rekordnév) SysModified DateTime (frissítési idő)
28
Osztályozás
CL
Értékek meghatározott hierarchiájából kiválasztott érték tárolására szolgál.
Osztályozásösszesítés
CR
Az osztályozás általi összegek összesítésére szolgál.
© Copyright IBM Corp. 2011, 2015
Pontos helyesírás és kis-/ nagybetűs írásmód.
Az új osztályozási objektum hierarchikus feltöltést igényel.
Hierarchikus modul. A fejlécfájlnak a következőt kell tartalmaznia: Szülő = \Az utódosztályozáshoz tartozó osztályozások és teljes elérési útvonal. Az útvonalat ne zárja le osztásjellel (\). Nem az Adatintegrátor eszközzel való használatra szolgál. A rendszer munkafolyamat vagy az Összesítés művelet révén tölti fel.
14. táblázat: Rekordmezők típusai (Folytatás) Mezőtípus
Utótag
Használat
Szín
CO
Szín tárolására szolgál.
Ellenőrzőszám CN
Importálási formátum
Példa
Színérték pontos helyesírással és kis-/ nagybetűs írásmóddal.
Egyedi azonosítószámok előállítására és tárolására szolgál.
Megjegyzések A színértékeket a számjel (#) után a szín hexadecimális értékével adja meg. Például a fekete szín értéke: #000000. Az ellenőrzőszámokat a rendszer Közzététel vagy Létrehozás művelettel tölti fel az üzleti objektum Közzététel lapján megadott feltételek alapján. Nem kötelező, ha az Ellenőrzőszám mezőt a munkafolyamat automatikusan tölti fel, vagy alapértelmezés szerinti feltöltésre van beállítva.
AlapértelmezetttriStartDateDA = dátumformátum.01/01/2006
Dátum
DA
Dátum tárolására szolgál.
Dátum és időpont
DT
Hosszú egész triDateDT, amely Dátum és a következőt szám időpont ábrázolja: ezredmásodperben. kombinációjának 08/21/2006 tárolására 15:30:00 = szolgál. 1156199400000
Időtartam
DU
Időtartam hosszának tárolására szolgál. A következőként írható le: Évek száma Hónapok száma Hetek száma Napok száma Órák száma Percek száma Másodpercek száma.
A következő cstDurationDU, formátumban amely 5 napot, 6 fejezhető ki: órát és 30 percet ábrázol = 8.x 5d6h30m0s #w#d#h#m #s
A 8.x, 9.x és 10.x változat formátuma eltérő. Ügyeljen a rendszerének megfelelő formátum alkalmazására.
9.x – #y#M#w#d #h#m#s 10.x – #y#M#w#d #h#m#s
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
29
14. táblázat: Rekordmezők típusai (Folytatás) Mezőtípus
Utótag
Használat
Pénzügyi összesítés
FR
A pénzügyi tranzakciókban érintett egyéb mezőkből származó végösszegek tárolására szolgál.
Kép
IM
Kép tárolására szolgál.
Importálási formátum
Példa
Megjegyzések Nem az Adatintegrátor eszközzel való használatra szolgál. A rendszer munkafolyamat vagy az Összesítés művelet révén tölti fel.
triImageIM = //Company-1 /fileMyImage Name.jpg
A feltöltés elindítása előtt minden képnek léteznie kell a [telepítési_gyökérmappa]/userfiles/images mappában. A képfájlnevekig vezető elérési útvonalaknak pontosan kell egyezniük. Minden képfájl nevét a "file" kulcsszóval kell kezdeni a megfelelő megjelenítés érdekében.
30
Csak címke
LA
Megfelelő mezővel nem rendelkező címke megadására szolgál.
Lista
LI
Egy érték kiválasztására szolgál az értékek listájáról.
Megjegyzés
NO
Tetszőleges hosszúságú formázott szöveg tárolására szolgál.
Szám
NU
Számok tárolására szolgál.
© Copyright IBM Corp. 2011, 2015
Nem importálásra szolgál. Csak az Űrlapkészítő eszközben kerül meghatározásra. Módosítás szükséges. Pontos helyesírás és kis-/ nagybetűs írásmód.
triMonthLI = December
Az Adatintegrátor eszköz nem támogatja a megjegyzésmezőket.
triGross Egyszerű MeasuredNU = szám, 12000.5 szükség szerint a tizedesjegyek számának beállításával.
Nincs szükség vesszőre, $ jelre vagy más formázásra, kivéve, ha vannak tizedesjegyek.
14. táblázat: Rekordmezők típusai (Folytatás) Importálási formátum
Mezőtípus
Utótag
Használat
Jelszó
PA
A felhasználói felületen módosítható, de meg nem jelenített szöveges érték tárolására szolgál.
Alfanumerikus szöveg.
Csak rendszer SY által olvasható
A rekordokkal és az azokat létrehozó üzleti objektumokkal kapcsolatos információk elérésére szolgál.
Az IBM TRIRIGA rendszer munkafolyamatai töltik fel. Nem szükséges importálni.
Szöveg
TX
Szöveges értékek tárolására szolgál.
Egyszerű szöveg.
Időpont
TI
Időpont tárolására szolgál.
Hosszú egész triStartTimeTI, amely a számként következőt kerül feltöltésre ábrázolja: 9:30:35 ezredmásodperben. PM = 77435000
Mértékegység UO
Mértékegység mezőhöz vagy üzleti objektumhoz való társítására szolgál.
Pontos helyesírás és kis-/ nagybetűs írásmód.
URL
URL cím tárolására szolgál.
Teljes könyvtárelérési útvonal, a http, ftp vagy \\ karakterekkel együtt.
UR
Példa
Megjegyzések Titkosított.
Az egyetlen korlátozás az üzleti objektum mezőjére vonatkozó karakterkorlát. Ha 30 karaktert töltenek fel egy 20 karakteres mezőbe, akkor 10 karakter levágásra kerül.
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
31
14. táblázat: Rekordmezők típusai (Folytatás) Mezőtípus
Utótag
Használat
Importálási formátum
Rendszerlap::Rekordinformációk szakasz
Példa
Megjegyzések Általában munkafolyamatok töltik fel ezeket a mezőket. Az adatok ezen mezőkbe való feltöltése magában hordozza a munkafolyamat-ciklus létrehozásának kockázatát, épp ezért ezek számos területen csak olvashatók. Ezekre példa a következő néhány mező: LocationName (grafika helye) OrgName (szervezet neve) GeographyName (földrajzi elhelyezkedés neve)
Helymeghatározó mező
Teljes elérési Másik útvonalat üzletiobjektum-rekordra vagy mutató mezőhivatkozás.mezőben megjelenített értéket igényel a hierarchikus rekordok esetén.
Előfordulhat, hogy társítási feltöltést igényel, ha a megjelenített név nem egyedi a helymeghatározó mező által használt lekérdezés eredményhalmazában.
Közzétételi nevek Az Adatmodellező Üzletiobjektum-leképezés eszközében a Leképezési tulajdonságok jelzik, hogy mely mezők tartalmazzák az üzleti objektumból létrehozott rekord közzétételi nevét. A közzétételi névben szereplő mezőértékek kombinációjának első 100 karaktere egyedi módon azonosítja a rekordot az ugyanazon üzleti objektumból létrehozott összes rekord körében. Az Adatintegrátor eszközzel feldolgozandó, tabulátorral tagolt értékeket tartalmazó fájloknak tartalmazniuk kell a közzétételinév-mezők egyedi értékét biztosító mezőket. Ha a közzétételi név mezőértékei egy meglévő rekordhoz kerülnek megadásra, akkor az Adatintegrátor eszköz a feltöltött fájlban megadott további mezőértékekkel frissíti a meglévő rekordot. Ha a tabulátorral tagolt értékeket tartalmazó feltöltött fájl nem ad meg egyedi közzétételi neveket, akkor előfordulhat, hogy az Adatintegrátor eszköznek nem sikerül rekordot létrehoznia. Ellenkező esetben pedig létrehoz egy rekordot, amikor éppen frissítenie kellene azt, vagy a helytelen rekord frissítését hajtja végre. Megtörténhet az is, hogy a tabulátorral tagolt értékeket tartalmazó fájlból származó első 100 karakter megegyezik egy rekord nevével, de a 100. karakter után a rekordnév nem egyezik. Ebben az esetben a rendszer visszautasítja a rekordot, és nem kerül sor frissítésre vagy létrehozásra.
32
© Copyright IBM Corp. 2011, 2015
Számmezők A többrekordos intelligens szakaszokban szereplő összegekhez kötődő mezők meghatározzák, hogy az intelligensszakasz-mezőlistán szereplő mezők értékét összesíteni kell. A mezők az üzleti objektum Általános szakaszában kerülnek létrehozásra, amelyet a rendszer automatikusan feltölt a mezőlistáról kiválasztott összegekkel. Az IBM TRIRIGA rendszer ezeket a mezőket használja fel egyes üzleti objektumok összegzési szakaszaiban és jelentéseiben. Ezek numerikus mezők. A számmezők mértékegységértékét a rendszer az üzleti objektumok szintjén felügyeli. Az adott üzleti objektum esetében az Adatmodellező eszközben meghatározott alapértelmezett értéket kapja eredményül.
Ellenőrzőszám-mezők Az Adatintegrátor eszköz nem képes kezelni az olyan közzétételi névvel rendelkező üzleti objektumok rekordfrissítéseit, amelyek ellenőrzőszám-szám mezőt és bejelölt Előállítás létrehozáshoz jelölőnégyzetet tartalmaznak. Ebben a példahelyzetben az Adatintegrátor eszköz nem képes megállapítani, hogy a feltöltési fájlból származó adott rekord létezik-e, amelynek hatására új rekordok jönnek létre a fájl minden feltöltésekor.
Követelmények Az Adatintegrátor eszköz az Adminisztrátori konzol Ügynökkezelő eszközében elérhető Adatimportálási ügynök elindítását igényli. Megköveteli továbbá azt is, hogy a feltölteni kívánt fájlnak tartalmaznia kell az importált üzleti objektumnak megfelelő Közzétételi név mezőket. Ha azonban a feltöltési fájl nem tartalmazza az adott üzleti objektum esetében kötelező mezőket is, akkor a bejelentkező és a rekordot az IBM TRIRIGA rendszerben megnyitó felhasználó kötelező mezőre figyelmeztető hibaüzenetet kap. A zökkenőmentes felhasználói élmény biztosítása érdekében az importált új rekordoknak is tartalmazniuk kell a kötelező mezők értékét. A fentiekből adódóan az Adatintegrátor eszköznek kétféle típusú, funkcionális és használhatósági követelményei vannak. Ha a követelmények bármelyike esetében nem teljesíti azokat, akkor nem kívánatos következményekkel szembesülhet. Amennyiben a funkcionális követelmények nem teljesülnek, úgy az Adatintegrátor eszköznek nem sikerül elvégeznie a feltöltést. Ha a használhatósági követelmények teljesülése nem biztosított, akkor pedig az adatfeltöltés sikeres lesz ugyan, de a felhasználói élménnyel kapcsolatban problémák merülnek fel. Mindig jó gyakorlatnak számít az Adatintegrátor eszközhöz kapcsolódó valamennyi fájl tesztelése az éles rendszeradatok másolatán, mielőtt sor kerülne a tényleges feltöltés vagy frissítés végrehajtására.
Funkcionális követelmények Az Adatintegrátor eszköz számos olyan funkcionális követelménnyel rendelkezik, amely hatással van a közzétételi nevekre, a tabulátorral tagolt értékeket tartalmazó fájlformátumokra és szülőútvonalakra. Ha teljesülnek ezek a követelmények, akkor a fejlécfájl kompatibilis formátumú.
Közzétételi nevek Minden üzleti objektumot közzé kell tenni ahhoz, hogy a felhasználók el tudják érni azokat. A Közzététel menüpont az Adatmodellező alkalmazás Eszközök lapján található. Fontos minden olyan mezőt befoglalni az adatfeltöltésbe, amely egy üzleti objektum közzétételi 2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
33
nevét határozza meg. Jellemzően név- vagy azonosítómezők kerülnek közzétételi névként felhasználásra, azonban más mezők is igénybe vehetők erre a célra. Ha például a triPeople üzleti objektum közzétételi neve a vezetéknévből, keresztnévből és azonosítóból áll, akkor a közzétételi név a következő lesz: "Kovács, János - 10025884". Az üzleti objektumhoz tartozó közzétételi név meghatározását úgy tekintheti meg, ha megnyitja az üzleti objektumot az Adatmodellező eszközben, majd megjeleníti az üzletiobjektum-leképezés tulajdonságait az Eszközök menüben. Az ellenőrzőszám-mezőket tartalmazó közzétételi nevek esetén a közzétételi nevet át kell definiálni egy olyan egyedi értékre, amely nem használ ellenőrzőszámot. Miután a feltöltés befejeződött, a közzétételi nevet visszaállíthatja az ellenőrzőszám-mező használatára. Figyelem: A közzétételi név nem tartalmazhat ellenőrzőszám-mezőt, ha meglévő rekordok kerülnek az IBM TRIRIGA rendszerben frissítésre. Helyette ez a helyzet új rekord létrehozásához vezet.
Tabulátorral tagolt értékeket tartalmazó fájlformátum Ha minden közzétételinév-mező szerepel és megfelelő helyesírású a fejlécfájlban, akkor az egyetlen egyéb funkcionális követelmény szerint a fájlt tabulátorral tagolt értékeket tartalmazó fájlként kell a kimeneten előállítani. A fájlkiterjesztés kötelezően .txt, de a fájlnév tetszőleges értékű lehet.
Szülőútvonalak Ha hierarchikus rekordadatokat kíván hierarchikus modulokba és üzleti objektumokba feltölteni, akkor a Szülő oszlopnak tartalmaznia kell a feltöltött rekord szülőjének teljes elérési útvonalát. A megfelelő szülőútvonal meghatározásának elmulasztása árva rekordokhoz vezet, amelyek nem jelennek meg a hierarchia ablakában.
Használhatósági követelmények Bár úgy tűnhet, hogy a fájlok feltöltése sikeresen végrehajtásra került, a feltöltés csak az első követelménynek számít. Amikor a felhasználó megnyit egy rekordot, előfordulhat, hogy egy kötelező mező nem kerül feltöltésre, ami hibaüzenetet állít elő. A kötelező mezők, számítások és összesítések olyan példák, ahol a használhatóság problémát jelenthet.
Kötelező mezők Amellett, hogy az Adatintegrátor eszköz megfelelő helyesírású és kis-/nagybetűs írásmódú Közzétételi neveket igényel az adatok feltöltéséhez, egyéb követelményekkel is számolni kell. Új rekordok esetén az Adatintegrátor eszközhöz tartozó fejlécfájlnak tartalmaznia kell az összes kötelező mezőt. Ezenkívül az Adatintegrátor-fájl fejlécsorában felsorolt valamennyi mező megkülönbözteti a kis- és nagybetűket, valamint megfelelő helyesírást is igényel. Ha kötelező mezők hiányoznak a fejlécfájlból, akkor előfordulhat, hogy a rekordot mégis sikeresen fel lehet tölteni. A bejelentkező és a rekordot megnyitó felhasználó azonban hibaüzenetet kap a hiányzó mezőről. Ezután a felhasználónak fel kell töltenie az összes kötelező mezőt ahhoz, hogy a rekordon sikeresen lehessen elvégezni az állapotátmenet-műveleteket. Ha emellett az adatfeltöltési folyamat csak olvasható állapotba helyezi a rekordot, akkor a kötelező mezők értékének megadása érdekében a felhasználó nem tudja szerkeszthető állapotúra módosítani azt. Úgy kerülheti el ezt a példahelyzetet, ha minden kötelező mezőt befoglal a feltölteni kívánt fejlécfájlba. Az Űrlapkészítő eszköz megnyitásával azonosíthatja és veheti fel a kötelező mezőket a fejlécfájlba.
34
© Copyright IBM Corp. 2011, 2015
Számítások A csak olvasható képletmezőket feltöltő számítások futtatása érdekében egy egyéni munkafolyamatot kell aktiválnia. Ne töltse fel közvetlenül a csak olvasható mezőket. Helyette a feltöltés után a munkafolyamat-funkció aktiválásával futtassa a számításokat.
Összesítések Egyéni munkafolyamatot kell aktiválnia, ha több üzleti objektum körében kell összesítenie információkat. Ügyeljen rá, hogy olyan munkafolyamatot állítson össze, amely a hierarchia valamennyi objektuma körében a legalacsonyabb utódtól kezdve a legmagasabb szülőig halad végig.
Egyéni munkafolyamatok A rekordokkal kapcsolatban minden feltöltési funkciót egyéni munkafolyamatok határoznak meg. Készítse el őket eseti jelleggel, majd aktiválja a munkafolyamatokat a feltöltésen. Például a munkafolyamat nullértékű állapotot meghagyó állapotátmenet-művelettel, vagy egy társítási eseményre vonatkozó aszinkron munkafolyamattal aktiválható. Figyelem: Bizonyos - például összesítésekhez vagy számításokhoz társított munkafolyamatokat még az Adatintegrátor-feltöltés elindítása előtt vissza kell vonni.
Tabulátorral tagolt értékeket tartalmazó fájlok A tabulátorral tagolt értékeket tartalmazó fájlok adatsorokat foglalnak magukban. Minden adatsor legalább egy adatelemet tartalmaz. Az adatelemeket mezőknek szokás nevezni. Az Adatintegrátor eszközzel beolvasandó tabulátorral tagolt értékeket tartalmazó fájloknak minden sorban azonos számú mezőt kell tartalmazniuk, bár nem minden mezőben szükséges értéknek szerepelnie. Mielőtt az Adatintegrátor eszköz megkezdi a tabulátorral tagolt értékeket tartalmazó fájl beolvasását, a felhasználó modult, üzleti objektumot és űrlapot rendel a fájlhoz. Ezek az információk közlik az Adatintegrátor eszközzel, hogy a fájlban található adatok hova kerüljenek a feltöltés során. Az Adatintegrátor eszköz a tabulátorral tagolt értékeket tartalmazó fájl egyes soraiban (kivéve az első sorban) található adatmezők segítségével hozza létre vagy frissíti az IBM TRIRIGA Application Platform rendszerben szereplő rekordot. Ha az Adatintegrátor eszköz azt állapítja meg, hogy a fájlhoz rendelt üzleti objektum már tartalmazza a feltöltött rekordot, akkor a fájlból származó rekordokkal frissíti a rekordot. Amennyiben az Adatintegrátor eszköz azt állapítja meg, hogy a feltöltött rekord még nem létezik, úgy a fájlhoz társított üzleti objektum és űrlap segítségével hozza létre a rekordot. Az Adatintegrátor eszköznek meg kell határoznia, hogy mely mező tartalmazza az adatokat a tabulátorral tagolt értékeket tartalmazó fájl sorainak egyes mezőiben. Az Adatintegrátor a tabulátorral tagolt értékeket tartalmazó fájl fejlécnek nevezett első sorának vizsgálatával állapítja meg, hogy hová kell helyeznie az adatokat az egyes mezőkből. Az Adatintegrátor nem használja fel adatokként a tabulátorral tagolt értékeket tartalmazó fájl első sorát a rekordok létrehozásához vagy frissítéséhez. Helyette arra számít, hogy az első sor mezői tartalmazzák a fájlhoz társított üzleti objektumban szereplő mezők nevét. A mezőnév azonosítja azt a mezőt, amelybe az adott mező adatai kerülnek. A tabulátorral tagolt értékeket tartalmazó fájl előállításának legegyszerűbb módja egy alkalmazás használata, amely elkészíti a fájlt és elhelyezi a mezőneveket annak első sorában. Egyes alkalmazások például képesek a jelentéseket tabulátorral tagolt értékeket tartalmazó 2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
35
fájlba exportálni vagy nyomtatni. Ha meg tudja határozni az egyes oszlopok fejlécét, akkor az valószínűleg azt jelenti, hogy az alkalmazás képes elhelyezni a fejlécértéket az első sor mezőiben. Ha az Adatintegrátor tabulátorral tagolt értékeket tartalmazó fájljainak előállításához alkalmazást vesz igénybe, akkor olyan oszlopfejléceket adjon meg, amelyek megegyeznek azokkal az IBM TRIRIGA mezőnevekkel, amelyekben a mezőértékeket el kívánja helyezni. Miután megfelelően beállította az IBM TRIRIGA objektum mezőneveivel megegyező oszlopfejléceket, akkor az Adatintegrátor eszköz tabulátorral tagolt értékeket tartalmazó fájljainak létrehozása automatizált folyamattá válik. Ha az alkalmazás nem tudja elhelyezni a tabulátorral tagolt értékeket tartalmazó fájl fejléceit, akkor az Adatintegrátor eszközzel továbbra is felhasználhatja a belőle származó adatokat. Az Adatintegrátor eszközhöz tartozó tabulátorral tagolt értékeket tartalmazó fájl előkészítésének folyamata további munkát igényel. Ha az a program, amelyből adatokat kíván importálni, nem tudja elhelyezni a mezőneveket a tabulátorral tagolt értékeket tartalmazó fájl első sorában, akkor a fájl szerkesztésével veheti fel azokat. A tabulátorral tagolt értékeket tartalmazó fájlok szerkesztéséhez a Microsoft Excel alkalmazást veheti igénybe. A tabulátorral tagolt értékeket tartalmazó fájl Excel alkalmazással való szerkesztésekor az Excel alkalmazás felszólíthatja a fájllal kapcsolatos információk megadására. Az Excel alkalmazás csupán azért teszi fel ezeket a kérdéseket, hogy biztos legyen a szerkeszteni kívánt fájl típusában. Az Excel alkalmazás megkérdezheti például, hogy a fájl tagolt vagy rögzített szélességű. Erre a kérdésre a Tagolt érték kiválasztásával válaszoljon. Az Excel ezután felszólíthatja az adott fájl által használt határolójelek kiválasztására. Válassza a tabulátort. Ne válasszon más határolójelet vagy beállítást. Miután beillesztette a mezőneveket tartalmazó első sort, tabulátorral tagolt értékeket tartalmazó fájlként végezze el a fájl mentését. Ha korábban eredeti Excel fájlként mentette a fájlt, akkor figyelmen kívül hagyhatja azokat az esetleges figyelmeztetéseket, amelyek a tabulátorral tagolt értékeket tartalmazó formátummal nem kompatibilis összetevők tartalmazására hívják fel a figyelmet. A tabulátorral tagolt értékeket tartalmazó fájl most már készen áll az Adatintegrátor eszköz általi feldolgozásra. Az Adatintegrátor eszközzel akkor importálhat adatokat tabulátorral tagolt értékeket tartalmazó fájlt létrehozni nem képes alkalmazásból, ha az exportálni tudja az adatokat egy olyan formátumban, amelyet az Excel be tud olvasni. Ha az alkalmazás képes Excel által beolvasható fájlt létrehozni, akkor olvassa be a fájlt az Excel alkalmazásban. Szükség esetén vegye fel a megfelelő mezőneveket tartalmazó első sort a fájlba. Ezután végezze el a fájl mentését tabulátorral tagolt értékeket tartalmazó fájlként. Ha a mezőneveket tartalmazó első sor hozzáadása érdekében szerkesztenie kell az adatfájlt, akkor nem szükséges saját kezűleg beírnia a mezőneveket. Az első sor létrehozásához az Adatintegrátor eszközt veheti igénybe.
Fejlécfájlok A fejlécfájlok olyan importálási sablonok, ahol az első fejlécsor deklarálja azokat a mezőneveket, amelyekbe az adatok importálásra kerülnek. Többféleképpen is létrehozhatja ezt a fejlécet. A legfontosabb szempont, hogy a sablonmezőfejléceknek kis-/nagybetűs írásmód és helyesírás tekintetében meg kell egyezniük a megfelelő üzletiobjektummezőnevekkel, valamint tartalmazniuk kell az üzleti objektumhoz tartozó Közzétételi név mezőket. Az IBM TRIRIGA rendszerben a modulok két típusa létezik: a nem hierarchikus és a hierarchikus modulok. A fejlécfájl létrehozási folyamata mindkettő esetében azonos. Kivételt jelent azonban az, hogy a hierarchikus feltöltések megkövetelik a feltöltött rekord szülőrekordjának teljes elérési útvonalát tartalmazó Szülő oszlop meglétét.
36
© Copyright IBM Corp. 2011, 2015
Nem hierarchikus modulokhoz tartozó fejlécfájlok A nem hierarchikus objektumok szülő-utód társítással nem rendelkező, a szülőobjektum létezésétől nem függő sima objektumok. Az IBM TRIRIGA rendszer nem hierarchikus üzleti objektumaira példa a triPeople, triSpecification és triAsset üzleti objektum. A modulok nem hierarchikus jellegét az Adatmodellező eszközben ellenőrizheti, ha kiválasztja az adott modult, majd áttekinti annak tulajdonságait. Miután létrehozta a fejlécfájlt, a fájl feltöltéséhez biztonsági hozzáféréssel kell rendelkeznie az Adatintegrátor eszközhöz. Ha a lépéseket megfelelően követték, az adatértékek pedig megfelelnek a mezőformázásnak, akkor a feltöltés sikeres. Mint minden Adatintegrátor-feltöltés esetében, a rendszer ezúttal is értesítést küld a felhasználónak a feltöltés státuszáról.
Hierarchikus modulokhoz tartozó fejlécfájlok A hierarchikus objektumok olyan szülő-utód társításokkal rendelkeznek, ahol az utódok a szülőobjektum létezésétől függnek. Az IBM TRIRIGA rendszer hierarchikus üzleti objektumaira példa a Geography, Location és Organization üzleti objektum. A modulok hierarchikus jellegét az Adatmodellező eszközben ellenőrizheti, ha kiválasztja az adott modult, majd áttekinti annak tulajdonságait. A hierarchikus modulok egyediek abból a szempontból, hogy egy kiegészítő mezőt igényelnek az Adatintegrátor eszközhöz tartozó fejlécfájl fejlécsorában. A kulcsszó: Parent, amely a fában a megfelelő szülő üzleti objektumhoz csatolja a leszármazott rekordot. Minden hierarchikus fa rendelkezik egy olyan gyökérrel, amelynek neve a modul nevével egyezik meg. A szervezeti üzleti objektumok esetén a gyökér az Organization. A hely típusú üzleti objektumok esetében a gyökér a Location. A földrajzi elhelyezkedés üzleti objektumai esetén a gyökér a Geography. Az adatok importálása mellett előfordulhat, hogy olyan rekordoknak is el kell végezni az importálását vagy hozzáfűzését, amelyek egy másik üzleti objektum leszármazott rekordjai. Például az épületrekordok a Location gyökér utódai. Az emeletrekordok az épületek leszármazottai. A területrekordok pedig az emeletek utódai. A fejlécfájlban saját kezűleg vegye fel a Parent (szülő) címkéjű kiegészítő oszlopot. A Parent kulcsszó az IBM TRIRIGA rendszer foglalt szavainak egyike, így a fejléc létrehozásakor sosem fordul elő paraméterként.
Fejlécfájlok létrehozása Az Adatintegrátor eszköz segítségével létrehozhatja a nem hierarchikus vagy hierarchikus modulokhoz tartozó fejlécfájlt.
Eljárás 1. A fő navigációs sávon válassza az Eszközök > Adminisztráció > Adatintegrátor lehetőséget. 2. Válassza ki az azon üzleti objektummal rendelkező modult, amelyet az Adatintegrátor eszköznek a fájlhoz kell társítania. A mező minden meghatározott modult megjelenít. 3. Válassza ki azt az üzleti objektumot, amelyet az Adatintegrátor eszköznek a fájlhoz kell társítania. A mező a kiválasztott modulon belül az összes közzétett üzleti objektumot megjeleníti. 4. Válassza ki a fájlban szereplő rekordokhoz társítandó űrlapot (grafikus felhasználói felületet). A mező a kiválasztott üzleti objektum valamennyi közzétett űrlapját 2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
37
5. 6.
7.
8. 9. 10. 11.
12. 13.
megjeleníti. A feltöltés során lehetséges, hogy nincsenek meglévő rekordok az adott közzétételi név kiválasztott űrlapjához. Ha azonban létezik másik rekord ugyanazon közzétételi névvel és másik űrlappal, akkor a feltöltött adatok akkor is hozzáfűzésre kerülnek a meglévő rekordhoz, ha az másik űrlappal rendelkezik. Válassza a Fejléc létrehozása lehetőséget. Tekintse át a megnyitott Megjelenítési oszlopok képernyőt. A képernyő a kiválasztott üzleti objektumban vagy űrlapon szereplő valamennyi mezőhöz tartalmaz egy-egy jelölőnégyzetet. Válassza ki a kívánt mezőket. A jelölőnégyzetre kattintva a rendszer hozzáadja a megfelelő mező nevét a jobb felső sarokban lévő Oszlopsorrend szakaszhoz. Ügyeljen rá, hogy a közzétételi név és minden kötelező mező valamennyi elemét befoglalja. Alapértelmezésben az Oszlopsorrend szakaszban szereplő mezők a kiválasztás sorrendjében láthatók. Az Oszlopsorrend szakasz a mezők fejlécfájlbeli megjelenítési sorrendjét tükrözi. A mezők sorrendjének módosításához a kijelölés érdekében kattintson a kívánt mező nevére, majd a felfelé és lefelé mutató nyíllal helyezze át a mezőt. Amikor az Oszlopsorrend szakaszban szereplő mezők listája teljessé vált, és a mezők már a helyes sorrendben vannak, akkor válassza az Exportálás lehetőséget. Kattintson a Mentés gombra. Válasszon célt a helyi számítógépen. Bár az Adatintegrátor eszköz .csv kiterjesztést ad a fájlnak, az gyakorlatilag .htm formátumban kerül előállításra. Módosítsa a fájlnév kiterjesztését .csv értékről .htm értékre, változtassa a Mentés más típusként lehetőséget Minden fájl értékre, majd kattintson a Mentés gombra. Keresse és nyissa meg a mentett fájlt a Microsoft Excel alkalmazásban. Figyelje meg, hogy a kiválasztott mezőnevek az űrlap első sorában szerepelnek. Ha a fejlécfájl hierarchikus modulhoz tartozik, akkor írja be a Parent kulcsszót az első sor első üres cellájába. Amennyiben a fejlécfájl nem hierarchikus modulhoz tartozik, úgy hagyja ki ezt a lépést. a. A Parent oszlop tartalmazza a feltöltött rekord szülőjének teljes elérési útvonalát. Ahhoz, hogy az Adatintegrátor eszköz megtalálja a szülőt és hozzáfűzze az új leszármazott rekordot a hierarchiafához, a szülő üzleti objektum teljes elérési útvonalát meg kell adnia. b. Mindig a szülő üzleti objektum teljes elérési útvonalát adja meg az első fordított törtvonallal (\) együtt. Ne helyezzen azonban osztásjelet (\) a szülőútvonal végére.
14. Adja meg a megfelelő oszlopok adatait. Ha nem ad meg közvetlenül adatokat a fejlécfájlban, akkor hagyja ki ezt a lépést. a. Módosítsa a Microsoft Excel táblázat összes celláját Szöveg formátumúra. Ezzel a beállítással bármilyen értéket megadhat, és elkerülheti az adatok átalakítási formázását. Jelölje ki a bal felső sarokban lévő cellát (az 1 felett és az A-tól balra), amellyel a teljes táblázatot kiválasztja. Ezután válassza a Formázás > Cellák > Szöveg > OK lehetőséget. b. A lista- és osztályozási értékeknek helyesírás és kis-/nagybetűs írásmód tekintetében egyaránt pontosan meg kell egyezniük. 15. Végezze el a fájl mentését tabulátorral tagolt értékeket tartalmazó .txt fájlként. Ellenőrizze, hogy a fájlnév .txt kiterjesztésre végződik, a Mentés más típusként beállítás pedig Szöveg (tabulátorral tagolt értékeket tartalmazó) (*.txt) értékű. 16. Válassza az Igen lehetőséget.
38
© Copyright IBM Corp. 2011, 2015
Társítási feltöltések előkészítése A társításokkal rendelkező adatrekordok importálása a hierarchikus feltöltésnél több munkát igényel. Az Adatintegrátor eszköz Társítási feltöltés szolgáltatása segítségével egymáshoz társíthatja a rekordokat, így például a személyeket a szervezetekhez, az eszközöket a területekhez, illetve a személyekhez rendelheti hozzá. A társítási karaktersorozat megadásával bármely két adatrekord között meghatározhatja ezt a csatolást.
Társítási karaktersorozatok Mielőtt létrehozhatna egy társításokkal rendelkező feltöltést, az Adatintegrátor segítségével meg kell erősítenie a társítási feltöltésben használni kívánt társítási karaktersorozatok meglétét. A társítási karaktersorozatok megerősítésének két módszere a rekordok Társítások lapjának felülvizsgálatához, valamint a Társításkezelő használatához kötődik. Minden egyes üzleti objektum számos más üzleti objektummal meghatározott társítással rendelkezik. Fontos a két üzleti objektum társítása érdekében meghatározott viszonyszerep-kifejezés ismerete. Ha szükséges, először adja meg a Társításkezelőben a társítást és a fordított társítást.
Társítások azonosítása A legtöbb IBM TRIRIGA rekord rendelkezik Társítások lappal a neki megfelelő űrlapokon. A Társítások lap segítségével azonosíthatja a rekordszintű társításokat és az adott rekordnak megfelelő társítási karaktersorozatokat.
Erről a feladatról A következő példa a részlegrekord társításait vizsgálja.
Eljárás 1. A fő navigációs sávon válassza a Portfólió menüt. Megjelenik a Portfólió oldal. 2. A Szervezetek portálszakaszban válassza a Részlegek lehetőséget. 3. A Részlegek oldalon válassza ki bármely rekord nevét. 4. A rekordban válassza a Társítások lapot. 5. Válassza ki a modult. 6. Válassza ki az üzleti objektumot. 7. Tekintse át az eredményeket. A Rekordok listán az alkalmazás megjeleníti az összes olyan rekordot, amely az űrlapon az adott rekordból származó megnyitott társításokkal rendelkezik. A társítási karaktersorozatként is ismert karaktersorozat-érték olyan szerepkifejezés, amely a két rekord között meglévő társítást írja le.
Társítási szabályok ellenőrzése A Társításkezelő segítségével megerősítheti az üzletiobjektum-szintű társítási szabályokat, valamint az azoknak megfelelő társítási karaktersorozatokat.
Eljárás 1. A fő navigációs sávon válassza az Eszközök > Tervezőeszközök > Társításkezelő lehetőséget. 2. A Modul panelen válassza ki azt a modult, ahová tervei szerint rekordokat kíván feltölteni az Adatintegrátor segítségével. 3. A fő panelen keresse és erősítse meg a társítási szabályokat a Társítás oszlopban.
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
39
Társítások hozzáadása a fejlécfájlokhoz Társításokat hozhat létre az IBM TRIRIGA Application Platform környezetben meglévő, valamint az Adatintegrátor eszköz által feltöltött rekordok között. A folyamat megszervezése érdekében adott információk hozzáadásával határozhatja meg az egyes társításokat a tabulátorral tagolt értékeket tartalmazó fejlécfájlban.
Erről a feladatról Az adott információk az alábbiakat azonosítják: v A feltöltött rekordokhoz társítandó rekord létrehozásához használt üzleti objektummal rendelkező modult. v A feltöltött rekordokhoz társítandó rekord létrehozásához használt üzleti objektumot. v A meglévő rekordoktól az új rekordokhoz vezető társítás nevét. Miután a társítási hivatkozást használó feltöltés befejeződött, a két rekord a Társítás lapon tükrözi a viszonyt. A társítás a Társítás oszlop meglévő rekordjától, mint "forrástól" a feltölteni kívánt rekordig, mint "célig" kerül létrehozásra. Ha a Társítás oszlopban megadott társítási karaktersorozathoz üzletiobjektum-szintű társítás létezik a Társításkezelő eszközben, akkor a megfelelő társítás a fordított irányban is létrejön. Az Adatintegrátor eszköz nem használható az intelligens szakaszok, valamint a helymeghatározó mezők bizonyos típusai feltöltéséhez. Előfordulhat, hogy egyéni munkafolyamatot kell készítenie minden társítási típushoz, amely hozzáfűzi a társított rekordot az intelligens szakaszhoz vagy helymeghatározó mezőhöz. Két rekord egyszerű társítása hatására azok nem jelennek meg az intelligens szakaszokban vagy helymeghatározó mezőkben. Kivételt jelent a lekérdezési szakasz, amely ugyanazt a társítást használja.
Eljárás 1. Az adatok utolsó oszlopától közvetlenül jobbra írja be az Associate (Társítás) kulcsszót egy új oszlopba. 2. Illesszen be két sort a fejlécsor és az első adatsor közé. Az adatok most a 4. sorban kezdődnek. 3. A Társítás oszlop 2. sorában adja meg az üzleti objektum teljes képzésű nevét, és foglalja azt dupla százalékjelek közé. Például: %%triPeople:triPeople%%. Ez a sor a következőképpen tükrözi a rekordok modulját és üzleti objektumát, amelyből társítás jön létre: %%Modul:ÜzletiObjektum%%. 4. A Társítás oszlop 3. sorában adjon meg egy társítási karaktersorozatot, és foglalja azt dupla százalékjelek közé. Például: %%Manages%%. Ennek a karaktersorozatnak a 2. sor %%Modul:ÜzletiObjektum%% formátumában a feltöltendő fájl üzleti objektumához megadott társítási karaktersorozatnak kell lennie. 5. A táblázat minden egyes sorában a Társítás oszlopban adja meg azon meglévő rekord nevét, amelyből az új rekord társításra kerül.
Munkafolyamat-feladatok előkészítése társítási feltöltésekhez A munkafolyamat-feladatok nem szükségesek a társítási feltöltésekhez, mivel a társítások létrehozásához a társítási feltöltések önmagukban is létezhetnek. Ha azonban a Társítás oszlop egyik rekordját intelligens szakaszhoz is hozzá kell fűzni, akkor az Adatintegrátor eszköz munkafolyamattal is fel tudja dolgozni a társítási feltöltést.
Erről a feladatról Ebben a példahelyzetben a Társítás oszlop egyik ideiglenes társítási karaktersorozata aktiválja a rekordot a feltöltött rekord megfelelő szakaszához hozzáfűző, illetve bármely mást leképező
40
© Copyright IBM Corp. 2011, 2015
munkafolyamatot. Ezután a munkafolyamat eltávolítja az Adatintegrátor által készített ideiglenes társítást, majd a rekord intelligens társításra vagy helymeghatározó mezőre való leképezésével létrehozza a megfelelő társítást. A rekord leképezése után az IBM TRIRIGA rendszer automatikusan létrehozza a szakaszban szereplő rekordok közötti helyes társítást. FIGYELEM: A munkafolyamatban olyan társítási karaktersorozatot használjon, amelyet jelenleg az objektumok egyike sem vesz igénybe. Ez a gyakorlat biztosítja, hogy a munkafolyamat csak akkor kerül aktiválásra, amikor a rekordok társítása a feltöltésből és nem felhasználói művelet által megy végbe. Győződjön meg róla, hogy olyan társítási karaktersorozatot használ, amely a Listakezelő eszköz Társítási típusok listáján szerepel. Szükség esetén saját karaktersorozatát is hozzáadhatja ehhez a listához. A társítás iránya fontos kérdés. A társítás a Társítás oszlop rekordjától, mint "forrástól" a feltölteni vagy frissíteni kívánt rekordig, mint "célig" kerül létrehozásra. Hacsak a Társítás oszlopban megadott társításhoz nem létezik üzletiobjektum-szintű társítás, akkor a fordított irányban nem jön létre társítás. Ebben a példahelyzetben csak egy társítás (és a neki megfelelő Társítás esemény) jön létre a szervezetrekordtól, mint "forrástól" a feltöltött vagy frissített triPeople rekordhoz, mint "célhoz". Mivel az Adatintegrátor-feltöltésben megadott társítástípushoz nem létezett üzletiobjektum-szintű társítás, így a fordított irányban nem került meghatározásra társítás.
Eljárás 1. Vizsgálja meg az Adatintegrátor-fájlt. Ebben a példahelyzetben a Társítás oszlop azt írja elő, hogy a Feltöltési társítás értékű társítástípus a megadott szervezetrekordtól, mint "forrástól" a triPeople rekordhoz, mint "célhoz" kerül létrehozásra. 2. Ha az Adatintegrátor-fájl olyan társítási karaktersorozatot használ, amely nem létezik a rendszerben, akkor hozzá kell adnia azt a Listakezelő eszköz Társítástípusok listájához. 3. A Listakezelő megnyitásához válassza az Eszközök > Adminisztráció > Listák menüpontot. 4. A Kezelő szakaszban válassza a Társítástípusok listát. A lista betöltése egy percnél hosszabb időt is igénybe vehet. 5. Adja meg az Adatintegrátor-fájlból eredő társítási karaktersorozatot az Érték mezőben. 6. Kattintson a Bejegyzések mentése gombra. 7. Az alábbiak szerint állítson össze egy új munkafolyamatot az organization modulban. Az indítási feladat határozza meg a munkafolyamat aktiváló feltételét. Ebben a példahelyzetben a munkafolyamat akkor kerül futtatásra, amikor a szervezetrekord társításra kerül egy triPeople rekordhoz a Feltöltési társítás karaktersorozattal. 8. Állítsa be a módosítási feladatot a munkafolyamat elsődleges rekordjának másodlagos rekordra való leképezésére. Másként fogalmazva a munkafolyamat elsődleges rekordja az indítási feladat üzleti objektuma. Időközben a másodlagos rekord az indítási feladatban szereplő társítás másik végéről származó üzleti objektum. Ebben a példahelyzetben az Organization rekordból a triPeople rekordba történik leképezés, amellyel a szervezetrekord képezhető le a személyrekord intelligens szakaszára. 9. Az Objektumleképezés ablak megnyitásához válassza a Leképezés szerkesztése lehetőséget. 10. Minden mezőleképezés eltávolításához válassza az Összes törlése lehetőséget. A leképezések törlése néhány másodpercet vehet igénybe. 11. Görgessen le a triPrimaryOrganization intelligens szakaszhoz. 12. Válassza a Keresés ikont. 13. Állítsa a szakaszt Forrás értékűre. Ez a beállítás a forrásrekordot (Organization) a célrekord (triPeople) szakaszára képezi le, majd létrehozza a hivatkozást és társítást az intelligens szakasz feltöltéséhez. 2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
41
14. Görgessen vissza, majd kattintson az OK gombra. 15. Az Új feladat panelről válasszon egy Rekordok társítása feladatot. Ez a feladat a Következő feladat társításának feloldása lehetőségre változik. 16. Módosítsa a beállítást Társítás a következő felhasználásával értékről Társítás eltávolítása értékre, a társítást pedig Feltöltési társítás értékre. Ez a feladat megszünteti a munkafolyamat aktiválásához használt ideiglenes társítást, amely a tabulátorral tagolt értékeket tartalmazó Adatintegrátor-fájlban és az indítási feladatban egyaránt megadásra kerül. 17. Állítsa a Társított rekord helye szakaszt a másodlagos üzleti objektumra (azaz a triPeople rekordra). Ha beágyazott rekordokat tölt fel, akkor az ismétlődő társítások elkerülése érdekében a társításfeloldási feladatot a módosítási (rekordleképezési) feladat előtt kell futtatni. 18. Tegye közzé a munkafolyamatot. Előfordulhat, hogy éles környezet esetén ki kell ürítenie a kiszolgáló munkafolyamat-gyorsítótárát.
Adatok feltöltése Az adatok IBM TRIRIGA alkalmazásba való feltöltését az Adatintegrátor segítségével végezheti el úgy, hogy a fájlokat egyenként, illetve kötegelt módban tölti fel. Az Adatintegrátorba importált fájl neve nem haladhatja meg az 50 karakteres hosszt.
Adatok kézi feltöltése Miután megtörtént a fejlécfájl létrehozása, rekordinformációkkal való feltöltése, majd tabulátorral tagolt értékeket tartalmazó fájlként sor került a mentésére is, készen áll a fájl Adatintegrátor eszközbe való feltöltésére.
Erről a feladatról Az eljárás a futtatott feltöltés - társítási, hierarchikus vagy nem hierarchikus - típusától függetlenül azonos. Az egyedüli követelmény, hogy meg kell győződni a megfelelő Modul::ÜzletiObjektum::Űrlap kiválasztásáról. A megfelelő beállítások kiválasztásának elmulasztása sikertelen feltöltéshez vagy a helytelen objektumba történő sikeres rekordfeltöltéshez vezet. Amikor a rekordok elsőként létrehozásra kerülnek, akkor a Null nevű különleges állapotban vannak. A Null állapotú rekordok az azokat jelenleg használó művelet befejezése után eltűnnek. Az Adatintegrátor eszköz esetében fontos, hogy a műveletek újonnan létrehozott rekordokon való futtatásához ki kell emelni a rekordokat a Null állapotból. Ha a művelet nem emeli ki a rekordot a Null állapotból, akkor létrehozása után a rekord azonnal eltűnik. A Művelet listán szereplő lehetőségek mindegyike olyan művelet, amely kiemeli a rekordokat a Null állapotból.
Eljárás 1. A fő navigációs sávon válassza az Eszközök > Adminisztráció > Adatintegrátor lehetőséget. 2. Ellenőrizze, hogy a Modul, Üzleti objektum és Űrlap mezőben szereplő értékek megegyeznek-e a fejlécfájllal. Az Importálási típus értéke kötelezően: Hozzáadás. A Hozzáadás érték azt jelenti, hogy ha egy sor olyan értékeket tartalmaz a rekord közzétételinév-mezői esetében, amelyek megegyeznek egy meglévő rekorddal, akkor a sor egyéb értékei frissítik a rekordot. Amennyiben a sor olyan értékeket tartalmaz a rekord közzétételinév-mezői esetében, amelyek nem egyeznek meg egy meglévő rekorddal, úgy a sorban szereplő adatok segítségével a rendszer új rekordot hoz létre.
42
© Copyright IBM Corp. 2011, 2015
3. A Művelet listáról válassza ki a rekordon az Adatintegrátor eszköz általi létrehozása vagy frissítése után futtatni kívánt műveletet. Ez a lista az új rekordok érvényes műveleteit tartalmazza a kiválasztott üzleti objektum által használt státuszátmeneti család alapján. 4. Ha a munkafolyamatnak el kell indulnia azután, hogy az Adatintegrátor eszköz létrehozott egy rekordot, akkor egy olyan részművelettel kell elindítania a munkafolyamatot, amely a Művelet listán szereplő művelethez kapcsolódik. 5. A Fájltípus egyetlen értéke: Tabulátorral tagolt értékeket tartalmazó (*.txt). A Fájl karakterkészlete listáról azonban kiválasztható az importált fájl összeállításához használt karakterkészlet. 6. Ellenőrizze, hogy nincs bejelölve a Kötegelt feltöltés jelölőnégyzet. A beállítás jelölésének törlése arra utasítja az Adatintegrátor eszközt, hogy csak egyszer olvassa be a megadott adatfájlt. 7. A Tallózás lehetőség kiválasztásával keresse és nyissa meg a létrehozott fejlécfájlt. 8. Válassza a Fájl feltöltése lehetőséget. 9. Kattintson az OK gombra. Az adatok beolvasásra kerülnek a megadott fájlból. Miután a feltöltési folyamat befejeződött, a rendszer értesítést küld a Kezdőlap portál Értesítések szakaszába. 10. A kapcsolódó portál vagy oldal megtekintésével ellenőrizze, hogy az összes rekord importálása megfelelően megtörtént.
Adatok feltöltése kötegelt feltöltésekkel A kötegelt feltöltések révén automatizálhatja a feltöltési folyamatot, valamint úgy ütemezheti az eseményeket, hogy az IBM TRIRIGA Application Platform rendszer az ütemezési beállításoknak megfelelően automatikusan töltse fel a megadott fájlt. Ez a funkció a külső rendszerből származó adatok integrálásának automatizálásához hasznos, hiszen így nincs szükség programba kódolt parancsfájlokra vagy az integráció fejlesztésére.
A kötegelt feltöltés beállításai A TRIRIGAWEB.properties fájl tartalmazza a kötegelt feltöltés azon beállításait, amelyek a bemenet, a feldolgozás, a kimenet, a hibák és a naplófájlok elérési útvonalát határozzák meg. A TRIRIGAWEB.properties fájl BatchInputLoc, BatchProcessLoc, BatchOutputLoc, BatchErrorLoc és BatchLogLoc paramétereiben megadott mappáknak létezniük kell, nevüknek pedig pontosan meg kell egyezniük. A kötegelt feltöltések megvalósítása előtt futtassa a CreateBatchProcess.bat (Windows) vagy a CreateBatchProcess.sh (Linux) parancsfájlt a [TRIRIGA_telepítési_könyvtár]\ userfiles könyvtárban, amellyel létrehozza a feldolgozás végrehajtásához szükséges alapértelmezett könyvtárakat. A kötegelt feltöltés általában a legjobb választás, ha az Adatintegrátor eszköz rendszeres időközönként olvas be olyan adatfájlokat, amelyek mind azonos módon, ugyanolyan típusú rekordokba vannak szervezve.
Kötegelt feltöltések ütemezése Miután megtörtént a fejlécfájl létrehozása, rekordinformációkkal való feltöltése, majd tabulátorral tagolt értékeket tartalmazó fájlként sor került a mentésére is, készen áll a feltöltési folyamat automatizálására, valamint a kötegelt feltöltések Adatintegrátor eszközzel való ütemezésére.
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
43
Erről a feladatról Amikor a rekordok elsőként létrehozásra kerülnek, akkor a Null nevű különleges állapotban vannak. A Null állapotú rekordok az azokat jelenleg használó művelet befejezése után eltűnnek. Az Adatintegrátor eszköz esetében fontos, hogy a műveletek újonnan létrehozott rekordokon való futtatásához ki kell emelni a rekordokat a Null állapotból. Ha a művelet nem emeli ki a rekordot a Null állapotból, akkor létrehozása után a rekord azonnal eltűnik. A Művelet listán szereplő lehetőségek mindegyike olyan művelet, amely kiemeli a rekordokat a Null állapotból. Gyakran úgy adódik, hogy az Adatintegrátor eszköz futtatási alkalmai között megadott időköz egyenletesen osztható fel 24 órás időtartamokra. Ha ez történik, akkor az adatok mindennap ugyanakkor kerülnek a fájlból beolvasásra. Ha olyan időközt választ, amely nem osztható fel egyenletesen 24 órás időtartamokra, így például 5 órát ad meg, akkor az adatok mindennap ugyanakkor kerülnek a fájlból beolvasásra. Máshogy fogalmazva mindennap az Óra alaphelyzetbe állítása mindennap ekkor mezőben megadott időpontban kerül sor az adatok meghatározott fájlból való ütemezett beolvasására. Ezután a megadott időközönként újraütemezésre kerül. Például tegyük fel, hogy a feltöltési folyamat mindennap 9.00-kor kezdődik. Ha 5 óra 0 percre állítja az időközt, akkor a kötegelt feldolgozás 9.00-kor kerül futtatásra, majd a következő 24 óra folyamán 5 órás időközönként ismétlődik. Vagyis a folyamat mindennap a következő időpontokban kerül futtatásra: 9.00, 14.00, 19.00, 00:00 és 5.00. Ezután újból elindul 9.00-kor, ugyanolyan időközönként ismétlődve. A futó ügynök 10 percenként kerül futtatásra. Az ügynök végighalad az összes létrehozott kötegelt feldolgozású objektumon, majd az aktuális időpont alapján a megfelelő időben futtatja a kötegelt objektumokat. Mivel az ügynök pontos futási időpontja ismeretlen, az IBM TRIRIGA Application Platform rendszer 1 perces puffert illeszt be az egyes időnövekmények kezdő időpontja elé. Ha a példában az ügynök 9.00:10-kor kerül futtatásra, akkor a folyamat a 9.00 és 9.01 közötti platformellenőrzések óta fut. Az 5 órás időközök példájában a parancsfájlok akkor kerülnek futtatásra, ha az aktuális időpont a 9.00-9.01, 14.00-14.01, 19.00-19.01, 24.00-24.01 és 5.00-5.01 tartományba esik.
Eljárás 1. A fő navigációs sávon válassza az Eszközök > Adminisztráció > Adatintegrátor lehetőséget. 2. Ellenőrizze, hogy a Modul, Üzleti objektum és Űrlap mezőben szereplő értékek megegyeznek-e a fejlécfájllal. Az Importálási típus értéke kötelezően: Hozzáadás. A Hozzáadás érték azt jelenti, hogy ha egy sor olyan értékeket tartalmaz a rekord közzétételinév-mezői esetében, amelyek megegyeznek egy meglévő rekorddal, akkor a sor egyéb értékei frissítik a rekordot. Amennyiben a sor olyan értékeket tartalmaz a rekord közzétételinév-mezői esetében, amelyek nem egyeznek meg egy meglévő rekorddal, úgy a sorban szereplő adatok segítségével a rendszer új rekordot hoz létre. 3. A Művelet listáról válassza ki a rekordon az Adatintegrátor eszköz általi létrehozása vagy frissítése után futtatni kívánt műveletet. Ez a lista az új rekordok érvényes műveleteit tartalmazza a kiválasztott üzleti objektum által használt státuszátmeneti család alapján. 4. Ha a munkafolyamatnak el kell indulnia azután, hogy az Adatintegrátor eszköz létrehozott egy rekordot, akkor egy olyan részművelettel kell elindítania a munkafolyamatot, amely a Művelet listán szereplő művelethez kapcsolódik. 5. A Fájltípus egyetlen értéke: Tabulátorral tagolt értékeket tartalmazó (*.txt). A Fájl karakterkészlete listáról azonban kiválasztható az importált fájl összeállításához használt karakterkészlet.
44
© Copyright IBM Corp. 2011, 2015
6. Jelölje be a Kötegelt feltöltés jelölőnégyzetet. A Kötegelt adatok feltöltése ___ órás és ___ perces időközönként címkéjű mezők azt vezérlik, hogy az Adatintegrátor eszköz milyen gyakran kerül ütemezésre az adatok beolvasására. 7. A Kötegelt adatok feltöltése ilyen időközönként mezőben állítsa be az időnövekmény értékét a feltöltési időközök számára, amelyek az Óra alaphelyzetbe állítása mindennap ekkor mezőben beállított időpontban kezdődnek. Az alapértelmezett érték: 0 óra 0 perc. 8. Állítsa az Óra alaphelyzetbe állítása mindennap ekkor értéket arra az időpontra, amikor a kötegelt feltöltési folyamatnak naponta el kell indulnia. Ha az Óra alaphelyzetbe állítása mindennap ekkor mező 24 óránál nagyobb értéket tartalmaz, akkor a feltöltésre naponta csak egyszer kerül sor a kijelölt Óra alaphelyzetbe állítása mindennap ekkor időpontban. 9. Határozza meg a fejlécfájl nevét a Fájlnév (*.txt) mezőben. A fájlnak egy olyan könyvtárban kell lennie, amelyen az IBM TRIRIGA Application Platform fut. Ha a kijelölt fájl a megfelelő helyen található, akkor a platform feldolgozza a fájlt és elhelyezi a feldolgozási időt az adatfeltöltési üzleti objektum Utolsó futtatás időpontja mezőjében. 10. Adja meg a Megerősítési e-mail cím értékét. Minden alkalommal, amikor az Adatintegrátor eszköz kísérletet tesz egy fájl kötegelt feltöltésére, a rendszer e-mailt küld a megadott címre. Ez az e-mail a feltöltés sikeres voltától függetlenül elküldésre kerül. 11. Válassza a Fájl feltöltése lehetőséget. 12. Kattintson az OK gombra. A platform ütemezi a megadott fájl feltöltését, majd korlátlan ideig a megadott időközönként folytatja a fájlfeltöltés ütemezését. Az adatok beolvasásra kerülnek a megadott fájlból. Minden feltöltési folyamat befejezése után a rendszer e-mail értesítést küld a Megerősítési e-mail cím mezőben megadott címre. 13. A kapcsolódó portál vagy oldal megtekintésével ellenőrizze, hogy az összes rekord importálása megfelelően megtörtént.
A kötegelt feltöltés leállítása Ha módosítani kívánja a kötegelt feltöltés bármely paraméterét, akkor először le kell állítania annak ütemezését, majd létre kell hoznia egy azt helyettesítő kötegelt feltöltést. A kötegelt feltöltési rekordok törléséhez a fő navigációs sávon válassza az Eszközök > Rendszerbeállítás > Rendszer > Adatfeltöltés lehetőséget.
Tippek az Adatintegrátor eszköz használatához A következő tippek segítségével kiterjesztheti az IBM TRIRIGA adatintegrátor eszköz vállalata általi üzemeltetésének módját. 15. táblázat: Tippek az Adatintegrátor eszköz használatához Tipp
Leírás
Meglévő rekordok társítása
Miután minden rekord létrehozásra került, a fejlécfájl újrafelhasználásával készítse el a társítási feltöltéshez tartozó fejlécfájlt. Ha az összes rekord létrehozása után alakítja ki a társításokat, akkor kiküszöbölheti a nem létező rekordokkal kapcsolatos problémákat.
Adatfeltöltési hibák ellenőrzése
Minden alkalommal, amikor az Adatintegrátor eszköz futása során hibákba ütközik, létrehoz egy adatfeltöltési hibarekordot. Az adott adatfeltöltési hibarekord megkereséséhez válassza az Eszközök > Rendszerbeállítás > Rendszer > Adatfeltöltési hiba menüpontot. Görgesse végig az eredményoldalon szereplő rekordokat. Kattintson a fájlnév hiperhivatkozására.
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
45
15. táblázat: Tippek az Adatintegrátor eszköz használatához (Folytatás) Tipp
Leírás
Megerősítés az üzleti objektum eredményoldalán keresztül
Miután az adatok sikeres értesítést állítottak elő, tekintse át az adatokat az üzleti objektum eredményoldalán keresztül. Hierarchikus objektumok esetén győződjön meg róla, hogy a leszármazott rekordok a megfelelő szülő alatt jelennek meg a hierarchia ablakában.
Adatintegrátorfigyelmeztetések
Az Adatintegrátor eszköz kevesebb ellenőrzést végez, mint az az űrlap, amelybe saját kezűleg viszi be az adatokat: v Létrehozza vagy frissíti a kötelező mezők esetében hiányzó értékkel rendelkező rekordokat. v Lehetővé teszi a listamezőkben bármely érték megadását, még akkor is, ha az adott érték nem szerepel a listán. v Nem futtat kért ellenőrzéseket a mezőértékeken. Ha a feltöltés kifejezetten nem állítja be az általa létrehozott rekordok szervezetét és földrajzi elhelyezkedését, akkor előfordulhat, hogy az adott rekordokhoz való biztonsági hozzáférés eltér majd a várttól. Lehet, hogy a létrehozott rekordokhoz való megfelelő biztonsági hozzáférés biztosítása érdekében fel kell vennie a szervezet vagy földrajzi elhelyezkedés mezőit a sima szövegfájl rekordjaiba.
46
Adatfeltöltési rekordok
Minden alkalommal, amikor az Adatintegrátor eszköz segítségével kezdeményezi az adatok beolvasását, az eszköz létrehoz egy adatfeltöltési rekordot. Ha kötegelt feltöltések ütemezését kezdeményezi, akkor is csak egy adatfeltöltési rekord készül. Miután a feltöltés befejeződött, úgy tájékozódhat a feltöltés sikerességéről, hogy megtekinti a feltöltésnek megfelelő adatfeltöltési rekordot. Az adatfeltöltési rekord intelligens szakasza tartalmazza az adatfeltöltési hibarekordokat. Ha hibák történtek, akkor azokat az intelligens szakaszban tekintheti meg. Az adott adatfeltöltési rekord megkereséséhez válassza az Eszközök > Rendszerbeállítás > Rendszer > Adatfeltöltés menüpontot. Görgesse végig az eredményoldalon szereplő rekordokat. Kattintson a fájlnév hiperhivatkozására.
Mappatisztítás
Az Adatintegrátor kötegelt feltöltéséhez kapcsolódó rendszeradminisztrációs folyamatoknak magukban kell foglalniuk a bemeneti és naplómappák ismétlődő tisztítását.
© Copyright IBM Corp. 2011, 2015
15. táblázat: Tippek az Adatintegrátor eszköz használatához (Folytatás) Tipp
Leírás
Feltöltési fájlok kezelése
Amikor a fájlok kötegelt módban kerülnek feltöltésre, akkor a feltöltés közvetlen emberi részvétel nélkül történik. A platform a felhasználó számítógépe helyett a rendszert futtató számítógépen keresi meg a fájlokat. Előfordulhat, hogy a kötegelt adatfeltöltésekhez használt számítógép és könyvtár azonosítása érdekében egyeztetnie kell az IBM TRIRIGA Application Platform környezetet szervezete számára felügyelő személlyel. A fájlok megfelelő feldolgozásának biztosításához vegye figyelembe a feldolgozandó fájlok adott könyvtárban való elhelyezésére vonatkozó alábbi szabályokat, amelyek az elhelyezés időpontját és módját határozzák meg: v Mielőtt kötegelt feltöltés céljából elhelyez egy fájlt a könyvtárban, először ellenőrizze, hogy létezik-e már azonos nevű fájl az adott könyvtárban. Ha létezik, akkor az azt jelenti, hogy az utolsó adott nevű fájl nem került feldolgozásra. Miután megtörtént a fájl feldolgozása, a rendszer azt másik könyvtárba helyezi át. v A könyvtárban lévő fájl megfelelő feldolgozásának biztosítása érdekében várja meg, amíg a fájl eltűnik, mielőtt egy azonos nevű új fájlt helyezne el a könyvtárban. v Amikor elérkezik a fájl könyvtárban való elhelyezésének ideje, ne a fájl másik helyről való átmásolásával helyezze el azt a könyvtárban. A másolással kapcsolatban az jelent problémát, hogy a fájl darabokban kerül a könyvtárban elhelyezésre. Máshogy fogalmazva, a fájl könyvtárba másolása esetén létezik egy olyan időtartam, amikor még csak a fájl egy része található a könyvtárban. Ha az IBM TRIRIGA Application Platform rendszer akkor próbálja feldolgozni a fájlt, amikor az még nincs teljes egészében jelen, akkor előfordulhat, hogy helytelenül dolgozza fel a fájlt. v A fájl könyvtárba másolása helyett először helyezze el valahol másutt a fájlt a könyvtárral megegyező fájlrendszerben. Ezután átnevezéssel vagy áthelyezéssel mozgassa a fájlt a könyvtárba. Amikor ugyanazon fájlrendszeren belül nevezi vagy helyezi át a fájlt, akkor nem kerül sor fájlmásolásra. Helyette egy bejegyzés kerül a könyvtárhoz hozzáadásra, amely arra a helyre mutat, ahol a fájl már jelenleg is megtalálható.
Teljes köteg feldolgozása
Lehetőség van egy olyan munkafolyamat kialakítására, amely az egyes rekordok létrehozása vagy frissítése után a kötegben lévő összes rekordot feldolgozza. Amikor a tabulátorral tagolt értékeket tartalmazó fájl feltöltése befejeződött, a platform az Alkalmazás műveletet futtatja a feltöltéshez társított adatfeltöltési rekordon. A rekordok feldolgozása során társítás jön létre az adatfeltöltési rekordtól az érintett rekordokhoz. A társítás neve: A következő adatbetöltési státusza. A Társításkezelő eszköz segítségével A következő adatbetöltési státusza üzleti objektumról más érintett üzleti objektumra módosíthatja az ezzel a névvel rendelkező társítást. Ha így tesz, az adatfeltöltési rekordra vonatkozó Alkalmazás művelet által elindított munkafolyamat minden feltöltött rekordot képes feldolgozni. A Munkafolyamat lekérése feladat segítségével az adott mezőben szereplő értékük sorrendjében rendezett rekordokat kérheti le. Így a rekordokban szereplő bármely mezővel meghatározhatja a munkafolyamat általi feldolgozásuk sorrendjét.
2. fejezet Adatok integrálása a TRIRIGA Data Integrator eszközzel
47
15. táblázat: Tippek az Adatintegrátor eszköz használatához (Folytatás) Tipp
Leírás
Képlet-, összesítési és számítási munkafolyamatok visszavonása
Éles környezetekben a feltöltés futtatása előtt minden képlet-, összesítési és számítási munkafolyamatot vissza kell vonni az üzleti objektummal kapcsolatban. Ez az eljárás biztosítja, hogy a rekordok anélkül kerülnek létrehozásra, hogy ezzel szükségtelen munkafolyamatok részleges adatokon való futtatására kényszerítenék a platformot. Segít továbbá a végtelen ciklusokat is kiküszöbölni, amelyek a hierarchikus objektumokkal kapcsolatban alakulhatnak ki. Miután a feltöltés sikeresen végrehajtásra került, tegye ismét közzé és futtassa a munkafolyamatot az új adathalmazon.
Minden fájl csúcsidőszakon kívüli futtatása
A feltöltött információk mennyiségétől függően a kiszolgáló-erőforrások kimerülhetnek, a teljesítmény pedig visszaeshet. A felhasználók teljesítményproblémákat tapasztalhatnak, ami a téves riasztások és a gyorssegélyszolgálathoz érkező hívások számának növekedését okozhatja.
A rekordfeldolgozás időzítése Az IBM TRIRIGA Application Platform rendszer nem feltétlenül abban a sorrendben dolgozza fel a feltöltött rekordokat, mint amiben azok a tabulátorral tagolt értékeket tartalmazó fájlban szerepelnek. A rendszer egymás után olvassa be az adatokat az egyes tabulátorral tagolt értékeket tartalmazó rekordokból, majd egy másik szállal dolgozza fel az adatokat a rekordok létrehozása vagy frissítése érdekében. A legtöbb esetben nem számít, hogy a rekordok milyen sorrendben kerülnek feldolgozásra. Ha azonban a beolvasásuk sorrendjében kell feldolgoznia a kötegelt rekordokat, akkor kényszerítenie kell az Adatintegrátor eszközt arra, hogy ugyanazzal a szállal dolgozza fel az összes rekordot. Ezen feladat végrehajtásához állítsa az Adatimportálási ügynök által használt szálak számát 1-re. A kötegelt feltöltéshez kapcsolódó TRIRIGAWEB.properties fájl
A TRIRIGAWEB.properties fájl tartalmazza a kötegelt feltöltés fájlbeállításait, egész pontosan a bemenet, a feldolgozás, a kimenet, a hibák és a napló beállításait. A TRIRIGAWEB.properties fájlban meghatározott fájloknak létező, egyező nevű fájloknak kell lenniük.
Először töltse fel a rekordokat Ne végezze el az összes mezőt és társítást egy fájlban tartalmazó Adatintegrátor-fájl feltöltését. Először hozza létre az összes üzleti objektumhoz tartozó valamennyi rekordot. Csak akkor kezdje el a rekordok egymáshoz társításának feladatát, miután importálta az összes rekordot. Rekordhalmazok feltöltése
Ne helyezzen rendkívül nagy mennyiségű adatot egyetlen Adatintegrátor-fájlba. Adatintegrátor-fájlonként használjon 5000 rekordokból álló adathalmazokat. Ez a gyakorlat csökkenti a memóriával és rendszerkapacitással kapcsolatos hibák előfordulását.
Képek feltöltése
Ha képeket kell rendelnie az újonnan feltöltött rekordokhoz, akkor ehhez a következő formátumot használhatja. Tegyük fel, hogy a képmező neve: triImageIM. triImageIM //Company-1/file123.jpg A fájlnévnek a "file" kulcsszóval kell kezdődnie, például: filemyimagename.jpg vagy file12345.gif. A példa alapján a fájlt a [TRIRIGA_telepítési_könyvtár]\userfiles\ Company-1 könyvtárban kell elhelyezni, mielőtt elvégezné az Adatintegrátor-fájl feltöltését.
48
© Copyright IBM Corp. 2011, 2015
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével Lehetősége van arra, hogy az Adatbetöltés-kezelő eszköz segítségével külső rendszerekből adatokat importáljon az TRIRIGA adatbázisba. Az adatbetöltési folyamat több üzleti objektum egymás utáni beállítását és betöltését foglalja magában, amely mechanizmust biztosít az adatbetöltés előrehaladásának megfigyeléséhez és a hibák azonosításához. A következő ábra az Adatbetöltés-kezelő eszköz használatát szemlélteti az adatbetöltési készletek, adatbetöltési elemek, integrációs objektumok és Adatcsatlakozási feladatok közötti együttműködések meghatározásához. Előállíthat egy adatbetöltési készletek számára testreszabott táblázatot is. A táblázat segítségével rendszerezheti és érvényesítheti külső adatait, mielőtt betölti azokat a TRIRIGA rendszerbe. TRIRIGA Adatbetöltés-kezelő
Táblázatadatok
Adatbetöltési készlet
Dokumentumkezelő
1:M Adatbetöltési elem(ek)
Adatcsatlakozási feladatok
Integrációs objektumok
Táblázatsablon
1:M Integration Object Példány(ok)
1:M Integrációs példány Hibarekord(ok)
Megjegyzés: A TRIRIGA adatbetöltés-kezelő eszköz csak a Fájl-DC (Adatcsatlakozási) sémával meghatározott integrációs objektumokat támogatja. Az adatbetöltési táblázatok létrehozásának és feltöltésének, valamint az új adatbetöltési elemek hozzáadásának funkciója kifejezetten a Fájl-DC sémával meghatározott integrációs objektumok számára készült. Ezek a funkciók az egyéb sémákkal meghatározott integrációs objektumok esetében nem működnek. Minden más funkció csak a Fájl-DC sémával meghatározott integrációs objektumok felhasználásával került tesztelésre, így előfordulhat, hogy az egyéb sémákkal megadott integrációs objektumok esetén nem működnek.
Adatbetöltési készletek Az adatbetöltési készlet a sorrendben feldolgozott integrációs objektumok csoportosításainak meghatározására szolgáló TRIRIGA üzleti objektum. Például előfordulhat, hogy a “Földrajz” nevű adatbetöltési készlet tartalmazza a “Világrégió”, “Ország”, “Állam” és “Város” integrációs objektumának hivatkozásait. Bármely integrációs objektum hozzáadható az adatbetöltési készletekhez, az integrációs objektumoknak pedig semmilyen módon nem szükséges kapcsolódniuk egymáshoz. © Szerzői jog IBM 2011, 2015
49
A következő ábra az adatbetöltési készletek, adatbetöltési elemek és integrációs objektumok közötti viszonyokat szemlélteti.
TRIRIGA Data Load Manager
Data Load Set
1:M Data Load Item(s)
Integration Objects
Adatbetöltési készletek és adatbetöltési elemek Amikor létrehoz egy új, vagy kiválaszt egy meglévő adatbetöltési készletet, akkor meg kell határoznia az adatbetöltési elemeket, valamint azok feldolgozási sorrendjét. Az adatbetöltési készlet adatbetöltési elemeket használ az integrációs objektumokra való hivatkozáshoz. Az adatbetöltési készlet a külső forrásból származó adatok meglévő TRIRIGA üzleti objektumokra való leképezésére szolgál.
Mielőtt elkezdené Az új adatbetöltési elemek létrehozása előtt a DC betöltés - sablon integrációs objektum módosításával először meghatározhatja az integrációs objektum alapértelmezett beállításait.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Adatbetöltés-kezelő > Adatbetöltési készletek menüpontra. 2. Adjon hozzá egy adatbetöltési készletet. 3. Határozza meg az adatbetöltési készlet nevét és a feldolgozás típusát. 4. Adjon hozzá meglévő adatbetöltési elemeket, vagy új adatbetöltési elemek létrehozásával vegye fel azokat az adatbetöltési készletbe. a. Adja meg a betöltési modult, a betöltési üzleti objektumot, az állomásoztatásitáblaűrlapot és az Adatcsatlakozási feladatot. b. Hozza létre, majd végezze el az adatbetöltési elem mentését. 5. Adja meg az adatbetöltési elemek feldolgozási sorrendjét. 6. Hozza létre, majd végezze el az adatbetöltési készlet mentését.
50
© Copyright IBM Corp. 2011, 2015
7. Dolgozza fel az integrációt. 8. Vizsgálja meg az esetleges hibákat.
Adatbetöltési készletek feldolgozása az Adatbetöltés-kezelő eszközben Az adatok TRIRIGA rendszerbe való integrálását egyetlen adatbetöltésikészlet-űrlapról származó több adatbetöltési elem feldolgozása, illetve az adatok közvetlenül az adatbetöltésielem-űrlapon való feldolgozása révén hajthatja végre. Az adatbetöltési készleteken belüli adatbetöltési elemek feldolgozása egymás utáni sorrendben történik. Az adatbetöltési készlet a sorrendben feldolgozott integrációs objektumok csoportosításainak meghatározására szolgáló TRIRIGA üzleti objektum. Az integrációs objektumok feldolgozása legalább egy integrációsobjektum-példányt, Adatcsatlakozási feladatot és integrációsobjektum-példányhoz kapcsolódó hibarekordot állít elő.
Adatok feldolgozása az Adatbetöltési készlet űrlap segítségével Az adatbetöltési készletben szereplő valamennyi adatbetöltési elemből elvégezheti az adatok feldolgozását. A feldolgozni kívánt adatbetöltési elemek mindegyikéhez adatfájlok csatolhatók. A megadott feldolgozástípus alapján a feldolgozás az alábbi módokon mehet végbe: Teljes készlet feldolgozása Az adatbetöltési készletben "Kész" státusszal szereplő valamennyi adatbetöltési elem sorrendi feldolgozása. Készlet feldolgozása hibáig Az adatbetöltési készletben "Kész" státusszal szereplő valamennyi adatbetöltési elem sorrendi feldolgozása. A feldolgozás addig fut, amíg az adatbetöltési elemek egyike meghiúsul, vagy a rendszer eléri az adatbetöltési készlet végét. Következő elem feldolgozása Csak a legalacsonyabb sorszámmal rendelkező, "Kész" státuszú adatbetöltési elem kerül feldolgozásra. Ha a feldolgozás befejeződött, értékelje ki a feldolgozási történetet és a feldolgozási hibanaplót, hogy lássa, betöltésre kerültek-e az adatfájlokból származó rekordok.
Adatok feldolgozása az Adatbetöltési elem űrlap segítségével Az adatok feldolgozását közvetlenül az egyes adatbetöltési elemekből is elvégezheti. A feldolgozni kíván adatbetöltési elemekhez egy-egy adatfájl csatolható. Ha a feldolgozás befejeződött, értékelje ki a feldolgozási történetet és a feldolgozási hibanaplót, hogy lássa, betöltésre került-e az adatfájlból származó rekord. Az alábbi ábra a folyamatot szemlélteti:
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
51
TRIRIGA Adatbetöltés-kezelő
Adatcsatlakozási feladatok
Integrációs objektumok
1:M Integration Object Példány(ok)
1:M Integrációs példány Hibarekord(ok)
Táblázatok előállítása az Adatbetöltés-kezelő eszközben Adatbetöltési táblázatok előállításával gyűjtheti be és érvényesítheti a TRIRIGA rendszerben használni kívánt adatbetöltési készleteket. Az adatbetöltési táblázatok a következő funkciókat szolgálják: v Egyéni táblázat biztosítása az adatbetöltési készlet számára a külső adatok rendszerezése és érvényesítése céljából, mielőtt azok feltöltésre kerülnek a TRIRIGA rendszerbe. v Meglévő rekordok exportálása az adatbetöltési táblázat segítségével a TRIRIGA rendszerből. Ez a használati mód lehetővé teszi a meglévő rekordok érvényesítését a feltölteni kívánt külső adatokkal. A következő ábra azt szemlélteti, hogy az Adatbetöltés-kezelő eszköz segítségével miként állíthatja elő az adatbetöltési táblázatokat. TRIRIGA Adatbetöltés-kezelő
Adatbetöltés táblázat a következővel: / exportált adatok nélkül
Adatbetöltési készlet
1:M Adatbetöltési elem(ek)
52
© Copyright IBM Corp. 2011, 2015
Dokumentumkezelő
Adatbetöltés táblázatsablon termékkel együtt szállított
Adatbetöltési táblázatok létrehozása Előállíthat egy olyan táblázatot, amely a külső adatok rendszerezése és érvényesítése céljából testreszabásra kerül az adatbetöltési készlet számára, mielőtt megtörténne az adatok betöltése a TRIRIGA rendszerbe. Előállíthat továbbá egy olyan táblázatot is, amely a már a TRIRIGA rendszerben található meglévő rekordokat tartalmazza.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Adatbetöltés-kezelő > Adatbetöltési készletek menüpontra. 2. Nyissa meg azt az adatbetöltésikészlet-rekordot, amely számára táblázatot kíván létrehozni. 3. Ha meglévő rekordokat kíván a TRIRIGA rendszerből a táblázatba exportálni, akkor jelölje be az Adatok exportálása jelölőnégyzetet az űrlap Adatbetöltési táblázat létrehozása szakaszában. Az adatok nem kerülnek exportálásra a következő állomásoztatásitábla-oszlopokba: DC_... (kivéve: DC_PATH), Adatcsatlakozási intelligens szakasz (az Adatcsatlakozás által használt tulajdonság Adatmodellező eszközbeli bejelölése esetén kerül előállításra), ..._UOM (mértékegység) és ..._UOMTYP (mértékegységtípus). Ezen állomásoztatásitábla-oszlopok az adatok TRIRIGA rendszerbeli feltöltésére használhatók. 4. Kattintson a Mentés, majd a Létrehozás gombra. 5. A táblázat megtekintéséhez a Táblázatfájl mezőben kattintson a Tartalom megjelenítése lehetőségre.
Eredmények A táblázat megtekintésekor az adatbetöltési készlet által hivatkozott minden egyes üzleti objektum a következő lapokkal rendelkezik a táblázatban: Áttekintés A makróleírásokat és a naplózás konfigurációs adatait tartalmazza. Osztályozások Az osztályozási adatok tárolására szolgál. Listák A listaadatok tárolására szolgál. Helymeghatározók A helymeghatározó adatok tárolására szolgál. Objektumhierarchia A hierarchikus adatokkal kapcsolatos információk tárolására szolgál. Mezők A mezőszintű metaadatok tárolására szolgál. Adat
A munkalapok oszlopfejlécei az adatbetöltési készlet által hivatkozott integrációs objektumok adatleképezésében megadott mezőknek felelnek meg.
Adatbetöltési táblázatok érvényesítési makrói Az adatbetöltési táblázat sablonja makrók készletét foglalja magában, amelyet az üzletiobjektum-adatok érvényesítése céljából futtathat, mielőtt elvégzi az adatok IBM TRIRIGA rendszerbe való betöltését. Az érvényesítési makrók futtatása adatfeltételek ellenőrzését hajtja végre. A táblázat létrehozásakor letöltheti a fájlt, beviheti az adatokat, majd futtathatja az alábbi táblázatban azonosított makrók bármelyikét:
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
53
16. táblázat: Táblázatérvényesítési makrók
54
Makró
Billentyűparancs
Futtatás helye
Leírás
ValidateDataSheet
Ctrl-Shift-V
Mező- vagy adatmunkalap
A munkafüzet egyetlen munkalapján lévő adatokat érvényesíti. A megfelelő munkalapon megadott adatok érvényesítéséhez a mezők munkalapját veszi igénybe. Minden megadott feltétel ellenőrzésre kerül. A részletes hibaüzenetek a munkalap VALIDATION_ERRORS oszlopához és a naplófájlhoz egyaránt hozzáadásra kerülnek. A munkalap számára a rendszer automatikusan előállít egy tabulátorral tagolt értékeket tartalmazó fájlt.
ValidateAllDataSheets
Ctrl-Shift-A
Minden munkalap
A munkafüzet valamennyi munkalapján érvényesíti az adatokat.
ClearAllValidationErrors Ctrl-Shift-C
Minden munkalap
Törli a minden munkalap VALIDATION_ERRORS oszlopában tárolt hibaüzeneteket.
GenerateTextFile
Adatmunkalap
Az adatok munkalapja számára tabulátorral tagolt értékeket tartalmazó szövegfájlt állít elő. Az Áttekintés munkalapon megadott drive és path paraméter a fájl helyének meghatározásához kerül felhasználásra. A fájlok alapértelmezett helye a C:\TRIRIGA mappa. Ha a mappa nem létezik, akkor a rendszer létrehozza azt. Az előállított fájl az adatok TRIRIGA rendszerbe való betöltésére használható. Az előállított fájl a következő elnevezési formátumot követi: Üzleti_objektum_neve.txt.
© Copyright IBM Corp. 2011, 2015
Ctrl-Shift-T
16. táblázat: Táblázatérvényesítési makrók (Folytatás) Makró
Billentyűparancs
Futtatás helye
Leírás
GenerateDCPathAllSheetsCtrl-Shift-G
Minden munkalap
DC_PATH értékeket állít elő a munkafüzet minden adatmunkalapja számára. A DC_PATH_PARENT mező segítségével állítja elő a DC_PATH értékeket. A DC_PATH_PARENT mező azonosítja a szülőrekord nevét a szülőmunkalap TRINAMETX mezőértéke segítségével. A hierarchia-útvonalon található valamennyi rekordot bele kell foglalni a táblázatba a DC_PATH előállításához. A megfelelő mezőmunkalap Szülők sora kerül felhasználásra azon munkalapok meghatározásához, ahol a DC_PATH_PARENT oszlop értékének megfelelő TRINAMETX értéket keresni kell. Az Objektumhierarchia munkalap azonosítja a hierarchia gyökérrekordját.
HideFieldSheets
Ctrl-Shift-H
Minden munkalap
Minden mezőmunkalapot elrejt a munkafüzetben.
UnHideFieldSheets
Ctrl-Shift-U
Minden munkalap
Minden elrejtett mezőmunkalapot felfed a munkafüzetben.
Mező- vagy adatmunkalap
Minden dátummező értékét UNIX időmeghatározó számértékké alakítja át, amely az 1970. január 1. óta eltelt ezredmásodpercek számaként ábrázolja a dátumot.
ConvertDateToUnixFormat Ctrl-Shift-E
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
55
16. táblázat: Táblázatérvényesítési makrók (Folytatás) Makró
Billentyűparancs
ConvertUnixFormatToDate Ctrl-Shift-D
Futtatás helye
Leírás
Mező- vagy adatmunkalap
Minden olyan dátummező értékét átalakítja a neki megfelelő dátumértékre, amely UNIX időmeghatározó számértékeket tartalmaz, azaz az 1970. január 1. óta eltelt ezredmásodpercek számát.
A következő táblázat az adatérvényesítési makrók futtatásakor ellenőrzött feltételek részleteit mutatja be: 17. táblázat: A táblázatérvényesítési makrók által ellenőrzött feltételek
56
Feltétel
Makró leírása
Kötelező mező
Ha a mezők munkalapján szereplő Kötelező tulajdonság true (igaz) értékre van beállítva, akkor a makró ellenőrzi, hogy a megfelelő adatmunkalapon ezen mező minden értéke nullértéktől eltérő-e.
Numerikus mezőtípus
Ellenőrzi, hogy a megfelelő adatmunkalapon ezen mező minden értéke számértéket tartalmaz-e.
Dátum adattípus
Ellenőrzi, hogy a megfelelő adatmunkalapon ezen mező minden értéke érvényes dátum- vagy időmeghatározó értékeket tartalmaz-e, azaz 0-nál nagyobb számértékeket.
Logikai adattípus
Ellenőrzi, hogy a megfelelő adatmunkalapon ezen mező minden értéke logikai értéket tartalmaz-e. A makró kisbetűssé alakítja át az oszlop értékét, majd ellenőrzi, hogy az true (igaz) vagy false (hamis) értékű-e.
Létezik az osztályozáskikeresési oszlop
Ellenőrzi, hogy az Osztályozások munkalap tartalmaz-e olyan fejlécértékkel rendelkező oszlopot, amely megegyezik a Mezők munkalapon szereplő Osztályozás értékkel.
Osztályozásérték
Ellenőrzi, hogy az adatmunkalapon szereplő mezőérték megegyezik-e az Osztályozások munkalap megfelelő oszlopában lévő értékek egyikével.
Létezik a listakikeresési oszlop
Ellenőrzi, hogy a Listák munkalap tartalmaz-e olyan fejlécértékkel rendelkező oszlopot, amely megegyezik a Mezők munkalapon szereplő listaértékkel.
Listaérték
Ellenőrzi, hogy az adatmunkalapon szereplő mezőérték megegyezik-e a Listák munkalap megfelelő oszlopában lévő értékek egyikével.
Szövegmező hossza
Ellenőrzi, hogy ezen mező bármely értéke meghaladja-e a mezőméret számára megadott méretet. Ha a mezőméret értéke üres, akkor az érvényesítésre nem kerül sor.
© Copyright IBM Corp. 2011, 2015
17. táblázat: A táblázatérvényesítési makrók által ellenőrzött feltételek (Folytatás) Feltétel
Makró leírása
Létezik a helymeghatározómező-kikeresési oszlop Ellenőrzi, hogy a Helymeghatározók munkalap tartalmaz-e olyan fejlécértékkel rendelkező oszlopot, amely megegyezik a Mezők munkalapon szereplő helymeghatározó-értékkel. Helymeghatározómező-érték
Ellenőrzi, hogy az adatmunkalapon szereplő mezőérték megegyezik-e a Helymeghatározók munkalap megfelelő oszlopában lévő értékek egyikével.
Állomásoztatásitáblakulcs-mező
Ha az állomásoztatásitábla-kulcs értéke true (igaz) a Mezők munkalap legalább egy mezője esetében, akkor a makró az adott mezők segítségével előállítja az egyes sorok egyedi kulcsát az adatmunkalapon, valamint azonosítja az ismétlődő kulcsot tartalmazó sorokat.
Szülőhierarchia
Ellenőrzi, hogy az adatmunkalap DC_PATH értékei megadásra kerültek-e a szülő adatmunkalapok egyikén. A szülő adatmunkalapokat a megfelelő mezőmunkalap Szülők sora azonosítja. Az Objektumhierarchia munkalap azonosítja a hierarchia legfelső szintjét.
Ismétlődő útvonalak
Ellenőrzi az adatmunkalap összes rekordját, és azonosítja azt a helyzetet, amikor a sor a rekord betöltéséhez használttal azonos DC útvonallal rendelkezik.
A következő táblázat az adatbetöltési táblázat Mezők munkalapján szereplő tulajdonságok részleteit mutatja be: 18. táblázat: Az adatbetöltési táblázat Mezők munkalapján szereplő tulajdonságok Tulajdonság neve
Tulajdonság leírása
Adatmunkalap oszlopa
Az adatmunkalapon található megfelelő fejlécoszlop nevét azonosítja.
Mezőtípus
A TRIRIGA adattípust azonosítja.
Mező mérete
A szövegmezők maximális méretét azonosítja. Az érték minden egyéb mező esetében üres.
Osztályozás
Az osztályozás nevét és az egyedi azonosítót határozza meg. A formátum: osztályozás_neve:azonosító.
Lista
A lista egyedi azonosítóját határozza meg.
Kötelező
A true (igaz) érték megadása a mező kötelező jellegére utal.
Állomásoztatásitábla-kulcs
A true (igaz) érték megadása a mező állomásoztatásitábla-kulcs jellegére utal.
Helymeghatározó
A helymeghatározó nevét és az egyedi azonosítót határozza meg. A formátum: helymeghatározó_neve:azonosító.
Szülők
Az adott üzleti objektum valamennyi lehetséges szülőűrlapját azonosítja. Csak akkor érhetők el itt értékek, ha a modul hierarchikus adatokat tartalmaz.
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
57
Mintaadatok feldolgozása és betöltése az Adatbetöltés-kezelő eszközzel A mintaként biztosított adatbetöltési készletek és integrációs objektumok a TRIRIGA rendszerrel együtt kerülnek szállításra. A minták módosításával a földrajzielhelyezkedés-, hely-, szervezet-, személy-, specifikáció- és eszköz-portfólióadatok tölthetők be. Minden adatbetöltésikészlet-minta több integrációsobjektum-mintára hivatkozik. Minden egyes integrációs objektum tartalmaz egy fejlécadatokkal ellátott mintaadatfájlt, valamint néhány mintaadatsort, amely megfelel az adatok leképezésének. Az Adatcsatlakozási feladatok és munkafolyamatok szintén megtalálhatók bennük az egyes adattípusokhoz.
Mintaadatok feldolgozása Feldolgozhatja a TRIRIGA rendszerrel szállított adatbetöltési mintákat. Ezután az Adatbetöltés-kezelő eszközben elérhető Adatbetöltési készletek alkalmazás segítségével töltheti be ezeket a mintaadatokat.
Mielőtt elkezdené A mintaadatok betöltéséhez először fel kell dolgoznia a termék által tartalmazott adatbetöltési mintákat.
Eljárás 1. “A mintaadatok beállítása”: a termékkel szállított betöltési készletek és integrációs objektumok, valamint az Adatmodellező eszköz használata az állomásoztatási táblák beállításához. 2. “Az adatforrás módosítása” oldalszám: 59: a helyi TRIRIGA adatbázis hitelesítési adatainak befoglalása. 3. “Adatbetöltési módosítások megvalósítása” oldalszám: 59: a TRIRIGA rendszerbe betölteni kívánt adatbetöltési elemek esetében. 4. “Mintaadatok betöltése” oldalszám: 59: az Adatbetöltési készletek alkalmazás segítségével.
A mintaadatok beállítása Beállíthatja a termékkel szállított adatbetöltési készletek és integrációs objektumok mintáit, valamint az Adatmodellező eszköz segítségével konfigurálhatja az állomásoztatási táblákat.
Mielőtt elkezdené Ha biztosítani kívánja az állomásoztatási táblákból származó mintaadatok Adatcsatlakozási ügynök általi hatékony betöltését, akkor a TRIRIGA alkalmazáskiszolgáló-adminisztrátora a TRIRIGAWEB.properties fájl szerkesztésével állítsa be a következő tulajdonságot: DATACONNECT_SLEEP_TIME = -10. A tulajdonság módosításával arra konfigurálja az Adatcsatlakozási ügynököt, hogy a legrövidebb támogatott időköznek megfelelően - 10 másodpercenként - ellenőrizze a mintaadatokat.
Eljárás 1. Lépjen át az Eszközök > Tervezőeszközök > Adatmodellező menüpontra. 2. Állítsa be a feldolgozni kívánt egyes integrációs objektumokat. a. Válassza ki a társított üzleti objektumot. b. Az Adatmodellező ablakában válassza az Eszközök > Üzleti objektum felülvizsgálata lehetőséget. A társított üzleti objektum módosításához állítsa Adatcsatlakozás értékre az Állomásoztatási tábla tulajdonságot, majd végezze el az üzleti objektum mentését.
58
© Copyright IBM Corp. 2011, 2015
c. A Mezőlista elemei közül azonosítsa és válassza ki az állomásoztatási táblához hozzáadni vagy onnan eltávolítani kívánt üzletiobjektum-mezőket. Minden egyes mező esetében jelölje be az Állomásoztatásitábla-mező tulajdonságot, illetve távolítsa el annak jelölését. d. Az üzleti objektum közzététele, valamint az állomásoztatási tábla létrehozása vagy módosítása érdekében az Adatmodellező ablakában válassza az Eszközök > Üzleti objektum közzététele lehetőséget.
Az adatforrás módosítása Az adatforrás módosításával befoglalhatja a helyi TRIRIGA adatbázishoz kapcsolódó hitelesítési adatokat.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Adatbetöltés-kezelő > Adatforrások menüpontra. 2. Válassza ki a DB-DataLoad adatforrást, majd módosítsa az adatbázis hitelesítési adatait. 3. Válassza az Adatbázis-kapcsolat tesztelése hivatkozást, amellyel ellenőrizheti, hogy a módosított hitelesítési adatokkal sikeresen tud-e csatlakozni az adatbázishoz. 4. A módosítások jelenlegi adatforrásra és az ezen adatforrást meghatározó meglévő integrációs objektumokra való alkalmazásához végezze el a mentés és bezárás műveletét.
Adatbetöltési módosítások megvalósítása Módosíthatja a TRIRIGA rendszerbe betölteni kívánt adatbetöltési elemeket. A módosítás az adatforrások, adatleképezések és -fájlok megváltoztatását is magában foglalhatja.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Adatbetöltés-kezelő > Adatbetöltési készletek menüpontra. 2. 3. 4. 5. 6.
Válassza ki a módosítani kívánt adatbetöltési készletet. Vegye fel vagy távolítsa el az adatbetöltési elemeket az adatbetöltési készletből. Válassza ki a módosítani kívánt adatbetöltési elemet. Az adatbetöltési elem módosításához válassza az Integrációs objektum mezőt. Az állomásoztatási tábla létezésének ellenőrzéséhez az integrációsobjektum-űrlap Adatforrás szakaszában válassza az Adatbázis-kapcsolat tesztelése hivatkozást.
7. Az Adatleképezés lapon vegyen fel vagy távolítson el mezőket. 8. Végezze el az integrációs objektum mentését és bezárását. 9. Az adatbetöltésielem-űrlap Részletek lapján töltse le és módosítsa az Adatfájl mezőben tárolt fájlt. 10. Töltse fel a módosított fájlt.
Mintaadatok betöltése Az Adatbetöltési készletek alkalmazás segítségével elvégezheti a mintaadatok - köztük a földrajzielhelyezkedés-, hely-, szervezet-, személy-, specifikáció- és eszköz-portfólióadatok betöltését.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Adatbetöltés-kezelő > Adatbetöltési készletek menüpontra. 2. Válassza ki a feldolgozni kívánt integrációs objektumokat tartalmazó adatbetöltési készletet. 3. Válassza ki a feldolgozás típusát.
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
59
4. Az adatbetöltési készletben található integrációs objektumok végrehajtása érdekében kattintson a Feldolgozás lehetőségre.
Mi a következő lépés? A mintaadatok betöltésével kapcsolatban további információk lekérdezése érdekében tegye a következőket: v Az egyes adatbetöltési elemek frissített státuszának megjelenítéséhez frissítse az Adatbetöltési elemek szakaszt. v A részletes feldolgozási státusz megtekintéséhez frissítse a feldolgozási történet szakaszát. Amikor legalább egy rekord sikeresen betöltésre került az állomásoztatási táblába, létrejön egy Adatcsatlakozási feladat, az Adatcsatlakozási ügynök pedig feldolgozza a rekordokat. v A feldolgozott feladatok listájának megtekintéséhez válassza az Adatcsatlakozási feladatok lapot. Ennek alternatívájaként az Adminisztrátori konzol segítségével jelenítse meg a feladat státuszát. v Az érvényesítés során azonosított esetleges hibák megtekintéséhez válassza a Feldolgozási hibanapló lapot.
Portfólió-mintaadatok A TRIRIGA rendszer mintaadatokat kínál az adatbetöltési készletek és az integrációsobjektum-portfóliók számára, amelyeket az Adatbetöltés-kezelő eszközben vehet igénybe. A következő táblázat az adatbetöltési készletek és integrációsobjektum-portfóliók számára rendelkezésre álló mintaadatok részleteit mutatja be: 19. táblázat: Integrációsobjektum-portfóliók mintaadatai Adatbetöltési készlet neve
Adattípus
Integrációs objektum neve
Földrajzi elhelyezkedés
Világrégiók
DC - Geography triWorldRegion
Országok
DC - Geography - triCountry
Államok
DC - Geography - triState
Régiók
DC - Geography - triRegion
Nagyvárosi területek
DC - Geography triMetropolitanArea
Megyék
DC - Geography - triCounty
Városok
DC - Geography - triCity
Ingatlan
DC - Location - triProperty
Épületek
DC - Location - triBuilding
Telek
DC - Location - triLand
Emeletek
DC - Location - triFloor
Terület
DC - Location - triSpace
Saját cég
DC - Organization triMyCompany
Divíziók
DC - Organization - triDivision
Részlegek
DC - Organization triDepartment
Külső cégek
DC - Organization triExternalCompany
Hely
Szervezet
60
© Copyright IBM Corp. 2011, 2015
19. táblázat: Integrációsobjektum-portfóliók mintaadatai (Folytatás) Adatbetöltési készlet neve
Személyek
Specifikáció
Eszköz
Adattípus
Integrációs objektum neve
Munkacsoportok
DC - Organization triWorkGroup
Alkalmazottak
DC - triPeople - triEmployee
Tanácsadók
DC - triPeople - triConsultant
Külső kapcsolattartók
DC - triPeople triExternalContact
Épületberendezés
DC - triSpecification triBuildingEquipmentSpec
Fogyóeszközök
DC - triSpecification triConsumablesSpec
Szerelvények
DC - triSpecification triFixtureSpec
Élelmezésiszolgáltatásberendezés
DC - triSpecification triFoodServiceEquipmentSpec
Bútorok
DC - triSpecification triFurnitureSpec
Irodai berendezések
DC - triSpecification triOfficeEquipmentSpec
Értékesítésipont-berendezés
DC - triSpecification triPointofSaleEquipmentSpec
Biztonság
DC - triSpecification triSecurityEquipmentSpec
Szolgáltatások
DC - triSpecification triServicesSpec
Területszabványok
DC - triSpecification triSpaceStandardSpec
Technológia
DC - triSpecification triTechnologyAssetsSpec
Telefonok
DC - triSpecification triTelephoneSpec
Szerszámok és vizsgálati berendezések
DC - triSpecification triToolsandTestEquipmentSpec
Járművek
DC - triSpecification triVehicleSpec
Munkaterületi csatlakozók
DC - triSpecification triWorkAreaOutletsSpec
Épületberendezés
DC - triAsset triBuildingEquipment
Szerelvények
DC - triAsset - triFixture
Élelmezésiszolgáltatásberendezés
DC - triAsset triFoodServiceEquipment
Bútorok
DC - triAsset - triFurniture
Irodai berendezések
DC - triAsset triOfficeEquipment
Értékesítésipont-berendezés
DC - triAsset triPointofSaleEquipment
3. fejezet Adatok integrálása a TRIRIGA rendszer Adatbetöltés-kezelő eszközével
61
19. táblázat: Integrációsobjektum-portfóliók mintaadatai (Folytatás) Adatbetöltési készlet neve
Területkezelési társítások
62
© Copyright IBM Corp. 2011, 2015
Adattípus
Integrációs objektum neve
Biztonság
DC - triAsset triSecurityEquipment
Technológia
DC - triAsset triTechnologyAssets
Telefonok
DC - triAsset - triTelephones
Szerszámok és vizsgálati berendezések
DC - triAsset triToolsandTestEquipment
Járművek
DC - triAsset - triVehicles
Munkaterületi csatlakozók
DC - triAsset triWorkAreaOutlets
Társítás
DC - Társítás triSpaceAllocation triSpaceLevelAllocation Lefoglal – Helymeghatározók
Társítás
DC - Társítás - triPeople triEmployee - Elsődleges hellyel\szervezettel rendelkezik Intelligens szakasz
Társítás
DC - Társítás Adatsegédprogramok triPeopleReportsToDTO Jelentések a következőnek DTO
Nyilatkozatok Ezek az információk az Egyesült Államokban forgalmazott termékekre és szolgáltatásokra vonatkoznak. 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 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 Armonk, NY 10504-1785 U.S.A. Ha duplabyte-os (DBCS) információkkal kapcsolatban van szüksége licencre, akkor lépjen kapcsolatban az országában az IBM szellemi tulajdon osztállyal, 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 A következő bekezdés nem vonatkozik az Egyesült Királyságra, valamint azokra az országokra, amelyeknek jogi szabályozása ellentétes a bekezdés tartalmával: 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 államok 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, 2015
63
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 Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. 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 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 más gyártótól származó 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 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 üzleti vállalkozások neveivel és címeivel 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 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.
Adatvédelmi szempontok 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
64
© Copyright IBM Corp. 2011, 2015
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/hu/hu/), az IBM online adatvédelmi tájékoztató (http://www.ibm.com/privacy/details/hu/hu/) "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.
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. A jelenlegi IBM védjegyek felsorolása a “Copyright and trademark information” oldalon tekinthető meg a www.ibm.com/legal/copytrade.shtml címen. 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.
Nyilatkozatok
65
66
© Copyright IBM Corp. 2011, 2015
Nyomtatva Dániában