Kapitola 4. Rozšíření funkcí konektoru Přehled rozšířených funkcí . . . . . . Vlastní zavaděče tříd . . . . . . . Vlastní třídy a vlastní úlohy . . . . . Režim vývoje zavaděče tříd . . . . . Servery proxy servletů . . . . . . Přístup k serveru proxy servletu . . . . Přidání souborů prostředků do zavaděčů tříd . Konfigurace serverů proxy servletu. . . . Odstraňování problémů s rozšířenými funkcemi Běžné problémy s rozšířenými funkcemi .
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS) . . . . . . . 29 Přehled map GIS . . . . . . . . . . Datové služby Esri a nástroje IBM TRIRIGA.
Kapitola 1. Integrace dat s externími aplikacemi Nástroje konektoru produktu IBM® TRIRIGA Application Platform použijte k importu, aktualizaci nebo exportu dat z databáze produktu IBM TRIRIGA, nebo k propojení nebo sdílení dat s aplikacemi produktu IBM TRIRIGA. Tyto nástroje zahrnují objekt integrace produktu TRIRIGA, produkty IBM TRIRIGA Connector for Esri Geographic Information System (GIS), IBM TRIRIGA Connector for Business Applications, IBM TRIRIGA DataConnect, IBM TRIRIGA Data Integrator a integraci služeb OSLC.
Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA Integrační objekt TRIRIGA je obslužný obchodní objekt v modulu triIntegration, který obsahuje metadata řídící integraci mezi produktem IBM TRIRIGA a externími systémy. Když vytvoříte definice integrace s integračním objektem TRIRIGA, použijete k sestavení připojení integrací standardní nástroje produktu IBM TRIRIGA, jako např. sledy prací a dotazy.
Přehled integračního objektu produktu TRIRIGA Když použijete integrační objekt k definování nové definice integrace, musíte vybrat datové schéma. V závislosti na výběru schématu musíte nadefinovat několik prvků, které zahrnují zdroj dat, soubor importu nebo exportu, odchozí dotaz, mapování dat nebo mapu odezvy.
Záznamy integračních objektů Chcete-li nadefinovat novou definici integrace, musíte vytvořit záznam integračního objektu z integračního objektu produktu TRIRIGA. Chcete-li zobrazit existující záznamy integračního objektu, vyberte volbu Nástroje > Nastavení systému > Integrace > Integrační objekt.
Datová schémata Když nadefinujete novou definici integrace, musíte vybrat z několika voleb nebo schémat pro nadefinování informačního obsahu, protokolu a přenosu pro data. Schéma databáze používá tabulky databáze pro import nebo export dat. Schéma souboru používá k importu nebo exportu dat soubory. Schéma DataConnect importuje soubory do pracovních tabulek DataConnect. Schéma HTTP post exportuje data pomocí protokolu HTTP.
Schéma databáze Když zvolíte příchozí schéma databáze, musíte definovat zdroj dat a mapování dat. Mapování dat se používá k mapování dat z externího zdroje na existující pole produktu IBM TRIRIGA. Když zvolíte odchozí schéma databáze, musíte definovat zdroj dat a odchozí dotaz. Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA.
Schéma souboru Když zvolíte příchozí schéma souboru, musíte definovat soubor importu a mapování dat. Mapování dat se používá k mapování dat z externího zdroje na existující pole produktu IBM TRIRIGA. Když zvolíte odchozí schéma souboru, musíte definovat soubor exportu a odchozí dotaz. Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA.
Pomocí tohoto schématu můžete použít sledy prací ke zpracování a ověření dat, čímž získáte další kontrolu nad ošetřováním chyb. Další informace o DataConnect viz příručka Application Building for the IBM TRIRIGA Application Platform: Data Management.
Schéma HTTP post Když vyberete odchozí schéma HTTP post, musíte definovat server, kam se data zašlou, odchozí dotaz a mapu odezvy. Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA. Mapa odezvy se používá k mapování parametrů odezvy z požadavku HTTP na existující pole produktu IBM TRIRIGA.
Nástroje databáze Když vyberete schéma databáze nebo schéma DataConnect, můžete otestovat databázového spojení, generovat testovací data nebo generovat SQL pro tabulku databáze. Chcete-li vyexportovat velké binární objekty, musíte použít dynamický odchozí dotaz.
Testování databázového připojení Výběrem akce Testovat databázové připojení ověříte, že server může komunikovat s databází. Název tabulky se použije ke spuštění dotazu select 1+1 from [table name] na databázi. Barva záhlaví sekce Databáze se změní na červenou, pokud dojde k chybě. Chcete-li zobrazit chyby, přezkoumejte protokoly serveru v konzole administrátora produktu IBM TRIRIGA. Informace o konzole administrátora viz příručka IBM TRIRIGA Application Platform 3 Administrator Console User Guide.
Povinný přístup k tabulce pro schéma DataConnect Schéma DataConnect je oddělené od interního rozhraní API produktu IBM TRIRIGA a využívá produkt IBM TRIRIGA Connector for Business Applications ke komunikaci s produktem TRIRIGA. Schéma DataConnect umožňuje přístup k databázi pro kontrolu, čtení a zápis do tabulek. Schéma DataConnect vyžaduje přístup k následujícím tabulkám. Kromě tabulky DC_JOB a S_ jsou následující tabulky využity k určení sloupců, které jsou k dispozici pro objekty DataConnect. Stejné tabulky musí mít schopnosti čtení pro uživatele, který je zvolen ve zdroji dat. IBS_SPEC_TYPE_STAGE Přístup pro čtení. IBS_SPEC_TYPE Přístup pro čtení. SYS.COLUMNS (Microsoft SQL Server) Přístup pro čtení. SYS.TABLES (Microsoft SQL Server) Přístup pro čtení. IBS_MODULE Přístup pro čtení. ALL_TAB_COLUMNS (Oracle Database) Přístup pro čtení. DC_JOB Přístup pro čtení a zápis
Vytvoření generických SQL Vyberete akci Generovat SQL pro tabulku pro vytvoření generického SQL pro definování tabulky databáze. Než vyberete tuto akci, zadejte název tabulky databáze a dokončete mapování dat. Každá tabulka, která se používá pro příchozí integraci, musí mít následující sloupce: IMD_ID ID transakce, které je jedinečné pro každou položku v tabulce. Toto ID není stejné jako ID záznamu. IMD_STATUS Identifikuje stav každé položky v tabulce. Výchozí stav Připraveno identifikuje záznamy, které se zpracují. Další stavy zahrnují Probíhá zpracování, Dokončeno a Selhalo. IMD_MESSAGE Identifikuje chyby v importu řádku. Stejné chybové zprávy se také zobrazí ve formuláři Integrační objekt. TRIRIGA_RECORD_ID ID interního záznamu, který produkt IBM TRIRIGA používá k identifikaci záznamu, který se aktualizuje nebo vytváří. Následující ukázkový kód byl vygenerován pro příchozí integraci osoby-záznam s následujícími poli. -- Automaticky generovaný skript pro MSSQL. 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 ’Ready’, 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 )
Vytvoření testovacích dat Chcete-li načíst data do databáze, vyberte akci Generovat testovací data. Tato akce je k dispozici jen v příchozím směru. Jakmile vytvoříte tabulku databáze a připojíte se k ní, může načíst testovací data do databáze. Testovací data použijte ke spuštění jednoduchého testování funkčnosti, chcete-li si ověřit správnost mapování a správnost fungování procesu integrace. Zadejte počet řádků, které se vloží do tabulky databáze v poli Testovací řádky. Data budou generována jako alfanumerické hodnoty. Pokud uvedete výchozí hodnotu do svého mapování dat, tato hodnota se vloží do všech řádků. Tato výchozí hodnota je užitečná, pokud by pole mohlo být pole lokátoru, číselné pole, pole s datem nebo seznam, který vyžaduje specifickou hodnotu. Pokud se k naplnění pracovní databáze daty používá externí systém, externí systém musí naplnit pouze pole bez metadat. Sloupce IMD_* se naplní automaticky. Jakmile se aktualizuje nebo vytvoří záznam, sloupec TRIRIGA_RECORD_ID bude obsahovat ID záznamu, které identifikuje tento záznam interně v produktu IBM TRIRIGA.
Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
5
Podpora velkých binárních objektů (BLOB) Objekty BLOB jsou podporovány pro příchozí i odchozí schémata databáze. Podporované typy objektů BLOB zahrnují binární pole, pole s poznámkami a obsah správce dokumentů. Pole obrazů nejsou podporována. Chcete-li vyexportovat pole objektů BLOB, musíte použít mapování dat jako dynamický odchozí dotaz. Když naimportujete nebo exportujete objekty správce dokumentů, pro binární obsah neexistuje žádná skutečná hodnota dokumentu v tomto objektu. Namísto toho vyberete libovolný sloupec základního objektu, který se použije jako zástupný symbol pro váš obsah. Externí název může být cokoliv, co si přejete, ale hodnota ve sloupci Předvolba musí být CONTENT. Tato hodnota je spouštěč, který připojí objekt správce dokumentů k obsahu.
Nástroje souboru Když vyberete schéma souboru nebo schéma DataConnect, můžete otestovat připojení k souboru. Můžete číst nebo zapisovat kamkoliv na sí, kam má server přístup.
Příchozí integrace Pro příchozí integrace můžete naimportovat standardizované nestrukturované oddělené soubory. Ručně můžete zadat binární pole, které bude kopií importovaného pole integrace. Uvedení ručního pole vám pomůže při testování, takže lokální zpracování bude možné zpracovat bez přepsání souboru importu. Po importu bude soubor přejmenován pomocí data zpracování a přesunut do složky processed. Pokud je ve vašem prostředí IBM TRIRIGA spuštěno více agentů sledu prací, všechny servery musí mít bu přístup ke stejné lokalitě souboru, nebo ke své vlastní kopii tohoto souboru. Sled prací, který je spuštěn během procesu provedení integrace, musí mít přístup k souboru bez ohledu na to, který agent sledu prací spustil sled prací.
Odchozí integrace Pro odchozí integrace můžete exportovat formáty souborů, které zahrnují standardizované oddělené nestrukturované soubory a soubory .json, .xml nebo .xslt.
Tokeny HTTP post Když vyberete odchozí schéma HTTP post, můžete přidat tokeny k hodnotám do polí Adresa URL Http, Identifikátor URI Http a Záhlaví. Token je hodnota, která je dodána z výsledků odchozího dotazu pro požadavek HTTP. Název tokenu musí přesně odpovídat popisku sloupce v dotazu. Chcete-li například přidat hodnotu sloupce accountId z výsledků odchozího dotazu do pole Identifikátor URI Http, zadejte /ws/account/accountId/property do pole Identifikátor URI Http. Za běhu produkt IBM TRIRIGA vykreslí hodnotu, která se vrátí ve výsledku dotazu. Pokud je hodnota accountId 123, odeslaný identifikátor URI je /ws/account/123/property. Když je s tokeny proveden dávkový požadavek, hodnoty v poslední řadě výsledků poskytnou tokeny.
Odchozí dotazy Pro odchozí integrace musíte nadefinovat odchozí dotaz, který vyberete pole exportovaná z vaší databáze IBM TRIRIGA. Odchozí dotaz můžete nadefinovat ze správce sestav produktu IBM TRIRIGA. Můžete také nadefinovat mapu dat jako dynamický odchozí dotaz.
Odchozí dotazy ze správce sestav Když nadefinujete odchozí dotaz pomocí dotazu ze správce sestav IBM TRIRIGA, mapování dat je definováno v definici dotazu. Popisky pro sestavy, které uvedete pro každé pole, musí představovat externí název tabulky, název uzlu XML, hodnotu označení nebo název sloupce se záhlavím textového pole.
Mapování dat jako dynamické odchozí dotazy Když nadefinujete odchozí dotaz jako dynamický dotaz, mapování dat je nadefinováno v mapování dat. S tímto odchozím využitím mapování dat nemapujete žádná příchozí data z externího zdroje na existující pole produktu IBM TRIRIGA. Namísto toho vyberte, která pole se exportují z databáze produktu IBM TRIRIGA. Schéma databáze Pokud používáte schéma databáze a musíte exportovat binární velké objekty (nebo BLOB), musíte použít dynamický dotaz. Pro export můžete zvolit pole s binárním obsahem, poznámku nebo pole obsahu správce dokumentů. Výchozí data Chcete-li uvést výchozí data pro pole, použijete dynamický dotaz. Chcete-li například použít schéma HTTP post, můžete použít dynamický dotaz pro předání statického parametru nebo hodnoty. Aby výchozí data správně fungovala s dynamickým dotazem, musíte nejprve definovat a uložit mapování dat s výchozí datovou sadou a poté vybrat akci Generovat SQL pro tabulku. Tato akce nastaví sloupec pro použití výchozích dat pro nová vložení.
Mapování dat Pro příchozí integrace musíte nadefinovat mapování dat, které mapuje data z externího zdroje na existující pole produktu IBM TRIRIGA. Avšak pro odchozí integrace můžete také nadefinovat mapování dat jako dynamický odchozí dotaz pro výběr toho, která pole budou exportována z vaší databáze IBM TRIRIGA.
Mapování dat pro příchozí integrace Když nadefinujete mapování dat, musíte uvést modul, obchodní objekt, formulář a pole. Po definování mapování dat musíte mapování uložit, dříve než uložíte záznam, nebo o změny přijdete. Seznam Výchozí akce se používá, pokud nelze nalézt mapovaný záznam a musí být vytvořen. Pokud mapovaný záznam existuje, výchozí akce je ignorována a záznam se aktualizuje. Dostupné akce, které jsou vypsány na seznamu Výchozí akce jsou přechody ze stavu null, které jsou k dispozici pro záznam. Mapování dat se skládá z následujících hierarchických prvků formuláře: Formulář Zobrazuje hierarchickou reprezentaci formuláře. Každý formulář se skládá z karet. Tab
Zobrazuje hierarchickou reprezentaci karet. Každá karta obsahuje části.
Sekce Grafika Nelze mapovat. Sekce dotazu Nelze mapovat. Sekce s více kartami Nelze mapovat. Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
7
Pole inteligentní sekce Spustí rozevírací okno pro definování identifikace pole. Když uvedete pole inteligentní sekce, použijte rozevírací okno k výběru formuláře, který se použije jako filtr. Dále vyberte pole, které se použije jako filtr pro získání ID záznamu. ID záznamu propojené inteligentní sekce musí být identifikováno produktem IBM TRIRIGA Connector for Business Applications. Pole lokátoru Chová se jako standardní pole, pokud však nelze vyhledat data nebo není jedinečné, integrace selže. Standardní pole Je textové pole, se kterým se pracuje jako s řetězcem. Pole s datem Není zobrazeno v hierarchii. Namísto toho použijete tabulku atributů pole k definování správného formátu data produktu IBM TRIRIGA pro příchozí data. Pole jen pro čtení Označeno přeškrtnutím a nelze jej mapovat, ale je možné ho použít jako klíčové pole pro nápovědu identifikace záznamu. Požadovaná pole Označeno červeným písmem a je vyžadováno pro vytvoření záznamu. Integrace se nezdaří, pokud toto pole není mapováno. Každé pole v mapování dat vlastní následující atributy pole: Základní nadřízený Pro hierarchické obchodní objekty, jako je geografie, lokalita a organizace, cesta označuje kořen hierarchie. Chcete-li zajistit, že se záznam vytvoří pod správným kořenem v hierarchii, musíte uvést cestu. Pokud neuvedete cestu, záznam se vytvoří na stejné úrovni jako kořen a záznam neuvidíte ani se k němu nedostanete z formuláře. Příklad pro produkt JBoss Application Server je \Location. Příklad pro produkt Oracle WebLogic Server je \\Location. Typ
Definiční typ metadat tohoto pole. Všechna pole jsou považována za řetězce. Příklady zahrnují Seznam, Číslo a Text.
Externí Název externího pole, které chcete mapovat na produkt IBM TRIRIGA. Jelikož je možné tyto hodnoty použít pro sloupce databáze nebo formátované soubory, nepoužívejte mezery, speciální znaky nebo číslice. Příkladem je Uživatelský_jazyk. Když se použije v mapě odezvy schématu HTTP post, můžete uvést řetězec XPath nebo JSONPath. Je_klíč Označuje, zda má příchozí záznam pole, které je definováno jako klíč. Pokud ano, hodnota pro příchozí řádek dat se použije jako filtr pro dotazovaný obchodní objekt a vrátí se přesně jedno ID záznamu. Chcete-li aktualizovat záznamy v produktu IBM TRIRIGA, potřebujete ID záznamu k jeho identifikaci. Pokud se nevrátí žádné ID záznamů, nebo se jich vrátí několik, řádek vytvoří záznam se všemi hodnotami pro tento řádek. Je_nadřízený Označuje, zda má příchozí záznam pole, které je definováno jako nadřízený. Pokud ano, hodnota pro příchozí záznam se použije jako filtr v dotazu, který je použit k zachycení ID záznamu pro nadřízeného. Označením nadřízeného záznamu jiného záznamu je možné vytvořit hierarchii. Chcete-li označit podřízený záznam jiného záznamu, musíte zahrnout ID záznamu nadřízeného do požadavku na vytvoření záznamu nebo aktualizaci záznamu. Pokud tuto hodnotu nadefinujete v mapování
dat, tato identifikace nadřízeného se vyřeší automaticky. Pokud není nalezen nadřízený nebo je vráceno více nadřízených, zaprotokoluje se varování a záznam se vytvoří na stejné úrovni jako kořen. Výchozí Konstantní hodnota, která se použije na všechny instance záznamu. Příkladem je americká angličtina. Pokud uvedete výchozí hodnotu, Externí hodnota bude ignorována a výchozí sloupec musí existovat pouze v tomto mapování dat. Výchozí hodnota se použije jen v době běhu schématem souboru a schématem HTTP post. Pokud jste vybrali schéma databáze, musíte vybrat akci Generovat SQL pro tabulku, chcete-li nastavit výchozí hodnotu v pracovní tabulce; hodnota je v době běhu ignorována.
Mapování dat pro příchozí integrace DataConnect Když nadefinujete mapování dat, musíte uvést modul, obchodní objekt, formulář a pracovní tabulku. Po definování mapování dat musíte mapování uložit, dříve než uložíte záznam, nebo o změny přijdete. Mapování dat pro integrace DataConnect je stejné jako mapování dat použité pro další příchozí integrace s následujícími výjimkami nebo poznámkami: Moduly Seznam modulů je specifický těm modulům s obchodními objekty, které mají povolenu vlastnost Má pracovní tabulku. Obchodní objekty Seznam obchodních objektů je specifický pro ty obchodní objekty, které mají povolenu vlastnost Má pracovní tabulku. formuláře Hodnota v poli Formuláře musí být pro proces uvedena, aby správně fungovala. Pracovní tabulka Když vyberete obchodní objekt, spustí se dotaz a zobrazí dostupné sloupce databáze z pracovní tabulky, které jsou přidruženy k obchodnímu objektu. Pole Pracovní tabulka je vyplněno a je jen pro čtení. Pole
Hierarchie zobrazuje pole, která jsou definovaná jako pole pracovních tabulek. Pole jen pro čtení, která jsou označena přeškrtnutím, používá automatické zpracování a nelze je mapovat. K dispozici jsou další pole.
Atributy pole Když vyberete dostupné pole, do tabulky atributů pole se přidá nový řádek. Externí atribut zobrazuje standardně název sloupce databáze, ale můžete jej změnit, aby odpovídal záhlaví souboru. Atributy isKey, isParent a Default jsou jen pro čtení a nepoužívají se. Protože mapujete soubor importu na sloupce pracovní tabulky, musí mít první řádek souboru importu sloupce, které se shodují s hodnotami externích atributů. Posloupnost sloupců není důležitá, ale názvy sloupců rozlišují velikost písmen. Pokud jsou například externí hodnoty v mapování dat vypsány jako Field1, Field2, Field3, skutečné externí sloupce lze nazvat Field2, Field1, Field3. Pokud jsou názvy identické, pole se použijí správně.
Mapování dat pro odchozí integrace Pro odchozí integrace musíte nadefinovat odchozí dotaz, který vyberete pole exportovaná z vaší databáze IBM TRIRIGA. Odchozí dotaz můžete nadefinovat ze správce sestav produktu Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
9
IBM TRIRIGA. Můžete také nadefinovat mapu dat jako dynamický odchozí dotaz.
Mapy odezvy Pro integrace odchozích metod HTTP post musíte nadefinovat mapu odezvy, která mapuje parametry odezvy z požadavku HTTP na existující pole produktu IBM TRIRIGA. Ačkoliv je mapa odezvy organizována jako mapa dat, platí jen pro schéma HTTP post a povoluje pouze jednoduché hodnoty odezvy.
Import nebo export dat s tabulkami databáze Pokud vaše integrace vyžaduje tabulky databáze pro import nebo export dat, použijte k definování integrace integrační objekt produktu TRIRIGA. Příchozí schéma databáze mapuje data z externího zdroje na existující pole produktu IBM TRIRIGA. Odchozí schéma databáze definuje, která pole jsou exportována z databáze IBM TRIRIGA.
Import dat se schématem databáze Když zvolíte příchozí schéma databáze, musíte definovat zdroj dat a mapování dat. Mapování dat se používá k mapování dat z externího zdroje na existující pole produktu IBM TRIRIGA.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma databáze, příchozí směr, zdroj dat a další podrobnosti o integraci. 4. Otestujte databázové připojení nebo vygenerujte testovací data. 5. Definujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat. 6. Pokud jste nadefinovali výchozí data nebo musíte vytvořit generický SQL, vygenerujte SQL pro tabulku databáze. 7. Vytvořte a uložte záznam. 8. Provete integraci. 9. Prozkoumejte chyby.
Export dat se schématem databáze Když zvolíte odchozí schéma databáze, musíte definovat zdroj dat a odchozí dotaz. Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA.
Informace o této úloze Odchozí dotaz můžete nadefinovat ze správce sestav produktu IBM TRIRIGA. Můžete také nadefinovat mapu dat jako dynamický odchozí dotaz.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma databáze, odchozí směr, zdroj dat a další podrobnosti o integraci. 4. Otestujte databázové připojení. 5. Definujte odchozí dotaz. 6. Pokud jste vybrali dynamický dotaz, nadefinujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat.
7. Pokud jste nadefinovali výchozí data nebo musíte vytvořit generický SQL, vygenerujte SQL pro tabulku databáze. 8. Vytvořte a uložte záznam. 9. Provete integraci. 10. Prozkoumejte chyby.
Import nebo export dat se soubory Pokud vaše integrace vyžaduje soubory pro import nebo export dat, použijte k definování integrace integrační objekt produktu TRIRIGA. Příchozí schéma souboru mapuje data z externího zdroje na existující pole produktu IBM TRIRIGA. Odchozí schéma souboru definuje, která pole jsou exportována z databáze IBM TRIRIGA.
Import dat se schématem souboru Když zvolíte příchozí schéma souboru, musíte definovat soubor importu a mapování dat. Mapování dat se používá k mapování dat z externího zdroje na existující pole produktu IBM TRIRIGA.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma souboru, příchozí směr, soubor importu a další podrobnosti o integraci. 4. Testování přístupu k souboru. 5. Definujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat. 6. Vytvořte a uložte záznam. 7. Provete integraci. 8. Prozkoumejte chyby.
Export dat se schématem souboru Když zvolíte odchozí schéma souboru, musíte definovat soubor exportu a odchozí dotaz. Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA.
Informace o této úloze Odchozí dotaz můžete nadefinovat ze správce sestav produktu IBM TRIRIGA. Můžete také nadefinovat mapu dat jako dynamický odchozí dotaz.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma souboru, odchozí směr, export souboru a další podrobnosti o integraci. 4. Testování přístupu k souboru. 5. Definujte odchozí dotaz. 6. Pokud jste vybrali dynamický dotaz, nadefinujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat. 7. Vytvořte a uložte záznam. Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
11
8. Provete integraci. 9. Prozkoumejte chyby.
Import dat do pracovních tabulek nástroje DataConnect Pokud vaše integrace vyžaduje nástroj systému ETL, ale nemáte přístup nebo školení pro jeho použití, pro definování integrace použijete integrační objekt produktu TRIRIGA. Příchozí schéma DataConnect produktu IBM TRIRIGA mapuje data ze souboru importu do pracovních tabulek DataConnect.
Import dat se schématem DataConnect Když zvolíte příchozí schéma DataConnect produktu IBM TRIRIGA, musíte nadefinovat zdroj dat, soubor importu, úlohu DataConnect a mapování dat.
Informace o této úloze Zdroj dat se používá pro přístup k pracovním tabulkám DataConnect. Mapování dat se používá k mapování dat ze souboru na pracovní tabulky DataConnect. Když spustíte integraci, v pracovních tabulkách DataConnect se vloží nebo aktualizují položky s akcí upsert (aktualizovat nebo vložit). Musíte vybrat jedno nebo více polí jako klíčová pole. DataConnect využívá klíče k určení toho, zda je třeba vložit nebo aktualizovat řádek.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma DataConnect, zdroj dat, soubor importu a další podrobnosti o integraci. 4. Otestujte databázové připojení. 5. Testování přístupu k souboru. 6. Definujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat. 7. Vytvořte a uložte záznam. 8. Provete integraci. 9. Prozkoumejte chyby.
Export dat pomocí protokolu HTTP Pokud vše integrace vyžaduje pro export dat protokol HTTP, použijte k definování integrace integrační objekt produktu TRIRIGA. Schéma odchozích metod HTTP post mapuje parametry odezvy z požadavku HTTP na existující pole produktu IBM TRIRIGA.
Export dat pomocí schématu HTTP post Když vyberete odchozí schéma HTTP post, musíte definovat server, kam se data zašlou, odchozí dotaz a mapu odezvy.
Informace o této úloze Odchozí dotaz se používá k definování toho, která pole se exportují z vaší databáze IBM TRIRIGA. Mapa odezvy se používá k mapování parametrů odezvy z požadavku HTTP na existující pole produktu IBM TRIRIGA.
Odchozí dotaz můžete nadefinovat ze správce sestav produktu IBM TRIRIGA. Můžete také nadefinovat mapu dat jako dynamický odchozí dotaz.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Integrace > Integrační objekt. 2. Přidejte záznam integračního objektu. 3. Uvete název integrace, schéma HTTP post, externí server a další podrobnosti o integraci. 4. Definujte odchozí dotaz. 5. Pokud jste vybrali dynamický dotaz, nadefinujte mapování dat uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapování dat. 6. Definujte mapu odezvy uvedením modulu, obchodního objektu, formuláře a polí. Uložte mapu odezvy. 7. Vytvořte a uložte záznam. 8. Provete integraci. 9. Prozkoumejte chyby.
Příklad: Export dat v integracích geokódování Esri Můžete zvolit odchozí schéma HTTP post k exportu dat z databáze IBM TRIRIGA na server Esri. Poté můžete namapovat parametry odezvy z požadavku HTTP na záznamy lokality, chcete-li aktualizovat jejich geokódy.
Pozadí Ichiro je specialista na integrace ve společnosti Company ABC. Vyvíjí integrace produktu IBM TRIRIGA pro zákazníky společnosti Company ABC. Ichiro vyvíjí odchozí integraci HTTP post s externí službou geokódování Esri. Následující adresa URL HTTP poskytuje služby geokódování Esri pomocí rozhraní API REST. Aby mohla služba geokódování Esri určit, které adresy geokódovat, požadavek HTTP musí obsahovat specifické parametry v řetězci dotazu. Odezva je ve formátu JSON. http://geocode.arcgis.com/arcgis/rest/services /World/GeocodeServer/findAddressCandidates
Krok 1: Definujte schéma integračních dat Ichiro definuje záznam integračního objektu s následujícími podrobnostmi o poli: Název Adresa podle geokódu Schéma Příspěvek HTTP Směr
Odchozí
Typ zasílání Řetězec dotazu Typ odezvy JSON Adresa URL HTTP http://geocode.arcgis.com/arcgis/rest/services /World/GeocodeServer/findAddressCandidates
Dotaz pro odchozí sekci: Je dynamická? Ano Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
13
Krok 2: Definujte mapování dat Protože Ichiro zvolil dynamický dotaz, nadefinuje mapování dat uvedením modulu Lokalita, obchodního objektu triBuilding, formuláře triBuilding a polí. Hodnoty atributu Externího pole představují názvy parametru, které se přidají k řetězci dotazu. Protože se pole Předvolba nepoužije, data pole se dynamicky stáhnou ze záznamů lokality produktu IBM TRIRIGA. Definuje následující pole s následujícími Externími hodnotami atributu: triAddressTX Adresa triZipPostalTX PSČ triCityTX Město triStateProvTX Stav Pro další dvě pole Ichiro nadefinuje další dvě Externí hodnoty, aby uvedl odpovídající Výchozí hodnoty, které jsou povinné pro službu geokódování Esri. Jeho Externí hodnoty jsou outSR pro WKID a f pro formát. Jeho odpovídající Výchozí hodnoty jsou 102100 pro WKID a json pro formát. Chcete-li ověřit jeho hodnotu 102100, zkontroluje hodnoty WKID pro geografický souřadnicový systém (resources.arcgis.com/en/help/rest/apiref/gcs.html) a souřadnicový systém projekce (resources.arcgis.com/en/help/rest/apiref/pcs.html). Nadefinuje následující pole s Externími a Výchozími hodnotami atributu: triIdTX outSR a 102100 triDescriptionTX f a json Ichiro uloží mapování dat.
Krok 3: Definujte mapování odezvy Dále Ichiro nadefinuje mapování odezvy pro načtení odezvy ze služby geokódování Esri a namapuje načtené hodnoty zeměpisné šířky a zeměpisné délky na záznam lokality produktu IBM TRIRIGA. Nadefinuje mapování odezvy uvedením modulu Lokalita, obchodního objektu triBuilding, formuláře triBuilding a polí. Protože je odezva ve formátu JSON, Externí hodnoty atributu jsou v syntaxi JSONPath. Definuje následující pole s následujícími Externími hodnotami atributu: triGisLongitudeNU candidates[0].location.x triGisLatitudeNU candidates[0].location.y Ichiro uloží mapování odezvy a uloží i záznam integračního objektu.
Krok 4: Provete definici integrace Když Ichiro vybere akci formuláře Provést ke spuštění definice integrace, dojde k následujícímu procesu: v Hodnoty mapování dat se použijí k vytvoření dynamického dotazu. Je volán dotaz.
v Protože typ zasílání je řetězec dotazu, každý výsledek z dotazu je převeden do následující struktury adresy URL: 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
Skutečné parametry závisí na skutečných datech produktu IBM TRIRIGA. v Následující objekt formátu JSON zobrazuje odezvu: { "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 Hodnoty mapování odezvy se použijí k extrahování hodnot candidates[0].location.x a candidates[0].location.y z objektu JSON a jejich mapování na pole triGisLongitudeNU a triGisLatitudeNU v záznamu lokality IBM TRIRIGA. Záznam lokality se aktualizuje novými daty. v Protože nebyla uvedena žádná akce pro exportovaná data v sekci Odchozí dotaz, pro data lokality se nespustí žádné akce. Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
15
v Shromáždí se konečný počet integračního procesu a pomocí podrobností o spuštění integrace a o chybách, ke kterým došlo, se vytvoří záznam historie o provedení.
Provedení integrací Kromě akce formuláře Provést můžete také provést záznam objektu integrace nebo formulář definice integrace z vlastní úlohy nebo adresy URL. S vlastní úlohou můžete filtrovat odchozí dotaz s formulářem dat z momentálně spuštěného procesu. Pomocí adresy URL můžete předávat parametry z externí aplikace pro spuštění akce Provést nebo načtení výsledků dotazu správce sestav produktu IBM TRIRIGA ve formátu JSON.
Provedení z formulářů Po vytvoření záznamu integračního objektu můžete začít používat akci formuláře Provést ke spuštění definice integrace. Tato akce spustí sled prací triIntegration - Provést. Záznam integračního objektu se změní na jen pro čtení a jeho stav se změní na Probíhá zpracování. Když je zpracování integrace dokončeno bez chyb, záznam integračního objektu se změní zpět na stav Připraveno. Pokud se během zpracování vyskytne chyba, jeho stav se změní na Selhání a záznam nezmění svůj stav. Pak musíte ručně zkontrolovat chybu, která se vyskytla. Avšak můžete přepsat kontrolu a změnit záznam zpět do stavu Připraveno klepnutím na akci Dokončit. Sekce Historie provedení obsahuje záznamy s podrobnostmi o každém spuštění integrace. Každý záznam podrobností obsahuje stav, počet zpracování a dobu trvání spuštění. Pokud má spuštění integrace chyby, také obsahuje protokol chyb a sekci dotazu, která vypisuje seznam jednotlivých záznamů, které selhaly. Když je spuštění integrace zahájeno z jiného sledu prací, záznam integračního objektu obsahující úplný přehled chyb také obsahuje oříznutou zprávu. Oříznutá zpráva je ve skrytém textovém poli, které lze například zobrazit ve zprávě upozornění. Odchozí integrace mohou najednou zpracovat maximálně 1000 záznamů. Pokud je třeba vyexportovat více než 1000, vytvořte si logiku sledu prací, která spustí integraci, dokud nebudou zpracovány všechny záznamy.
Příklad: Provedení z vlastních úloh Po vytvoření záznamu integračního objektu můžete použít vlastní úlohu k filtrování odchozího požadavku s daty z momentálně spuštěného procesu.
Pozadí Ichiro je specialista na integrace ve společnosti Company ABC. Vyvíjí integrace produktu IBM TRIRIGA pro zákazníky společnosti Company ABC. Ichiro aktualizuje část záznamů, ale chce, aby integrace odeslala záznam, když uživatel klepne na konkrétní akci. Takže použije speciální objekt Vlastní úloha, který používá proměnnou sledu prací pro nastavení dat, a tak komunikuje se záznamem zavaděče třídy Integrace. Pomocí této funkce může Ichiro sestavit sadu záznamů ve sledu prací pomocí běžných metod. Poté může předat tuto sadu odkazem na vlastní úlohu a přiřazením záznamu integračního objektu, který se má spustit podle proměnné sledu prací nazvané IntegrationObject. Ichiro má základní sled prací obsahující následující úlohy sledu prací: v Spouštěcí úloha v Úloha dotazu, která je nazvaná Dotaz na integrační objekt
Úloha definice proměnné, která je nazvaná Definovat IO jako proměnnou Úloha definice proměnné, která je nazvaná Instance integrace Úloha dotazu, která je nazvaná Dotaz na množinu osob Vlastní úloha, která je nazvaná Vlastní úloha Koncová úloha
Krok 1: Definovat sled prací Ichiro Vyberte úlohu Spuštění, nastaví sled prací jako asynchronní a nastaví spuštění sledu prací, když je uložen záznam osoby (triPeople) (triSave).
Krok 2: Definujte první úlohu dotazu Ichiro vloží první úlohu dotazu a pojmenuje ji Dotaz pro integrační objekt. V této úloze se dotáže (Předvolba správce - Integrační objekty) na záznamy integračních objektů, které chce spustit. Poté bude filtrovat výsledky tohoto dotazu pro specifický název. Ichiro musí mít pouze jeden výsledný záznam integračního objektu.
Krok 3: Definujte první úlohu Definice proměnné Ichiro vloží první úlohu Definice proměnné a pojmenuje ji Definovat IO jako proměnnou. V této úloze nadefinuje záznam integračního objektu (triIntegration) jako proměnnou. Výsledek dotazu z předchozí úlohy je přiřazen k této proměnné.
Krok 4: Definujte druhou úlohu Definice proměnné Ichiro vloží druhou úlohu Definice proměnné a pojmenuje ji Instance integrace. V této úloze nadefinuje objekt instance integrace (triIntegrationInstance) jako proměnnou. Tato proměnná návratu se používá pro návrat hodnoty z vlastní úlohy na konci sledu prací.
Krok 5: Definujte druhou úlohu dotazu Ichiro vloží druhou úlohu dotazu a pojmenuje ji Dotaz na množinu osob. V této úloze získá filtrovanou sadu záznamu osob, která je zpracována pro integraci. Dotáže se (triEmployee – Find) na záznamy osob. Poté vyfiltruje výsledky pro záznamy, kde křestní jméno osoby (triFirstNameTX) obsahuje Ichiro. Ichiro ověří, že obchodní objekt osob (triPeople) obsahuje pole ID záznamu (triRecordIdSY). Pro každý obchodní objekt, který je použit v úloze dotazu předané záznamu integračního objektu, musí být zahrnuto pole ID záznamu (triRecordIdSY). Když je integrace spuštěna, záznam integračního objektu používá ID záznamu k načtení zbývajících polí v obchodním objektu, který je definován v mapování dat.
Krok 6: Definujte vlastní úlohu Ichiro vloží speciální vlastní úlohu, který používá proměnnou sledu prací pro nastavení dat, a tak komunikuje se záznamem zavaděče třídy Integrace. V této úloze předá výsledky úlohy Dotaz na množinu osob jako sadu záznamů. Nakonec Ichiro přidá proměnnou návratu, která je nutná pro získání záznamu instance integrace. Název návratové hodnoty musí být IntegrationInstance. Tato vlastní úloha je také definována s následující hodnotami a chováním: v Pole Název třídy pro vlastní úlohu je nastaveno na Integration:com.tririga.custom.integration.Parameter. Tento název třídy se musí
Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
17
použít, když je implementována tato metoda. Třída Parametr uvnitř cesty k zavaděči tříd Integrace implementuje třídu rozhraní Java CustomParamBusinessConnectTask s následujícím podpisem: public CustomParamTaskResult execute(TririgaWS client, Map params, long userId, Record[] records)
v Argument params představuje přiřazenou proměnnou IntegrationObject, takže proces obsahuje instrukce, které potřebuje k pokračování v integraci. Argument records představuje sekci Záznamy ve vlastní úloze, kde jsou přiřazeny záznamy, které se použijí pro procesy sledu prací. Namísto spuštění události na jednom objektu se předávají události dvě sady objektů. v Třída Parametr vyhledává záznam integračního objektu z proměnné IntegrationObject a zpracovává výsledky v argumentu records, který je předán. Toto zpracování zahrnuje spuštění dotazu ze sekce Odchozí dotaz záznamu integračního objektu a filtrování podle ID záznamů, které byly předány. Jako výsledek jsou data exportována s běžnými obslužnými programy. Ale export již není vázán na dotazy typu vše-nebo-nic nebo na spouštění události přímo z akce formuláře Provést.
Provedení z adres URL Po vytvoření záznamu integračního objektu můžete využít adresu URL k předání parametrů z externí aplikace ke spuštění akce Provést. Adresu URL můžete také použít k načtení výsledků z dotazu správce sestav produktu IBM TRIRIGA ve formátu JSON. Verze produktu IBM TRIRIGA Application Platform 3.3 nebo novější je vyžadována pro externí spuštění události pomocí adresy URL obsahující ověřovací pověření. Ověření můžete zadat jedním z následujících způsobů: v Přidejte hodnoty Jméno uživatele a Heslo do záhlaví požadavku HTTP ve standardním protokolu zabezpečení základní autorizace. v Přidejte hodnoty Parametr Jméno uživatele a Parametr Heslo a jejich odpovídající hodnoty Jméno uživatele a Heslo do záhlaví požadavku HTTP. v Přidejte hodnoty Parametr Jméno uživatele a Parametr Heslo a jejich odpovídající hodnoty Jméno uživatele a Heslo jako parametry POST nebo jako řetězec dotazu adresy URL do záhlaví požadavku HTTP.
Spuštění akce Provést Chcete-li spustit akci Provést na záznamu integračního objektu externě pomocí adresy URL, připojíte řetězec dotazu k adrese URL. Řetězec dotazu obsahuje pověření a nastaví další parametr ioName k názvu záznamu integračního objektu. Chcete-li například spustit záznam integračního objektu Adresa geokódu, zavoláte následující adresu URL: http://localhost:8001/html/en/default/rest /Integration?user=username&pass=password&ioName=Geocode+Address
Pokud adresa URL spustí akci Provést na záznamu integračního objektu dle očekávání, vrátí se zpráva Úspěšné. Spuštění akce Provést na záznamu integračního objektu je asynchronní událost, takže není možné získat výsledky integračního procesu synchronně. Potřebujete-li okamžitou zpětnou vazbu na výsledky, můžete svázat událost oznámení s dokončením záznamu integračního objektu. Poté vás aplikace IBM TRIRIGA může upozornit, až se proces integrace dokončí. Další volbou může být získání informací výzvou produktu IBM TRIRIGA.
Načíst výsledky dotazu Jakýkoli dotaz, který je definován ve správci sestav produktu IBM TRIRIGA, může být externě proveden pomocí adresy URL. Chcete-li uvést dotaz, použijte následující parametry: action Povinný parametr. Musí být nastaven na query. module Povinný parametr, pokud není použit žádný token pokračování. Modul pro dotaz, například triPeople. bo
Volitelný parametr. Obchodní objekt pro dotaz, například triPeople. Pokud existuje více než jeden obchodní objekt, vynechte tento parametr.
dotaz Povinný parametr, pokud není použit žádný token pokračování. Název dotazu, například triEmployee - Find. f
Volitelný parametr. Formát vrácených výsledků, který zahrnuje následující volby: json
pjson Řetězec JSON ve formátu tisku pro přehlednost.
ct
xml
Minimalizovaný řetězec XML.
pxml
Řetězec XML ve formátu tisku pro přehlednost.
tab
Text oddělený tabulátory.
Povinný parametr, pokud je další dávka záznamů požadována. Je vrácen token pokračování, když počet výsledků dotazu překročí výchozích 1000 výsledků. Když se pokusíte načíst další dávku záznamů, musíte předat tento parametr s tokenem, který je uveden v předchozí odezvě.
Chcete-li například uvést dotaz pro všechny zaměstnance, zavoláte následující adresu URL: http://localhost:8001/html/en/default/rest /Integration?user=username&pass=password&action=query &module=triPeople&bo=triPeople&query=triEmployee+-+Find&f=pjson
Provedení procesů DataConnect Když vyberete příchozí schéma DataConnect IBM TRIRIGA, definice integrace může spustit dva typy úloh DataConnect. Standardní typ vytvoří jednu úlohu pro zvolený obchodní objekt. Vícenásobný typ načte více pracovních tabulek a spustí je jako jednu úlohu. Vícenásobný typ vyžaduje závislou definici integrace, která je k dispozici ve sledu prací. Standardní typ Když je definice integrace spuštěna, tento typ úlohy DataConnect postupuje podle následujícího průběhu procesu. 1. Vytvoří číslo úlohy z maximálního čísla DC_JOB. 2. Vloží novou položku do tabulky DC_JOB s novým číslem úlohy, obchodním objektem a stavem (Nová). 3. Načte pracovní tabulku s číslem úlohy, názvem formuláře, stavem 2 (Připraveno) a akcí 4 (Upsert). 4. Aktualizuje tabulku DC_JOB se stavem 2 (Připraveno). Vícenásobný typ Když je definice integrace spuštěna, tento typ úlohy DataConnect postupuje podle následujícího průběhu procesu. 1. Vytvoří číslo úlohy z maximálního čísla DC_JOB. 2. Vloží novou položku do tabulky DC_JOB s novým číslem úlohy, obchodním objektem a stavem (Nová). Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
19
3. Načte pracovní tabulku s číslem úlohy, názvem formuláře, stavem 2 (Připraveno) a akcí 4 (Upsert). 4. Dotáže se na závislé definice integrace (IntegrationObject Dependent) a opakuje kroky 1 - 4, dokud již nemá závislou definici integrace. 5. Aktualizuje tabulku DC_JOB se stavem 2 (Připraveno).
Zpracování chyb Pokud se během integrace vyskytnou selhání, ovlivněné záznamy se neuloží. Souhrn instancí integrace zobrazí chyby, které se vyskytly, a každý záznam, který se nezdařil, je znázorněn záznamem selhání instance. Záznam selhání instance obsahuje znázornění záznamu instance, který můžete ručně upravit a znovu odeslat. Pole Znovu odeslat záznam v záznamu selhání instance triIntegrationInstanceFailure) je pole s poznámkou, které obsahuje dvojice klíč-hodnota představující záznam, který se snažíte vytvořit nebo aktualizovat. Můžete ručně upravit data v poli Opětovně odeslat záznam a poté klepnout na akci formuláře Opětovně odeslat, abyste opětovně odeslali záznam. Když je znovu odeslaný záznam úspěšně zpracován, dojde k následujícím událostem: v Znázornění neúspěšného záznamu se změní z "Selhání" na "Úspěšné". v Vymažou se textové položky v poli Chybová zpráva a Opětovně odeslat záznam. v Počty záznamů instance integrace (triIntegrationInstance) se aktualizují, aby odrážely správné počty. Zvláště počet v poli Úspěšné záznamy se zvýší o jeden a počet v poli Nezdařené záznamy se o jeden sníží. Když je počet Nezdařené záznamy roven nule, můžete dokončit záznam integračního objektu pomocí akce Dokončit.
Prvky integrace Kromě definování a provedení definice integrace, prvky a procesy, které jsou společné pro integrace, zahrnují odchozí formáty, upgrady objektů a migrace objektů. Další společné prvky zahrnují standardní sledy prací, standardní dotazy a standardní seznamy.
Odchozí formáty Pro integrace odchozího souboru můžete vybrat formáty souborů .json, .xml nebo .xslt. Pro integrace odchozích HTTP post můžete vybrat formáty JSON, XML nebo XSLT post a formáty odezvy.
Typy exportu souboru Formáty exportu souboru zahrnují fixní, .json, .xml a .xslt. Pokud si zvolíte fixní volbu pro standardní oddělené soubory, zpřístupní se pole Záhlaví souboru.
Typy HTTP post Formáty HTTP post zahrnují parametr, řetězec dotazu, JSON, XML a XSLT. Výsledky odchozího dotazu jsou převedeny do zvoleného formátu. Parametr Každý řádek je převeden na dvojice název parametru-hodnota. Každý záznam je odeslán samostatně. Dávkové odeslání není k dispozici. Řetězec dotazu Každý řádek je převeden na dvojice název parametru-hodnota, které se připojí k
adrese URL jako řetězec dotazu a odešlou se. Ačkoliv jsou data připojena k adrese URL, namísto začlenění do těla požadavku, metoda požadavku HTTP je POST, nikoliv GET. JSON Formát JSON můžete vybrat jako typ zaslání pro schéma HTTP post nebo jako typ exportu pro schéma souboru. Chcete-li odeslat oddělený požadavek pro každý záznam, který je vrácen odchozím požadavkem, uvete hodnotu Typ odezvy. Jednoduché parametry odezvy musí odpovídat polím, která jsou definována v mapování odezvy. Chcete-li odeslat všechny vrácené záznamy jako jediné odeslání dávky, neuvádějte typ odezvy. Struktura JSON obsahuje dva objekty: data a záhlaví. Datový objekt obsahuje pole objektů s popisky a hodnotami ze sloupců odchozích dotazů, ale je-li to uvedeno, také zahrnuje ID obchodního objektu a ID záznamu. Následující příklad zobrazuje výchozí strukturu JSON: { "data": [ { “[column_label]”:”[column_value]”, "boId": 10002100, "recId": 2999294 }, ... ], "header": [ "[column_label]", ... ] }
XML a XSLT Formát XML můžete vybrat jako typ zaslání pro schéma HTTP post nebo jako typ exportu pro schéma souboru. Chcete-li odeslat oddělený požadavek pro každý záznam, který je vrácen odchozím požadavkem, uvete hodnotu Typ odezvy. Jednoduché parametry odezvy musí odpovídat polím, která jsou definována v mapování odezvy. Chcete-li odeslat všechny vrácené záznamy jako jediné odeslání dávky, neuvádějte typ odezvy. Výchozí struktura XML Struktura XML má tři uzly pro každý sloupec odchozího dotazu: pole, popisek a hodnotu. Následující příklad zobrazuje výchozí strukturu XML: triIdTX1000000 ... ...
Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
21
Pro datové hodnoty výsledky odchozích dotazů zahrnují hodnoty řádků, které jsou uloženy v databázi, a formátované zobrazené hodnoty, které jsou zobrazeny uživateli. Do výsledků dotazu je přidán uzel displayValue. Následující příklad zobrazuje výchozí strukturu XML: DateDateTime
Popisky jako uzly Pokud si zvolíte volbu Použít popisek dotazu jako prvek, výchozí struktura XML se změní. Uzly popisku a hodnot jsou sloučeny pomocí názvu popisku jako uzlu hodnoty. Následující příklad zobrazuje strukturu XML: triIdTX1000000 ... ...
Pro hodnoty dat se sloučený uzel name_display přidá k výsledkům dotazu. Následující příklad zobrazuje strukturu XML: DateDateTime
Transformace XSLT Pokud používáte transformaci XSLT pro strukturu XML, můžete použít binární pole XSLT pro ukládání šablony stylů XSLT. Toto pole není povinné. Můžete také transformovat strukturu XML s volbou a nebo bez volby Použít popisek dotazu jako prvek.
Typy odezvy HTTP Formáty odezvy HTTP zahrnují fixní, JSON a XML. Jednoduché parametry odezvy musí odpovídat polím, která jsou definována v mapování odezvy. Pokud vyberete volbu Odeslat jako dávku, neuvádějte hodnotu Typ odezvy. Po dokončení integračního procesu jsou záznamy ovlivněné odezvou vypsány na kartě Přidružení definice integrace s řetězcem přidružení Ze zdroje. Fixní Vrátí odezvu HTTP ve formátu řetězce. Například, pokud je odezva "Úspěch" nebo "Selhání", můžete tento řetězec namapovat na pole, které můžete použít jako bod rozhodování ve sledu prací následného zpracování. JSON Načte odezvu HTTP ve formátu JSON. V mapě odezvy nadefinujte Externí atribut s řetězcem JSONPath. Musíte použít pouze jednoduché definice odezvy. Pokud je prvek JSON, který chcete mapovat, pole, musíte uvést číslo indexu tohoto pole. Například candidates[0].location.x vrátí -12819744.7565 v následující struktuře JSON: { "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 Vrátí odezvu HTTP ve formátu XML. V mapě odezvy nadefinujte Externí atribut s řetězcem XPath. Musíte použít pouze jednoduché definice odezvy. Pokud je prvek XML, který chcete mapovat, pole, musíte uvést číslo indexu tohoto pole. Například //root/candidate/location[2]/x vrátí 5 v následující struktuře XML: Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
23
<x>1 2 <x>5 6
Formát XML může také načíst a aktualizovat více záznamů v odezvě. V mapě odezvy, kde nadefinujete Externí atribut s řetězcem XPath, musíte znázornit opakovaný prvek XML pomocí tokenu [i]. V následujícím příkladu pro mapování cesty XPath na atribut recordId ve struktuře XML nastavíte XPath na //result[i]/@recordId. Chcete-li namapovat cestu XPath na uzel Název, nastavíte XPath na //result[i]/columns/column/Name. Můžete také nastavit (klíčový) atribut isKey v mapě na aktualizaci záznamu. triNameTXtriIdTXtriNameTXtriIdTX ...
Upgrady objektu Kdykoliv je k dispozici nový instalační program IBM TRIRIGA Application Platform, můžete uvést, zda upgraduje integrační objekt produktu TRIRIGA během upgradu platformy. Pokud nechcete, aby instalační program upgradoval integrační objekt produktu TRIRIGA, tak před jeho spuštěním vytvořte záznam integračního objektu, který je nazván IGNORE_UPGRADE. Nespouštějte tento záznam. Záznam musí být přítomen jen v existující instalaci platformy. Pak jakmile je instalační program spuštěn, neupgraduje integrační objekt produktu TRIRIGA, i když bude verze sestavení instalačního programu novější než momentálně nainstalovaná verze platformy.
Pokud nevytvoříte tento záznam IGNORE_UPGRADE, tak instalační program upgraduje integrační objekt produktu TRIRIGA, pokud bude verze sestavení instalačního programu novější, než je momentálně instalovaná verze platformy.
Migrace objektů Po spuštění migrace objektu, ale před použitím záznamu integračního objektu v novém prostředí, musíte otevřít libovolný záznam integračního objektu a spustit akci Přemapovat. Akce Přemapovat aktualizuje všechna ID uložená v mapách dat a mapách odezvy. Tyto mapy obsahují ID pro moduly, obchodní objekty, formuláře a data inteligentního záznamu. Chcete-li se ujistit, že ID jsou aktualizována pro nové prostředí, musíte spustit akci Přemapovat.
Prvky objektu Modul triIntegration obsahuje několik obchodních objektů, jako je integrační objekt TRIRIGA. Kromě toho záznam integračního objektu vyžaduje použití několika prvků zavaděčů tříd. Modul triIntegration zahrnuje následující obchodní objekty: triIntegration Integrační objekt TRIRIGA je primární obchodní objekt, který definuje integraci mezi produktem IBM TRIRIGA a externími systémy. Z tohoto integračního objektu TRIRIGA vytvoříte definice integrace nebo záznamy integračního objektu. triDataSource Obchodní objekt zdroje dat obsahuje nastavení vlastností, které definuje připojení k databázi. Tento objekt je odkazován jako sekce jednotlivého záznamu v záznamu integračního objektu. Toto odkazování umožňuje opětovné použití definic zdroje dat napříč několika definicemi integrace. triIntegrationInstance Obchodní objekt instance integrace obsahuje podrobnosti o specifické instanci spuštění integrace. Tento objekt obsahuje počty, dobu, jak dlouho běžel, kolekci chybových zpráv, pokud takové jsou, a sekci dotazů s podrobnostmi o každém záznamu, který selhal. Tento objekt je přidružen k záznamům ovlivněným odezvou. Tento objekt je odkazován v sekci Provést historii záznamu integračního objektu. triIntegrationInstanceFailure obchodní objekt selhání instance integrace obsahuje podrobnosti o jediném záznamu, který selhal, pro vstupní integraci. Tento objekt obsahuje chybovou zprávu pro selhání a zjednodušené znázornění odeslaného záznamu, který lze ručně upravit a znovu odeslat. Záznam zavaděče tříd produktu TRIRIGA, který je nazván Integrace je požadován záznamem integračního objektu. Tento záznam zavaděče tříd Integrace zahrnuje následující prvky ve své sekci dotazu Soubory prostředku: jtds-1.2.5.jar Soubor JDTS (Java Device Test Suite) .jar je ovladač databáze pro produkt Microsoft SQL Server. Ačkoliv je produkt IBM TRIRIGA dodán s ovladačem JDBC (Java Database Connectivity) Oracle (JDBC) pro Oracle Database, produkt IBM TRIRIGA nezahrnuje ovladač databáze pro produkt Microsoft SQL Server. Pokud se
Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
25
připojujete k produktu Microsoft SQL Server, musíte přidat ovladač Microsoft SQL Server, jako je jtds-1.2.5.jar k sekci dotazů Soubory prostředku záznamu zavaděče tříd Integrace. TRIRIGAIntegration.jar Integrační soubor TRIRIGA .jar obsahuje všechny třídy Java, které jsou použity komponentami integračního objektu produktu TRIRIGA. Soubor zahrnuje vstupní body vlastních úloh souvisejících se sledy prací a komunikační vrstvu, kterou používají prvky souboru TRIRIGAIntegration_Assets.zip. TRIRIGAIntegration_Assets.zip Aktiva integrace TRIRIGA v souboru .zip obsahují všechny soubory .html, .css, JavaScript a soubory s obrázkem používané mapováním dat pro příchozí integrace. Skript JavaScript komunikuje s rozhraním API Java produktu IBM TRIRIGA Connector for Business Applications pomocí popisovačů proxy servletu na základě identifikátoru URI. Prvky na straně serveru jsou obsaženy v rámci souboru TRIRIGAIntegration.jar.
Verze objektů Chcete-li určit, která verze integračního objektu produktu TRIRIGA je nainstalována ve vašem prostředí IBM TRIRIGA, můžete přejít na následující webovou adresu: http://[localhost:8001/context]/html/en/default/rest/Integration. Výsledek zobrazí datum a číslo sestavení a číslo verze integračního objektu, který momentálně spouštíte.
Standardní sledy prací Integrační objekt produktu TRIRIGA je dodán s několika sledy prací IBM TRIRIGA. Následující sledy prací jsou spuštěny ze záznamu integračního objektu nebo jejich podporovaných záznamů. triIntegration - Provést Tento asynchronní sled prací se spustí, když uživatel vybere akci Provést. Tento sled prací je primární sled prací, který podporuje integraci mezi produktem IBM TRIRIGA a externími systémy. Sled prací řídí stav záznamu, který se zobrazí ve formuláři. Úloha Spustit integraci je vlastní úloha, která zavolá metodu Integration:com.tririga.custom.integration.Integration a je primárním vstupním bodem pro všechny záznamy integračních objektů. Informace o procesech spuštěných během integrace se definují v záznamu integračního objektu a předávají se do vlastní úlohy pomocí ID záznamu. Standardní sled prací obsahuje následující úlohy sledu prací: v Spouštěcí úloha v Úloha upravení záznamu, která je nazvaná Označit stav jako Probíhá zpracování v Vlastní úloha, která je nazvaná Spustit integraci v Přepnout úlohu – Pokud je splněno kritérium přepínače, spuste následující úlohy: - Úloha Spustit akci - Úloha Upravit záznamy, která je nazvaná Označit stav jako Připraveno – Pokud je kritérium přepínače nepravdivé, spuste následující úlohy: - Úloha Upravit záznamy, která je nazvaná Upravit stav jako Nezdařený v Koncová úloha
triIntegration - Generovat SQL pro tabulku Tento synchronní sled prací je spouštěn z akce sekce databáze záznamu integračního objektu, aby vygeneroval SQL pro použití s pracovními tabulkami. triIntegration - Generovat testovací data Tento synchronní sled prací je spuštěn z akce sekce databáze záznamu integračního objektu pro generování náhodných testovacích dat v pracovních tabulkách. Tato testovací data lze použít pro testování funkčnosti nebo zavedení. triIntegration - HideShow Data Sections Tento synchronní sled prací spustí počáteční načtení nového záznamu integračního objektu a z různých prvků formuláře, jako je akce pole sled prací OnChange. Tento sled prací zobrazí a skryje prvky formuláře podle potřeby, aby vyhovovaly integraci, kterou definujete. triIntegration - PreLoad Tento synchronní sled prací je volán, když se otevře nový záznam integračního objektu. Postupně tento sled prací zavolá sledy prací triIntegration – ResetMetaData a triIntegration – HideShow Data Sections. triIntegration - Reset MetaData Tento synchronní sled prací resetuje prvky formuláře, které jsou vymazány. Tento sled prací je volán ze sledu prací triIntegration – PreLoad. triIntegration - Opětovně odeslat Tento asynchronní sled prací je spuštěn při opětovném odeslání záznamu, který selhal, z nezdařeného záznamu instance (triIntegrationInstanceFailure). triIntegration - Testovat připojení k databázi Tento synchronní sled prací je spuštěn z akce sekce databáze záznamu integračního objektu pro volání select count(1) from [table_name] na definované databázi. Volání ověří, že definice integrace může komunikovat, a na této databázi spustí příkazy SQL. triIntegration - Testovat přístup k souboru Tento synchronní sled prací je spouštěn z akce sekce souboru záznamu integračního objektu, aby ověřil vytvoření, načtení, aktualizaci a odstranění oprávnění pro uvedenou lokalitu souboru. triDataSource - Reset Metadata Tento asynchronní sled prací resetuje záznam zdroje dat (triDataSource). triDataSource - Test DB Connection Tento synchronní sled prací je spuštěn ze záznamu zdroje dat (triDataSource) pro volání select count(1) from [table_name] na definované databázi. Toto volání ověří, že definice zdroje dat může komunikovat a spustit příkaz SQL na této databázi.
Standardní dotazy Integrační objekt produktu TRIRIGA je dodán s několika dotazy produktu IBM TRIRIGA. Následující oblasti aplikace a odpovídající dotazy jsou zahrnuty do modulu triIntegration. Pole Název zdroje dat triDatasource - getIntegrationObject datasource Sekce Provést historii triIntegration - získat Instance Sekce Selhání triIntegrationFailures - Get all failures Kapitola 2. Integrace dat s integračním objektem produktu TRIRIGA
27
Pole IntegrationObject Dependent Výchozí správce - objekty integrace Portál Moje sestavy triIntegration - getIntegrationObject
Standardní seznamy Integrační objekt produktu TRIRIGA je dodán s několika seznamy produktu IBM TRIRIGA. Následující pole a odpovídající seznamy jsou zahrnuty do modulu triIntegration. Typ datového připojení triDataConnectTypeLI Název ovladače databáze triDriverNameLI Oddělovač triFileDelimiterLI Směr
triIntegrationDirectionLI
Exportovat typ triFileExportTypeLI Typ integrace triIntegrationTypeLI Typ zasílání triHttpPostTypeLI
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS) Data můžete načíst ze své databáze IBM TRIRIGA a data ze serveru ArcGIS Esri a zobrazit je na mapách GIS. Mapy GIS mohou být v sekci portálů a na kartách formulářů.
Přehled map GIS Když přidáte mapy do portálů a formulářů produktu IBM TRIRIGA, uživatelé uvidí data v grafické formě, s funkcemi, které upravíte, aby lépe porozuměli datům. Chcete-li zobrazit mapy v aplikaci IBM TRIRIGA, musíte vytvořit záznam mapy GIS pro každou mapu a musíte uvést lokalitu svého serveru map GIS. Geografický informační systém (GIS) je systém pro zachycení, uložení, analýzu a správu dat a přidružených atributů, které jsou prostorově odkazovány na Zemi. V nejužším slova smyslu se jedná o informační systém, který integruje, ukládá, upravuje, analyzuje, sdílí a zobrazuje geograficky odkazované informace. Se systémem GIS mohou uživatelé vytvořit interaktivní dotazy, analyzovat prostorové informace, upravovat data, integrovat mapy a uvést výsledky těchto úloh. Technologie geografického informačního systému se používá pro správu prostředků, správu aktiv, posouzení dopadu na životní prostředí, městské plánování, prodeje, marketing, logistiku a mnoho dalších aktivit. GIS například umožňuje správcům zařízení snadno posoudit dopad na aktiva zařízení v události přírodních havárií. Nebo lze GIS použít k vyhledání lokality pro nový obchod, chcete-li využít dříve opomíjený trh.
Datové služby Esri a nástroje IBM TRIRIGA Chcete-li zobrazit mapy GIS ve formuláři produktu IBM TRIRIGA, potřebujete jak datové služby Esri, tak i nástroje IBM TRIRIGA. Následující seznam zobrazuje služby a nástroje, které umožňují zobrazení map GIS ve formulářích produktu IBM TRIRIGA. Datové služby produktu Esri v Geografická a geoprostorová data (Datové služby). Systém produktu IBM TRIRIGA získává data pomocí služeb rozhraní API REST na serverech Esri. v Zobrazení skutečné mapy. Server ArcGIS, a už se službami nabízenými v režimu online, nebo hostovanými na vlastněném serveru, vykreslí mapy a zachází s geozpracováním. v Geozpracování pro dobu jízdy nebo poloměr vzdálenosti. Geozpracování poskytuje server ArcGIS. v Geokódování pro shromažování souřadnic zeměpisné šířky a zeměpisné délky adresovatelných objektů nebo identifikátorů, které představují tyto funkce. Geokódování poskytuje server ArcGIS. v Rozhraní API Esri JavaScript. Vykresluje prohlížeč a poskytuje data ze serveru a základní interakci s mapováním dat. Standardní konfigurace je definována v objektu mapy GIS produktu IBM TRIRIGA. Nástroje produktu IBM TRIRIGA v Počáteční sada dat budov, která se používá k dotazování serveru ArcGIS Esri.
v Objekt ClassLoader, který obsahuje logiku pro vykreslení prohlížeče Esri JavaScript. v Nástroje pro konfiguraci základních map, vrstev, prostorových odkazů, modulů widget a dotazů, které se použijí ve vykreslených oblastech map GIS v rámci produktu IBM TRIRIGA. Produkt Esri nabízí množství datových služeb, včetně datové služby Geografický dotaz. Tyto služby používá produkt IBM TRIRIGA k určení zeměpisných oblastí, které uživatel uvidí v rámci aktuálního zobrazení mapy. Mapu GIS lze zobrazit v sekci portálu nebo na kartě formuláře produktu IBM TRIRIGA. Stejná plně dostupná funkce je k dispozici pokaždé, kdy je zobrazena mapa. Verze aplikací IBM TRIRIGA Application Platform a IBM TRIRIGA, které podporují funkce GIS, jsou definovány v příručce IBM TRIRIGA Application Platform Compatibility Matrix (https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/ IBM+TRIRIGA1/page/Support+Matrix).
Body integrace Esri Chcete-li zobrazit mapy, produkt IBM TRIRIGA komunikuje se službou mapování, která je poskytována serverem ArcGIS Esri. Produkt IBM TRIRIGA komunikuje se serverem ArcGIS Esri pomocí skriptu Java™, JavaScript a HTML. Rozhraní API produktu Esri JavaScript provádí volání služeb na server ArcGIS Esri a do produktu IBM TRIRIGA s nativním protokolem služeb HTTP. Akce, které jsou poskytovány na záznamech IBM TRIRIGA (například akce Adresa geokódu), spustí záznam integračního objektu pomocí sledu prací, aby provedly volání služby. Následující pole na každém formuláři dodané lokality a obchodní objekty podporují tento záznam integračního objektu: triGisLatitudeNU Obsahuje zeměpisnou šířku bodu geokódu. triGisLongitudeNU Obsahuje zeměpisnou délku bodu geokódu. Nadefinujete adresy URL a porty, které se používají pro vytváření map GIS. Nadefinujete základní mapy, vrstvy a služby modulů widget, jako jsou služby geometrie. Jedinou výjimkou je rozhraní API Esri JavaScript dodané z CDN Esri. Další informace o službách, které se používají s rozhraním API, viz webový server Esri (www.esri.com). Rozhraní API v režimu offline je samostatné a lze použít za bránou firewall.
Mapy v sekcích portálů GIS Sekce portálu GIS ukazuje na webovou stránku v aplikaci, která obsahuje mapu GIS. Mapa GIS je přidružena k záznamu mapy GIS, který definuje data pro vykreslení. Sekce portálu GIS s webovými stránkami v aplikaci zahrnují následující sekce portálu: v triURL - GIS - Environmental Manager/Planner nebo v triURL - GIS - Environmental Manager/Planner (US Govt) Když se uživatel přihlásí do aplikace, je vyvolána adresa URL, aby načetla webovou stránku, která obsahuje mapu. Na základě této mapy, která je definována v parametru adresy URL, je vrácen seznam spustitelných sestav. Spustí se první sestava z tohoto seznamu a do mapy se vrátí výsledky.
Sestavy mohou být metrické nebo standardní dotazy. Sestavy definují, co uživatel uvidí v bublinových značkách pro lokality nebo funkce. Dotazy také naplní tabulky dat v prohlížeči. Existuje korelace jeden-na-jednoho mezi bublinovými značkami na mapě a daty v tabulce. Tabulka obsahuje stejná pole, která obsahuje bublinová značka, protože zdrojem dat je pro oba stejná sestava. S moduly widget mapy může uživatel posouvat, přiblížit nebo vyhledat lokality. Uživatel může také vytvořit a upravit funkce na mapě a přiřadit je k objektu IBM TRIRIGA. Přesně vymezené lokality na mapě zobrazují umístění vrácená z dotazu. Každá lokalita má bublinovou značku (text při ponechání ukazatele), která zobrazuje informace související s lokalitou. Pokud je dotaz metrickým dotazem, bublinové značky zobrazí metrické výsledky. Barvy ikon přesně vymezených lokalit odpovídají prahovým hodnotám, které představují metrické výsledky. Pokud je dotaz standardním dotazem, ikony přesně vymezených lokalit jsou zbarveny modře. Výchozí barvy jsou modrá, červená, zelená a žlutá. Můžete použít své vlastní ikony pro znázornění přesně vymezených lokalit na mapě. Dotaz, který je přidružen k mapě v sekci portálu neovlivní data v portálu, ani na ně nijak nereaguje. GIS je samostatná aplikace uvnitř sekce portálu. Sekce GIS zahrnuje tlačítko Uložit předvolby. Tato funkce ukládá aktuální oblast mapy a zobrazení. Když se příště uživatel přihlásí, uložená nastavení přepíší předvolbu v parametru adresy URL sekce portálu. Pokud uživatel neuložil žádné předvolby, sekce zobrazí výchozí zobrazení jako definované v řetězci parametru adresy URL. Uživatelské předvolby se ukládají na uživatele, na mapu. Když uživatel změní mapu na jinou, předvolby pro původní mapu se nepoužijí na druhou mapu. Namísto toho se druhá mapa zobrazí s výchozími nastaveními pro tuto mapu, pokud tedy uživatel dříve neuložil předvolby pro druhou mapu.
Mapy na kartách formulářů GIS Karta GIS obsahuje mapu, která přesně stanoví lokalitu záznamu. Když má uživatel odpovídající licence, dodané lokality, geografické oblasti a transakční plán nemovitostí, formuláře zahrnují kartu GIS. Oblast mapy na kartě GIS je lokalizovaná oblast. Výchozí dotaz vykreslí mapu. Dotaz je uveden v adrese URL jako řetězec parametru, který určuje, jaké dotazy se spustí. Adresa URL pro kartu GIS je definována v aplikaci Form Builder.
Přehled prvků mapy GIS Když nadefinujete novou definici mapy GIS, musíte nakonfigurovat různé prvky map. Prvky map zahrnují fyzické oblasti, dotazy, základní mapy, vrstvy, ikony a moduly widget.
Záznamy map GIS Chcete-li definovat novou definici mapy GIS, musíte vytvořit záznam mapy GIS z obchodního objektu mapy GIS. Existující záznamy mapy GIS jsou vypsány v nabídce Nástroje > Nastavení systému > GIS > Mapa GIS.
Fyzické oblasti Počáteční oblast se odkazuje na prostorový odkaz a hranice mapy, když se poprvé otevře v sekci portálu nebo na kartě formuláře. Pokud není všeobecně známé ID (WKID) odpovídající pro základní mapy a vrstvy, vaše sekce mapy je prázdná a neobsahuje mapu. Dva příklady hodnot WKID jsou 4326 a 102100.
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS)
31
Další informace viz hodnoty WKID pro geografický souřadnicový systém (resources.arcgis.com/en/help/rest/apiref/gcs.html) a souřadnicový systém projekce (resources.arcgis.com/en/help/rest/apiref/pcs.html).
Dotazy Dotazy definují data lokality sestavení produktu IBM TRIRIGA, která se zobrazí na mapě. Libovolný dotaz, který je podporovaný správcem sestav produktu IBM TRIRIGA, lze na tuto mapu použít. Dotaz s nejnižší hodnotou v poli Pořadí zobrazení se zobrazí jako výchozí. Chcete-li vybrat jiný dotaz, můžete klepnout na kartu Zobrazit podrobnosti nad mapou a vybrat dotaz ze seznamu. Metrické dotazy se chovají odlišně v sekcích GIS, než se chovají v jiných oblastech produktu IBM TRIRIGA. V sekcích GIS jsou data metrických dotazů filtrována a seskupena podle geografických dat, která se zobrazí v aktuálním zobrazení mapy. Struktura metrického dotazu musí být tabulková a dotaz musí zahrnovat sloupce zobrazení, které jsou označeny Zeměpisná délka a Zeměpisná šířka. Pole Zeměpisná šířka a Zeměpisná délka přesně zobrazují položku na mapě. Pokud jsou výsledky dotazu ve více než jednom systému mapování, software GIS provede převod a zobrazí výsledky v základní mapě. Když je spuštěn dotaz a filtr dorazů zahrnuje pole triGisLatitudeNU a triGisLongitudeNU, prohlížeč Esri JavaScript automaticky přidá filtry do dotazu. Filtry omezují výsledky na oblasti v rámci mapy. Musí být použita pole triGisLatitudeNU a triGisLongitudeNU; jinak nelze přidat filtry. Mapa může vrátit maximálně 1000 záznamů.
Základní mapy Základní mapy identifikují mapy, které jsou k dispozici pro zobrazení. Základní mapa s nejnižší hodnotou v poli Pořadí zobrazení se zobrazí jako výchozí. Jinou základní mapu můžete vybrat po klepnutí na kartu Zobrazit podrobnosti nad mapou a výběrem seznamu Přepnout základní mapu. Karta Zobrazit podrobnosti také zobrazuje informace o mapě, která je poskytována dodavatelem map. Záznam základní mapy vyžaduje, abyste uvedli adresu URL REST serveru Esri, který poskytuje službu mapování. Pokud je adresa URL správná a platná, popis služby základní mapy, který je poskytován serverem Esri, se vykreslí ve spodní části formuláře základní mapy GIS. Pokud se namísto popisu služby základní mapy nic nezobrazí nebo uvidíte chybu, potvrte, že váš server Esri povolil službu základní mapy s koncovými body REST. Můžete změnit ikonu, která zobrazuje, kdy se základní mapa zobrazí na seznamu Přepnout základní mapu na kartě mapy Zobrazit podrobnosti. Když pole Adresa URL miniatury ukazuje na platný obrázek, zobrazí se na seznamu Přepnout základní mapy. Pokud neuvedete hodnotu, objeví se výchozí obrázek.
Vrstvy Vrstvy identifikují vrstvy legendy, které jsou k dispozici pro zobrazení v horní části základní mapy.
Když je zaškrtnuto zaškrtávací políčko Předvolba, vrstva se zobrazí při vykreslení mapy. Vrstvu můžete přidat klepnutím na kartu Zobrazit podrobnosti nad mapou a zaškrtnutím zaškrtávacího políčka vedle názvu vrstvy. Zrušením zaškrtnutí zaškrtávacího políčka odeberete vrstvu ze zobrazení. Když vyberete vrstvu s přidruženými informacemi o legendě, sloupec napravo od mapy zobrazí tuto legendu. Když se zobrazí několik vrstev, legendy se vypíší v pořadí zobrazení. Jak upravujete oblast mapy přibližováním, data v legendě se aktualizují, aby odrážela správnou úroveň podrobností. Pokud se vrstva zobrazí při výchozím nastavení, legenda se nezobrazí, dokud neklepnete bu na kartu Zobrazit podrobnosti, nebo na kartu Zobrazit tabulku. Zpožděním zobrazení ušetříte místo na mapě, což je důležité, když se mapa zobrazuje na menších místech, jako je portál. Sloupec, který zobrazuje legendu, zmizí po odebrání poslední vrstvy. Záznam vrstvy vyžaduje, abyste uvedli adresu URL REST serveru Esri, který poskytuje službu mapování. Pokud je adresa URL správná a platná, popis služby základní mapy, který je poskytován serverem Esri, se vykreslí ve spodní části formuláře základní mapy GIS. Pokud se namísto popisu služby základní mapy nic nezobrazí nebo uvidíte chybu, potvrte, že váš server Esri povolil službu vrstvy s koncovými body REST.
Ikony Barvy špendlíků a barvy ikon lze nadefinovat tak, aby představovaly konkrétní rozsah datových hodnot. Když metrický dotaz určí body na mapě, prahové hodnoty, které jsou definovány v metrickém dotazu, řídí barvy špendlíků. Prahová hodnota například v metrickém dotazu definuje hodnotu 1 až 3 jako nízkou a červená barva představuje záporný výsledek. Pokud dotaz vrátí hodnotu 2, špendlík se zobrazí se souborem ikony obsaženým v poli Červená ikona. Pole Modrá ikona se používá pro hodnotu, která je vrácena standardním dotazem. Můžete změnit zobrazené ikony odesláním svých souborů do sekce Ikony. Soubor s ikonami může být libovolného formátu, který se používá k vykreslení na webu, například soubor .jpg nebo .png. Pokud nezměníte soubor s ikonami, použijí se dodané ikony.
Moduly widget Moduly widget lze definovat pro přidání geoprocesoru, poskytnutí mapy přehledu nebo přidání vlastních modulů widget. Většina modulů widget je k dispozici po klepnutí na kartu Zobrazit podrobnosti nad mapou.
Ukázkové moduly widget Produkt IBM TRIRIGA Connector for Esri Geographic Information System (GIS) obsahuje ukázkové moduly widget z produktu Esri. Tyto dodané moduly widget jsou zahrnuty jen pro účely ilustrace. Ukázkové moduly widget mají následující charakteristiky: Modul widget Geokodér Pomocí dodaného modulu widget geokodéru můžete navést mapu na souřadnice zeměpisné šířky a zeměpisné délky nebo na adresu. Modul widget Doba jízdy Dodaný modul widget Doba jízdy zobrazuje poloměry pro minutovou, dvouminutovou a tříminutovou dobu jízdy ze zvoleného bodu. Modul widget Přehled map Dodaný modul widget Přehled map otevřete klepnutím na šipku, která je v pravém Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS)
33
horním rohu mapy. Přehled map zobrazuje stručnou verzi mapy a obsahuje podokno, které lze posouvat. Přetáhnutím tohoto podokna můžete procházet větší oblasti mapy bez nutnosti oddálení. Modul widget Editor Pomocí dodaného modulu widget Editor můžete kreslit čáry, mnohoúhelníky nebo bod na mapě. Entita se uloží na mapu produktu Esri, pokud přidružíte funkci k jednomu ze záznamů v dotazu nebo zaškrtnete zaškrtávací políčko Zobrazit všechny funkce. Dodaný modul widget Editor je nazvaný sampleEditor.js. Tento soubor můžete použít jako příklad toho, jak vytvořit vlastní moduly widget. V dodaném ukázkovém modulu widget editoru lze přidružit funkci k ID produktu IBM TRIRIGA. Chcete-li přidružit funkci k ID, zadejte hodnotu do jednoho z číselných nebo textových polí v informačním podokně. V ukázce je použito pole ID vydání. Stejnou metodou v jiném modulu widget editoru můžete přidružit funkci k hodnotě. Můžete nakreslit funkci a přidružit ji k záznamu IBM TRIRIGA klepnutím na kartu Zobrazit tabulku a výběrem ikony Přidružit ke zvolené funkci pro záznam produktu IBM TRIRIGA v tabulce. Při dalším dotazu na tento záznam se na mapě zobrazí funkce. ID produktu IBM TRIRIGA je společné ID mezi produkty IBM TRIRIGA a Esri. Je-li povolen, dodaný modul widget editoru koliduje s informacemi bublinových značek poskytnutých špendlíky. V době vydání neexistuje žádné známé náhradní řešení. Modul widget Blízkost Pomocí modulu widget Blízkost server po klepnutí na bod na mapě zpracuje poloměr vzdálenosti z této mapy. Data, která se zobrazí na mapě, se změní, takže jediné zobrazené budovy jsou v blízkosti hranic. Blízkost hranice určuje server.
Vlastní moduly widget Vlastní moduly widget jsou vytvořeny z rozčleněného kódu JavaScript specifického pro moduly widget produktu Esri. Pomocí této funkce můžete přidat vlastní modul widget produktu Esri, který je založen na rozhraní API Esri JavaScript verze 3.3. Vlastní modul widget může být něco tak jednoduchého, jako je překryv mapy, nebo tak složitý, jako je úprava mnohoúhelníku. Chcete-li nadefinovat modul widget, odešlete kód JavaScript pro modul widget do pole Kód. Po přidání vlastního kódu JavaScript do binárního pole, je kód vložen do prohlížeče produktu Esri JavaScript a za běhu připojen k vykreslené mapě. Další informace viz bílý list papíru pro příručku EsriJS Widget Construction (https://www.ibm.com/developerworks/community/wikis/home?lang=en#/wiki/ IBM+TRIRIGA1/page/Connector+for+Esri+GIS).
Skupiny modulů widget Skupiny modulů widget identifikují skupiny zabezpečení, které jsou autorizovány pro přístup k modulům widget, kromě členů skupiny administrátorů. Uživatelé v kterékoli z vypsaných skupin zabezpečení nebo skupiny administrátorů mohou zobrazit konkrétní modul widget, když je vybrána volba Přidat zabezpečení v sekci Moduly widget.
Služby geometrie Služby geometrie identifikují služby, které se používají ke zpracování transformací projekcí pro prohlížeč kódu Esri JavaScript. Tuto službu můžete odkazovat v modulech widget a použít ji pro projekci bodu.
Předvolby náhledu Můžete si zobrazit náhled mapy, která je konfigurována v záznamu map GIS, a také uložit předvolby mapy na kartě Náhled formuláře. Základní mapu a oblasti pro rozšíření aktuálního zobrazení můžete uložit klepnutím na kartu Zobrazit podrobnosti a poté na tlačítko Uložit předvolby. Výběr tlačítek Vymazat předvolby vrátí základní mapu a oblasti pro rozšíření na základní hodnoty, které jsou definovány v záznamu mapy GIS. Předvolby jsou uloženy podle přidružení ze záznamu mapy GIS na objekty s uživatelskými předvolbami GIS. Můžete uložit předvolby pro každou mapu. Můžete zobrazit data uvedená na mapě v tabulce výběrem karty Zobrazit tabulku. Když vyberete řádek v tabulce, mapa se přiblíží na bod na mapě odpovídající záznamu a zde se vycentruje. Výběr odkazu Exportovat v pravém horním rohu tabulky stáhne tabulku jako textový soubor se záznamy oddělenými tabulátory. Hodnota v poli Vytvořená adresa URL na kartě Náhled je adresa URL pro mapu, která je zobrazena na kartě Náhled. Můžete zkopírovat hodnotu pole Vytvořená adresa URL a vložit ji do záznamu lokality, aby ji svázala s mapou.
Konfigurace map GIS Pomocí záznamů mapy GIS zobrazíte mapy GIS v portálech a formulářích produktu IBM TRIRIGA. Záznam mapy GIS definuje připojení mezi aplikací IBM TRIRIGA a serverem ArcGIS, který poskytuje mapy produktu Esri. Záznam mapy GIS obsahuje metadata definující, které mapy, vrstvy a moduly widget se zobrazí.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > GIS > Mapa GIS. 2. Přidejte záznam mapy GIS. 3. Uvete název mapy, minimální a maximální oblasti a všeobecně známé ID (WKID) pro tuto mapu. 4. Identifikujte dotazy na definování výsledků dat, které se zobrazí na mapě. 5. Identifikujte základní mapy a jejich adresy URL na server Esri, který poskytuje službu mapování. 6. Identifikujte libovolné vrstvy, chcete-li poskytnout informace o legendě, která se zobrazí přes mapu. 7. Nahrate libovolné ikony, chcete-li upravit obrázky špendlíků, které se zobrazí na mapě. 8. Identifikujte moduly widget, chcete-li poskytnout další nástroje mapování nebo upravit nové. 9. Identifikujte skupiny modulů widget, chcete-li získat zabezpečený přístup k modulům widget, kromě členů skupiny administrátorů. 10. Uvete službu geometrie, která transformuje projekce pro prohlížeč Esri JavaScript. 11. Vytvořte a uložte záznam.
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS)
35
Přidání vlastních sekcí portálu GIS Sekce portálu GIS ukazuje na webovou stránku v aplikaci, která obsahuje mapu GIS. Mapa GIS je přidružena k záznamu mapy GIS, který definuje data pro vykreslení. Sekce portálu GIS má Externí typ sekce portálu, kde uvedete adresu URL mapy.
Informace o této úloze Můžete použít jednu z následujících dodaných sekcí portálu GIS s webovými stránkami v aplikaci pro porovnání: v triURL - GIS - Environmental Manager/Planner nebo v triURL - GIS - Environmental Manager/Planner (US Govt)
Postup 1. Nakonfigurujte záznam mapy GIS. Nadefinujte oblasti, dotazy, základní mapy, vrstvy a další prvky mapy. U tohoto příkladu je název mapy Moje první mapa. 2. Z tvůrce portálů vytvořte novou sekci portálu s Externím typem sekce portálu. 3. Zadejte adresu URL mapy. U tohoto příkladu je adresa URL /html/en/default/rest/ EsriJS?map=Moje první mapa. Hodnota parametru mapy Moje první mapa sdělí prohlížeči mapy vykreslit tento záznam mapy GIS.
Uvedení serverů ArcGIS Váš server ArcGIS může být externí server v režimu online nebo interní hostovaný server. Soubor prostředku v záznamu zavaděče tříd EsriJS ClassLoader uvádí, odkud jsou vaše mapy GIS dodávány.
Informace o této úloze Soubor prostředku pro externí server ArcGIS v režimu online musí být nazván EsriJS_arcgis.js. Soubor prostředku pro interní hostovaný server ArcGIS, který je obvykle za bránou firewall, musí být nazván Esri_API_3.3.zip. Když poprvé některý uživatel načte libovolnou mapu, software se připojí ke službě, která je definována souborem prostředku v záznamu EsriJS ClassLoader. Pokud není k dispozici žádný soubor prostředku, zobrazí se varovná zpráva. Pokud jsou k dispozici oba soubory prostředku, použije se externí server v režimu online. Existující záznamy EsriJS ClassLoader jsou vypsány v nabídce Nástroje > Nastavení systému > Systém > Zavaděč tříd.
Uvedení externích serverů ArcGIS Uvedete lokalitu externího serveru ArcGIS online v souboru prostředků, který přidáte do záznamu EsriJS ClassLoader.
Informace o této úloze Rozhraní API produktu Esri JavaScript musí být dodáno ze sítě CDN, která je poskytována produktem Esri a musí být ve verzi 3.3. Soubor prostředků, který jste přidali k záznamu EsriJS ClassLoader, musí být nazván EsriJS_arcgis.js. Když po přidání souboru EsriJS_arcgis.js libovolný uživatel přistoupí k mapě GIS, tato mapa a všechny funkce budou dodány z externího serveru online.
Postup 1. Stáhněte soubor z produktu Esri, který definuje službu, ke které vaše společnost přihlásila odběr. Soubor může být například init.js z http://js.arcgis.com/3.3/. 2. Přejmenujte soubor na EsriJS_arcgis.js. 3. Otevřete záznam EsriJS ClassLoader. 4. V záznamu přidejte soubor prostředků, abyste mohli přenést svůj soubor EsriJS_arcgis.js. Pokud je přítomen soubor EsriJS_API_3.3.zip, můžete jej odebrat ze souborů prostředků. 5. Uložte záznam.
Uvedení interních serverů ArcGIS Uvedete lokalitu interního hostovaného serveru ArcGIS v souboru prostředků, který přidáte do záznamu EsriJS ClassLoader.
Informace o této úloze Adresář [HOSTNAME_AND_PATH_TO_JSAPI] musí být upraven, aby odpovídal proměnné BASE_URL. Soubor prostředků, který přidáte do záznamu EsriJS ClassLoader, musí být nazván EsriJS_API_3.3.zip. Když po přidání souboru EsriJS_API_3.3.zip libovolný uživatel přistoupí k mapě GIS, jsou mapa a všechny budoucí mapy dodány z interního hostovaného serveru.
Postup 1. Přejděte do sekce Soubory ke stažení Esri (www.esri.com/apps/products/download/). a. Stáhněte rozhraní API ArcGIS pro verzi JavaScript v3.3 API (arcgis_js_v33_api.zip) b. Extrahujte soubory z komprimovaného souboru. 2. Vyhledejte soubor arcgis_js_v33_api\library\3.3\jsapi\init.js a otevřete jej pomocí textového editoru. a. Vyhledejte [HOSTNAME_AND_PATH_TO_JSAPI] na tomto řádku: location.protocol) + ’//’ + "[HOSTNAME_AND_PATH_TO_JSAPI]js/ dojo/dojo" b. Změňte tento řádek na následující kód: location.protocol) + ’//’ + BASE_URL + "js/dojo/dojo" c. Věnujte pozornost umístění uvozovek. d. Uložte soubor init.js. 3. Vyhledejte soubor arcgis_js_v33_api\library\3.3\jsapi\dojo\dojo\dojo.js a otevřete jej pomocí textového editoru. a. Vyhledejte [HOSTNAME_AND_PATH_TO_JSAPI] na tomto řádku: location.protocol) + ’//’ + "[HOSTNAME_AND_PATH_TO_JSAPI]js/ dojo/dojo" b. Změňte tento řádek na následující kód: location.protocol) + ’//’ + BASE_URL + "js/dojo/dojo" c. Věnujte pozornost umístění uvozovek. d. Uložte soubor dojo.js. 4. Vyhledejte adresář arcgis_js_v33_api\library a vyberte složku 3.3. Vytvořte komprimovaný soubor této složky. 5. Přejmenujte komprimovaný soubor na EsriJS_API_3.3.zip. 6. Otevřete záznam EsriJS ClassLoader.
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS)
37
7. V tomto záznamu přidejte soubor prostředku, aby bylo možné aktualizovat váš soubor EsriJS_API_3.3.zip. Pokud je soubor EsriJS_arcgis.js k dispozici, musíte jej odebrat ze souborů prostředku. 8. Uložte záznam.
Přepínání z interních na externí servery Uvedete lokalitu svého serveru ArcGIS v souboru prostředků, který přidáte k záznamu EsriJS ClassLoader. Soubor prostředků můžete změnit z interního hostovaného serveru na externí server v režimu online a naopak.
Informace o této úloze Když po změně serveru ArcGIS přistoupí uživatel k libovolné mapě GIS, tato mapa a všechny budoucí mapy budou dodány z nového serveru.
Postup 1. Otevřete záznam EsriJS ClassLoader. 2. Najděte nebo vytvořte soubor prostředků, který uvádí nový server ArcGIS, a přidejte soubor prostředků do záznamu. 3. Odeberte starý soubor prostředků, který uvádí starý server ArcGIS. 4. Uložte záznam.
Odstraňování problémů s mapami systému GIS Chcete-li pomoci při řešení výkonu nebo zobrazení problémů se sekcemi portálu a kartami formulářů GIS, můžete si prohlédnout následující problémy, příčiny a nápravy.
Běžné problémy s mapami GIS Běžné problémy GIS zahrnují pomalou odezvu, chybějící prvky a duplicitní záznamy. Některé z běžných vysvětlení mohou pomoci vyřešit tyto problémy. Mapa má pomalou odezvu Rychlost, jakou se mapa obnoví, když ji přiblížíte a oddálíte, závisí na rychlosti vašeho připojení k Internetu. Pokaždé, když posunete mapu, provede se volání pro odezvu a překreslení mapy. Váš prohlížeč Esri JavaScript ovládá tyto akce. Doba, jak dlouho trvá překreslit mapu, závisí na rychlosti sítě, která se používá. Pokud používáte službu online, jako je produkt Esri, příkazy komunikují přes protokol HTTP. Pokud používáte vnitropodnikový server Esri, váš intranet určuje latenci. Pokud váš prohlížeč Esri JavaScript funguje v produktu Microsoft Internet Explorer, ověřte si, že je pro něj povoleno následující nastavení XML HTTP. Vyberte volby Nástroje > Volby Internetu > Rozšířené > Povolit nativní podporu XMLHTTP. Popisky v bublinových značkách a tabulky se nezobrazují Popisky v bublinových značkách a v tabulkách jsou definovány dotazy produktu IBM TRIRIGA. Chcete-li vložit značku na mapu, data musí obsahovat a dotaz musí zobrazovat pole označená Zeměpisná šířka a Zeměpisná délka. Chcete-li zobrazit obrázek lokality v bublinových značkách, data lokality musí obsahovat a dotaz musí zobrazovat pole, které je označeno Obrázek. Chybějící lokality v Lokality nemají geokódy. Aby se lokalita zobrazila na mapě, záznam musí mít geokód. v Váš dotaz nevrací výsledky.
v Váš server ArcGIS není spuštěn nebo neodpovídá. Data se nezobrazují v Všechny dotazy musí interpretovat seznam lokalit nebo entit. v Systém je navržen tak, aby měl počáteční dotaz a základní mapu. Standardní dotaz může obejít tyto požadavky a zobrazit všechny geokódované výsledky na mapě. Dotaz musí vracet sloupec s výsledky zeměpisné šířky a zeměpisné délky. Duplicitní záznamy Duplicitní záznamy v tabulce jsou způsobeny datovými problémy s vašimi strukturami hierarchie. GIS používá fixní hierarchickou tabulku. Můžete přestavět fixní hierarchickou strukturu. Sekce GIS je prázdná Pokud je vaše sekce GIS prázdná bílá obrazovka namísto mapy, zkontrolujte následující kritéria: v Konfigurační stránky GIS jsou řádně nastaveny. v Server ArcGIS je spuštěn. v Zavaděč tříd ArcGIS ClassLoader není nastaven na režim ladění. v Máte licenci pro použití mapy GIS. Zpráva o chybějící licenci Pokud zpráva uvádí, že nemáte licenci GIS, ověřte, že je váš licenční soubor IBM TRIRIGA nebo soubory aktuální.
Odebrání duplicitních záznamů z map GIS Chcete-li odebrat duplicitní záznamy z tabulky zobrazení mapy GIS, můžete znovu sestavit fixní strukturu hierarchie pomocí datového modeláře IBM TRIRIGA.
Postup 1. 2. 3. 4.
Vyberte volbu Nástroje > Nástroje tvůrce > Datový modelář. Vyberte nabídku Veřejné služby > Struktury hierarchie. Vyberte nabídku Všechny zeměpisné oblasti, poté odkaz Generovat data. Vyberte nabídku Prostory pro sestavení, poté odkaz Generovat data.
5. Vyberte volbu Budovy a pozemky, poté odkaz Generovat data.
Kapitola 3. Integrace dat s produktem TRIRIGA Connector for Esri Geographic Information System (GIS)
Kapitola 4. Rozšíření funkcí konektoru Můžete zapsat rozšířené funkce pro mnoho konektorů produktu IBM TRIRIGA. Tyto rozšířené funkce používají zavaděče tříd, soubory prostředků, vlastní komponenty sledu prací, servery proxy servletů, programovací jazyk Java a rozhraní webové služby IBM TRIRIGA Connector for Business Applications.
Přehled rozšířených funkcí Konektory produktu IBM TRIRIGA používají obchodní objekt zavaděče tříd a soubory prostředků. Server proxy servletu je rozšíření zavaděčů tříd. Až budete zapisovat rozšířené funkce, můžete tyto funkce distribuovat v balíku migrace objektů. Konektory používají obchodní objekt zavaděče tříd a soubory prostředků a vlastní komponenty sledu prací, jako jsou např. VlastníÚloha, VlastníParametry a VlastníTransakce. Server proxy servletu je rozšíření zavaděčů tříd, které poskytuje úchyt pro rozhraní API Java pro produkt IBM TRIRIGA Connector for Business Applications (CBA). Produkt CBA používá programování ve stylu servletu v jazyce Java pro integraci s externími systémy s vlastními komponentami. Chcete-li vytvořit konektory produktu IBM TRIRIGA, musíte být seznámeni s nástroji tvůrce produktu IBM TRIRIGA Application Platform, rozhraním webové služby produktu IBM TRIRIGA Connector for Business Applications a programovacím jazykem Java. Konektor můžete naimplementovat pouze pomocí programovacího jazyka Java.
Vlastní zavaděče tříd Komponenty vlastních zavaděčů tříd produktu IBM TRIRIGA spolupracují se zavaděči tříd systému při implementaci tříd Java do domény aplikačního serveru. Následující obrázek názorně ukazuje interakci mezi vlastním zavaděčem tříd produktu IBM TRIRIGA a zavaděči tříd systému.
Vlastní třídy a vlastní úlohy Když vytvoříte záznam zavaděče tříd, můžete přidat vlastní třídy Java do cesty ke třídě aplikačního serveru. K těmto třídám můžete přistoupit z vlastní úlohy ve sledu prací. Můžete přidat vlastní třídy Java do cesty ke třídě aplikačního serveru třemi způsoby: První nadřízený, Poslední nadřízený a Izolovaný. K těmto třídám můžete přistoupit pomocí vlastní úlohy ve sledu prací kvůli programové interakci nebo je můžete rozšířit, aby fungovaly jako servlet v jazyce Java. Obě metody rozšíří schopnosti formuláře pro sekce portálu a karty formuláře. Abyste přistoupili k třídám z vlastní úlohy, která se načte skrze zavaděč tříd, musíte dodržet následující pravidla: v Spuste balíky tříd pomocí jedné z následujících tří struktur: com.tririga.ps, com.tririga.appdev nebo com.tririga.custom. Jakákoli jiná struktura je blokována.
v Uvete název zavaděče tříd, za nímž bude následovat dvojtečka, v poli Název třídy ve vlastní úloze sledu prací. Například, pokud máte záznam zavaděče tříd pojmenovaný MyClassLoader a vaše třída položky je com.tririga.custom.myclassloader.Hello, pak bude v poli Název třídy hodnota MyClassLoader:com.tririga.custom.myclassloader.Hello. Když použijete tuto konvenci pojmenování, sled prací může vyhledat třídu v rámci kontextu uvedeného zavaděče tříd. v Naimplementujte jeden z objektů com.tririga.workflow.pub.CustomTask, který je k dispozici v dodaném souboru TririgaCustomTask.jar v adresáři instalační_adresář/ tools/BusinessConnect. V rámci vývoje musíte zahrnout soubory TririgaBusinessConnect.jar a TririgaCustomTask.jar do cesty ke třídě IDE. Pokud zahrnete tyto knihovny do obchodního objektu zavaděče tříd, budou ignorovány. Chcete-li získat informace o tom, jak naimplementovat vlastní úlohu a co vám nabízí, prohlédněte si Tvoření aplikací pro produkt IBM TRIRIGA Application Platform 3. Objekt zavaděče tříd poskytuje jednoduchý úchyt pro implementaci za běhu a bezpečnou správu implementací vlastních úloh. Nepřidává ani nemění funkce vlastní úlohy. Tvoření aplikací pro produkt IBM TRIRIGA Application Platform 3 vás instruuje, abyste umístili soubory do adresáře lib aplikačního serveru. Tento krok můžete přeskočit, který může být komplikovaný, pokud máte více serverů. Místo toho přidejte zavaděč tříd do databáze a nechte kontejner, aby extrahoval a použil třídy.
Režim vývoje zavaděče tříd V režimu vývoje můžete změnit soubory a prohlédnout si změny, když obnovíte stránku, aniž byste museli přenést soubory do záznamu zavaděče tříd. Obvykle, když upravíte, přidáte nebo odeberete soubor prostředku ze záznamu zavaděče tříd, se spustí sled prací, který zvýší číslo revize. Změna tohoto čísla revize řekne produktu IBM TRIRIGA Application Platform, aby znovu načetl tento záznam zavaděče tříd. Avšak, pokud máte přístup ke složce instalační_adresář/userfiles/název_zavaděče_tříd produktu IBM TRIRIGA, můžete vybrat volbu Režim vývoje v záznamu zavaděče tříd. Když vyberete tuto volbu, zavaděč tříd bude ignorovat číslo revize a místo toho stáhne soubory ze složky instalační_adresář/userfiles/název_zavaděče_tříd. Typy souborů, které můžete změnit, zahrnují webovou stránku, (.html), skript JavaScript (.js), Adobe Flash a obrazy. Upozornění: Pokud vymažete zaškrtávací políčko Režim vývoje, produkt IBM TRIRIGA Application Platform stáhne nejnovější soubory ze záznamu zavaděče tříd, a může se tak přepsat vaši práci.
Servery proxy servletů Server proxy servletu je rozšíření zavaděčů tříd. Použijte jej k vývoji tříd ve stylu servletu, které mohou vykreslovat, přesměrovávat a komunikovat s aktivy formuláře v rámci záznamu zavaděče tříd. Aktiva musíte přenést do záznamu zavaděče tříd jako soubory prostředků. Následující obrázek názorně ukazuje interakci mezi serverem proxy servletu a vlastním zavaděčem tříd produktu IBM TRIRIGA.
Kapitola 4. Rozšíření funkcí konektoru
43
TRIRIGA
Požadavek
Server proxy servletu
Ověřit relaci
Connector for Business Applications
Ověřit klienta
Generovat výjimku
Vlastní zavaděč tříd
Databáze aplikace TRIRIGA
Vytvořit instanci implementační třídy
Ne
Ano
Ne
TririgaWS (rozhraní API CBA)
Implementace IConnect
Ano
Grafické uživatelské rozhraní
Vlastní kód
Vzdálený přístup k datům
Vykreslit grafické rozhraní
Obrázek 2. Server proxy servletu
Přístup k serveru proxy servletu Server proxy servletu je k dispozici na následující adrese URL: http://YourServer/html/en/ default/rest/název_konektoru. Je-li váš server proxy servletu pojmenován MyFirstConnector a je řádně nakonfigurovaný, je k dispozici na následující adrese URL: http://váš_server/html/en/default/rest/MyFirstConnector. Abyste mohli přistoupit k této adrese URL, musíte mít platné jméno uživatele a heslo. Tuto adresu URL můžete přidat jako externí odkaz v rámci sekce portálu nebo v rámci vlastní karty formuláře. Veškerý přístup k serveru proxy servletu začíná z této základní adresy URL. Chcete-li přistoupit k souborům v rámci souborů prostředků zavaděče tříd, připojte slovo resource k základní adrese URL, po kterém bude následovat cesta k prostředku, který chcete načíst.
Pokud máte například obraz, který slouží jako soubor prostředku, s názvem dobrýDen.jpg, můžete tento obraz dynamicky načíst s pomocí následující adresy URL: http://váš_server/html/en/default/rest/MyFirstConnector/resource/helloWorld.jpg. Server zkontroluje, zda je tento soubor prostředku načten. Není-li tento soubor načten, server jej stáhne z binárního pole Soubor prostředku v záznamu souboru prostředku a umístí jej do složky instalační_adresář/userfiles/název_zavaděče_tříd. Po provedení požadavku server zkontroluje mezipamě a spáruje jeho číslo revize s číslem revize v zavaděči tříd. Pokud se čísla revizí liší, server znovu načte všechny soubory, které nejsou částí souboru .jar, do tohoto adresáře. Server pak odkáže na toto umístění pro každý následný požadavek. Soubory prostředku se automaticky aktualizují pokaždé, když se provede změna. Nemusíte restartovat server, abyste obnovili zavaděč tříd.
Přidání souborů prostředků do zavaděčů tříd Přidejte soubory prostředků do zavaděče tříd, chcete-li poskytnout třídy a aktiva formulářů, jako je např. webová stránka (.html), skript JavaScript (.js), Flash, soubory s obrazy a soubory vlastností. Například, soubor prostředku skriptu JavaScript (.js) v záznamu zavaděče tříd EsriJS uvádí zdroj map systému GIS.
Informace o této úloze Soubor prostředku může použít více než jeden zavaděč tříd. U souborů prostředků je vhodné připojit k názvům knihoven předponu v podobě zkratky zavaděče tříd a skutečného názvu knihovny. Pokud odesíláte soubor .jar, pak se do cesty ke třídě načtou pouze soubory .class. Máte-li mnoho aktiv, jako např. webovou stránku (.html), skript JavaScript (.js) a soubory s obrazy, můžete je shromáždit do komprimovaného souboru a přenést je jako jediný soubor. Můžete také přenést jednotlivý soubor, jako např. konfigurační soubor, abyste jej mohli snadněji upravit. Když upravíte, přidáte nebo odeberete soubor prostředku ze záznamu zavaděče tříd, spustí se sled prací, který zvýší číslo revize. Změna tohoto čísla revize řekne produktu IBM TRIRIGA Application Platform, aby znovu načetl tento záznam zavaděče tříd.
Postup 1. Přejděte na nabídku Nástroje > Nastavení systému > Systém > Zavaděč tříd. 2. Přidejte nebo otevřete záznam zavaděče tříd. 3. V záznamu vyhledejte nebo přidejte soubory prostředků. 4. Uložte záznam.
Konfigurace serverů proxy servletu Aby server proxy servletu správně vykreslil a prošel kódem, naimplementujete třídu rozhraní Java, která je obsažena v souboru TririgaCustomTask.jar.
Informace o této úloze Balík com.tririga.custom je jediný balík, který můžete použít k vytvoření implementační třídy. Třída musí být jedinečná. Můžete mít pouze jednu implementační třídu IConnect na jeden záznam zavaděče tříd. Název záznamu zavaděče tříd a název třídy Java, která
Kapitola 4. Rozšíření funkcí konektoru
45
implementuje IConnect, musí být stejný. Pokud jste třídu pojmenovali MyFirstConnector, pak musíte také identifikovat záznam zavaděče tříd jako MyFirstConnector. Jakmile nakonfigurujete server proxy servletu, můžete přistoupit ke konektoru.
Postup 1. Vytvořte třídu Java v balíku com.tririga.custom. Například vytvoříte třídu s názvem MyFirstConnector. 2. Naimplementujte rozhraní Java com.tririga.pub.adapter.IConnect pomocí metody execute ve třídě IConnect. Například, pokud jste třídu pojmenovali MyFirstConnector, vytvoříte následující kód: public class MyFirstConnector implements IConnect { public void execute(TririgaWS tws, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //zde umístěte váš kód } }
Tento příklad má úchyt pro třídu rozhraní TririgaWS. Tato třída je rozhraní Java pro rozhraní API produktu IBM TRIRIGA Connector for Business Applications. Příklad také ukazuje základní požadavek a odezvu, kterou obvykle obdržíte v servletu Java. 3. Přidejte kód do metody execute, kde stojí //zde umístěte váš kód. Pokračování příkladu: Chcete-li vytisknout webovou stránku (.html) se "Hello World", vložte následující kód: PrintWriter out = response.getWriter(); try{ response.setContentType("text/html"); out.println(""); out.print("Hello World"); out.println(""); out.flush(); } finally { if(out!=null)out.close(); }
4. Zkompilujte třídu Java a přidejte ji do souboru .jar. Například, zkompilujete třídu MyFirstConnector a přidáte ji do souboru .jar s názvem MyFirstConnector.jar. 5. Přejděte na nabídku Nástroje > Nastavení systému > Systém > Zavaděč tříd. 6. Načtěte záznam zavaděče tříd. Například, přidejte záznam zavaděče tříd s názvem MyFirstConnector. 7. V záznamu přidejte soubor prostředku, abyste mohli přenést soubor MyFirstConnector.jar. 8. Uložte záznam.
Odstraňování problémů s rozšířenými funkcemi Chcete-li získat pomoc při problémech se zavaděči tříd, servery proxy servletů nebo s vlastními konektory, prohlédněte si následující problémy, příčiny a nápravy.
Běžné problémy s rozšířenými funkcemi Běžné problémy se zavaděči tříd, servery proxy servletů a vlastními konektory můžete vyřešit, aktivujete-li nebo upravíte-li protokoly platformy. Chcete-li zahájit protokolování platformy
V konzole administrátora zapněte ve spravovaném objektu Protokolování platformy ladění pro kategorie Zavaděč tříd a Server proxy servletu. Tyto protokoly v režimu s komentářem vám mohou poskytnout základní informace o činnosti serveru. Chcete-li získat informace o přístupu k a používání konzoly administrátora, prohlédněte si IBM TRIRIGA Application Platform 3 - Příručka pro uživatele konzoly administrátora. Chcete-li zjednodušit ladění zavaděčů tříd a serverů proxy servletů Chcete-li v konzole administrátora přidat vlastní kategorii do spravovaného objektu Protokolování platformy, přidejte ji do souboru CustomLogCategories.xml a restartujte server. Soubor CustomLogCategories.xml se nachází ve složce instalační_adresář/config. Tato metoda se upřednostňuje, protože ji můžete nastavit jednou. Po restartu serveru můžete znovu zapnout volbu DEBUG výběrem volby u vlastní kategorie. Soubory .jar se nenaimplementují podle očekávání Nepřidávejte více instancí stejného souboru .jar do záznamu zavaděče tříd. Například, jeden, který přidáte přímo, a další, který je obsažený v rámci komprimovaného souboru. Pokud k tomu dojde, nebude načtená instance souboru .jar předvídatelná.
Upozornění Tyto informace jsou určeny pro produkty a služby nabízené ve Spojených státech. IBM nemusí produkty, služby nebo funkce popsané v tomto dokumentu nabízet v jiných zemích. Informace o produktech a službách, které jsou momentálně ve Vaší zemi dostupné, můžete získat od obchodního zástupce IBM pro Vaši oblast. Žádný z odkazů na produkty, programové vybavení nebo služby IBM neznamená, ani z něj nelze vyvozovat, že smí být použit pouze uvedený produkt, program nebo služba IBM. Použít lze jakýkoli funkčně ekvivalentní produkt, program či službu neporušující práva IBM k duševnímu vlastnictví. Za vyhodnocení a ověření operací libovolného produktu, programu či služby od jiného výrobce však odpovídá uživatel. IBM může mít patenty nebo podané žádosti o patent, které zahrnují předmět tohoto dokumentu. Vlastnictví tohoto dokumentu Vám nedává žádná práva k těmto patentům. Písemné dotazy ohledně licencí můžete zaslat na adresu: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. Pokud máte zájem o licenci v zemi s dvoubajtovou znakovou sadou (DBCS), kontaktujte IBM Intellectual Property Department ve Vaší zemi nebo zašlete písemné dotazy na adresu: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan Následující odstavec se netýká Velké Británie nebo kterékoliv jiné země, kde taková opatření odporují místním právním předpisům: SPOLEČNOST INTERNATIONAL BUSINESS MACHINES CORPORATION TUTO PUBLIKACI POSKYTUJE TAK, JAK JE (AS-IS), BEZ JAKÝCHKOLIV ZÁRUK, VYJÁDŘENÝCH VÝSLOVNĚ NEBO VYPLÝVAJÍCÍCH Z OKOLNOSTÍ, VČETNĚ, A TO ZEJMÉNA, ZÁRUK NEPORUŠENÍ PRÁV TŘETÍCH STRAN, PRODEJNOSTI NEBO VHODNOSTI PRO URČITÝ ÚČEL VYPLÝVAJÍCÍCH Z OKOLNOSTÍ. Právní řády některých zemí nepřipouštějí vyloučení záruk vyjádřených výslovně nebo vyplývajících z okolností v určitých transakcích, a proto se na vás výše uvedené omezení nemusí vztahovat. Tato publikace může obsahovat technické nepřesnosti nebo typografické chyby. Informace zde uvedené jsou pravidelně aktualizovány a v nových vydáních této publikace již budou tyto změny zahrnuty. IBM má právo kdykoliv bez upozornění zdokonalovat nebo měnit produkt(y) a program(y) popsané v této publikaci. Jakékoliv odkazy v této publikaci na webové stránky jiných společností jsou poskytovány pouze pro pohodlí uživatele a nemohou být žádným způsobem vykládány jako doporučení těchto webových stránek ze strany IBM. Materiály obsažené na takovýchto webových stránkách nejsou součástí materiálů k tomuto produktu IBM a tyto webové stránky mohou být používány pouze na vlastní nebezpečí.
IBM může, pokud to považuje za vhodné, používat nebo distribuovat libovolné informace, které jí poskytnete, aniž by tím vznikl jakýkoliv závazek IBM vůči Vám. Držitelé licence na tento program, kteří si přejí mít přístup i k informacím o programu za účelem (i) výměny informací mezi nezávisle vytvořenými programy a jinými programy (včetně tohoto) a (ii) vzájemného použití sdílených informací, mohou kontaktovat: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Informace tohoto typu mohou být dostupné za určitých podmínek. V některých případech připadá v úvahu zaplacení poplatku. IBM poskytuje licencovaný program popsaný v tomto dokumentu a veškeré dostupné licencované materiály na základě podmínek uvedených ve smlouvě IBM Customer Agreement, v Mezinárodní licenční smlouvě na programy IBM International Program License Agreement nebo v jiné ekvivalentní smlouvě. Informace týkající se produktů jiných společností byly získány od dodavatelů těchto produktů, z jejich tištěných materiálů nebo z jiných veřejně dostupných zdrojů. IBM tyto produkty netestovala a nemůže potvrdit jejich přesnost, kompatibilitu nebo jiná tvrzení, která se k těmto produktům vztahují. Otázky týkající se možností produktů jiných společností adresujte dodavatelům těchto produktů. Tyto informace obsahují příklady údajů a sestav používaných v každodenních obchodních operacích. Z důvodu zajištění co největší názornosti obsahují uvedené příklady jména osob, společností, názvy značek a produktů. Všechna tato jména jsou fiktivní a jakákoliv podobnost se jmény a adresami používanými skutečnými obchodními podniky je čistě náhodná. LICENČNÍ INFORMACE: Tyto informace obsahují ukázkové aplikační programy ve zdrojovém jazyce, které ilustrují programovací techniky na různých provozních platformách. Jste oprávněni kopírovat, upravovat a distribuovat tyto vzorové programy jakýmkoliv způsobem, aniž by vám tím vznikal jakýkoliv finanční závazek vůči IBM, pro účely vývoje, užívání, marketingu nebo distribuce aplikačních programů kompatibilních s rozhraním API pro operační systém, pro který byly vzorové programy napsány. Vzorové programy nebyly důkladně testovány za všech podmínek. IBM proto nezaručuje ani nenaznačuje spolehlivost, provozuschopnost nebo funkčnost těchto programů. Vzorové programy jsou poskytovány "JAK JSOU", bez záruky jakéhokoli druhu. IBM nenese odpovědnost za jakékoli škody vzniklé v důsledku vašeho užívání vzorových programů.
Zásady ochrany osobních údajů Softwarové produkty IBM, včetně řešení SaaS (software as a service solution) ("Nabídky softwaru"), mohou využívat soubory cookie nebo jiné technologie ke shromažování informací o užívání produktů s cílem zlepšit pracovní zkušenosti koncového uživatele, lépe přizpůsobit interakce s koncovým uživatelem nebo pro jiné účely. Nabídky softwaru shromažují v mnoha případech údaje, z nichž nelze určit totožnost. Některé z našich Nabídek softwaru vám mohou pomoci umožnit shromažování údajů, z nichž lze určit totožnost. Používá-li tato Nabídka softwaru soubory cookie ke sběru údajů, z nichž lze určit totožnost, naleznete níže specifické informace o užívání souborů cookie touto nabídkou.
Tato Nabídka softwaru nevyužívá soubory cookie nebo jiné technologie ke shromažování údajů, z nichž lze určit totožnost. Jestliže konfigurace implementované pro tuto Nabídku softwaru vám - jako zákazníkovi poskytují schopnost shromažovat od koncových uživatelů údaje, z nichž lze určit totožnost, prostřednictvím souborů cookie a jiných technologií, jste povinni vyhledat právní poradu ohledně právních předpisů, jež se vztahují na takový sběr dat, včetně veškerých požadavků týkajících se oznamování a vyžádání souhlasu. Informace o užívání různých technologií, včetně souborů cookie, pro tyto účely najdete v dokumentu IBM Privacy Policy na adrese http://www.ibm.com/privacy a v dokumentu IBM Online Privacy Statement na adrese http://www.ibm.com/privacy/details v části nazvané "Cookies, Web Beacons and Other Technologies" a v dokumentu "IBM Software Products and Software-as-a-Service Privacy Statement" na adrese http://www.ibm.com/software/info/ product-privacy/.
Ochranné známky IBM, logo IBM a ibm.com jsou ochranné známky nebo registrované ochranné známky společnosti International Business Machines Corp ve Spojených státech a případně v dalších jiných zemích. Ostatní názvy produktů a služeb mohou být ochrannými známkami IBM a ostatních společností. Aktuální seznam ochranných známek IBM je k dispozici na webu “Copyright and trademark information” na adrese www.ibm.com/legal/copytrade.shtml. Java a všechny ochranné známky a loga založené na termínu Java jsou ochranné známky společnosti Oracle a jejích příbuzných společností. Linux je ochrannou známkou společnosti Linus Torvalds ve Spojených Státech a případně v dalších jiných zemích. Microsoft, Windows, Windows NT, a logo Windows jsou ochranné známky společnosti Microsoft Corporation ve Spojených státech a případně v dalších jiných zemích. UNIX je registrovaná ochranná známka společnosti The Open Group ve Spojených státech a jiných zemích. Ostatní názvy produktů a služeb mohou být ochrannými známkami IBM a ostatních společností.
