3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel. . 31 GIS térképek áttekintése . . . . . . . . . . Esri adatszolgáltatások és IBM TRIRIGA eszközök .
1. fejezet Adatok integrálása külső alkalmazásokkal Az IBM® TRIRIGA Application Platform Connector eszközök segítségével az IBM TRIRIGA adatbázisból származó adatok importálását, frissítését vagy exportálását, illetve az adatok IBM TRIRIGA alkalmazásokban történő hivatkozását, valamint az alkalmazásokkal való megosztását hajthatja végre. Ezek az eszközök a következőket foglalják magukban: TRIRIGA integrációs objektum, IBM TRIRIGA Connector for Esri Geographic Information System (GIS), IBM TRIRIGA Connector for Business Applications, IBM TRIRIGA DataConnect, IBM TRIRIGA Data Integrator és OSLC integráció.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal A TRIRIGA integrációs objektum egy olyan üzleti segédobjektum a triIntegration modulban, amely az IBM TRIRIGA és a külső rendszerek közötti integrációt vezérlő metaadatokat foglalja magában. Amikor a TRIRIGA integrációs objektummal hoz létre integrációmeghatározásokat, akkor általános IBM TRIRIGA eszközökkel, például munkafolyamatokkal és lekérdezésekkel állíthat össze integrációs kapcsolatokat.
A TRIRIGA integrációs objektum áttekintése Amikor az integrációs objektum segítségével megad egy új integrációmeghatározást, ki kell választania az adatsémát. A sémaválasztástól függően több elemet, köztük az adatforrást, az import- vagy exportfájlt, a kimenő lekérdezést, az adat- vagy válaszleképezést is meg kell határoznia.
Integrációs objektum rekordok Új integrációmeghatározás megadásához létre kell hoznia egy integrációs objektum rekordot a TRIRIGA integrációs objektumból. A meglévő integrációs objektum rekordok megtekintéséhez kattintson az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum lehetőségre.
Adatsémák Amikor új integrációmeghatározásokat ad meg, számos beállítás vagy séma közül kell választania az adatokhoz tartozó hasznos tartalom, protokoll és szállítás meghatározásához. Az adatbázisséma adatbázistáblákat használ az adatok importálásához vagy exportálásához. A fájlséma segítségével fájlokkal végezheti el az adatok importálását vagy exportálását. A DataConnect séma a fájlokat DataConnect állomásoztatási táblákba importálja. A HTTP POST séma az adatok exportálását a HTTP protokollal hajtja végre.
Adatbázisséma A bejövő adatbázisséma kiválasztásakor meg kell határoznia az adatforrást és az adatleképezést. Az adatleképezés a külső forrásból származó adatok meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra. A kimenő adatbázisséma kiválasztásakor meg kell határoznia az adatforrást és a kimenő lekérdezést. A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál.
Fájlséma A bejövő fájlséma kiválasztásakor meg kell határoznia az importfájlt és az adatleképezést. Az adatleképezés a külső forrásból származó adatok meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra. A kimenő fájlséma kiválasztásakor meg kell határoznia az exportfájlt és a kimenő lekérdezést. A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál.
DataConnect séma A bejövő IBM TRIRIGA DataConnect séma kiválasztásakor meg kell határoznia az adatforrást, az importfájlt, a DataConnect feladatot, valamint az adatleképezést. Az adatforrás a DataConnect állomásoztatási táblák eléréséhez kerül felhasználásra. Az adatleképezés a fájlból származó adatok DataConnect állomásoztatási táblákra való leképezésére szolgál. Ezen séma segítségével munkafolyamatokkal tudja feldolgozni és érvényesíteni az adatokat, ami nagyobb fokú felügyeletet biztosít a hibák kezeléséhez. A DataConnect további információiért forduljon az Alkalmazáskészítés az IBM TRIRIGA Application Platform 3-as változatában: Adatkezelés című kiadványhoz.
HTTP POST séma Amikor a kimenő HTTP POST sémát választja, akkor meg kell határoznia azt a kiszolgálót, amelyre az adatok elküldésre kerülnek, a kimenő lekérdezést, valamint a válaszleképezést. A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál. A válaszleképezés a HTTP kérésből származó válaszparaméterek meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra.
Adatbáziseszközök Amikor kiválasztja az adatbázis- vagy a DataConnect sémát, végrehajthatja az adatbázis-kapcsolat tesztelését, a tesztadatok előállítását vagy az adatbázistábla SQL kódjának elkészítését. A nagy bináris objektummezők exportálásához dinamikus kimenő lekérdezést kell igénybe vennie.
Az adatbázis-kapcsolat tesztelése Az Adatbázis-kapcsolat tesztelése művelet segítségével ellenőrizheti, hogy a kiszolgáló képes kommunikálni az adatbázissal. A táblanév egy select 1+1 from [tábla_neve] lekérdezés adatbázisban való futtatásához kerül felhasználásra. Az Adatbázis szakaszfejléc színe hiba esetén vörösre változik. A hibák megtekintéséhez vizsgálja felül az IBM TRIRIGA adminisztrátori konzolon elérhető kiszolgálónaplókat. Az Adminisztrátori konzollal kapcsolatos információkért forduljon az IBM TRIRIGA Application Platform 3 Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz.
A DataConnect séma számára szükséges táblahozzáférés A DataConnect séma elkülönül az IBM TRIRIGA rendszer belső alkalmazásprogramozási felületeitől, és az IBM TRIRIGA Connector for Business Applications segítségével kommunikál a TRIRIGA rendszerrel. A DataConnect séma teszi lehetővé az adatbázis táblavizsgálat, -olvasás és -írás céljából történő elérését. A DataConnect séma a következő táblákhoz igényel hozzáférést. A DC_JOB és az S_ tábla kivételével a rendszer az alábbi táblákat használja a DataConnect objektumok számára rendelkezésre álló oszlopok meghatározásához. Ugyanezen táblákhoz olvasási képességnek kell társulnia az adatforrásnál kiválasztott felhasználó esetében. IBS_SPEC_TYPE_STAGE Olvasási hozzáférés. IBS_SPEC_TYPE Olvasási hozzáférés. SYS.COLUMNS (Microsoft SQL Server) Olvasási hozzáférés.
Általános SQL kód létrehozása A Tábla SQL kódjának előállítása művelet segítségével általános SQL kódot hozhat létre az adatbázistábla meghatározása céljából. Mielőtt kiválasztja ezt a műveletet, adja meg az adatbázistábla nevét és végezze el az adatleképezést. A bejövő integrációkhoz használt valamennyi táblának rendelkeznie kell a következő oszlopokkal: IMD_ID A tábla minden bejegyzése esetén egyedi tranzakcióazonosító. Ez az azonosító nem azonos a rekordazonosítóval. IMD_STATUS A tábla egyes bejegyzéseinek státuszát azonosítja. Az alapértelmezett Kész státusz feldolgozandó rekordokat azonosít. Az egyéb állapotok közé tartozik a Feldolgozás alatt, a Befejeződött és a Meghiúsult státusz. IMD_MESSAGE A sor importálása közben felmerült esetleges hibákat azonosítja. Ugyanezek a hibaüzenetek az Integrációs objektum űrlapon is megjelennek. TRIRIGA_RECORD_ID Az IBM TRIRIGA rendszer által a frissítés vagy létrehozás alatt álló rekord azonosításához használt belső rekordazonosító. A következő kódminta a személyrekord előző mezőkkel rendelkező bejövő integrációja számára került előállításra. -- MSSQL rendszer számára automatikusan előállított parancsfájl. CREATE TABLE example_people_in ( IMD_ID NUMERIC (18, 0) IDENTITY(1,1) NOT NULL, IMD_STATUS VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null DEFAULT ’Kész’, IMD_MESSAGE VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null, TRIRIGA_RECORD_ID VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null, TRI_ID VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null, FIRST_NAME VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null, LAST_NAME VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null, LANGUAGE VARCHAR(1000) COLLATE SQL_Latin1_General_CP1_CS_AS null )
Tesztadatok létrehozása A Tesztadatok előállítása művelet kiválasztásával tesztadatokkal töltheti fel az adatbázist. Ez a művelet csak a bejövő irány esetén érhető el. Miután létrehozta az adatbázistáblát és képes csatlakozni, betöltheti a tesztadatokat az adatbázisba. A tesztadatok felhasználásával egyszerű funkcionális tesztelést végezhet, hogy meggyőződjön a leképezések helyességéről, valamint az integrációs folyamat megfelelő működéséről. A Tesztsorok mezőben adja meg az adatbázistáblába beszúrni kívánt sorok 2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
5
számát. Az adatok alfanumerikus értékekként kerülnek előállításra. Ha megad egy alapértelmezett értéket az adatleképezésében, akkor a kérdéses érték minden sor esetében beszúrásra kerül. Ez az alapérték akkor hasznos, amikor előfordulhat, hogy a mező helymeghatározó, szám- vagy dátummező, illetve egy adott értéket igénylő lista. Ha egy külső rendszer segítségével tölti fel az állomásoztatási adatbázist, akkor a külső rendszernek csak a metaadatmezőktől eltérő mezőket kell feltöltenie. Az IMD_* oszlopok feltöltése automatikusan megtörténik. Miután a rekord frissítésre vagy létrehozásra került, a TRIRIGA_RECORD_ID tartalmazza a rekordot az IBM TRIRIGA rendszeren belül azonosító rekordazonosítót.
Nagy bináris objektumok (BLOB) támogatása A BLOB objektumok a bejövő és kimenő adatbázissémák esetén egyaránt támogatottak. A támogatott BLOB típusok közé tartoznak a bináris és megjegyzésmezők, valamint a Dokumentumkezelő tartalma. A rendszer nem támogatja a képmezőket. A BLOB mezők exportálásához adatleképezést kell használnia dinamikus kimenő lekérdezésként. A Dokumentumkezelő eszköz objektumainak importálása vagy exportálása során nem léteznek tényleges értékek az objektumhoz tartozó dokumentum bináris tartalma számára. Ehelyett válasszon ki egy tetszőleges, a tartalom helyőrzőjeként használni kívánt alapobjektum-oszlopot, például egy szövegmezőt az Általános szakaszban. A külső név tetszőleges lehet, de az Alapértelmezett oszlopban a CONTENT értéknek kell szerepelnie. Ez az érték az aktiváló, amely a tartalomhoz kapcsolja a Dokumentumkezelő objektumot.
Fájleszközök A fájl- vagy a DataConnect séma kiválasztásakor tesztelheti a fájlkapcsolatot. Az adatok beolvasását és kiírását a hálózat minden olyan pontján elvégezheti, amelyhez a kiszolgáló rendelkezik hozzáféréssel.
Bejövő integrációk Bejövő integrációk esetén szabványosított, egymástól elválasztott értékeket tartalmazó sima szövegfájlokat importálhat. Saját kezűleg adhatja meg azon bináris mező értékét, amely az importált integrációs mező másolata. A kézi mező megadása elősegítheti a tesztelést, így a helyi feldolgozás az importfájl felülírása nélkül ismételhető meg. A fájl importálását követően a feldolgozási dátum felhasználásával átnevezésre kerül, majd a rendszer áthelyezi az a feldolgozott mappába. Ha több munkafolyamat-ügynök fut IBM TRIRIGA környezetében, akkor a kiszolgálók mindegyikének rendelkeznie kell hozzáféréssel ugyanahhoz a fájlhelyhez, vagy a fájlról készült saját másolatukhoz. Az integráció-végrehajtási folyamat során futó munkafolyamatnak el kell érnie a fájlt, attól függetlenül, hogy melyik munkafolyamat-ügynök indította el a munkafolyamatot.
Kimenő integrációk A kimenő integrációk esetén többek között olyan fájlformátumokat exportálhat, mint a szabványosított, egymástól elválasztott értékeket tartalmazó sima szövegfájlok, valamint a .json, .xml vagy .xslt fájlok.
HTTP POST jelsorok A kimenő HTTP POST séma kiválasztásakor jelsorokat adhat hozzá a HTTP URL, HTTP URI és Fejlécek mezőben szereplő értékekhez. A jelsor olyan érték, amely a HTTP kérés kimenő lekérdezési eredményeiből származik. A jelsor nevének pontosan meg kell egyeznie a lekérdezésben szereplő oszlop címkéjével. Például a kimenő lekérdezési eredményekből származó accountId (fiókazonosító) oszlopérték HTTP URI mezőhöz való hozzáadásához adja meg a /ws/account/accountId/ property karaktersorozatot a HTTP URI mezőben. Futás közben az IBM TRIRIGA rendszer állítja elő a lekérdezési eredményekben visszaadott értéket. Ha az accountId értéke 123, akkor az elküldött URI a következő lesz: /ws/account/123/property. Amikor a kötegelt kérések jelsorokkal kerülnek elküldésre, akkor az utolsó eredménysorban szereplő értékek adják meg a jelsorokat.
Kimenő lekérdezések Kimenő integrációk esetén meg kell határoznia azt a kimenő lekérdezést, amely kiválasztja az IBM TRIRIGA adatbázisból exportálásra kerülő mezőket. A kimenő lekérdezést az IBM TRIRIGA rendszer Jelentéskezelő eszközében határozhatja meg. Megadhat továbbá egy adatleképezést is dinamikus kimenő lekérdezésként.
Kimenő lekérdezések a Jelentéskezelő eszközben Amikor az IBM TRIRIGA rendszer Jelentéskezelő eszközéből származó lekérdezéssel határozza meg a kimenő lekérdezést, akkor az adatok leképezése a lekérdezés meghatározásában kerül megadásra. Az egyes mezők számára megadott jelentéscímkéknek a külső tábla nevét, az XML csomópontnevet, a címke értékét vagy a szövegmező fejlécoszlopának nevét kell képviselniük.
Adatleképezések dinamikus kimenő lekérdezésekként Amikor dinamikus lekérdezésként határozza meg a kimenő lekérdezéseket, akkor az adatok leképezése az adatleképezésben kerül megadásra. Az adatleképezés ezen kimenő felhasználásával nem képez le külső forrásból származó bejövő adatokat meglévő IBM TRIRIGA mezőkre. Ehelyett kiválasztja, hogy mely mezők kerüljenek exportálásra IBM TRIRIGA adatbázisából. Adatbázisséma Ha az adatbázisséma használata esetén nagy bináris objektumokat (BLOB) kell exportálnia, akkor ehhez dinamikus lekérdezést kell igénybe vennie. Az exportálás számára bináris és megjegyzésmezők, illetve a Dokumentumkezelő tartalommezői választhatók ki. Alapértelmezett adatok A mezők alapértelmezett adatainak meghatározásához dinamikus lekérdezést kell használnia. Ha például a HTTP POST sémát alkalmazza, akkor a dinamikus lekérdezés segítségével adhatja át a statikus paramétereket vagy értékeket. Ahhoz, hogy az alapértelmezett adatok megfelelően működjenek a dinamikus lekérdezés esetében, először az alapértelmezett adathalmazzal végre kell hajtania az adatleképezés meghatározását és mentését, majd ezután ki kell választania a Tábla SQL kódjának előállítása műveletet. Ez a művelet állítja be az új beszúrások alapértelmezett adatai esetén használandó oszlopot.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
7
Adatleképezések A bejövő integrációk esetén meg kell határoznia azt az adatleképezést, amely a külső forrásból képezi le az adatokat a meglévő IBM TRIRIGA mezőkre. A kimenő integrációk esetén azonban dinamikus kimenő lekérdezésként is megadhatja az adatleképezést az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének kiválasztásához.
Bejövő integrációk adatleképezései Az adatleképezés meghatározásakor a modult, az üzleti objektumot, az űrlapot és a mezőket kell megadnia. Miután meghatározta az adatleképezést, a rekord mentése előtt végre kell hajtania a leképezés mentését, vagy a módosítások elvesznek. Az Alapértelmezett művelet lista akkor kerül felhasználásra, ha a leképezett rekord nem található, és így létre kell azt hozni. Ha a leképezett rekord létezik, akkor az alapértelmezett művelet figyelmen kívül marad, a rekord pedig frissítésre kerül. Az Alapértelmezett művelet listán szereplő műveletek a rekord számára rendelkezésre álló, null állapotból való átmeneteket képviselik. Az adatleképezés a következő hierarchikus űrlapelemeket tartalmazza: Űrlap
Az űrlap hierarchikus ábrázolását jeleníti meg. Minden űrlap lapokból áll.
Lap
A lap hierarchikus ábrázolását jeleníti meg. Minden lap szakaszokból tevődik össze.
Grafika szakasz Nem képezhető le. Lekérdezés szakasz Nem képezhető le. Többlapos szakasz Nem képezhető le. Intelligens szakasz mező A mező azonosítási módjának meghatározása érdekében egy előugró ablakot aktivál. Az intelligensszakasz-mezők meghatározásakor az előugró ablak segítségével jelölheti ki a szűrőként használni kívánt űrlapot. Ezután ki kell választania a rekordazonosító lekéréséhez szűrőként használni kívánt mezőt. A csatolt intelligens szakasz rekordazonosítóját az IBM TRIRIGA Connector for Business Applications segítségével kell azonosítani. Helymeghatározó mező Általános mezőként viselkedik, de az integráció meghiúsul, ha az adatok nem találhatók vagy nem egyediek. Általános mező Szövegmező, amelyet a rendszer karaktersorozatként kezel. Dátummező Nem jelenik meg a hierarchiában. Ehelyett a mezőattribútumok táblája segítségével határozhatja meg a bejövő adatoknak megfelelő IBM TRIRIGA dátumformátumot. Csak olvasható mező Áthúzás jelzi őket és nem képezhetők le, kulcsmezőként azonban felhasználhatók a rekord azonosításának elősegítése érdekében. Kötelező mező Vörös betűtípus jelzi, és a rekord létrehozásához kötelező megadni. Az integráció meghiúsul, ha ez a mező nincs leképezve. Az adatleképezésben minden egyes mező a következő mezőattribútumokkal rendelkezik:
Alapszülő A hierarchikus üzleti objektumok, például a földrajzi elhelyezkedés, hely és szervezet esetén a hierarchia gyökerét azonosító elérési útvonal. Meg kell adnia az elérési útvonalat, ha biztosítani kívánja, hogy a rekord a hierarchia megfelelő gyökere alatt kerül létrehozásra. Amennyiben nem adja meg az elérési útvonalat, úgy a rekord a gyökérrel egy szinten jön létre, így nem látja azt vagy nem tud hozzáférni a rekordhoz az űrlapról. JBoss Application Server példa: \Location. Oracle WebLogic Server példa: \\Location. Típus
A mező metaadat-meghatározási típusa. A rendszer minden mezőt karaktersorozatként kezel. Példák: Lista, Szám és Szöveg.
Külső Az IBM TRIRIGA rendszerre leképezni kívánt külső mező neve. Mivel az értékeket adatbázisoszlopokhoz vagy formázott fájlokhoz lehet felhasználni, ne alkalmazzon szóközöket, speciális karaktereket vagy számokat. Példa: User_Language. A HTTP POST séma válaszleképezésében használva meghatározhat egy XPath vagy JSONPath karaktersorozatot. isKey
Azt jelzi, hogy a bejövő rekord kulcsként meghatározott mezővel rendelkezik-e. Ha igen, akkor a bejövő adatsor értéke a lekérdezett üzleti objektum szűrőjeként kerül felhasználásra, és a rendszer pontosan egy rekordazonosítót ad vissza. A rekordok IBM TRIRIGA rendszerbeli frissítéséhez a rekordazonosítóra van szükség a rekord azonosításához. Ha nem található rekordazonosító, illetve több rekordazonosító is visszaadásra kerül, akkor a rekord a sor minden értékének felhasználásával jön létre az adott sorhoz.
isParent Azt jelzi, hogy a bejövő rekord szülőként meghatározott mezővel rendelkezik-e. Ha igen, akkor a bejövő rekord értékét a rendszer szűrőként használja abban a lekérdezésben, amely a szülőhöz tartozó rekordazonosító rögzítésére szolgál. Egy másik rekord szülőrekordjának azonosításával létre lehet hozni a hierarchiát. Egy másik rekord leszármazott rekordjának azonosításához a szülő rekordazonosítóját bele kell foglalnia a rekordlétrehozási vagy -frissítési kérésbe. Amennyiben meghatározza ezt az értéket az adatleképezésben, úgy ennek a szülőazonosításnak a kezelése automatikusan történik. Ha a szülő nem található, vagy a rendszer több szülőt is visszaad, akkor egy figyelmeztető üzenet naplózására kerül sor, a rekord pedig a gyökérrel azonos szinten jön létre. Alapértelmezett A rekord valamennyi példányára alkalmazott konstans érték. Példa: Amerikai angol. Ha meghatároz egy alapértelmezett értéket, akkor a Külső érték figyelmen kívül marad, az alapértelmezett oszlopnak pedig csak ebben az adatleképezésben kell léteznie. Az alapértelmezett értéket a fájl- és a HTTP POST séma csak futás közben használja. Ha az adatbázissémát választotta, akkor az alapértelmezett érték állomásoztatási táblában történő beállítása érdekében a Tábla SQL kódjának előállítása műveletet kell választania; az érték futás közben figyelmen kívül marad.
Bejövő DataConnect integrációk adatleképezései Az adatleképezés meghatározásakor a modult, az üzleti objektumot, az űrlapot és az állomásoztatási táblát kell megadnia. Miután meghatározta az adatleképezést, a rekord mentése előtt végre kell hajtania a leképezés mentését, vagy a módosítások elvesznek. A DataConnect integrációk adatleképezése a következő kivételekkel vagy megjegyzésekkel hasonló az egyéb bejövő integrációk esetében használt adatleképezésekhez:
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
9
Modulok A modulok felsorolása az engedélyezett Állomásoztatási táblával rendelkezik tulajdonsággal ellátott üzleti objektumok moduljaira jellemző. Üzleti objektumok Az üzleti objektumok felsorolása az engedélyezett Állomásoztatási táblával rendelkezik tulajdonsággal ellátott üzleti objektumokra jellemző. Űrlapok Az Űrlapok mezőben szereplő értéket a folyamat helyes működéséhez meg kell adni. Állomásoztatási tábla Az üzleti objektum kiválasztásakor a rendszer lefuttat egy lekérdezést és megjeleníti az üzleti objektumhoz társított állomásoztatási táblából rendelkezésre álló adatbázisoszlopokat. Az Állomásoztatási tábla mező feltöltésre kerül és csak olvasható. Mezők A hierarchia az állomásoztatásitábla-mezőkként meghatározott mezőket jeleníti meg. A csak olvasható - áthúzással jelölt - mezőket az automatikus folyamat használja fel, és ezeket nem lehet leképezni. Az egyéb mezők rendelkezésre állnak. Mezőattribútumok Amikor kiválaszt egy rendelkezésre álló mezőt, a rendszer új sort ad hozzá a mezőattribútumok táblájához. A Külső attribútum alapértelmezésben az adatbázisoszlop nevét jeleníti meg, de megváltoztathatja azt, hogy megegyezzen a fájlfejléccel. Az isKey, isParent és Alapértelmezett attribútum csak olvasható, így nem kerülnek felhasználásra. Mivel az importfájlt az állomásoztatási adatbázis oszlopaira képezi le, az importfájl első sorának a Külső attribútumértékekkel megegyező oszlopokkal kell rendelkeznie. Az oszlopok sorrendje lényegtelen, de az oszlopnevekben a kis- és nagybetűk eltérőnek számítanak. Ha például az adatleképezésben szereplő Külső értékek listája a Mező1, Mező2 és Mező3 értéket tartalmazza, akkor a tényleges külső oszlopok a következők lehetnek: Mező2, Mező1 és Mező3. Ha a nevek azonosak, akkor a mezők megfelelően alkalmazhatók.
Kimenő integrációk adatleképezései Kimenő integrációk esetén meg kell határoznia azt a kimenő lekérdezést, amely kiválasztja az IBM TRIRIGA adatbázisból exportálásra kerülő mezőket. A kimenő lekérdezést az IBM TRIRIGA rendszer Jelentéskezelő eszközében határozhatja meg. Megadhat továbbá egy adatleképezést is dinamikus kimenő lekérdezésként.
Válaszleképezések A kimenő HTTP POST integrációk esetén meg kell határoznia azt a válaszleképezést, amely a HTTP kérésből származó válaszparamétereket képezi le meglévő IBM TRIRIGA mezőkre. Bár a válaszleképezés az adatleképezéshez hasonló elrendezésű, csak a HTTP POST sémára vonatkozik, és kizárólag egyszerű válaszértékek használatát teszi lehetővé.
Adatok importálása vagy exportálása adatbázistáblákkal Ha integrációja adatbázistáblákat igényel az adatok importálásához vagy exportálásához, akkor a TRIRIGA integrációs objektum segítségével meg kell határoznia az integrációt. A bejövő adatbázisséma képezi le a külső forrásból származó adatokat a meglévő IBM TRIRIGA mezőkre. A kimenő adatbázisséma határozza meg, hogy mely mezők kerülnek az IBM TRIRIGA adatbázisból exportálásra.
Adatok importálása az adatbázissémával A bejövő adatbázisséma kiválasztásakor meg kell határoznia az adatforrást és az adatleképezést. Az adatleképezés a külső forrásból származó adatok meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, az adatbázissémát, a bejövő irányt, az adatforrást, valamint az egyéb integrációs részleteket. 4. Tesztelje az adatbázis-kapcsolatot vagy állítsa elő a tesztadatokat. 5. Határozza meg az adatleképezést: adja meg a modult, az üzleti objektumot, az űrlapot és a mezőket. Végezze el az adatleképezés mentését. 6. Ha alapértelmezett adatokat határozott meg, vagy általános SQL kódot kell előállítania, akkor készítse el az adatbázistáblához tartozó SQL kódot. 7. Hozza létre, majd mentse a rekordot. 8. Hajtsa végre az integrációt. 9. Vizsgálja meg a hibákat.
Adatok exportálása az adatbázissémával A kimenő adatbázisséma kiválasztásakor meg kell határoznia az adatforrást és a kimenő lekérdezést. A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál.
Erről a feladatról A kimenő lekérdezést az IBM TRIRIGA rendszer Jelentéskezelő eszközében határozhatja meg. Megadhat továbbá egy adatleképezést is dinamikus kimenő lekérdezésként.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, az adatbázissémát, a kimenő irányt, az adatforrást, valamint az egyéb integrációs részleteket. 4. Tesztelje az adatbázis-kapcsolatot. 5. Határozza meg a kimenő lekérdezést. 6. Ha dinamikus lekérdezést választott, akkor a modul, az üzleti objektum, az űrlap és a mezők megadásával határozza meg az adatleképezést. Végezze el az adatleképezés mentését. 7. Ha alapértelmezett adatokat határozott meg, vagy általános SQL kódot kell előállítania, akkor készítse el az adatbázistáblához tartozó SQL kódot. 8. Hozza létre, majd mentse a rekordot. 9. Hajtsa végre az integrációt. 10. Vizsgálja meg a hibákat.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
11
Adatok importálása vagy exportálása fájlokkal Ha integrációja fájlokat igényel az adatok importálásához vagy exportálásához, akkor a TRIRIGA integrációs objektum segítségével meg kell határoznia az integrációt. A bejövő fájlséma képezi le a külső forrásból származó adatokat a meglévő IBM TRIRIGA mezőkre. A kimenő fájlséma határozza meg, hogy mely mezők kerülnek az IBM TRIRIGA adatbázisból exportálásra.
Adatok importálása a fájlsémával A bejövő fájlséma kiválasztásakor meg kell határoznia az importfájlt és az adatleképezést. Az adatleképezés a külső forrásból származó adatok meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, a fájlsémát, a bejövő irányt, az importfájlt, valamint az egyéb integrációs részleteket. 4. Tesztelje a fájlelérést. 5. Határozza meg az adatleképezést: adja meg a modult, az üzleti objektumot, az űrlapot és a mezőket. Végezze el az adatleképezés mentését. 6. Hozza létre, majd mentse a rekordot. 7. Hajtsa végre az integrációt. 8. Vizsgálja meg a hibákat.
Adatok exportálása a fájlsémával A kimenő fájlséma kiválasztásakor meg kell határoznia az exportfájlt és a kimenő lekérdezést. A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál.
Erről a feladatról A kimenő lekérdezést az IBM TRIRIGA rendszer Jelentéskezelő eszközében határozhatja meg. Megadhat továbbá egy adatleképezést is dinamikus kimenő lekérdezésként.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, a fájlsémát, a kimenő irányt, az exportfájlt, valamint az egyéb integrációs részleteket. 4. Tesztelje a fájlelérést. 5. Határozza meg a kimenő lekérdezést. 6. Ha dinamikus lekérdezést választott, akkor a modul, az üzleti objektum, az űrlap és a mezők megadásával határozza meg az adatleképezést. Végezze el az adatleképezés mentését. 7. Hozza létre, majd mentse a rekordot. 8. Hajtsa végre az integrációt. 9. Vizsgálja meg a hibákat.
Adatok importálása DataConnect állomásoztatási táblákba Ha integrációja ETL eszközt igényel, de nem rendelkezik azokhoz hozzáféréssel vagy nem részesült képzésben az ilyen eszközök használatával kapcsolatban, akkor a TRIRIGA integrációs objektum segítségével kell meghatároznia az integrációt. A bejövő IBM TRIRIGA DataConnect séma képezi le az importfájlból származó adatokat a DataConnect állomásoztatási táblákra.
Adatok importálása a DataConnect sémával A bejövő IBM TRIRIGA DataConnect séma kiválasztásakor meg kell határoznia az adatforrást, az importfájlt, a DataConnect feladatot, valamint az adatleképezést.
Erről a feladatról Az adatforrás a DataConnect állomásoztatási táblák eléréséhez kerül felhasználásra. Az adatleképezés a fájlból származó adatok DataConnect állomásoztatási táblákra való leképezésére szolgál. Az integráció futtatásakor a rendszer egy upsert (frissítési vagy beszúrási) művelettel illeszti be vagy frissíti a bejegyzéseket a DataConnect állomásoztatási táblákban. Legalább egy mezőt kulcsmezőként kell kiválasztania. A DataConnect eszköz a kulcsok segítségével határozza meg, hogy a sor beszúrására vagy frissítésére van-e szükség.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, a DataConnect sémát, az adatforrást, az importfájlt, valamint az egyéb integrációs részleteket. 4. Tesztelje az adatbázis-kapcsolatot. 5. Tesztelje a fájlelérést. 6. Határozza meg az adatleképezést: adja meg a modult, az üzleti objektumot, az űrlapot és a mezőket. Végezze el az adatleképezés mentését. 7. Hozza létre, majd mentse a rekordot. 8. Hajtsa végre az integrációt. 9. Vizsgálja meg a hibákat.
Adatok exportálása a HTTP protokollal Ha integrációja Hiperszöveg-átviteli protokollt (HTTP) igényel az adatok exportálásához, akkor a TRIRIGA integrációs objektum segítségével meg kell határoznia az integrációt. A kimenő HTTP POST séma képezi le a HTTP kérésből származó válaszparamétereket a meglévő IBM TRIRIGA mezőkre.
Adatok exportálása a HTTP POST sémával Amikor a kimenő HTTP POST sémát választja, akkor meg kell határoznia azt a kiszolgálót, amelyre az adatok elküldésre kerülnek, a kimenő lekérdezést, valamint a válaszleképezést.
Erről a feladatról A kimenő lekérdezés az IBM TRIRIGA adatbázisból exportálásra kerülő mezők körének meghatározására szolgál. A válaszleképezés a HTTP kérésből származó válaszparaméterek meglévő IBM TRIRIGA mezőkre való leképezéséhez kerül felhasználásra. 2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
13
A kimenő lekérdezést az IBM TRIRIGA rendszer Jelentéskezelő eszközében határozhatja meg. Megadhat továbbá egy adatleképezést is dinamikus kimenő lekérdezésként.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Integráció > Integrációs objektum menüpontra. 2. Vegyen fel egy integrációs objektum rekordot. 3. Határozza meg az integráció nevét, a HTTP POST sémát, a külső kiszolgálót, valamint az egyéb integrációs részleteket. 4. Határozza meg a kimenő lekérdezést. 5. Ha dinamikus lekérdezést választott, akkor a modul, az üzleti objektum, az űrlap és a mezők megadásával határozza meg az adatleképezést. Végezze el az adatleképezés mentését. 6. Határozza meg a válaszleképezést: adja meg a modult, az üzleti objektumot, az űrlapot és a mezőket. Végezze el a válaszleképezés mentését. 7. Hozza létre, majd mentse a rekordot. 8. Hajtsa végre az integrációt. 9. Vizsgálja meg a hibákat.
Példa: Adatok exportálása Esri geokódolási integrációkban Kiválaszthatja a kimenő HTTP POST sémát az adatok IBM TRIRIGA adatbázisból Esri kiszolgálóra való exportálásához. Ezután leképezheti a HTTP kérésből származó válaszparamétereket a helyrekordokra, hogy ezáltal elvégezze geokódjaik frissítését.
Háttér Ichiro az ABC vállalat integrációs szakértője. IBM TRIRIGA integrációkat fejleszt az ABC vállalat ügyfelei részére. Ichiro épp egy külső Esri geokódolási szolgáltatással megvalósuló kimenő HTTP POST integrációt fejleszt. A következő HTTP URL cím a REST alkalmazásprogramozási felületen (API) keresztül adja meg az Esri geokódolási szolgáltatásokat. Az Esri geokódolási szolgáltatás esetében a geokódolandó címek meghatározásához a HTTP kérésnek tartalmaznia kell adott paramétereket a lekérdezési karaktersorozatban. A válasz JSON formátumú. http://geocode.arcgis.com/arcgis/rest/services /World/GeocodeServer/findAddressCandidates
1. lépés: Az integráció adatsémájának meghatározása Ichiro a következő mezőrészletekkel határozza meg az integrációs objektum rekordot: Név
2. lépés: Az adatleképezés meghatározása Mivel Ichiro dinamikus lekérdezést választott, a Location modul, a triBuilding üzleti objektum, a triBuilding űrlap és a mezők megadásával határozza meg az adatleképezést. A Külső mezőattribútum-értékek képviselik a lekérdezési karaktersorozathoz hozzáadott paraméterneveket. Mivel az Alapértelmezett mezőattribútum nem kerül felhasználásra, a mezőadatok lekérése dinamikusan történik az IBM TRIRIGA helyrekordokból. Az alábbi mezőket határozza meg a következő Külső attribútumértékekkel: triAddressTX Address (Cím) triZipPostalTX ZIP (Irányítószám) triCityTX City (Város) triStateProvTX State (Állam) Két további mező esetében Ichiro két kiegészítő Külső értéket ad meg, amellyel az Esri geokódolási szolgáltatás számára kötelező megfelelő Alapértelmezett értékeket határozza meg. Külső értékei: outSR a WKID azonosító, illetve f a formátum számára. Az ezeknek megfelelő Alapértelmezett értékei: 102100 a WKID azonosító, illetve json a formátum esetén. Saját 102100 értéke ellenőrzése érdekében megvizsgálja a földrajzi koordináta-rendszer (resources.arcgis.com/en/help/rest/apiref/gcs.html) és a vetített koordináta-rendszer (resources.arcgis.com/en/help/rest/apiref/pcs.html) WKID azonosítóját. A következő mezőket határozza meg saját Külső és Alapértelmezett attribútumértékeivel: triIdTX outSR és 102100 triDescriptionTX f és json Ichiro elvégzi az adatleképezés mentését.
3. lépés: A válaszleképezés meghatározása A következő lépésként Ichiro meghatározza a válaszleképezést az Esri geokódolási szolgáltatástól érkező válasz lekéréséhez, majd a kapott szélesség- és hosszúságértéket leképezi az IBM TRIRIGA helyrekordra. A válaszleképezést a Location modul, a triBuilding üzleti objektum, a triBuilding űrlap és a mezők megadásával határozza meg. Mivel a válasz JSON formátumú, a Külső attribútumértékek a JSONPath szintaxist követik. Az alábbi mezőket határozza meg a következő Külső attribútumértékekkel: triGisLongitudeNU candidates[0].location.x triGisLatitudeNU candidates[0].location.y Ichiro elvégzi a válaszleképezés és az integrációs objektum rekord mentését.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
15
4. lépés: Az integrációmeghatározás végrehajtása Amikor Ichiro a Végrehajtás űrlapművelet kiválasztásával elindítja az integrációmeghatározást, a következő folyamat megy végbe: v Az adatleképezési értékek segítségével a rendszer dinamikus lekérdezést állít össze. Ezután meghívja a lekérdezést. v Mivel a küldési típus lekérdezési karaktersorozat, a lekérdezésből származó minden egyes eredmény a következő URL adatszerkezetre kerül átalakításra: http://geocode.arcgis.com/arcgis/rest/services /World/GeocodeServer/findAddressCandidates?Address=6720+Via+Austi+Pkwy &ZIP=89119&City=Las+Vegas&State=Nevada&outSR=102100&f=json
A tényleges paraméterek köre az aktuális IBM TRIRIGA adatoktól függ. v A következő JSON objektum a választ mutatja be: { "spatialReference": { "wkid":102100,"latestWkid":3857 }, "candidates": [{ "address":"6720 Via Austi Pky, Las Vegas, NV, 89119", "location": { "x":-12819684.945332458, "y":4309927.0270621451 }, "score":100, "attributes": { } }, { "address":"6720 Via Austi Pky, Las Vegas, NV, 89119", "location": { "x":-12819744.862808136, "y":4309924.3334144857 }, "score":100, "attributes": { } }, { "address":"6721 Via Austi Pky, Las Vegas, NV, 89119", "location": { "x":-12819808.664131654, "y":4309995.0691041043 }, "score":79, "attributes": { } }, { "address":"Via Austi Pky, Las Vegas, NV, 89119", "location": { "x":-12819804.948472099, "y":4309871.0261052754 }, "score":100, "attributes": { } }] }
v A válaszleképezés értékei segítségével a candidates[0].location.x és candidates[0].location.y koordináta kinyerésre kerül a JSON objektumból, majd a rendszer elvégzi azok leképezését az IBM TRIRIGA helyrekordban található triGisLongitudeNU és triGisLatitudeNU mezőre. A helyrekord frissítése megtörténik az új adatokkal. v Mivel nem került művelet meghatározásra a Kimenő lekérdezése szakaszban az exportált adatok számára, a rendszer nem aktivál műveleteket a helyadatokon. v A rendszer begyűjti az integrációs folyamat végelszámolásának adatait, majd az integráció futtatásához és az esetlegesen felmerült hibákhoz kapcsolódó részletekkel létrehozza a végrehajtásitörténet-rekordot.
Integráció végrehajtása A Végrehajtás űrlapműveleten kívül az integrációs objektum rekordokat vagy integrációmeghatározásokat egyéni feladatokból vagy URL címekről is végre lehet hajtani. Az egyéni feladatok segítségével a jelenleg futó folyamatból származó adatokkal lehet szűrést végezni a kimenő lekérdezéseken. Az URL címek felhasználásával külső alkalmazásokból adhatók át paraméterek a Végrehajtás művelet aktiválásához, illetve kérhetők le az IBM TRIRIGA jelentéskezelő-lekérdezések JSON formátumú eredményei.
Végrehajtás űrlapokról Miután létrehozta az integrációs objektum rekordot, a Végrehajtás űrlapművelet segítségével indíthatja el az integrációmeghatározást. Ez a művelet a triIntegration - Végrehajtás munkafolyamatot futtatja. Az integrációs objektum rekord csak olvashatóvá válik, státusza pedig Feldolgozás alatt értékűre módosul. Amikor az integráció feldolgozása hibák nélkül befejeződött, akkor az integrációs objektum rekord állapota visszaáll a Kész értékre. Ha a feldolgozás alatt hiba történt, akkor a státusz Meghiúsult értékűre módosul, a rekord pedig nem vált állapotot. Ezután saját kezűleg kell megvizsgálnia a felmerült hibákat. Azonban a Befejezés műveletre kattintva felülbírálhatja a vizsgálatot és a rekord állapotát Kész értékre állíthatja vissza. A Végrehajtási történet szakasz az integráció egyes futtatási alkalmaival kapcsolatos részletek rekordjait tartalmazza. Minden részletrekord magában foglalja a státuszt, a feldolgozási számlálót, valamint a futás időtartamát. Amikor az integrációfuttatás hibákkal rendelkezik, akkor tartalmazza a hibák naplóját és a lekérdezéseket felsoroló szakaszt is, amelyben az egyes meghiúsult rekordok listája kerül megjelenítésre. Ha az integrációfuttatást másik munkafolyamatból aktiválták, akkor a hibák teljes körű áttekintését tartalmazó integrációs objektum rekord egy csonkolt üzenetet is magában foglal. A csonkolt üzenet egy rejtett szövegmezőben található, amelyet például egy figyelmeztető üzenetben lehet megjeleníteni. A kimenő integrációk egyszerre legfeljebb 1000 rekordot képes feldolgozni. Amennyiben 1000 rekordnál többet kell exportálni, úgy hozza létre saját munkafolyamatát, amely addig futtatja az integrációt, amíg minden rekord feldolgozásra nem kerül.
Példa: Végrehajtás egyéni feladatokból Miután létrehozta az integrációs objektum rekordot, egy egyéni feladat segítségével a jelenleg futó folyamatból származó adatokkal végezhet szűrést a kimenő lekérdezésen.
Háttér Ichiro az ABC vállalat integrációs szakértője. IBM TRIRIGA integrációkat fejleszt az ABC vállalat ügyfelei részére.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
17
Ichiro frissíti a rekordok részhalmazát, de azt szeretné, ha az integráció elküldene egy rekordot, amikor a felhasználó az adott műveletre kattint. Így egy különleges egyénifeladat-objektumot vesz igénybe, amely munkafolyamat-változók segítségével állítja be az adatokat, illetve kommunikál az Integration osztálybetöltő-rekorddal. Ezzel a szolgáltatással Ichiro az általános metódusok felhasználásával tudja összeállítani a rekordok részhalmazát a munkafolyamatban. Ezután az egyéni feladatra hivatkozva adhatja át a részhalmazt, valamint rendelheti hozzá az IntegrationObject nevű munkafolyamatváltozóhoz az aktiválni kívánt integrációs objektum rekordot. Ichiro alapvető munkafolyamata az alábbi munkafolyamat-feladatokból áll: v Kezdő feladat v v v v v v
Az Integrációs objektum lekérdezése nevű lekérdezési feladat Az I/O változóként való meghatározása nevű változómeghatározási feladat Az Integrációs példány nevű változómeghatározási feladat A Személyek részhalmazának lekérdezése nevű lekérdezési feladat Az Egyéni feladat nevű egyéni feladat Befejező feladat
1. lépés: A munkafolyamat meghatározása Ichiro kiválasztja a kezdő feladatot, a munkafolyamatot aszinkronként állítja be, majd megadja, hogy a munkafolyamatot akkor kell futtatni, amikor egy személyrekord (triPeople) mentésre kerül (triSave).
2. lépés: Az első lekérdezési feladat meghatározása Ichiro beszúrja az első lekérdezési feladatot, majd a következő nevet adja meg számára: Integrációs objektum lekérdezése. Ebben a feladatban az aktiválni kívánt integrációs objektum rekordot kérdezi le (Kezelői alapérték - integrációs objektumok). Ezután adott névre szűri a lekérdezés eredményeit. Ichirónak csak egy eredményül kapott integrációs objektum rekorddal szabad rendelkeznie.
3. lépés: Az első változómeghatározási feladat megadása Ichiro beszúrja az első változómeghatározási feladatot, amelynek a következő nevet választja: I/O változóként való meghatározása. Ebben a feladatban változóként határozza meg az integrációs objektum rekordot (triIntegration). Az előző feladatból származó lekérdezés eredménye ehhez a változóhoz kerül hozzárendelésre.
4. lépés: A második változómeghatározási feladat megadása Ichiro beszúrja a második változómeghatározási feladatot, amelynek a következő nevet választja: Integrációs példány. Ebben a feladatban változóként határozza meg az integrációs példányobjektumot (triIntegrationInstance). Ez a visszaadott változó az egyéni feladatból származó visszatérési értékhez kerül a munkafolyamat végén felhasználásra.
5. lépés: A második lekérdezési feladat meghatározása Ichiro beszúrja a második lekérdezési feladatot, majd a következő nevet adja meg számára: Személyek részhalmazának lekérdezése. Ebben a feladatban az integráció számára feldolgozott személyrekordok szűrt halmazát kérdezi le. A személyrekordokra fogalmaz meg lekérdezést (triEmployee – Keresés). Ezután szűri az eredményeket olyan rekordokra, amelyekben a személy utóneve (triFirstNameTX) tartalmazza az Ichiro karaktersorozatot.
Ichiro ellenőrzi, hogy a személyek üzleti objektuma (triPeople) tartalmazza-e a rekordazonosító (triRecordIdSY) mezőt. Az integrációs objektum rekordnak átadott lekérdezési feladatban használt minden üzleti objektumnak tartalmaznia kell a rekordazonosító (triRecordIdSY) mezőt. Az integráció futtatásakor az integrációs objektum rekord a rekordazonosítót használja az adatleképezésben meghatározott üzleti objektum további mezőinek lekéréséhez.
6. lépés: Az egyéni feladat meghatározása Ichiro egy különleges egyéni feladatot vesz igénybe, amely munkafolyamat-változók segítségével állítja be az adatokat, illetve kommunikál az Integration osztálybetöltőrekorddal. Ebben a feladatban rekordok készleteként adja át a Személyek részhalmazának lekérdezése feladat eredményeit. Végül Ichiro felveszi azt a visszatérési változót, amelyre az integrációs példányrekord lekérdezéséhez van szükség. A visszatérési érték neve kötelezően: IntegrationInstance. Ez az egyéni feladat a következő értékekkel és viselkedéssel is meghatározásra kerül: v Az egyéni feladat Osztálynév mezője Integration:com.tririga.custom.integration.Parameter értékre kerül beállításra. Ez az osztálynév használandó kötelezően a metódus megvalósításakor. Az Integration osztálybetöltő-útvonalon belüli Parameter osztály az alábbi szignatúrával rendelkező CustomParamBusinessConnectTask Java felületosztályt valósítja meg: public CustomParamTaskResult execute(TririgaWS client, Map params, long userId, Record[] records)
v A params argumentum a hozzárendelt IntegrationObject változót képviseli, amelynek révén a folyamat rendelkezik az integráció folytatásához szükséges útmutatással. A records argumentum az egyéni feladat Rekordok szakaszát képviseli, ahol a munkafolyamat esetében használandó rekordok kerülnek hozzárendelésre. Az esemény egy objektumon való aktiválása helyett két objektumkészlet kerül az eseménynek átadásra. v A Parameter osztály kikeresi az integrációs objektum rekordot az IntegrationObject változóból, majd feldolgozza az eredményeket az átadott records argumentumban. Ez a feldolgozás a lekérdezésnek az integrációs objektum rekord Kimenő lekérdezése szakaszában való futtatására, valamint az átadott rekordokhoz tartozó rekordazonosítók szerinti szűrésére terjed ki. A feldolgozás eredményeként megtörténik az adatok exportálása az általános segédprogramokkal. Az exportálást azonban már nem korlátozzák a "mindent vagy semmit" lekérdezések, illetve az esemény közvetlen, Végrehajtás űrlapművelettel való aktiválása.
Végrehajtás URL címekről Miután létrehozta az integrációs objektum rekordot, egy URL cím segítségével adhat át paramétereket külső alkalmazásokból a Végrehajtás művelet aktiválása érdekében. Az URL cím felhasználásával az IBM TRIRIGA rendszer jelentéskezelő-lekérdezéseinek JSON formátumú eredményei is lekérhetők. Az események hitelesítési adatokat tartalmazó URL címmel történő külső aktiválásához az IBM TRIRIGA Application Platform rendszer 3.3 vagy újabb változatára van szükség. A hitelesítést a következő módok egyikén lehet megadni: v Az alapszintű hitelesítés általános biztonsági protokollja keretében vegye fel a Felhasználónév és a Jelszó értéket a HTTP kérésfejlécbe. v Vegye fel a Felhasználónév-paraméter és Jelszóparaméter értéket, valamint a nekik megfelelő Felhasználónév és Jelszó értéket a HTTP kérésfejlécbe. v Vegye fel a Felhasználónév-paraméter és Jelszóparaméter értéket, valamint a nekik megfelelő Felhasználónév és Jelszó értéket POST paraméterekként, illetve a HTTP kérésfejléc URL lekérdezési karaktersorozataként. 2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
19
A Végrehajtás művelet aktiválása A Végrehajtás művelet URL címmel történő, integrációs objektum rekordon való külső aktiválásához hozzá kell fűznie egy lekérdezési karaktersorozatot az URL címhez. A lekérdezési karaktersorozat tartalmazza a hitelesítési adatokat, valamint beállítja a kiegészítő ioName paramétert az integrációs objektum rekord nevére. Például a Geocode Address (Geokódolási cím) integrációs objektum rekord aktiválásához a következő URL címet kell meghívni: http://localhost:8001/html/en/default/rest /Integration?user=username&pass=password&ioName=Geocode+Address
Ha az URL cím a várt módon aktiválja a Végrehajtás műveletet az integrációs objektum rekordon, akkor a rendszer a Sikeres üzenetet adja vissza. A Végrehajtás művelet integrációs objektum rekordon való meghívása aszinkron esemény, így nincs lehetőség az integrációs folyamat eredményeinek szinkron lekérésére. Ha azonnali visszajelzésre van szüksége az eredményekről, akkor értesítési eseményt kapcsolhat az integrációs objektum rekord végrehajtásának befejezéséhez. Ezután az IBM TRIRIGA alkalmazás értesítheti, ha befejeződött az integrációs folyamat. Egy másik lehetőség az információk IBM TRIRIGA rendszerből való lekérdezése.
A lekérdezési eredmények lekérése Az IBM TRIRIGA rendszer Jelentéskezelő eszközében meghatározott minden lekérdezés végrehajtható külsőleg URL cím segítségével. A lekérdezés meghatározásához a következő paramétereket használhatja fel: action Kötelező paraméter. A következő értékre kell beállítani: query (lekérdezés). module Használt jelsor hiányában kötelező paraméter. A lekérdezéshez kapcsolódó modul, például: triPeople. bo
Elhagyható paraméter. A lekérdezéshez kapcsolódó üzleti objektum, például: triPeople. Ha több üzleti objektum van, hagyja ki ezt a paramétert.
query Használt jelsor hiányában kötelező paraméter. A lekérdezés neve, például: triEmployee - Keresés. f
Elhagyható paraméter. A visszaadott eredmények formátuma, amelyben a következő paraméterek helyezhetők el: json
pjson Az olvashatóság megkönnyítése érdekében nyomtatási formátumban előállított JSON karaktersorozat.
ct
20
xml
Minimalizált XML karaktersorozat.
pxml
Az olvashatóság megkönnyítése érdekében nyomtatási formátumban előállított XML karaktersorozat.
tab
Tabulátorral tagolt szöveg.
Kötelező paraméter, ha a rekordok következő kötege kerül lekérésre. A folytatási jelsort a rendszer akkor adja vissza, ha a lekérdezési eredmények száma meghaladja az alapértelmezett 1000-es értéket. A rekordok következő kötegének lekérésére tett kísérlet során át kell adnia ezt a paramétert az előző válaszban megadott jelsorral együtt.
Például az összes alkalmazott lekérdezésének megadásához a következő URL címet kell meghívnia: http://localhost:8001/html/en/default/rest /Integration?user=username&pass=password&action=query &module=triPeople&bo=triPeople&query=triEmployee+-+Find&f=pjson
DataConnect folyamatok végrehajtása A bejövő IBM TRIRIGA DataConnect séma kiválasztásakor az integrációmeghatározás a DataConnect feladatok két típusát képes futtatni. Az általános típus egy feladatot hoz létre a kiválasztott üzleti objektum számára. A többszörös típus több állomásoztatási táblát tölt be, majd azokat egy feladatként futtatja. A többszörös típus függő integrációmeghatározást igényel, amely a munkafolyamatban áll rendelkezésre. Általános típus Az integrációmeghatározás futtatásakor a DataConnect feladatok ezen típusa az alábbi folyamatot követi. 1. Létrehoz egy feladatszámot a maximális DC_JOB számértékből. 2. Az új feladatszámmal, az üzleti objektummal és 1-es (Új) státusszal beszúr egy új bejegyzést a DC_JOB táblába. 3. Betölti az állomásoztatási táblát a feladatszámmal, űrlapnévvel, 2-es (Kész) állapottal és 4-es (Upsert) művelettel. 4. 2-es (Kész) státusszal frissíti a DC_JOB táblát. Többszörös típus Az integrációmeghatározás futtatásakor a DataConnect feladatok ezen típusa az alábbi folyamatot követi. 1. Létrehoz egy feladatszámot a maximális DC_JOB számértékből. 2. Az új feladatszámmal, az üzleti objektummal és 1-es (Új) státusszal beszúr egy új bejegyzést a DC_JOB táblába. 3. Betölti az állomásoztatási táblát a feladatszámmal, űrlapnévvel, 2-es (Kész) állapottal és 4-es (Upsert) művelettel. 4. Lekérdezi a függő integrációmeghatározást (Integrációsobjektum-függő), majd addig ismétli az 1-4. lépést, amíg az integrációmeghatározás már nem rendelkezik függő integrációmeghatározással. 5. 2-es (Kész) státusszal frissíti a DC_JOB táblát.
Hibakezelés Ha az integráció során hibák történnek, az érintett rekordok mentésére nem kerül sor. Az integrációpéldány összegzése megjeleníti a felmerült hibákat, a sikertelen rekordok mindegyikét pedig egy-egy példányhibarekord képviseli. A példányhibarekord tartalmazza a saját kezűleg szerkeszthető, majd újból elküldhető példányrekord-ábrázolást. A példányhibarekordokban (triIntegrationInstanceFailure) szereplő Rekord újraküldése mező egy olyan megjegyzésmező, amely a létrehozni vagy frissíteni próbált rekordot ábrázoló kulcs-érték párokat tartalmazza. Saját kezűleg szerkesztheti a Rekord újraküldése mezőben található adatokat, majd az Újraküldés űrlapműveletre kattintva ismét elküldheti a rekordot. Amikor az újraküldött rekord feldolgozása sikeresen végrehajtásra került, a következő események mennek végbe: v A sikertelen rekord megjelenítése "Hiba" értékről "Sikeres" értékre változik. v A rendszer törli a Hibaüzenet és a Rekord újraküldése mezőben szereplő szöveges bejegyzéseket.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
21
v Az integrációpéldány (triIntegrationInstance) rekordszáma frissítésre kerül, hogy az a helyes értéket tükrözze. Egész pontosan a Sikeres rekordok mezőben szereplő szám eggyel nő, a Sikertelen rekordok mező értéke pedig eggyel csökken. Amikor a Sikertelen rekordok számlálója egyenlő nullával, akkor fejezze be az integrációs objektum rekord futtatását a Befejezés művelettel.
Integrációs elemek Az integrációmeghatározás megadásán és végrehajtásán túl az integrációk körében közös elemek és folyamatok közé tartoznak a kimenő formátumok, objektumfrissítések és -átállítások. Az egyéb közös elemek az általános munkafolyamatokat, általános lekérdezéseket és általános listákat foglalják magukban.
Kimenő formátumok A kimenő fájlintegrációk esetén a .json, .xml vagy .xslt fájlformátum választható ki. A kimenő HTTP POST integrációk esetében a JSON, XML vagy XSLT küldési és válaszformátumok választhatók ki.
Fájlexportálási típusok A fájlexportálási formátumok közé tartozik a sima szöveg, a .json, .xml és .xslt formátum. Ha általános, egymástól elválasztott értékeket tartalmazó fájlok esetében a sima szöveg beállítást választja, akkor a Fájlfejléc mező elérhetővé válik.
HTTP POST típusok A HTTP POST formátumok közé tartozik a paraméter, a lekérdezési karaktersorozat, a JSON, XML és XSLT formátum. A kimenő lekérdezés eredményei a kiválasztott formátumra kerülnek átalakításra. Paraméter Minden sor paraméternév-érték párokká kerül átalakításra. Az egyes rekordok elküldésére külön-külön kerül sor. Nem érhető el kötegelt adatküldés. Lekérdezési karaktersorozat Minden sor paraméternév-érték párokká kerül átalakításra, amelyeket a rendszer lekérdezési karaktersorozatként fűz hozzá az URL címhez, majd elküldi azokat. Bár a kérés törzsébe való befoglalás helyett az adatok az URL címhez vannak fűzve, a HTTP kérés metódusa POST, nem GET. JSON A HTTP POST séma küldési típusaként, illetve a fájlséma exportálási típusaként lehetősége van arra, hogy a JSON értéket válassza. Ha a kimenő lekérdezés által visszaadott minden egyes rekord esetén külön kérést kíván küldeni, akkor adja meg a Válasz típusa értéket. Az egyszerű válaszparamétereknek meg kell egyezniük a válaszleképezésben megadott mezőkkel. Ha az összes visszaadott rekordot egyetlen kötegelt adatküldés keretében kívánja elküldeni, akkor ne adja meg a választípust. A JSON adatszerkezet két objektummal rendelkezik: az adatok és a fejléc objektumával. Az adatobjektum egy objektumtömböt tartalmaz a kimenő lekérdezési oszlopokból származó címkékkel és értékekkel, és ha megadásra került, akkor az üzleti objektum és a rekord azonosítóját is magában foglalja. A következő példa az alapértelmezett JSON adatszerkezetet mutatja be:
XML és XSLT A HTTP POST séma küldési típusaként, illetve a fájlséma exportálási típusaként lehetősége van arra, hogy az XML értéket válassza. Ha a kimenő lekérdezés által visszaadott minden egyes rekord esetén külön kérést kíván küldeni, akkor adja meg a Válasz típusa értéket. Az egyszerű válaszparamétereknek meg kell egyezniük a válaszleképezésben megadott mezőkkel. Ha az összes visszaadott rekordot egyetlen kötegelt adatküldés keretében kívánja elküldeni, akkor ne adja meg a választípust. Alapértelmezett XML adatszerkezet Az XML adatszerkezet három csomópontot tartalmaz a kimenő lekérdezés egyes oszlopai: a mező, címke és érték számára. A következő példa az alapértelmezett XML adatszerkezetet mutatja be: triIdTX1000000 ... ...
A dátumértékek esetén a kimenő lekérdezés eredményei az adatbázisban tárolt nyers értékeket, valamint a felhasználónak megjelenített formázott kimeneti értékeket foglalják magukban. A displayValue csomópont hozzáadásra kerül a lekérdezési eredményekhez. A következő példa az alapértelmezett XML adatszerkezetet mutatja be: DateDateTime
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
23
Címkék csomópontokként Ha a Lekérdezési címke használata elemként beállítást választja, akkor az alapértelmezett XML adatszerkezet megváltozik. A címke és érték csomópontja ekkor a címkenév értékcsomópontként való felhasználásával összevonásra kerül. A következő példa az XML adatszerkezetet mutatja be: triIdTX1000000 ... ...
A dátumértékek esetén a rendszer az összevont név_display csomópontot adja hozzá a lekérdezési eredményekhez. A következő példa az XML adatszerkezetet mutatja be: DateDateTime
XSLT átalakítások Ha XSLT átalakítást alkalmaz az XML adatszerkezetre, akkor a bináris XSLT mező segítségével tárolhatja az XSLT stíluslapot. A mező kitöltése nem kötelező. Az XML adatszerkezetet a Lekérdezési címke használata elemként beállítással vagy anélkül is átalakítható.
HTTP választípusok A HTTP válaszformátumok közé tartozik a sima szöveg, a JSON és az XML formátum. Az egyszerű válaszparamétereknek meg kell egyezniük a válaszleképezésben megadott mezőkkel. Ha bejelöli a Küldés kötegként beállítást, ne adja meg a Válasz típusa értéket. Miután az integrációs folyamat befejeződött, a válasz által érintett rekordok a Származtatott társítási karaktersorozattal rendelkező integrációmeghatározás Társítások lapján kerülnek felsorolásra. Sima szöveg A HTTP választ karaktersorozat-formátumban kéri le.
Ha például a válasz "Sikeres" vagy "Sikertelen", akkor a kérdéses karaktersorozatot leképezheti egy mezőre, amely az utófeldolgozási munkafolyamat döntési pontjaként kerülhet felhasználásra. JSON A HTTP választ JSON formátumban kéri le. A válaszleképezésben a JSONPath karaktersorozattal határozhatja meg a Külső attribútumot. Csak egyszerű válaszmeghatározásokat használhat. Ha a leképezni kívánt JSON elem egy tömbben szerepel, akkor meg kell adnia a kérdéses tömb indexszámát. Például a candidates[0].location.x kód a -12819744.7565 értéket adja vissza az alábbi JSON adatszerkezetben: { "spatialReference" : { "wkid" : 102100 }, "candidates" : [ { "address" : "6720 Via Austi Pky, Las Vegas, NV, 89119", "location" : { "x" : -12819744.7565, "y" : 4309920.3012000024 }, "score" : 100, "attributes" : { } }, { "address" : "6721 Via Austi Pky, Las Vegas, NV, 89119", "location" : { "x" : -12819812.309700001, "y" : 4309994.186999999 }, "score" : 79, "attributes" : { } } ] }
XML A HTTP választ XML formátumban kéri le. A válaszleképezésben az XPath karaktersorozattal határozhatja meg a Külső attribútumot. Csak egyszerű válaszmeghatározásokat használhat. Ha a leképezni kívánt XML elem egy tömbben szerepel, akkor meg kell adnia a kérdéses tömb indexszámát. Például a //root/candidate/location[2]/x kód az 5 értéket adja vissza az alábbi XML adatszerkezetben: <x>1 2 <x>5 6
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
25
Az XML formátum több rekordot is képes lekérni és frissíteni a válaszban. A válaszleképezésben ott, ahol a Külső attribútumot határozza meg az XPath karaktersorozattal, az [i] jelsorral kell ábrázolnia az ismétlődő XML elemet. Az alábbi példában az XPath kifejezés recordId attribútumra való leképezéséhez az XML adatszerkezetben a következőre állíthatja be az XPath kifejezést: //result[i]/@recordId. Az XPath kifejezés Name csomópontra történő leképezéséhez a következőre állítsa be az XPath kifejezést: //result[i]/columns/ column/Name. A rekord frissítése érdekében az isKey (kulcs) attribútumot is beállíthatja a leképezésben. triNameTXtriIdTXtriNameTXtriIdTX ...
Objektumfrissítések Minden alkalommal, amikor rendelkezésre áll egy új IBM TRIRIGA Application Platform telepítő, meghatározhatja, hogy a telepítő frissítse-e a TRIRIGA integrációs objektumot a platformfrissítés közben. Ha nem szeretné, hogy a telepítő frissítse a TRIRIGA integrációs objektumot, akkor a telepítő futtatása előtt létre kell hoznia egy IGNORE_UPGRADE nevű integrációs objektum rekordot. Ne futtassa ezt a rekordot. A rekordnak csupán jelen kell lennie a meglévő platformtelepítési környezetben. Ezután a telepítő futtatása során az akkor sem frissíti a TRIRIGA integrációs objektumot, ha a telepítő összeépítési változata újabb a jelenleg telepített platformverziónál. Ha nem hozza létre ezt az IGNORE_UPGRADE rekordot, akkor a telepítő elvégzi a TRIRIGA integrációs objektum frissítését, ha a telepítő összeépítési változata újabb a jelenleg telepített platformverziónál.
Objektumátállítások Az objektumátállítás futtatása előtt, de még az integrációs objektum rekordok új környezetben való felhasználása előtt meg kell nyitnia valamelyik integrációs objektum rekordot, majd futtatnia kell az Újraleképezés műveletet. Az Újraleképezés művelet az adat- és válaszleképezésekben mentett azonosítók mindegyikét frissíti. Ezek a leképezések modulok, üzleti objektumok, űrlapok és intelligensrekord-adatok azonosítóit tartalmazzák. Az Újraleképezés művelet futtatásával az azonosítók új környezet számára történő frissítéséről kell gondoskodnia.
Objektumelemek A triIntegration modul több üzleti objektumot tartalmaz, például ezek közé tartozik a TRIRIGA integrációs objektum is. Az integrációs objektum rekord ezen kívül még több osztálybetöltő-elem használatát igényli. A triIntegration modul az alábbi üzleti objektumokat foglalja magában: triIntegration A TRIRIGA integrációs objektum az az elsődleges üzleti objektum, amely az IBM TRIRIGA és a külső rendszerek közötti integrációt határozza meg. Az integrációmeghatározásokat vagy integrációs objektum rekordokat ebből a TRIRIGA integrációs objektumból hozhatja létre. triDataSource Azon adatforrás üzleti objektum, amely az adatbázis-kapcsolatot meghatározó tulajdonságbeállításokat tartalmazza. Erre az objektumra egy egyrekordos intelligens szakasz hivatkozik az integrációs objektum rekordban. Ez a hivatkozás lehetővé teszi az adatforrás-meghatározások több integrációmeghatározás körében történő ismételt felhasználását. triIntegrationInstance Az integrációpéldány üzleti objektuma tartalmazza a futtatott integráció adott példányával kapcsolatos részleteket. Ez az objektum a számlálókat, a futtatás időtartamát, az esetleges hibaüzenetek gyűjteményét, valamint a sikertelen rekordokkal kapcsolatos részletek lekérdezési szakaszát foglalja magában. Ez az objektum a válasz által érintett rekordokhoz van társítva. Az objektumra az integrációs objektum rekord Végrehajtási történet szakaszában mutat hivatkozás. triIntegrationInstanceFailure Az integrációpéldány-hiba üzleti objektuma a bejövő integráció esetén sikertelen adott rekorddal kapcsolatban tartalmaz részleteket. Ez az objektum magában foglalja a sikertelenség hibaüzenetét, valamint az elküldött rekord egyszerűsített ábrázolását, amelyet saját kezűleg lehet szerkeszteni, majd ismét elküldeni. Az Integration nevű TRIRIGA osztálybetöltő-rekordra az integrációs objektum rekordnak van szüksége. Az Integration osztálybetöltő-rekord a következő elemeket tartalmazza Erőforrásfájlok lekérdezési szakaszában: jtds-1.2.5.jar A Java eszköztesztkészlethez (JDTS) tartozó .jar fájl a Microsoft SQL Server rendszer adatbázis-illesztőprogramja. Bár az IBM TRIRIGA az Oracle rendszer Java Database Connectivity (JDBC) Oracle Database illesztőprogramjával kerül szállításra, az IBM TRIRIGA nem tartalmaz adatbázis-illesztőprogramot a Microsoft SQL Server számára. Ha a Microsoft SQL Server rendszerhez csatlakozik, hozzá kell adnia a Microsoft SQL
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
27
Server illesztőprogramját, így például a jtds-1.2.5.jar fájlt az Integration osztálybetöltő-rekord Erőforrásfájlok lekérdezési szakaszához. TRIRIGAIntegration.jar A TRIRIGA integrációhoz tartozó .jar fájl tartalmazza az összes olyan Java osztályt, amelyet a TRIRIGA integrációsobjektum-összetevők használnak. A fájl munkafolyamattal kapcsolatos egyénifeladat-belépési pontokat és egy olyan kommunikációs réteget tartalmaz, amelyet a TRIRIGAIntegration_Assets.zip fájl elemei vesznek igénybe. TRIRIGAIntegration_Assets.zip A TRIRIGA integrációs eszközökhöz tartozó .zip fájl minden olyan .html, .css, JavaScript és képfájlt tartalmaz, amelyet a bejövő integrációkhoz tartozó adatleképezés használ. A JavaScript az URI alapú kiszolgálókisalkalmazás-proxy azonosítói segítségével kommunikál az IBM TRIRIGA Connector for Business Applications Java alkalmazásprogramozási felületével. A kiszolgáló oldali elemeket a TRIRIGAIntegration.jar fájl tartalmazza.
Objektumváltozatok Ha meg szeretné határozni, hogy a TRIRIGA integrációs objektum melyik változata van telepítve az IBM TRIRIGA környezetben, akkor keresse fel a következő webcímet: http://[localhost:8001/kontextus]/html/en/default/rest/Integration. Az így kapott eredmény megjeleníti a jelenleg futtatott integrációs objektum összeépítési dátumát, összeépítési számát, valamint verziószámát.
Általános munkafolyamatok A TRIRIGA integrációs objektum számos IBM TRIRIGA munkafolyamattal kerül szállításra. Az integrációs objektum rekordból vagy annak támogató rekordjaiból a rendszer az alábbi munkafolyamatokat aktiválja. triIntegration - Végrehajtás Ez az aszinkron munkafolyamat akkor kerül aktiválásra, amikor a felhasználó kiválasztja a Végrehajtás műveletet. Ez az az elsődleges munkafolyamat, amely az IBM TRIRIGA és a külső rendszerek közötti integrációt támogatja. Ez a munkafolyamat felügyeli az űrlapon megjelenő rekordstátuszt. Az Integráció aktiválása feladat egy olyan egyéni feladat, amely meghívja az Integration:com.tririga.custom.integration.Integration integrációt, és ez képezi valamennyi integrációs objektum rekord elsődleges belépési pontját. Az integráció során futtatandó folyamatokkal kapcsolatos információk az integrációs objektum rekordban kerülnek meghatározásra, majd a rekordazonosítón keresztül megtörténik azok egyéni feladatnak való átadása. Az általános munkafolyamat a következő munkafolyamat-feladatokat tartalmazza: v Kezdő feladat v Rekordmódosítási feladat, amelynek neve: Státusz megjelölése Feldolgozás alatt értékűként v Egyéni feladat, amelynek neve: Integráció aktiválása v Átkapcsolási feladat – Ha a kapcsolófeltétel true (igaz) értékű, a következő feladatok kerülnek futtatásra: - Művelet aktiválása feladat - Rekordmódosítási feladat, amelynek neve: Státusz megjelölése Kész értékűként
– Ha a kapcsolófeltétel false (hamis) értékű, a következő feladatok kerülnek futtatásra: - Rekordmódosítási feladat, amelynek neve: Státusz megjelölése Meghiúsult értékűként v Befejező feladat triIntegration - Tábla SQL kódjának előállítása Ez a szinkron munkafolyamat egy integrációs objektum rekord Adatbázis szakaszműveletéből kerül aktiválásra, célja pedig az állomásoztatási táblák esetén használandó SQL kód előállítása. triIntegration - Tesztadatok előállítása Ez a szinkron munkafolyamat egy integrációs objektum rekord Adatbázis szakaszműveletéből kerül aktiválásra, célja pedig véletlenszerű tesztadatok előállítása az állomásoztatási táblákban. Ezek a tesztadatok funkcionális vagy terheléses teszteléshez használhatók fel. triIntegration - Adatszakaszok elrejtése/megjelenítése Ez a szinkron munkafolyamat egy új integrációs objektum rekord kezdeti betöltése által kerül aktiválásra különféle űrlapelemekből, például a mezőműveletek Módosításkori munkafolyamatából. A munkafolyamat igény szerint megjeleníti és elrejti az űrlapelemeket, ahogy éppen megfelel a meghatározás alatt álló integrációnak. triIntegration - Előzetes betöltés Ez a szinkron munkafolyamat új integrációs objektum rekord megnyitásakor kerül meghívásra. Ezután a munkafolyamat hívja meg a triIntegration – Metaadatok visszaállítása és a triIntegration – Adatszakaszok elrejtése/megjelenítése munkafolyamatot. triIntegration - Metaadatok visszaállítása Ez a szinkron munkafolyamat a törölt űrlapelemeket állítja vissza. A munkafolyamat triIntegration – Előzetes betöltés munkafolyamatból kerül meghívásra. triIntegration – Újraküldés Ez az aszinkron munkafolyamat akkor kerül aktiválásra, amikor ismét elküld egy meghiúsult rekordot a példányhiba- (triIntegrationInstanceFailure) rekordból. triIntegration - Adatbázis-kapcsolat tesztelése Ez a szinkron munkafolyamat az integrációs objektum rekord Adatbázis szakaszműveletéből kerül aktiválásra a megadott adatbázishoz tartozó select count(1) from [tábla_neve] utasítás meghívása érdekében. A hívás ellenőrzi, hogy az integrációmeghatározás képes-e kommunikálni és SQL parancsokat futtatni az adatbázisban. triIntegration - Fájlhozzáférés tesztelése Ez a szinkron munkafolyamat az integrációs objektum rekord Fájl szakaszműveletéből kerül aktiválásra a megadott fájlhely létrehozási, lekérési, frissítési és törlési jogosultságainak ellenőrzése érdekében. triDataSource - Metaadatok visszaállítása Ez az aszinkron munkafolyamat visszaállítja az adatforrás- (triDataSource) rekordot. triDataSource - Adatbázis-kapcsolat tesztelése Ez a szinkron munkafolyamat az adatforrás- (triDataSource) rekordból kerül aktiválásra a megadott adatbázishoz tartozó select count(1) from [tábla_neve] utasítás meghívása érdekében. A hívás ellenőrzi, hogy az adatforrás-meghatározás képes-e kommunikálni és SQL parancsokat futtatni az adatbázisban.
2. fejezet Adatok integrálása a TRIRIGA integrációs objektummal
29
Általános lekérdezések A TRIRIGA integrációs objektum számos IBM TRIRIGA lekérdezéssel kerül szállításra. A következő alkalmazásterületek és a nekik megfelelő lekérdezések a triIntegration modulban találhatók. Adatforrás neve mező triDatasource - getIntegrationObject adatforrás Végrehajtási történet szakasz triIntegration - példányok lekérése Hibák szakasz triIntegrationFailures - összes hiba lekérése Integrációsobjektum-függő mező Kezelői alapérték - integrációs objektumok Saját jelentések portál triIntegration - getIntegrationObject
Általános listák A TRIRIGA integrációs objektum számos IBM TRIRIGA listával kerül szállításra. A következő mezők és a nekik megfelelő listák a triIntegration modulban találhatók. Adatkapcsolat típusa triDataConnectTypeLI Adatbázis-illesztőprogram neve triDriverNameLI Határoló triFileDelimiterLI Irány
3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel Lehetősége van arra, hogy adatokat kérjen le IBM TRIRIGA adatbázisából, illetve egy Esri ArcGIS kiszolgálóról, majd GIS térképeken jelenítse meg ezeket az adatokat. A GIS térképek portálszakaszokban és űrlapok lapjain helyezkedhetnek el.
GIS térképek áttekintése Amikor térképeket ad hozzá IBM TRIRIGA portáljaihoz és űrlapjaihoz, a felhasználók grafikus formátumban tekinthetik meg az adatokat olyan jellemzőkkel együtt, amelyeket az adatok értelmezhetőségének javítása céljából szabhat személyre. A térképek IBM TRIRIGA alkalmazásban történő megjelenítéséhez minden egyes térkép számára létre kell hoznia egy GIS térképrekordot, valamint meg kell határoznia a GIS térképkiszolgáló helyét. A földrajzi információs rendszer (GIS) a Földre vonatkozó térbeli hivatkozással ellátott adatok és kapcsolódó attribútumaik rögzítésének, tárolásának, elemzésének és kezelésének rendszere. A szó legszorosabb értelemében ez egy olyan információs rendszert jelent, amely a földrajzi hivatkozással rendelkező információk integrálására, tárolására, szerkesztésére, elemzésére, megosztására és megjelenítésére képes. A GIS rendszer segítségével a felhasználók interaktív lekérdezéseket hozhatnak létre, elemezhetik a térbeli információkat, elvégezhetik az adatok szerkesztését, a térképek integrálását, valamint az ezen feladatokhoz kapcsolódó eredmények térképen való megjelenítését. A földrajzi információs rendszer technológiája az erőforrások és eszközök kezelésére, a környezeti hatás felmérésére, valamint várostervezési, értékesítési, marketing-, logisztikai és számos egyéb tevékenységre használható. Például a GIS rendszer lehetővé teszi a létesítménykezelőknek, hogy természeti katasztrófa esetén könnyen felmérjék a létesítményi eszközökre gyakorolt hatásokat. Vagy a GIS rendszer segítségével egy új üzleti vállalkozás megtalálhatja azt a telephelyet, ahol kiaknázhatja a korábban még kiszolgálatlan piacban rejlő lehetőségeket.
Esri adatszolgáltatások és IBM TRIRIGA eszközök A GIS térképek IBM TRIRIGA űrlapokon való megjelenítéséhez az Esri adatszolgáltatásokra és az IBM TRIRIGA eszközökre egyaránt szükség van. A következő lista a GIS térképek IBM TRIRIGA űrlapokon való megjelenítését lehetővé tevő szolgáltatásokat és eszközöket mutatja be. Esri adatszolgáltatások v Földrajzi és térinformatikai adatok (adatszolgáltatások). Az IBM TRIRIGA rendszer ezeket az adatokat REST API szolgáltatásokon keresztül szerzi be az Esri kiszolgálókon. v A tényleges térképnézet. Az ArcGIS kiszolgáló - akár online kínálja, akár egy nem nyilvános kiszolgálón biztosítja a szolgáltatásokat - megjeleníti a térképeket és kezeli a földrajzi feldolgozást. v A vezetési időre vagy a távolság alapján meghatározott körzetekre vonatkozó földrajzi feldolgozás. A földrajzi feldolgozást az ArcGIS kiszolgáló biztosítja. v A címezhető objektumok szélességi és hosszúsági koordinátáinak, illetve a jellemzőket ábrázoló azonosítók összegyűjtésére irányuló geokódolás (földrajzi kódolás). A geokódolást az ArcGIS kiszolgáló biztosítja.
v Az Esri JavaScript alkalmazásprogramozási felület (API). Előállítja a megjelenítőt a kiszolgálóról származó adatok, valamint a térképi adatokkal való alapszintű együttműködés biztosításához. Az általános konfiguráció az IBM TRIRIGA GIS térképobjektumban kerül meghatározásra. IBM TRIRIGA eszközök v Az épületadatok kiinduló készlete, amely az Esri ArcGIS kiszolgáló lekérdezésére szolgál. v Osztálybetöltő-objektum, amely az Esri JavaScript megjelenítő előállítására szolgáló funkciót tartalmazza. v Eszközök az IBM TRIRIGA rendszeren belül megjelenített GIS térképterületeken felhasznált alaptérképek, rétegek, térbeli hivatkozások, eszközprimitívek és lekérdezések beállításához. Az Esri által kínált számos adatszolgáltatás egyike a térbeli lekérdezési szolgáltatás. Az IBM TRIRIGA rendszer ezen szolgáltatások segítségével határozza meg a felhasználó által az aktuális térképi nézetben látható földrajzi területek információit. A GIS térképek az IBM TRIRIGA portálszakaszokban vagy az űrlapok lapjain jeleníthetők meg. Minden alkalommal ugyanazon teljes körű szolgáltatásokkal ellátott funkció érhető el, amikor a rendszer megjelenít egy térképet. Az IBM TRIRIGA Application Platform és az IBM TRIRIGA alkalmazás GIS szolgáltatásokat támogató változatait az IBM TRIRIGA Application Platform kompatibilitási mátrix (https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/ wiki/IBM+TRIRIGA1/page/Support+Matrix) határozza meg.
Esri integrációs pontok A térképek megjelenítéséhez az IBM TRIRIGA rendszer az Esri ArcGIS kiszolgáló által biztosított térképkezelési szolgáltatással folytat kommunikációt. Az IBM TRIRIGA rendszer Java™, JavaScript és HTML felhasználásával kommunikál az Esri ArcGIS kiszolgálóval. Az Esri JavaScript API beépített HTTP szolgáltatási protokollja segítségével küldi el a szolgáltatáshívásokat az Esri ArcGIS kiszolgálónak és az IBM TRIRIGA rendszernek. Az IBM TRIRIGA rekordokon biztosított műveletek (például a Cím geokódolása művelet) munkafolyamat közvetítésével futtatják az integrációs objektum rekordokat, hogy elküldjék a hívást a szolgáltatásnak. Ezt az integrációs objektum rekordot a szállított helyűrlapok és üzleti objektumok alábbi mezői támogatják: triGisLatitudeNU A geokódolási pont szélességét tartalmazza. triGisLongitudeNU A geokódolási pont hosszúságát tartalmazza. Meg kell határoznia a GIS térkép létrehozásához használt URL címeket és portokat. Meg kell adnia az alaptérképeket, a rétegeket és az eszközprimitív-szolgáltatásokat, így például a geometriai szolgáltatást. Az egyetlen kivételt az Esri JavaScript alkalmazásprogramozási felülete (API) jelenti, amely az Esri tartalomszállítási hálózatán (CDN) keresztül kerül beszerzésre. A kérdéses alkalmazásprogramozási felülettel használt további szolgáltatások információiért forduljon az Esri webhelyéhez (www.esri.com). Az offline API önálló, tűzfal mögött használható alkalmazásprogramozási felület.
Térképek a GIS portálszakaszokban A GIS portálszakaszok egy GIS térképet tartalmazó, alkalmazáson belüli weboldalra mutatnak. A GIS térképek a megjelenítendő adatokat meghatározó GIS térképrekordokhoz kerülnek társításra. Az alkalmazáson belüli weboldalakkal rendelkező GIS portálszakaszok az alábbi portálszakaszokat foglalják magukban: v triURL - GIS - Környezetvédelmi menedzser/tervező vagy v triURL - GIS - Környezetvédelmi menedzser/tervező (USA hatóság) Amikor a felhasználók bejelentkeznek az alkalmazásba, a rendszer meghívja a térképet tartalmazó weboldalt betöltő URL címet. Az URL paraméterben megadott térkép alapján a végrehajtható jelentések listája kerül visszaadásra. A rendszer futtatja a lista első jelentését, majd visszaadja az eredményeket a térkép számára. A jelentések mutatószám- vagy általános lekérdezések lehetnek. A jelentések határozzák meg a felhasználók által a helyek vagy jellemzők esetében a buborékjelzésekben látott elemeket. A lekérdezések töltik fel továbbá a megjelenítőben szereplő adattáblázatot is. Egy:egy viszony áll fenn a térképen látható buborékjelzések, valamint a táblázatban megjelenített adatok között. A táblázat a buborékjelzésekkel azonos mezőket tartalmazza, mivel a forrásadatok mindkettő esetében ugyanabból a jelentésből származnak. A térképi eszközprimitívekkel a felhasználó pásztázás, nagyítás vagy keresés révén találhatja meg a kívánt helyeket. A felhasználó ezenkívül jellemzőket is létrehozhat, valamint szerkeszthet a térképen, majd azokat hozzárendelheti az IBM TRIRIGA objektumokhoz. A térképen megjelenő gombostűk a lekérdezés által visszaadott helyeket jelölik. Minden hely rendelkezik egy buborékjelzéssel (szöveges eszköztippel), amely az adott hellyel kapcsolatos információkat jeleníti meg. Ha a lekérdezés mutatószám típusú, akkor a buborékjelzések a mutatószám-eredményeket tüntetik fel. A helyek gombostűikonjának színe a mutatószám-eredmények által képviselt küszöbértékeknek felel meg. Ha a lekérdezés általános típusú, akkor a hely gombostűikonjai kék színt kapnak. Az alapértelmezett színek: kék, vörös, zöld és sárga. A helyek gombostűinek térképi ábrázolásához saját ikonokat is felhasználhat. A portálszakaszokban található térképekhez társított lekérdezések nem befolyásolják vagy tükrözik a portálon szereplő többi adatot. A GIS önálló alkalmazás a portálszakaszok belsejében. A GIS szakaszok tartalmazzák a Beállítások mentése gombot. Ez a szolgáltatás az aktuális térképtartomány és -nézet mentését hajtja végre. A felhasználó következő bejelentkezése alkalmával a mentett beállítások felülbírálják a portálszakasz URL címében szereplő URL paraméter alapértékét. Ha a felhasználó nem menti a beállításokat, akkor a szakasz az URL paraméter karaktersorozatában meghatározott alapértelmezett nézetet fogja megjeleníteni. A felhasználói beállítások felhasználónként és térképenként kerülnek tárolásra. Amikor a felhasználó másik térképre vált át, akkor a kiinduló térkép beállításai nem kerülnek az új térképen alkalmazásra. Ehelyett az új térkép a hozzá tartozó alapértelmezett beállításokkal jelenik meg, hacsak a felhasználó előzőleg végre nem hajtotta az ehhez a térképhez kapcsolódó beállítások mentését.
Térképek a GIS űrlapok lapjain A GIS lapok a rekordok helyét kijelölő térképet tartalmazzák.
3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel
33
Ha a felhasználó megfelelő licencekkel rendelkezik, akkor a hely, a földrajzi elhelyezkedés és az ingatlantranzakció-terv szállított űrlapján megtalálható egy GIS lap. A GIS lapon szereplő térkép tartománya a lokalizált terület. A térképet egy alapértelmezett lekérdezés jeleníti meg. A lekérdezés paraméter-karaktersorozatként kerül megadásra az URL címben, amely meghatározza a futtatandó lekérdezéseket. A GIS lap URL címe az Űrlapkészítőben adható meg.
GIS térképelemek áttekintése Új GIS térképmeghatározás megadásakor különféle térképelemeket kell beállítania. A térképelemek közé tartoznak a tartományok, lekérdezések, alapétérképek, rétegek, ikonok és eszközprimitívek.
GIS térképrekordok Új GIS térképmeghatározás megadásához létre kell hoznia egy GIS térképrekordot a GIS térkép üzleti objektumból. A meglévő GIS térképrekordok az Eszközök > Rendszerbeállítás > GIS > GIS térkép menüpontban kerülnek felsorolásra.
Tartományok A kezdeti tartományok a térkép térbeli hivatkozására, valamint annak határaira utalnak, amikor a térkép először megnyitásra kerül egy portálszakaszban vagy űrlapon belüli lapon. A közismert azonosító (WKID) nem megfelelő az alaptérképek és rétegek számára, a térképszakasz üres és nem tartalmaz térképet. A WKID értékre két példa: 4326 és 102100. További információkért tekintse meg a földrajzi koordináta-rendszer (resources.arcgis.com/ en/help/rest/apiref/gcs.html) és a vetített koordináta-rendszer (resources.arcgis.com/en/help/ rest/apiref/pcs.html) WKID értékeit.
Lekérdezések A lekérdezések az IBM TRIRIGA rendszerben szereplő épületek térképen megjelenő helyadatait határozzák meg. A térképen az IBM TRIRIGA rendszer Jelentéskezelő eszköze által támogatott bármely lekérdezés alkalmazható. Alapértelmezésben a Megjelenítési sorrend mezőben legalacsonyabb értékkel rendelkező lekérdezés kerül megjelenítésre. Ha másik lekérdezést szeretne kiválasztani, akkor a térkép feletti Részletek megjelenítése lapra kattintva a listáról választhatja ki a kívánt lekérdezést. A mutatószám-lekérdezések a GIS szakaszokban az IBM TRIRIGA rendszer egyéb területeitől eltérő módon viselkednek. A GIS szakaszokban a mutatószám-lekérdezések adatai az aktuális térképnézetben megjelenített földrajzi adatok szerint kerülnek szűrésre és csoportosításra. A mutatószám-lekérdezés adatszerkezetének kötelező táblázatosnak lennie, továbbá a lekérdezésnek tartalmaznia kell a Hosszúság és Szélesség címkéjű megjelenítési oszlopokat. A Szélesség és Hosszúság mező jelöli ki az elemet a térképen. Ha a lekérdezés eredményei több térképi rendszerből származnak, akkor a GIS szoftver végzi el az átalakítást, és jeleníti meg az eredményeket az alaptérképen. Amikor a lekérdezések futtatásakor a lekérdezésszűrő tartalmazza a triGisLatitudeNU és a triGisLongitudeNU mezőt, akkor az Esri JavaScript megjelenítő automatikusan hozzáadja a szűrőket a lekérdezéshez. A szűrők a térkép tartományának belsejére korlátozzák az eredményeket. A triGisLatitudeNU és a triGisLongitudeNU mezőnevet kell használni; ellenkező esetben a szűrők nem adhatók hozzá.
A térképi lekérdezések legfeljebb 1000 rekordot adhatnak vissza.
Alaptérképek Az alaptérképek a megjelenítés számára rendelkezésre álló térképeket azonosítják. Alapértelmezésben a Megjelenítési sorrend mezőben legalacsonyabb értékkel rendelkező alaptérkép kerül megjelenítésre. Másik alaptérkép kiválasztásához kattintson a térkép feletti Részletek megjelenítése lapra, majd válasszon az Alaptérkép váltása listáról. A Részletek megjelenítése lap a térképszállító által a térképpel kapcsolatban megadott információkat is feltünteti. Az alaptérképrekord a térképi szolgáltatást nyújtó Esri kiszolgáló REST URL címének megadását igényli. Ha az URL helyes és érvényes, akkor az alaptérképi szolgáltatás Esri kiszolgáló által megadott leírása megjelenik a GIS alaptérkép űrlap alján. Ha az alaptérképi szolgáltatás leírása helyett semmi sem látható, vagy hibaüzenet jelenik meg, akkor ellenőrizze, hogy az Esri kiszolgáló engedélyezte-e az alaptérképi szolgáltatást a REST végpontokkal. Az alaptérkép esetében az Alaptérkép váltása listán megjelenő ikont a térkép Részletek megjelenítése lapján módosíthatja. Amikor a Miniatűr URL címe mező érvényes képre mutat, akkor az megjelenik az Alaptérkép váltása listán. Ha nem ad meg értéket, akkor az alapértelmezett kép lesz látható.
Rétegek A rétegek az alaptérkép feletti megjelenítés céljából elérhető jelmagyarázat-rétegeket azonosítják. Az Alapértelmezett jelölőnégyzet bejelölése esetén a réteg megjelenik a térkép előállításakor. A rétegek hozzáadásához kattintson a térkép feletti Részletek megjelenítése lapra, majd jelölje be a réteg neve melletti jelölőnégyzetet. A jelölőnégyzet jelölésének megszüntetése eltávolítja az adott réteget a megjelenítésből. Amikor társított jelmagyarázat-információkkal rendelkező rétegeket választ ki, akkor a térkép jobb oldalán látható oszlop mutatja be a jelmagyarázatot. Több réteg megjelenítése esetén a jelmagyarázatok a megjelenítés sorrendjében kerülnek felsorolásra. Ahogy a nagyítás révén módosítja a térképi tartományokat, úgy a jelmagyarázatokban szereplő adatok is frissülnek, hogy a megfelelő részletezettségi szintet tükrözzék. Ha egy réteg alapértelmezésben megjelenik, akkor a jelmagyarázata addig nem lesz látható, míg a Részletek megjelenítése vagy a Táblázat megjelenítése lapra nem kattint. A megjelenítés késleltetése helyet takarít meg a térképen, ami akkor fontos, ha a térképet kisebb helyeken, például portálokon tekintik meg. A jelmagyarázatokat megjelenítő oszlop az utolsó réteg eltávolítását követően eltűnik. A rétegrekord a térképi szolgáltatást nyújtó Esri kiszolgáló REST URL címének megadását igényli. Ha az URL helyes és érvényes, akkor az alaptérképi szolgáltatás Esri kiszolgáló által megadott leírása megjelenik a GIS alaptérkép űrlap alján. Ha az alaptérképi szolgáltatás leírása helyett semmi sem látható, vagy hibaüzenet jelenik meg, akkor ellenőrizze, hogy az Esri kiszolgáló engedélyezte-e a rétegszolgáltatást a REST végpontokkal.
Ikonok A gombostűk vagy ikonok színe meghatározható úgy, hogy az az adatértékek bizonyos tartományát ábrázolja.
3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel
35
Amikor egy mutatószám-lekérdezés meghatározza a pontokat a térképen, akkor a mutatószám-lekérdezésben megadott küszöbértékek szabályozzák a gombostűk színét. Például a mutatószám-lekérdezésben szereplő küszöbértékek egyike egy 1 és 3 közötti értéket határoz meg alacsony értékként, a negatív eredményt pedig a vörös szín ábrázolja. Ha a lekérdezés a 2-es értéket adja vissza, akkor a gombostű a Vörös ikon mezőben szereplő ikonfájllal kerül megjelenítésre. A Kék ikon mezőt a rendszer egy általános lekérdezés által visszaadott értékhez használja fel. A megjelenített ikonok módosításához töltsön fel saját fájlokat az Ikonok szakaszban. Az ikonfájl tetszőleges, webes megjelenítésre szolgáló formátumú fájl, például .jpg vagy .png fájl lehet. Ha nem módosítja az ikonfájlokat, akkor a rendszer a szállított ikonokat veszi igénybe.
Eszközprimitívek Az eszközprimitívek a földrajzi feldolgozók hozzáadása, áttekintő térképek biztosítása, illetve egyéni eszközprimitívek felvétele céljából határozhatók meg. A legtöbb eszközprimitív akkor válik elérhetővé, amikor a térkép feletti Részletek megjelenítése lapra kattint.
Eszközprimitív-minták Az IBM TRIRIGA Connector for Esri Geographic Information System (GIS) rendszer Esri által biztosított eszközprimitív-mintákat tartalmaz. Ezen eredetileg szállított eszközprimitívek csak szemléltetési célokból kerültek beépítésre. Az eszközprimitív-minták az alábbi jellemzőkkel rendelkeznek: Geokódoló eszközprimitív Ezzel a rendszerrel együtt szállított, földrajzi kódolást végző eszközprimitívvel szélességi és hosszúsági koordinátákra, illetve megadott címekre irányíthatja a térképet. Vezetési idő eszközprimitív A rendszerrel együtt szállított eszközprimitívek ezen eleme a kiválasztott ponttól 1, 2 és 3 perces vezetési távolságra lévő körzeteket jeleníti meg. Áttekintő térkép eszközprimitív A rendszerrel együtt szállított, áttekintő térképet megjelenítő eszközprimitívet a térkép jobb felső sarkában található nyílra kattintva lehet megnyitni. Az áttekintés a térkép tömörebb változatát jeleníti meg, valamint tartalmaz egy mozgatható ablakrészt. Az ablakrész áthúzásával a térképi nézet kicsinyítése nélkül lehet a térkép nagyobb régiói között keresni. Szerkesztő eszközprimitív A rendszerrel együtt szállított szerkesztő eszközprimitív felhasználásával vonalak, sokszögek vagy pontok rajzolhatók a térképekre. Az entitás akkor kerül az Esri térképen mentésre, ha a jellemzőt a lekérdezés egyik rekordjához társítja, vagy bejelöli az Összes jellemző megjelenítése jelölőnégyzetet. A rendszerrel szállított szerkesztő eszközprimitív neve: sampleEditor.js. Ezt a fájlt az egyéni szerkesztési eszközprimitívek létrehozásának példájaként is felhasználhatja. A rendszerrel szállított szerkesztő eszközprimitívben lehetőség van arra, hogy a jellemzőket IBM TRIRIGA azonosítókhoz társítsa. A jellemző-azonosító társításhoz adja meg az információs ablaktáblán szereplő szám- vagy szövegmezők egyikének értékét. A minta a Kiadási azonosító mezőt használja. Ugyanezt a módszert más szerkesztési eszközprimitívben is alkalmazhatja, hogy a segítségével értékekhez társítsa a jellemzőket.
Jellemzőket rajzolhat, majd azokat IBM TRIRIGA rekordokhoz társíthatja, ha a Táblázat megjelenítése lapon a táblázat egyik IBM TRIRIGA rekordja esetében a Társítás kiválasztott jellemzőhöz ikonra kattint. A rekord következő lekérdezése alkalmával az adott jellemző megjelenik a térképen. Az IBM TRIRIGA azonosító az IBM TRIRIGA és az Esri rendszerben használt közös azonosító. Ha engedélyezett ez a funkció, akkor a rendszerrel szállított szerkesztő eszközprimitív megzavarja a gombostűk által biztosított buborékjelzés információit. A jelen kiadás idején erre egyelőre nincs ismert áthidaló megoldás. Közelség eszközprimitív A rendszerrel szállított közelség eszközprimitív segítségével a térkép egyes pontjaira kattintva a kiszolgáló az adott ponttól meghatározott sugarú távolságra lévő körzetet dolgozza fel. A térképen megjelenő adatok megváltoznak, hogy csak az adott közelségi határon belüli épületek legyenek láthatók. A közelség határvonalát a kiszolgáló állapítja meg.
Egyéni eszközprimitívek Az egyéni eszközprimitívek az Esri eszközprimitíveknek megfelelően széttagolt JavaScript kódrészekből épülnek fel. Ezzel a szolgáltatással olyan egyéni Esri eszközprimitíveket lehet hozzáadni, amelyek az Esri JavaScript API 3.3 változatára épülnek. Előfordulhat, hogy az egyéni eszközprimitív olyan egyszerű, hogy mindössze egy térképi átfedést jelent, vagy akár olyan összetett, hogy lehetővé teszi a sokszögek szerkesztését. Az eszközprimitívek meghatározásához töltse fel az adott eszközprimitív JavaScript kódját a Kód mezőben. Miután hozzáadta az egyéni JavaScript kódot a bináris mezőhöz, a rendszer beszúrja azt az Esri JavaScript megjelenítőbe, majd futás közben hozzáfűzi a megjelenített térképhez. További információkért tekintse meg a következő műszaki leírást: EsriJS eszközprimitívek összeállítása (https://www.ibm.com/developerworks/community/wikis/home?lang=en#/wiki/ IBM+TRIRIGA1/page/Connector+for+Esri+GIS).
Eszközprimitív-csoportok Az eszközprimitív-csoportok azokat a jogosultságcsoportokat határozzák meg, amelyek számára - az adminisztrátori csoporton kívül - engedélyezett az eszközprimitívek elérése. Azok a felhasználók, akik a felsorolt jogosultságcsoportok bármelyikének, illetve az adminisztrátori csoportnak a tagjai, akkor tekinthetnek meg egy adott eszközprimitívet, ha annak Jogosultság hozzáadása beállítását bejelölték az Eszközprimitívek szakaszban.
Geometriai szolgáltatások A geometriai szolgáltatás az Esri JavaScript megjelenítő esetében a kivetítési átalakítások feldolgozásához igénybe vett szolgáltatást azonosítja. Erre a szolgáltatásra hivatkozni lehet az eszközprimitívekben, valamint felhasználható a pontkivetítéshez.
Előkép-beállítások Lehetősége van arra, hogy megtekintse a GIS térképrekordban beállított térkép előképét, valamint elvégezze a térképi beállítások mentését az űrlap Előkép lapján. Az aktuális nézet alaptérképének és tartományának mentését a Részletek megjelenítése lapra kattintva a Beállítások mentése gomb segítségével hajthatja végre. Ha a Beállítások törlése gombot választja, azzal visszaállítja az alaptérképet és a tartományt azok GIS térképrekordban meghatározott alapértékeire. A beállítások a GIS térképrekord és a GIS felhasználói beállítások objektuma közötti társítás révén kerülnek mentésre. Minden egyes térkép esetében gondoskodhat a beállítások tárolásáról. 3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel
37
A térképen ábrázolt adatokat táblázatban is megtekintheti, ha a Táblázat megjelenítése lapot választja. Amikor kijelöl egy sort a táblázatban, akkor a térkép ráközelít az adott rekordnak megfelelő pontra a térképen, majd középre is igazítja azt. A táblázat jobb felső sarkában található Exportálás hivatkozás segítségével tabulátorral elválasztott értékeket tartalmazó szövegfájlként töltheti le a táblázatot. Az Előkép lap Összeállított URL mezőjében szereplő érték az Előkép lapon látható térkép URL címe. Az Összeállított URL mező értékét vágólapra másolhatja, majd onnan beillesztheti azt egy helyrekordba, ha az adott helyet a térképhez kívánja kötni.
GIS térképek beállítása A GIS térképeket GIS térképrekordok segítségével jelenítheti meg az IBM TRIRIGA portálokon és űrlapokon. A GIS térképrekord határozza meg az IBM TRIRIGA alkalmazás és az Esri térképeket szolgáltató ArcGIS kiszolgáló közötti kapcsolatot. A GIS térképrekord tartalmazza a megjelenítendő térképeket, rétegeket és eszközprimitíveket meghatározó metaadatokat.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > GIS > GIS térkép menüpontra. 2. Vegyen fel egy GIS térképrekordot. 3. Határozza meg a térkép nevét, a minimális és maximális tartományát, a térképhez tartozó közismert azonosítót (WKID). 4. Azonosítsa a lekérdezéseket a térképen megjelenített adateredmények meghatározása érdekében. 5. Azonosítsa az alaptérképeket és azok URL címét a térképszolgáltatást nyújtó Esri kiszolgálón. 6. Azonosítsa a térképen megjelenített jelmagyarázat-információkat biztosító esetleges rétegeket. 7. Cserélje le az ikonokat a térképen megjelenő gombostűképek személyre szabása érdekében. 8. Azonosítsa az esetleges eszközprimitíveket a további térképi eszközök biztosítása, illetve az új térképi eszközök személyre szabása céljából. 9. Azonosítsa az esetleges eszközprimitív-csoportokat, amelyekkel az adminisztrátori csoport tagjain kívül is biztonsági hozzáférés nyerhető az eszközprimitívekhez. 10. Határozza meg az Esri JavaScript megjelenítő esetében a kivetítéseket átalakító geometriai szolgáltatást. 11. Hozza létre, majd mentse a rekordot.
Egyéni GIS portálszakaszok hozzáadása A GIS portálszakaszok egy GIS térképet tartalmazó, alkalmazáson belüli weboldalra mutatnak. A GIS térképek a megjelenítendő adatokat meghatározó GIS térképrekordokhoz kerülnek társításra. A GIS portálszakaszok Külső portálszakasztípussal rendelkeznek, amely esetén meghatározhatja a térkép URL címét.
Erről a feladatról Az alkalmazáson belüli weboldalakkal a következő, rendszerrel szállított GIS portálszakaszok egyikét veheti igénybe a hivatkozáshoz: v triURL - GIS - Környezetvédelmi menedzser/tervező vagy v triURL - GIS - Környezetvédelmi menedzser/tervező (USA hatóság)
Eljárás 1. Állítsa be a GIS térképrekordot. Határozza meg a tartományt, lekérdezéseket, alaptérképeket, rétegeket és egyéb térképi elemeket. A példában a térkép neve Első saját térkép lesz. 2. A Portáltervező eszközben hozzon létre egy új portálszakaszt Külső portálszakasztípussal. 3. Adja meg a térkép URL címét. A példában az URL cím a következő: /html/en/default/rest/EsriJS?map=Első saját térkép. Az Első saját térkép map paramétere utasítja a térkép-megjelenítőt az adott GIS térképrekord megjelenítésére.
ArcGIS kiszolgálók meghatározása Az ArcGIS kiszolgáló egy külső online, illetve egy belső üzemeltetésű kiszolgáló lehet. A GIS térképek beszerzésének helyét az EsriJS osztálybetöltő- (ClassLoader) rekordban található egyik erőforrásfájl határozza meg.
Erről a feladatról A külső online ArcGIS kiszolgálóhoz kapcsolódó erőforrásfájlt kötelezően a következő névvel kell ellátni: EsriJS_arcgis.js. A belső üzemeltetésű - jellemzően tűzfal mögött elhelyezkedő - ArcGIS kiszolgálóra vonatkozó erőforrásfájl neve kötelezően Esri_API_3.3.zip. Az első alkalommal, amikor valamely felhasználó betölti a térképek bármelyikét, a szoftver csatlakozik az EsriJS osztálybetöltő-rekordban szereplő erőforrásfájl által meghatározott szolgáltatáshoz. Ha egyik erőforrásfájl sincs jelen, akkor a rendszer figyelmeztető üzenetet jelenít meg. Amennyiben mindkét erőforrásfájl megtalálható, úgy a külső online kiszolgáló kerül felhasználásra. A meglévő EsriJS osztálybetöltő-rekordok az Eszközök > Rendszerbeállítás > Rendszer > Osztálybetöltő menüpontban kerülnek felsorolásra.
Külső ArcGIS kiszolgálók meghatározása A külső online ArcGIS kiszolgáló helyét az EsriJS osztálybetöltő- (ClassLoader) rekordhoz hozzáadott erőforrásfájlban határozhatja meg.
Erről a feladatról Az Esri JavaScript alkalmazásprogramozási felületet (API) az Esri által biztosított tartalomszállítási hálózaton (CDN) keresztül kell beszerezni. Az API felületnek kötelező 3.3 változatúnak lennie. Az EsriJS osztálybetöltő-rekordhoz hozzáadásra kerülő erőforrásfájl neve kötelezően: EsriJS_arcgis.js. Miután hozzáadta az EsriJS_arcgis.js fájlt, a következő alkalommal, amikor egy felhasználó hozzáfér a GIS térképek bármelyikéhez, akkor a kérdéses és minden jövendő térkép a külső online kiszolgálóról kerül beszerzésre.
Eljárás 1. Töltse le a fájlt az Esri webhelyéről, amely meghatározza, hogy a vállalat melyik szolgáltatásra fizetett elő. Előfordulhat például, hogy az init.js fájlt kell a következő címről letölteni: http://js.arcgis.com/3.3/. 2. Nevezze át a letöltött fájlt a következőre: EsriJS_arcgis.js. 3. Nyissa meg az EsriJS osztálybetöltő-rekordot. 4. A rekordban adjon hozzá egy erőforrásfájlt, hogy feltölthesse az EsriJS_arcgis.js fájlt. Ha az EsriJS_API_3.3.zip fájl jelen van, eltávolíthatja azt az erőforrásfájlok közül. 5. Végezze el a rekord mentését. 3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel
39
Belső ArcGIS kiszolgálók meghatározása A belső üzemeltetésű ArcGIS kiszolgáló helyét az EsriJS osztálybetöltő- (ClassLoader) rekordhoz hozzáadott erőforrásfájlban határozhatja meg.
Erről a feladatról A [HOSTNAME_AND_PATH_TO_JSAPI] értéket módosítani kell, hogy az a BASE_URL változóra hivatkozzon. Az EsriJS osztálybetöltő-rekordhoz hozzáadásra kerülő erőforrásfájl neve kötelezően: EsriJS_API_3.3.zip. Miután hozzáadta az EsriJS_API_3.3.zip fájlt, a következő alkalommal, amikor egy felhasználó hozzáfér a GIS térképek bármelyikéhez, akkor a kérdéses és minden jövendő térkép a belső üzemeltetésű kiszolgálóról kerül beszerzésre.
Eljárás 1. Nyissa meg az ESRI letöltések (www.esri.com/apps/products/download/) webhelyét. a. Töltse le az ArcGIS alkalmazásprogramozási felületet a JavaScript v3.3 API számára (arcgis_js_v33_api.zip). b. Bontsa ki a fájlokat a tömörített állományból. 2. Keresse meg az arcgis_js_v33_api\library\3.3\jsapi\init.js fájlt, majd nyissa meg azt egy szövegszerkesztővel. a. Keresse meg a [HOSTNAME_AND_PATH_TO_JSAPI] értéket ebben a sorban: location.protocol) + ’//’ + "[HOSTNAME_AND_PATH_TO_JSAPI]js/ dojo/dojo" b. Módosítsa a sort a következő kódra: location.protocol) + ’//’ + BASE_URL + "js/dojo/dojo" c. Figyeljen az idézőjelek helyére. d. Végezze el az init.js fájl mentését. 3. Keresse meg az arcgis_js_v33_api\library\3.3\jsapi\dojo\dojo\dojo.js fájlt, majd nyissa meg azt egy szövegszerkesztővel. a. Keresse meg a [HOSTNAME_AND_PATH_TO_JSAPI] értéket ebben a sorban: location.protocol) + ’//’ + "[HOSTNAME_AND_PATH_TO_JSAPI]js/ dojo/dojo" b. Módosítsa a sort a következő kódra: location.protocol) + ’//’ + BASE_URL + "js/dojo/dojo" c. Figyeljen az idézőjelek helyére. d. Végezze el a dojo.js fájl mentését. 4. Keresse meg az arcgis_js_v33_api\library könyvtárat, majd jelölje ki a 3.3 mappát. Hozzon létre egy tömörített fájlt a mappából. 5. Nevezze át a tömörített fájlt a következőre: EsriJS_API_3.3.zip. 6. Nyissa meg az EsriJS osztálybetöltő-rekordot. 7. A rekordban adjon hozzá egy erőforrásfájlt, hogy feltölthesse az EsriJS_API_3.3.zip fájlt. Ha az EsriJS_arcgis.js fájl jelen van, el kell távolítania azt az erőforrásfájlok közül. 8. Végezze el a rekord mentését.
Átváltás belsőről külső kiszolgálókra Az ArcGIS kiszolgáló helyét az EsriJS osztálybetöltő- (ClassLoader) rekordhoz hozzáadott erőforrásfájlban határozhatja meg. Az erőforrásfájlt a belső üzemeletetésű kiszolgálóról külső online kiszolgálóra helyezheti át, illetve ugyanezt fordított irányban is megteheti.
Erről a feladatról Miután módosította az ArcGIS kiszolgálót, a következő alkalommal, amikor egy felhasználó hozzáfér a GIS térképek bármelyikéhez, akkor a kérdéses és minden jövendő térkép az új kiszolgálóról kerül beszerzésre.
Eljárás 1. Nyissa meg az EsriJS osztálybetöltő-rekordot. 2. Keresse meg vagy hozza létre az új ArcGIS kiszolgálót meghatározó erőforrásfájlt, majd vegye fel az erőforrásfájlt a rekordba. 3. Távolítsa el a régi ArcGIS kiszolgálót meghatározó régi erőforrásfájlt. 4. Végezze el a rekord mentését.
GIS térképek hibaelhárítása A GIS portálszakaszokkal és az űrlapok lapjaival kapcsolatban felmerült bármely teljesítmény- vagy megjelenítési probléma megoldásának elősegítése érdekében tanulmányozhatja a következő problémákat, okokat és megoldásokat.
GIS térképekkel kapcsolatos általános problémák Az általános GIS problémák közé tartoznak a hosszú válaszidők, a hiányzó elemek és az ismétlődő rekordok. Általános magyarázatuk esetleg segíthet megoldani a fennálló problémákat. A térkép lassan válaszol A térkép nagyítása és kicsinyítése esetén tapasztalt frissítési gyakoriság internetkapcsolata sebességétől függ. A térkép minden mozgatásakor egy válaszadásra és a térkép újrarajzolására irányuló hívást küld el. Ezeket a műveleteket Esri JavaScript megjelenítője kezeli. A térkép újrarajzolásához szükséges időtartam a használt hálózat sebességétől függ. Ha online szolgáltatást, például az Esri funkcióit használja, akkor a parancsok HTTP protokollon keresztül kommunikálnak. Amennyiben házon belüli Esri kiszolgálót alkalmaz, úgy a késleltetést a helyi intranet határozza meg. Ha Esri JavaScript megjelenítője Microsoft Internet Explorer böngészőben üzemel, akkor ellenőrizze, hogy a következő XML HTTP beállítás engedélyezett-e a böngészőben. Jelölje be az Eszközök > Internetbeállítások > Speciális > Natív XMLHTTP-támogatás engedélyezése beállítást. A buborékjelzésekben és a táblázatban látható címkék nem jelennek meg A buborékjelzésben és a táblázatban látható címkéket IBM TRIRIGA lekérdezések határozzák meg. A jelzések térképen való elhelyezéséhez az adatoknak tartalmazniuk kell, a lekérdezésnek pedig meg kell jelenítenie a Szélesség és Hosszúság címkéjű mezőt. A hely képének buborékjelzésekben való megjelenítéséhez a hely adatainak magukban kell foglalniuk, illetve a lekérdezésnek meg kell jelenítenie a Kép címkéjű mezőt. Hiányzó helyek v A helyek nincsenek geokódolva. A helyek térképi megjelenítéséhez a rekordokat földrajzi kódolással kell ellátni. v A lekérdezés nem eredményez találatokat. v Az ArcGIS kiszolgáló nem működik vagy nem válaszol. Nem jelennek meg adatok v Minden lekérdezésnek helyek vagy entitások listájára kell feloldásra kerülnie. 3. fejezet Adatok integrálása a TRIRIGA Connector for Esri Geographic Information System (GIS) rendszerrel
41
v A rendszer tervezéséből adódóan egy kezdeti lekérdezéssel és egy alaptérképpel rendelkezik. Az általános lekérdezések kihagyhatják ezeket a követelményeket, és minden geokódolt találatot megjeleníthetnek a térképen. A lekérdezésnek olyan eredményeket kell visszaadnia, amelyek tartalmazzák a szélesség és hosszúság oszlopát. Ismétlődő rekordok A táblázatban a hierarchikus adatszerkezetek adatproblémája okoz ismétlődő rekordokat. A GIS simított hierarchiatáblákat használ. Újraépítheti a simított hierarchikus adatszerkezeteket. A GIS szakasz üres Ha a GIS szakaszban térkép helyett üres (fehér) képernyő jelenik meg, akkor ellenőrizze a következő feltételeket: v A GIS konfigurációs oldalak megfelelően beállításra kerültek. v Az ArcGIS kiszolgáló jelenleg is működik. v Az ArcGIS osztálybetöltő nincs hibakeresési módba állítva. v Rendelkezik licenccel a GIS térkép használatához. Hiányzó licencről szóló üzenet Ha egy üzenet azt állítja, hogy nem rendelkezik GIS licenccel, akkor ellenőrizze az IBM TRIRIGA licencfájl(ok) naprakész voltát.
Ismétlődő rekordok eltávolítása a GIS térképekről Ha a GIS térkép megjelenítéséhez kapcsolódó táblából el kívánja távolítani az ismétlődő rekordokat, akkor az IBM TRIRIGA adatmodellező segítségével építheti újra a simított hierarchiastruktúrát.
Eljárás 1. Válassza az Eszközök > Tervezőeszközök > Adatmodellező menüpontot. 2. Válassza a Segédprogramok > Hierarchiastruktúrák lehetőséget. 3. Válassza az Összes földrajzi elhelyezkedés, majd az Adatok előállítása hivatkozást. 4. Válassza az Épületterületek, majd az Adatok előállítása hivatkozást. 5. Válassza az Épületek és telkek, majd az Adatok előállítása hivatkozást.
4. fejezet Kapcsolatfüggvények kiterjesztése Számos IBM TRIRIGA kapcsolat részére írhat kiterjesztett függvényeket. Ezek a kiterjesztett függvények az osztálybetöltőket, erőforrásfájlokat, egyéni munkafolyamat-összetevőket, kiszolgálókisalkalmazás-proxykat, a Java programozási nyelvet és az IBM TRIRIGA Connector for Business Applications webszolgáltatás-felületet veszik igénybe.
Kiterjesztett függvények áttekintése Az IBM TRIRIGA kapcsolatok a ClassLoader (osztálybetöltő) üzleti objektumot és az erőforrásfájlokat használják fel. A kiszolgálókisalkalmazás-proxy az osztálybetöltők kiterjesztése. A kiterjesztett függvények összeállításakor a függvényeket objektumátállítási csomagokban terjesztheti. A kapcsolatok a ClassLoader (osztálybetöltő) üzleti objektumot és az erőforrásfájlokat használják, valamint olyan egyéni munkafolyamat-összetevőket vesznek igénybe, mint a CustomTask, a CustomParameters és a CustomTransitions összetevő. A kiszolgálókisalkalmazás-proxy az osztálybetöltők azon kiterjesztése, amely egy azonosítót biztosít a Java alkalmazásprogramozási felülethez (API) az IBM TRIRIGA Connector for Business Applications (CBA) számára. A CBA Java kiszolgálókisalkalmazás-stílusú programozást használ az egyéni űrlapösszetevőkkel rendelkező külső rendszerekkel való integrációhoz. Az IBM TRIRIGA kapcsolatok létrehozásához jártasnak kell lennie az IBM TRIRIGA Application Platform tervezőeszközök, az IBM TRIRIGA Connector for Business Applications webszolgáltatás-felület és a Java programozási nyelv használatában. A kapcsolatokat csak a Java programozási nyelv felhasználásával lehet megvalósítani.
Egyéni osztálybetöltők Az IBM TRIRIGA egyéni osztálybetöltő összetevői a rendszer osztálybetöltőivel együttműködve hajtják végre a Java osztályok alkalmazáskiszolgáló-tartománybeli telepítését. A következő ábra az IBM TRIRIGA egyéni osztálybetöltője és a rendszer osztálybetöltői közötti együttműködést szemlélteti.
Egyéni osztályok és egyéni feladatok Az osztálybetöltő-rekordok létrehozásakor egyéni Java osztályokat adhat hozzá az alkalmazáskiszolgáló osztályútvonalához. Ezek az osztályok a munkafolyamatok egyéni feladataiból érhetők el. Az egyéni Java osztályokat háromféle módon adhatja hozzá az alkalmazáskiszolgáló osztályútvonalához: a Szülő először, a Szülő utoljára és az Elkülönített módszer közül választhat. Ezeket az osztályokat a munkafolyamatok egyéni feladataival lehet elérni a programozható együttműködés érdekében, illetve kiterjesztésük révén azok Java kiszolgáló kisalkalmazásként működtethetők. Az egyik módszer kiterjeszti az űrlapképességeket a portálszakaszok és az űrlapokon lévő lapok számára. Ha az osztályokat az osztálybetöltőn keresztül betöltött egyéni feladatokból kívánja elérni, akkor figyelembe kell vennie a következő szabályokat: v A következő három adatszerkezet egyikével indítsa el az osztálycsomagokat: com.tririga.ps, com.tririga.appdev vagy com.tririga.custom. Minden más adatszerkezet le van tiltva. v A munkafolyamat egyéni feladatában egy kettőspont után adja meg az osztálybetöltő nevét az Osztálynév mezőben. Ha például a MyClassLoader nevű osztálybetöltő-rekorddal rendelkezik, az adatbevitel osztálya pedig a com.tririga.custom.myclassloader.Hello osztály, akkor az Osztálynév mezőben szereplő érték a következő lesz:
MyClassLoader:com.tririga.custom.myclassloader.Hello. Ha ezt az elnevezési megállapodást alkalmazza, akkor a munkafolyamat képes osztálykeresést végezni a megadott osztálybetöltő kontextusán belül. v Valósítsa meg azon com.tririga.workflow.pub.CustomTask objektumok egyikét, amelyek a Telepítési_könyvtár/tools/BusinessConnect mappában található, rendszerrel együtt szállított TririgaCustomTask.jar fájlban állnak rendelkezésre. Fejlesztési célokra bele kell foglalnia a TririgaBusinessConnect.jar és a TririgaCustomTask.jar fájlt integrált fejlesztői környezete (IDE) osztályútvonalába. Ha felveszi ezeket a függvénytárakat a ClassLoader (osztálybetöltő) üzleti objektumba, akkor azok figyelmen kívül maradnak. Az egyéni feladatok megvalósítási módjával, valamint az általuk kínált funkciókkal kapcsolatban információkért forduljon az Alkalmazáskészítés az IBM TRIRIGA Application Platform 3-as változatában című kiadványhoz. A ClassLoader objektum egyszerű kezelési módszert biztosít a gyakori telepítéshez, valamint az egyénifeladat-megvalósítások biztonságos felügyeletéhez. Nem bővíti ki vagy változtatja meg az egyéni feladat funkcióját. Az Alkalmazáskészítés az IBM TRIRIGA Application Platform 3-as változatában című kiadvány szolgál útmutatással a fájlok elhelyezéséhez az alkalmazáskiszolgáló lib könyvtárában. Kihagyhatja ezt a lépést, ami azonban bonyodalmakhoz vezethet, ha több kiszolgálóval rendelkezik. Ehelyett vegye fel az osztálybetöltőt az adatbázisba, majd hagyja, hogy a tároló intelligens módon kibontsa és használja az osztályokat.
Osztálybetöltő-fejlesztési mód Fejlesztési módban megváltoztathatja a fájlokat, a módosításokat pedig az oldal frissítésével, a fájlok osztálybetöltő-rekordba való feltöltése nélkül tekintheti meg. Rendes körülmények között az erőforrásfájlok osztálybetöltő-rekordban történő módosítása, hozzáadása vagy eltávolítása esetén a rendszer egy munkafolyamatot futtat, amely megnöveli a felülvizsgálati számot. Ez a felülvizsgálati számban bekövetkező változás közli az IBM TRIRIGA Application Platform rendszerrel, hogy újból be kell töltenie az adott osztálybetöltő-rekordot. Ha azonban hozzáféréssel rendelkezik az IBM TRIRIGA rendszer telepítési_könyvtár/ userfiles/osztálybetöltő_neve mappájához, bejelölheti a Fejlesztési mód beállítást az osztálybetöltő-rekordban. A beállítás bejelölése esetén az osztálybetöltő figyelmen kívül hagyja a felülvizsgálati számot, és helyette a telepítési_könyvtár/userfiles/ osztálybetöltő_neve mappából olvassa be a fájlokat. A módosítható fájltípusok közé tartoznak a weboldalak (.html), a JavaScript fájlok (.js), valamint az Adobe Flash és képfájlok. FIGYELEM: Ha megszünteti a Fejlesztési mód jelölőnégyzet jelölését, akkor az IBM TRIRIGA Application Platform rendszer az osztálybetöltő-rekordból olvassa be a legújabb fájlokat, és felülírhatja a munkáját.
Kiszolgálókisalkalmazás-proxyk A kiszolgálókisalkalmazás-proxy az osztálybetöltők kiterjesztése. A segítségével olyan kiszolgálókisalkalmazás-stílusú osztályok fejleszthetők, amelyek képesek végrehajtani az osztálybetöltő-rekordban található űrlapeszközök előállítását, átirányítását, illetve a velük folytatott kommunikációt. Az eszközöket erőforrásfájlokként kell feltölteni az osztálybetöltő-rekordba. A következő ábra a kiszolgálókisalkalmazás-proxy és az IBM TRIRIGA rendszer egyéni osztálybetöltője közötti együttműködést szemlélteti.
4. fejezet Kapcsolatfüggvények kiterjesztése
45
TRIRIGA
Request
Servlet proxy
Authenticate session
Throw exception
Custom ClassLoader
TRIRIGA database
Instantiate implementation class
No
Authenticate client
No
TririgaWS (CBA API)
Yes
IConnect implementation
Connector for Business Applications
Yes
GUI
Custom code
Remote data access
Render GUI
2. ábra: Kiszolgálókisalkalmazás-proxy
A kiszolgálókisalkalmazás-proxy elérése A kiszolgálókisalkalmazás-proxy a következő URL címen érhető el: http://Saját_kiszolgáló/ html/en/default/rest/Kapcsolat_neve. Ha a kiszolgálókisalkalmazás-proxy például a MyFirstConnector nevet viseli, és megfelelően beállításra került, akkor a következő URL címen érhető el: http://Saját_kiszolgáló/html/en/default/rest/MyFirstConnector. Az URL cím eléréséhez érvényes felhasználónévvel és jelszóval kell rendelkeznie. Az URL címet külső hivatkozásként adhatja hozzá a portálszakaszokban vagy az űrlapok egyéni lapjain. A kiszolgálókisalkalmazás-proxy minden elérése ennél az alapvető URL címnél kezdődik. Az osztálybetöltő-erőforrásfájlokon belül található fájlok eléréséhez fűzze a resource kifejezést az alapvető URL címhez, majd utána adja meg a betölteni kívánt erőforráshoz vezető elérési útvonalat. Ha például egy képpel rendelkezik a helloWorld.jpg nevű erőforrásfájlban, akkor ezt a képet dinamikus módon a következő URL cím segítségével töltheti be: http://Saját_kiszolgáló/html/en/default/rest/MyFirstConnector/resource/helloWorld.jpg. A kiszolgáló ellenőrzi az erőforrásfájl betöltését. Ha a fájl nincs betöltve, akkor a kiszolgáló beolvassa azt az erőforrásfájl-rekord bináris Erőforrásfájl mezőjéből, majd elhelyezi a fájlt a Telepítési_könyvtár/userfiles/Osztálybetöltő_neve mappában. Ha kérés érkezik, a kiszolgáló ellenőrzi a gyorsítótárat, amelynek során egyezteti a fájl felülvizsgálati számát az
osztálybetöltőbeli felülvizsgálati számmal. Ha a felülvizsgálati számok eltérőek, akkor a kiszolgáló ismét betölti az összes olyan fájlt ebbe a könyvtárba, amely nem része .jar fájlnak. Ezután a kiszolgáló erre a helyre hivatkozik minden további kérésnél. Az erőforrásfájlok minden módosítás alkalmával automatikusan frissítésre kerülnek. Az osztálybetöltő frissítéséhez nem szükséges újraindítania a kiszolgálót.
Erőforrásfájlok hozzáadása az osztálybetöltőkhöz Az erőforrásfájlok osztálybetöltőhöz való hozzáadása révén az osztályokhoz és űrlapeszközökhöz, például a weboldalakhoz (.html), JavaScript fájlokhoz (.js), Flash animációkhoz, képekhez és tulajdonságfájlokhoz biztosíthat hozzáférést. Például az EsriJS osztálybetöltő-rekordban található JavaScript (.js) erőforrásfájlok egyike azt határozhatja meg, hogy a GIS térképek milyen forrásból származnak.
Erről a feladatról Az erőforrásfájlokat több osztálybetöltő is használhatja. Az erőforrásfájlok esetén jó alapszabály a függvénytárak nevét az osztálybetöltő rövidítését és a függvénytár valódi nevét tartalmazó előtaggal ellátni. Ha éppen egy .jar fájlt tölt fel, akkor csak a .class fájlok kerülnek az osztályútvonalra betöltésre. Ha számos eszközzel, például weboldallal (.html), JavaScript (.js) és képfájllal rendelkezik, akkor azokat egy tömörített fájlban összegyűjtve egyetlen fájlként töltheti fel. Emellett a fájlok (köztük például a konfigurációs fájlok) egyenként is feltölthetők, így könnyebben elvégezheti azok módosítását. Az erőforrásfájlok osztálybetöltő-rekordban történő módosítása, hozzáadása vagy eltávolítása esetén a rendszer egy munkafolyamatot futtat, amely megnöveli a felülvizsgálati számot. Ez a felülvizsgálati számban bekövetkező változás közli az IBM TRIRIGA Application Platform rendszerrel, hogy újból be kell töltenie az adott osztálybetöltő-rekordot.
Eljárás 1. Lépjen át az Eszközök > Rendszerbeállítás > Rendszer > Osztálybetöltő menüpontra. 2. Vegye fel vagy nyissa meg az osztálybetöltő-rekordot. 3. A rekordban keresse meg vagy adja hozzá az erőforrásfájlokat. 4. Végezze el a rekord mentését.
Kiszolgálókisalkalmazás-proxyk beállítása Ahhoz, hogy a kiszolgálókisalkalmazás-proxy megfelelően dolgozza fel és bocsássa át a megírt kódot, meg kell valósítania egy TririgaCustomTask.jar fájlban tárolt Java felületosztályt.
Erről a feladatról A com.tririga.custom csomag az egyetlen olyan csomag, amelynek segítségével létrehozhat egy megvalósítási osztályt. Az osztálynak egyedinek kell lennie. Osztálybetöltő-rekordonként csak egy IConnect megvalósítási osztállyal rendelkezhet. Az osztálybetöltő-rekord nevének, valamint az IConnect osztályt megvalósító Java osztálynak azonosnak kell lennie. Ha például a MyFirstConnector nevű osztállyal rendelkezik, akkor az osztálybetöltő-rekordot szintén a MyFirstConnector névvel kell azonosítania. Miután konfigurálta a kiszolgálókisalkalmazás-proxyt, hozzáférhet a kapcsolathoz. 4. fejezet Kapcsolatfüggvények kiterjesztése
47
Eljárás 1. Hozzon létre egy Java osztályt a com.tririga.custom csomagban. Például készítsen egy MyFirstConnector nevű osztályt. 2. Valósítsa meg a com.tririga.pub.adapter.IConnect Java felületet az IConnect osztályban található execute metóduson keresztül. Ha például osztálya a MyFirstConnector nevet viseli, akkor a következő kódot állíthatja össze: public class MyFirstConnector implements IConnect { public void execute(TririgaWS tws, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //ide kerül az összeállított kód } }
Ez a példa egy TririgaWS felületosztályhoz kapcsolódó azonosítót tartalmaz. Ez az osztály az IBM TRIRIGA Connector for Business Applications API Java felülete. A példa egy olyan alapvető kérést és választ is bemutat, amellyel rendes körülmények között Java kiszolgáló kisalkalmazásokban rendelkezhet. 3. Ott adja hozzá a megírt kódot az execute metódushoz, ahol az //ide kerül az összeállított kód megjegyzést látja. A példa folytatásaként a "Helló, világ!" szavakat tartalmazó weboldal (.html fájl) megjelenítéséhez az alábbi kódsorokat kell beszúrnia: PrintWriter out = response.getWriter(); try{ response.setContentType("text/html"); out.println(""); out.print("Helló, világ!"); out.println(""); out.flush(); } finally { if(out!=null)out.close(); }
4. Fordítsa le a Java osztályt, majd adja hozzá azt egy .jar fájlhoz. Például a MyFirstConnector osztály lefordítása után adja azt hozzá a MyFirstConnector.jar nevű .jar fájlhoz. 5. Lépjen át az Eszközök > Rendszerbeállítás > Rendszer > Osztálybetöltő menüpontra. 6. Vegye fel az osztálybetöltő-rekordot. Például vegye fel a MyFirstConnector nevű osztálybetöltő-rekordot. 7. A rekordban adjon hozzá egy erőforrásfájlt, hogy feltölthesse a MyFirstConnector.jar fájlt. 8. Végezze el a rekord mentését.
Kiterjesztett függvények hibaelhárítása Az osztálybetöltőkhöz, kiszolgálókisalkalmazás-proxykhoz vagy egyéni kapcsolatokhoz kötődő problémák megoldásának elősegítése érdekében tanulmányozhatja a következő problémákat, okokat és megoldásokat.
A kiterjesztett függvényekkel kapcsolatos általános problémák Az osztálybetöltőkhöz, kiszolgálókisalkalmazás-proxykhoz és egyéni kapcsolatokhoz kötődő általános problémákat a platformnaplók aktiválása vagy személyre szabása révén lehet megoldani. A platformnaplózás elindítása Az Adminisztrátori konzolon a Platformnaplózás felügyelt objektumban kapcsolja be az Osztálybetöltő és a Kiszolgálókisalkalmazás-proxy kategória hibakeresését. Ezen részletes módú naplók jó áttekintést adnak a kiszolgáló tevékenységéről.
Az Adminisztrátori konzol elérésével és használatával kapcsolatos információkért forduljon az IBM TRIRIGA Application Platform 3 - Adminisztrátori konzol felhasználói kézikönyv című kiadványhoz. Az osztálybetöltők és kiszolgálókisalkalmazás-proxyk hibakeresésének egyszerűbbé tétele Az Adminisztrátori konzolon a Platformnaplózás felügyelt objektum egyéni kategóriával történő kiegészítéséhez vegye fel azt a CustomLogCategories.xml fájlba, majd indítsa újra a kiszolgálót. A CustomLogCategories.xml fájl a Telepítési_könyvtár/config mappában található. Ez az előnyben részesített módszer, mivel egyszer kell a beállítást elvégezni. Ha a kiszolgáló újraindításra került, a beállítás egyéni kategóriában történő kiválasztásával visszakapcsolhatja a DEBUG (hibakeresés) módot. A .jar fájlok nem a várt módon kerülnek telepítésre Ne adja hozzá ugyanannak a .jar fájlnak több példányát is az osztálybetöltő-rekordokhoz. Például az egyik hozzáadására közvetlenül kerül sor, a másik pedig egy tömörített fájlon belül található. Ha ez történik, a .jar fájl betöltött példánya nem kiszámítható.
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
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.
