IBM TRIRIGA Application Platform Verze 3 Vydání 4.2
Sestavení aplikací pro produkt IBM TRIRIGA Application Platform: Správa dat
Poznámka Před použitím těchto informací a produktu, který podporují, si přečtěte informace v části “Upozornění” na stránce 59.
Toto vydání se vztahuje k verzi 3, vydání 4, úpravě 2, produktu IBM TRIRIGA Application Platform a ke všem následným vydáním a úpravám, pokud nebude v nových vydáních uvedeno jinak. © Copyright IBM Corporation 2011, 2015.
Obsah Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA. . . . . . . . . 1 Přehled procesu nástroje DataConnect produktu TRIRIGA 1 Balíky migrace objektu. . . . . . . . . . . 1 Nastavení pracovní tabulky . . . . . . . . . 1 Publikování obchodního objektu . . . . . . . 3 Odstranění obchodního objektu . . . . . . . 3 Obchodní objekty úloh . . . . . . . . . . . 3 Mechanismy pro přesun dat do tabulek . . . . . . 4 Pole pracovní tabulky . . . . . . . . . . 4 Pole tabulky DC_JOB . . . . . . . . . . 7 Mapy systému ETL . . . . . . . . . . . 9 Sledy prací pro přesun dat do záznamů . . . . . . 9 Nastavení úlohy sledu prací . . . . . . . . 10 Volání sledu prací . . . . . . . . . . . 12 Validace běhových dat . . . . . . . . . 13 Stavy iterace . . . . . . . . . . . . 13 Dočasná data . . . . . . . . . . . . 13 Agent DataConnect . . . . . . . . . . 17 Zpracování sledu prací . . . . . . . . . 17 Agent vyčištění . . . . . . . . . . . . 18 Běžné problémy s nástrojem DataConnect. . . . . . 18 Rady pro ovládání nástroje DataConnect . . . . . . 21
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA . . . . . . . . 25 Přehled procesu integrátoru dat produktu TRIRIGA . Typy polí . . . . . . . . . . . . Požadavky . . . . . . . . . . . . Funkční požadavky . . . . . . . . Požadavky na použitelnost . . . . . . Soubory se záznamy oddělenými tabulátory . . Soubory záhlaví . . . . . . . . . Soubory záhlaví pro nehierarchické moduly . Soubory záhlaví pro hierarchické moduly . .
© Copyright IBM Corp. 2011, 2015
. . . . . . . . .
. . . . . . . . .
25 25 30 31 32 32 34 34 34
Vytváření souborů záhlaví . . . . . . . Příprava asociativních přenosů . . . . . . Řetězce přidružení. . . . . . . . . Identifikace přidružení . . . . . . . Ověření pravidel přidružení . . . . . . Přidání přidružení k hlavičkovým souborům . Příprava úloh sledu prací pro asociativní přenos Přenos dat . . . . . . . . . . . . Načtení dat ručně . . . . . . . . . Přenos dat pomocí dávkových přenosů. . . Nastavení dávkového přenosu . . . . Plánování dávkových přenosů . . . . Ukončení dávkového přenosu . . . . Rady pro ovládání integrátoru dat . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
34 36 36 36 36 37 37 39 39 40 40 40 42 42
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA . . . . . 45 Sady načtení dat . . . . . . . . . . . Vytváření sad načtení dat a položek načtení dat . Zpracování sad načtení dat ve Správci načtení dat Generování tabulky ze Správce načtení dat . . . Vytváření tabulek načtení dat . . . . . . Makra ověření tabulek načtení dat . . . . Zpracování a načtení ukázkových dat pomocí Správce načtení dat . . . . . . . . . . . . . Zpracování ukázkových dat . . . . . . . Konfigurace ukázkových dat. . . . . . Úprava zdroje dat . . . . . . . . . Implementace změn načtení dat . . . . . Načtení ukázkových dat . . . . . . . Ukázková data portfolia . . . . . . . .
. . . . . .
. . . . . .
45 46 47 48 49 49
. . . . . . .
. . . . . . .
53 53 54 54 54 55 55
Upozornění . . . . . . . . . . . . . 59 Zásady ochrany osobních údajů . Ochranné známky . . . . .
. .
. .
. .
. .
. .
. .
. .
. 60 . 61
iii
iv
© Copyright IBM Corp. 2011, 2015
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA Můžete naimportovat data z externího systému do vaší databáze produktu IBM® TRIRIGA spolu s pracovními tabulkami a úlohami sledu prací pomocí nástroje DataConnect.
Přehled procesu nástroje DataConnect produktu TRIRIGA Nástroj DataConnect produktu IBM TRIRIGA je nástroj pro importování externích dat do databáze produktu IBM TRIRIGA. Je užitečný jak pro počáteční načtení dat, tak i pro dávkové vkládání, a opakované dávkové aktualizace dat. S pomocí nástroje DataConnect můžete zapsat data z externího zdroje přímo do pracovních tabulek produktu IBM TRIRIGA. Pak můžete použít sledy prací ke zpracování dat pro vložení do obchodních objektů produktu IBM TRIRIGA. Kromě odeslání dat pomocí příkazu Push je můžete také uložit do tabulek jazyků. Implementace procesu DataConnect zahrnuje následující základní kroky: v Příprava pracovních tabulek pro obchodní objekty, které jsou naplněny nebo aktualizovány z externího zdroje. v Příprava obchodního objektu řízení úloh DataConnect. Tento obchodní objekt řídí instanci integrace. v Příprava mechanismu k přesunutí dat z externího zdroje do odpovídajících pracovních tabulek obchodních objektů a do tabulky řízení úloh DataConnect. Můžete použít mapování systému ETL nebo SQL. v Příprava sledů prací k přesunu dat z pracovních tabulek obchodních objektů do nových nebo aktualizovaných záznamů. Tyto sledy prací, které zahájí agent DataConnect, mohou také validovat vstupní data a implementovat jinou obchodní logiku.
Balíky migrace objektu V závislosti na verzi aplikace produktu IBM TRIRIGA musíte použít určité balíky migrace objektu DataConnect na vaše upgrady. Balíky mají název triDataConnectJob.zip a triDataConnectJobLog.zip a nacházejí se v instalačním adresáři produktu IBM TRIRIGA ve složce \userfiles\upgrades. V modulu triDataConnectJob, pokud obchodní objekt triDataConnectJob není k dispozici ve vaší instalaci, musíte použít balík migrace objektů triDataConnectJob. V modulu triLog, pokud není k dispozici obchodní objekt triDataConnectJobLog ve vaší instalaci, musíte použít balík migrace objektu triDataConnectJobLog. Nástroj DataConnect funguje s databází aplikace produktu TRIRIGA ve verzi 8.x. Jakmile naimportujete balík migrace objektu triDataConnectJob, bude pole triCreatedBy prázdné. Tento stav nepředstavuje problém a nesmí jej změnit. Agent DataConnect naplní pole uživatelem produktu IBM TRIRIGA z položky úlohy DataConnect.
Nastavení pracovní tabulky Aby měl obchodní objekt k sobě přidruženou pracovní tabulku, musí být na obchodním objektu povolená vlastnost Má pracovní tabulku. Kromě toho musí být pole v rámci obchodního objektu identifikována jako pole pracovní tabulky s povolenou vlastností Pole pracovní tabulky. Publikování obchodního objektu zavede nebo aktualizuje přidruženou pracovní tabulku. Obchodní objekt může mít pouze jednu pracovní tabulku.
© Copyright IBM Corp. 2011, 2015
1
Obchodní objekty s pracovními tabulkami V konzole administrátora produktu IBM TRIRIGA vyberte spravovaný objekt DataConnect a pak Obchodní objekty s pracovními tabulkami, abyste si prohlédli seznam obchodních objektů s pracovními tabulkami. Chcete-li si prohlédnout pole pracovní tabulky pro konkrétní položku, vyberte položku a klepněte na volbu Rozbalit data. Sloupec Pole pak ukazuje název produktu IBM TRIRIGA pro pole, spojovník a název databáze pro pole. Pokud se jedná o klíčové pole používané pro akci aktualizovat a vložit, název pole obsahuje hvězdičku. Klíče sekce smart nástroje DataConnect zobrazují název sekce, za kterým následuje název pole. Definice polí jsou užitečné pro identifikaci odpovídajících polí pracovní tabulky pro příchozí data. Další informace viz příručka IBM TRIRIGA Application Platform 3 Administrator Console User Guide.
Má pracovní tabulku Vlastnost Má pracovní tabulku identifikuje ty obchodní objekty, pro které produkt IBM TRIRIGA udržuje pracovní tabulky. Je-li vlastnost povolená a obchodní objekt je publikovaný, vytvoří se nebo se aktualizuje pracovní tabulka. Je-li vlastnost zakázaná a obchodní objekt je publikovaný, proces publikování odstraní pracovní tabulku, pokud existuje. Standardně je vlastnost Má pracovní tabulku vypnutá. Když se obchodní objekt přinese prostřednictvím migrace objektu a migrace objektu publikuje tento obchodní objekt, vytvoří se pracovní tabulka s vybranou vlastností Má pracovní tabulku.
Pole pracovní tabulky Vlastnost Pole pracovní tabulky identifikuje ta pole, která se zahrnou do pracovní tabulky obchodního objektu. Pokud je vlastnost povolená, pole se zahrne do pracovní tabulky. Změny této vlastnosti po vytvoření pracovní tabulky se neprojeví v pracovní tabulce, dokud znovu nepublikujete obchodní objekt. Vlastnost Pole pracovní tabulky je standardně zakázaná, ledaže se pole vyžaduje. Vlastnost Pole pracovní tabulky je podporována pro následující typy polí: Logický, Obchodní objekt, Klasifikace, Barva, Datum, Datum a čas, Doba trvání, Seznam, Lokátor, Číslo, Heslo, Text, Čas, Měrná jednotka a Adresa URL. Pouze pole, která se nacházejí v sekci Obecné, jsou podporována jako pole pracovní tabulky. Pole ze sekce smart můžete přidat do pracovní tabulky. Všechna povinná pole mají povoleno vlastnost Pole pracovní tabulky. Pokud nastavíte vlastnost Pole pracovní tabulky pro pole s číslem, které má související pole s měrnou jednotkou v obchodním objektu, ujistěte se, že vlastnost Pole pracovní tabulky nastavíte na pole s měrnou jednotkou. Také musíte nastavit vlastnost Pole pracovní tabulky pro související měrnou jednotku, pokud se importovaná měrná jednotka liší od základní měrná jednotky. Například, pokud je základní měrnou jednotkou pro plochu čtvereční stopa, importovaná měrná jednotka jsou akry, nastavte vlastnost Pole pracovní tabulky pro importovanou měrnou jednotku. Můžete také zahrnout formátované hodnoty pro pole Datum, Datum a čas, Doba trvání a Čas v pracovní tabulce. Pokud je vlastnost povolená pro tato pole formátu DataConnect, pole se zahrne do pracovní tabulky. V pracovní tabulce se k názvu pole připojí _F. Pokud je například povolená vlastnost Pole pracovní tabulky pro pole s datem s názvem TRIDATEDA, pole TRIDATEDA_F se zahrne do pracovní tabulky. Formát těchto polí určují uživatelské předvolby. Použití těchto polí formátu je volitelné. Chcete-li zahrnout tato pole formátu do pracovní tabulky, musíte publikovat obchodní objekt, aby se použila změna.
2
© Copyright IBM Corp. 2011, 2015
Klíč pracovní tabulky Vlastnost Klíč pracovní tabulky identifikuje pole, která se použijí jako klíče k vyhledání záznamu pomocí akce Aktualizovat a vložit nebo Aktualizovat. Akce Vložit nepoužívá tuto vlastnost. Standardně je vlastnost Klíč pracovní tabulky vypnutá. Můžete ji vybrat pouze tehdy, když vyberete vlastnost Pole pracovní tabulky. Vlastnost Klíč pracovní tabulky je podporována pro následující typy polí: Logický, Obchodní objekt, Klasifikace, Barva, Datum, Datum a čas, Doba trvání, Seznam, Lokátor, Číslo, Heslo, Text, Čas, Měrná jednotka a Adresa URL.
Publikování obchodního objektu Když vyberete akci Publikovat obchodní objekt pro obchodní objekt s povolenou vlastností Má pracovní tabulku, spustí se některé kontroly. Pokud existují úlohy ve stavu Zpracování nebo Připraveno, které používají pracovní tabulku a obchodní objekt, publikování se nezdaří a uživateli se okamžitě zašle zpráva. Publikování obchodního objektu zpracuje agent a nejedná se o okamžitou akci. Agent publikování znovu zkontroluje pro případ, že byla spuštěna nová úloha, nebo že se mezitím změnil stav existující úlohy. Pokud existují úlohy ve stavu Zpracování nebo Připraveno, které používají pracovní tabulku a obchodní objekt, publikování obchodního objektu se nezdaří. Pak produkt IBM TRIRIGA zašle oznámení uživateli a zapíše podrobnosti o příčině selhání do souboru server.log.
Odstranění obchodního objektu Když vyberete akci Odstranit obchodní objekt pro obchodní objekt s povolenou vlastností Má pracovní tabulku, spustí se některé kontroly. Pokud existuje úloha ve stavu Zpracování, která používá pracovní tabulku a obchodní objekt, odstranění se nezdaří a uživateli se okamžitě zašle zpráva. Pokud existuje úloha ve stavu Čekání, obchodní objekt a pracovní tabulka se odstraní a stav úlohy se změní na Zastaralý.
Obchodní objekty úloh Tabulka DC_JOB (DataConnect Job Control) spravuje úlohy, které přesouvají data z pracovních tabulek do databáze produktu IBM TRIRIGA. Pro každý proces integrace musí v modulu triDataConnectJob existovat obchodní objekt. Vytvoření obchodního objektu v modulu triDataConnectJob představuje jednorázovou úlohu procesu integrace. Pro každý proces integrace potřebujete obchodní objekt řízení úloh DataConnect. Pokud například naplňujete nákupní objednávky z externího zdroje, může být vaším obchodním objektem řízení úloh DataConnect obchodní objekt cstPurchaseOrderJob. Pak může proces stáhnout data pro obchodní objekty cstPurchaseOrderBody a cstPurchaseOrderLine (s povoleným příznakem Má pracovní tabulku u obou objektů). Obecně platí, že obchodní objekt vytvoříte následujícím způsobem: v Otevřete modul triDataConnectJob prostřednictvím Datového modeláře. v Vytvořte obchodní objekt v modulu triDataConnectJob. Jakmile vytvoříte nový obchodní objekt, můžete pro něj vytvořit formulář a navigaci nabídky. Nástroj DataConnect se dodává se základním formulářem a základní nabídkou pro základní obchodní objekt triDataConnectJob. Přechody stavu nového obchodního objektu se zdědí ze základního obchodního objektu a nesmíte je změnit. Základní obchodní objekt triDataConnectJob obsahuje následující přechody stavu: v Null -> triDCStartProcessing -> Zpracování Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
3
v Zpracování -> triDCCompleted -> Dokončeno v Zpracování -> triDCFailed -> Nezdařilo se Všechna pole v první sekci jsou jen pro čtení. Druhá sekce obsahuje záznamy protokolu pro danou úlohu DataConnect. Záznamy protokolu jsou záznamy triDataConnectLog v modulu triLog. Klepnutím na položku si zobrazíte podrobnosti dané události. Druhá sekce standardně zobrazuje problémy nalezené během spuštění úlohy DataConnect. Avšak, pokud vyberete volbu Běhové prostředí DataConnect ve spravovaném objektu Protokolování platformy v konzole administrátora produktu IBM TRIRIGA, druhá sekce bude také zobrazovat kladné informace o vložených nebo aktualizovaných záznamech. Úrovně protokolování různých agentů určují nastavení protokolu platformy a nastavení log4j na serveru, na kterém běží daný agent. Nástroj DataConnect používá dva agenty. Jedním je agent DataConnect Agent, který vytváří objekt úlohy a prostřednictvím události jej asynchronně poskytuje agentovi sledu prací. Jeho úloha skončí, jakmile se vytvoří objekt a odešle událost. Druhý agent, agent sledu prací, spustí obchodní logiku (sledy prací) a pak úlohy DataConnect, které vytvoří a aktualizují objekty v databázi produktu IBM TRIRIGA. Chcete-li zobrazovat vykazování na objektech úloh, i když neexistují žádné problémy, musíte nastavit protokolování běhového prostředí DataConnect na serveru agenta sledu prací. Nastavení protokolování na serveru agenta DataConnect nemá význam, protože agent sledu prací spouští sled prací a vytváří nebo aktualizuje objekty z pracovních tabulek.
Mechanismy pro přesun dat do tabulek Musíte poskytnout mechanismus, bu prostřednictvím nástroje systému ETL, nebo skrze přímé příkazy SQL, pro přesun dat z externího zdroje do odpovídající tabulek v databázi produktu IBM TRIRIGA. Tyto tabulky zahrnují pracovní tabulky obchodního objektu a tabulku DC_JOB. Mechanismus musí vytvořit jedinečné číslo úlohy, na které se odkáže jak v tabulce DC_JOB, tak i v pracovních tabulkách obchodního objektu. Kromě toho může mechanismus zahrnout jedno nebo více čísel korelace a pořadových čísel. Ačkoliv k číslu úlohy není přidružen žádný význam, musí to být jedinečný identifikátor. Jedním ze způsobů vytvoření čísla úlohy je použití generátoru globálně jedinečných identifikátorů nebo univerzálních jedinečných identifikátorů. Pak je možné se pokusit o vložení položky tabulky DC_JOB se stavem Nový. Pokud se pokus podaří, použijte to jako číslo úlohy pro položky zapsané do pracovních tabulek. Pokud selže s chybou duplicitního klíče, vygenerujte jiný identifikátor GUID/UUID/FUID a zkuste to znovu. Pak můžete použít nástroj Spoon od společnosti Adobe Kettle. Tato metoda se podobá tomu, jak produkty IBM TRIRIGA Workplace Performance Management a IBM TRIRIGA Real Estate Environmental Sustainability používají nástroj Spoon k vytváření mapování systému ETL pro tabulky faktů, které stahují data z tabulek produktu IBM TRIRIGA.
Pole pracovní tabulky Kromě polí, která identifikujete pomocí vlastnosti Pole pracovní tabulky, obsahuje každá pracovní tabulka specifická pole. Tabulka 1. Pole pracovní tabulky
4
Název sloupce
Klíč
Typ
DC_JOB _NUMBER
Y
NUMBER (20)
© Copyright IBM Corp. 2011, 2015
Výchozí
S povol. hodnot. Null
Popis
N
Číslo identifikace úlohy.
Tabulka 1. Pole pracovní tabulky (pokračování)
Výchozí
S povol. hodnot. Null
Název sloupce
Klíč
Typ
Popis
DC_CID
Y
NUMBER (20)
N
Identifikační číslo korelace, které se použije pro vztahy nadřízený-podřízený z pracovních tabulek.
DC _SEQUENCE EMAIL_ID
Y
NUMBER (20)
N
Pořadové číslo pro skupinu položek.
DC_STATE
N
NUMBER (4)
0
N
Identifikátor stavu, který označuje aktuální stav této položky během zpracování úlohy DataConnect. Hodnoty jsou: 0 - Nový, 1 Připraveno, 2 - Zpracování, 3 Dokončeno, 4 - Nezdařený, 5 Zastaralý.
DC_ACTION
N
NUMBER (4)
1
N
Provedená akce. Hodnoty jsou: 1 Vložit, 2 - Aktualizovat, 4 Aktualizovat a vložit.
DC_PATH
N
VARCHAR ()
Y
Cesta (včetně názvu záznamu) k objektu, na kterém se provádí akce. Pro vložení může toto pole ukazovat úloze DataConnect, kam má umístit záznam do hierarchie. Podřízení musí mít cestu nadřízeného ve sloupci DC_PATH. Pokud se objekt nachází na vrcholu hierarchie, nebo pokud objekt není v hierarchii, sloupec DC_PATH musí být prázdný. Pokud pro aktualizaci neexistuje klíč, toto pole musí být nastaveno na záznam, který chcete aktualizovat, na IBS_SPEC.OBJECT_PATH záznamu, který se má aktualizovat.
DC_GUI _NAME
N
VARCHAR (100)
Y
Název formuláře, který má použít nový nebo aktualizovaný řádek. Pokud při vložení není tento formulář nastaven, systém použije výchozí formulář pro obchodní objekt, pokud existuje. V opačném případě nebude k objektu přidružen žádný formulář. Pokud při aktualizaci není tento formulář nastaven, systém neupraví aktuální nastavení formuláře.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
5
Tabulka 1. Pole pracovní tabulky (pokračování)
Název sloupce
Klíč
Typ
DC_PROJECT
N
VARCHAR (100)
Výchozí
S povol. hodnot. Null Y
Popis Při vložení nebo aktualizaci nastaví projekt záznamu, pokud není prázdný. Hodnota je to, co se objeví v pruhu nabídky portálu při výběru projektu. Sloupec DC_PROJECT musí používat formát IDprojektu-názevprojektu. Projekt se změní pouze u záznamu, který je zapojen do operace vložení nebo aktualizace. Na podřízených se nevyskytnou žádné změny. Pokud vkládáte nebo aktualizujete data se vztahem nadřízený-podřízený, ujistěte se, že nastavíte odpovídající projekt pro všechna data, která chcete změnit.
6
© Copyright IBM Corp. 2011, 2015
Tabulka 1. Pole pracovní tabulky (pokračování)
Název sloupce
Klíč
N Názvy sloupců určuje produkt IBM TRIRIGA Application Platform. Použijte konzolu administrátora k nalezení názvu pracovní tabulky a názvu databáze.
Typ
S povol. hodnot. Null
Výchozí
Závisí na typu sloupce produktu IBM TRIRIGA Application Platform.
Y
Popis Pole v obchodním objektu se zaškrtnutou (povolenou )volbou Pole pracovní tabulky. Pro pole Datum, Datum a čas, Doba trvání a Čas se přidá dodatečný sloupec do pracovní tabulky. K názvu těchto polí se připojí _F. Na základě vlastnosti Klíč pracovní tabulky mohou být pole klíči. Používáno akcí Aktualizovat a vložit a Aktualizovat. Pro aktualizaci a vložení úloha DataConnect vygeneruje SQL použitím určených hodnot klíčů z pracovní tabulky, aby viděla, zda existuje záznam. Pokud záznam existuje (tzn. že se jeden nalezne), záznam se aktualizuje s daty z pracovní tabulky. Pokud existuje více než jeden záznam, řádek pracovní tabulky se označí jako selhaný. Pokud záznam neexistuje (tzn. nenaleznou se žádné záznamy), vloží se nový záznam použitím dat z pracovní tabulky. Jsou-li pro aktualizace definovány klíče na pracovní tabulce, úloha DataConnect vygeneruje SQL použitím hodnot klíčů z pracovní tabulky, aby viděla, zda existuje záznam. Pokud záznam existuje (tzn. že se jeden nalezne), záznam se aktualizuje s daty z pracovní tabulky. Pokud existuje více než jeden záznam, řádek pracovní tabulky se označí jako selhaný. Pokud záznam neexistuje (tzn. nenaleznou se žádné záznamy) řádek pracovní tabulky se označí jako selhaný.
Pole tabulky DC_JOB Tabulku DC_JOB naplní externí proces, aktualizuje ji agent DataConnect Agent a asynchronní sledy prací, které na ní pracují, a odstraní ji agent vyčištění. Tabulka DC_JOB zahrnuje specifická pole. Tabulka 2. Pole tabulky DC_JOB
Název sloupce
Klíč
Typ
JOB _NUMBER
Y
NUMBER (20)
Výchozí
S povol. hodnot. Null
Popis
N
Číslo identifikace úlohy.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
7
Tabulka 2. Pole tabulky DC_JOB (pokračování)
Název sloupce
Klíč
Typ
Výchozí
S povol. hodnot. Null
JOB_TYPE
Y
NUMBER (4)
1
N
Identifikátor typu úlohy. Hodnota je: 1 - Vytvořit/aktualizovat záznamy produktu IBM TRIRIGA, příchozí data.
JOB_NAME
N
VARCHAR (100)
Y
Název úlohy.
JOB_RUN _CTL
N
VARCHAR (100)
N
Řídí souběžnost. Agent DataConnect použije JOB_RUN_CTL spolu s JOB_NAME ke snížení vlastní priority. Má-li úloha jediný podproces, nespustí se žádná jiná úloha s daným JOB_NAME, dokud nebude spuštěná úloha ve stavu Dokončeno nebo Nezdařený. Hodnoty jsou: 1 - s jediným podprocesem, 2 - s podporou více podprocesů.
BO_NAME
N
VARCHAR (100)
Y
Název obchodního objektu pro záznam, který je vytvořen za účelem znázornění úlohy. Tento obchodní objekt musíte vytvořit v modulu triDataConnectJob.
USER_ID
N
NUMBER (20)
Y
ID uživatele, které se použije pro zpracování. Musí být platné ID uživatele produktu IBM TRIRIGA (T_MYPROFILE ID).
STATE
N
NUMBER (4)
N
Identifikátor stavu, který označuje aktuální stav úlohy. Hodnoty jsou: 0 - Nový, 1 - Připraveno, 2 Zpracování, 3 - Dokončeno, 4 Nezdařený, 5 - Zastaralý.
SOURCE _SYS_ID
N
VARCHAR (100)
Y
Identifikátor systému, který vytvořil úlohu (používá se pro informační vykazování).
PROCESS _SYS_ID
N
VARCHAR (100)
Y
Identifikátor systému, který zpracovává/zpracoval úlohu (používá se pro informační vykazování). Nemusíte poskytnout tuto informaci.
CREATED _DATE
N
DATETIME
N
Datum a čas přidání položky (nastaveno na výchozí hodnotu).
UPDATED _DATE
N
DATETIME
Y
Datum a čas poslední změny položky. Nemusíte poskytnout tuto informaci.
0
Datum
Popis
Použijte konzolu administrátora, chcete-li vidět obsah tabulky DC_JOB. Vyberte úlohy DataConnect ve spravovaném objektu DataConnect v konzole administrátora. Další informace o konzole administrátora a spravovaném objektu DataConnect naleznete v Uživatelské příručce konzoly administrátora produktu IBM TRIRIGA Application Platform 3.
8
© Copyright IBM Corp. 2011, 2015
Mapy systému ETL Implementace integrace DataConnect určuje, jak přesouváte data do pracovních tabulek, bu prostřednictvím nástroje systému ETL, nebo skrze přímé příkazy SQL. Bez ohledu na to, jak přesouváte data z externího zdroje do pracovních tabulek, data musí být naplněna v externím zdroji, než spustíte mapování. Pokud používáte nástroj systému ETL, integrace řídí, jaké mapy systému ETL musíte vyvinout, abyste mohli přesunout data z externího zdroje do pracovních tabulek. Použijte nástroj k definování mapování systému ETL mezi externím zdrojem a pracovními tabulkami. Jedním takovým nástrojem je nástroj Spoon společnosti Pentaho Kettle. Jinak můžete použít libovolný nástroj. Když spustíte mapování, musí splnit následující úlohy: v Vytvořit jedinečné číslo úlohy. v Vytvořit položku v tabulce DC_JOB (DataConnect Job Control) a nastaví stav na Nový. v Naplnit pracovní tabulky obchodních objektů, včetně veškerých podřízených pracovních tabulek. Položky zahrnují číslo úlohy, jedno nebo více čísel korelace a akci. Cesta se vyžaduje na akcích aktualizace, kde nejsou definovány žádné klíče, a je volitelná pro akce vložení. v Volitelné: Aktualizuje položku v tabulce DC_JOB (DataConnect Job Control) a nastaví stav na Připraveno. Tuto aktualizaci můžete ručně nastavit skrze konzolu administrátora, vyberete-li spravovaný objekt DataConnect, úlohu DataConnect a pak akci Připravit úlohu.
Sledy prací pro přesun dat do záznamů Použijte schopnosti sledu prací v produktu IBM TRIRIGA k přesunu dat z pracovních tabulek do záznamů skutečných obchodních objektů. Přesná logika sledu prací závisí na podnikových obchodních pravidlech a obchodním objektu, který naplňujete. Sledy prací pro řízení nástroje DataConnect musí být vytvořeny v modulu triDataConnectJob. Použijte úlohu sledu prací DataConnect k načtení stavových záznamů a k iteraci skrze stavové položky, přičemž vytvořte nebo aktualizuje záznam smart každé položky. Úlohy sledu prací DataConnect můžete vnořit, abyste podpořili logiku vztahu nadřízený-podřízený a obchodní logiku. Úloha DataConnect funguje ve dvou částech: v Načte sadu záznamů, s nimiž chcete pracovat, z odpovídající pracovní tabulky, jak je definováno v nastaveních vlastností úlohy DataConnect. v Funguje jako iterátor pro následující úlohy: – Vytvoří nebo aktualizuje záznam pro každý řádek dat z pracovní tabulky. – Spustí tělo úlohy DataConnect pro každý řádek. Další kroky úlohy můžete umístit v rámci těla úlohy DataConnect. Zatímco se nacházíte uvnitř úlohy DataConnect, stav přezkoumání úlohy bude VLOŽIT, AKTUALIZOVAT, nebo NEZDAŘENÝ, na základě aktuální akce iterace úlohy. Při opuštění úlohy sledu prací DataConnect bude stav Dokončeno, nebo Nezdařený (pokud selhal libovolný z řádků pracovní tabulky).
Příklad sledu prací s úlohou DataConnect Následující příklad ukazuje nákupní objednávku (NO) s položkami NO pro účely vysvětlení. První je dokončený sled prací.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
9
Obrázek 1. Sled prací, který zahrnuje úlohu DataConnect
Nastavení úlohy sledu prací Ve tvůrci sledu prací vytvořte sled prací v modulu triDataConnectJob. Ukázkový sled prací pracuje s několika klíčovými úlohami sledu prací a nastaveními úloh.
Spouštěcí úloha Typ objektu, který souvisí s úlohou triDataConnectJob, a událost úlohy SYSTEM DC PROCESS JOB identifikují správný sled prací pro agenta DataConnect. Agent DataConnect stáhne pole BO_NAME, což musí být název typu objektu z položky DC_JOB úlohy.
10
© Copyright IBM Corp. 2011, 2015
Tabulka 3. Nastavení úlohy Spustit Pole
Popis
Název
V úloze 'Spustit' sledu prací pojmenujte sled prací pomocí standardů pojmenování produktu IBM TRIRIGA.
Souběh, Integrace
Set Souběh na asynchronní. Vyberte příznak Integrace, který úlohám DataConnect umožňuje být částí sledu prací.
Modul
Nastavte Modul na triDataConnectJob.
Typ objektu
Nastavte Typ objektu na obchodní objekt, který jste vytvořili v modulu triDataConnectJob.
Událost
Nastavte Událost na SYSTEM DC PROCESS JOB. Tato událost je událost DataConnect.
Šířit stav integrace, Integrace
Vyberte příznak Šířit stav integrace, který určuje, že se má šířit příznak Integrace, když tento sled prací zavolá jiný sled prací.
Úloha DataConnect Úloha DataConnect načte záznamy z pracovní tabulky a iteruje skrze stavové položky, přičemž vytvoří nebo aktualizuje záznam smart každé položky. Tabulka 4. Nastavení úlohy DataConnect Pole
Popis
Popisek, Popis
Vytvoří tělo sledu prací pomocí úlohy DataConnect tam, kde je to vhodné. Zadejte Popisek a Popis.
Modul, Obchodní objekt
Uvádí Modul a Obchodní objekt, na kterých pracuje úloha DataConnect.
Počáteční stav
Nastaví Počáteční stav na stav, ve kterém se musí vytvořit nový záznam. Úloha DataConnect ignoruje hodnotu počátečního stavu, pokud aktualizuje záznam. Volby v tomto okénku se seznamem jsou stavy, které jsou definované pro obchodní objekt. Záznam se vytvoří v daném stavu; nepřejde do něj. Chcete-li, aby záznam přešel do stavu, nechte úlohu DataConnect vytvořit objekt ve stavu Null. Pak použijte úlohu akce spouštěče v rámci těla úlohy DataConnect k přechodu záznamu do požadovaného stavu.
Použít dočasná data
Vyberte volbu Použít dočasná data, chcete-li, aby úloha DataConnect použila dočasná data. Když úloha DataConnect s vybranou volbou Použít dočasná data použije příchozí data, platforma vloží nebo použije aktualizace na dočasná data místo na trvalá data. Příklady a další podrobnosti viz Použít dočasná data.
V pořadí, Krok úlohy
V sekci Korelace: v V pořadí označuje, že se korelace na stavové položce a pořadové číslo používají k určení pořadí zpracování záznamů. Tento scénář je výchozí a nejčastější scénář, ledaže byste měli jednu úlohu DataConnect ve druhé. v Krok úlohy označuje, že korelace musí pocházet z uzavírající úlohy DataConnect a musí se použít v klauzuli Where k určení, jaké položky se mají zpracovat. Například číslo úlohy + číslo korelace, seřazeno podle pořadového čísla. Použití kroku úlohy umožňuje úloze DataConnect získat číslo korelace z jedné z uzavírajících úloh DataConnect.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
11
Tabulka 4. Nastavení úlohy DataConnect (pokračování) Pole
Popis
Žádný, Na každých x iterací, Všechny iterace
Vyberte rozsah v sekci Transakce. v Žádný: Záznam se potvrdí ihned po jeho vytvoření nebo aktualizaci. v Na x iterací: Nový kontext se vytvoří na každých x iterací a potvrdí se po dokončení daného počtu iterací. v Všechny iterace: Nový kontext se vytvoří dříve, než úloha spustí jakékoli zpracování, a potvrdí se po dokončení všech iterací.
Úloha akce spouštěče Posledním krokem ve sledu prací musí být úloha akce spouštěče, která úlohu označí jako dokončenou nebo nezdařenou. Tabulka 5. Nastavení úlohy akce spouštěče Pole
Popis
Popisek, Akce
Ve vlastnostech úlohy akce spouštěče zadejte do pole Popisek Označit úlohu jako dokončenou a v poli Akce vyberte volbu triDCCompleted.
Vzít, Jaké úlohy, Použít, Typ objektu
V sekci Záznamy vyberte v poli Vzít volbu Obchodní objekt a v poli Jaké úlohy vyberte volbu Start (loDCPurchaseOrder). Označte volbu Použít a v poli Typ objektu vyberte volbu loDCPurchaseOrder.
Úloha přerušení U transakcí, které chcete odvolat nebo potvrdit, vložte do těla úlohy DataConnect úlohu přerušení (nebo pokračování). Pomocí úlohy přerušení (nebo pokračování) můžete zkontrolovat stav úlohy DataConnect a určit, na jaký blok přejít. Můžete také rozhodnout, zda chcete pokračovat v iteraci (pokračování versus přerušení), a zda chcete potvrdit, nebo odvolat (úspěch nebo selhání). Nastavení transakce na úloze DataConnect funguje s nastaveními úlohy přerušení (nebo pokračování). Úloha přerušení má také nastavení k řízení dočasný dat. Další podrobnosti a příklady viz Použít dočasná data. Pokud úloha DataConnect nepoužívá transakce, řádky se potvrdí v každém kroku úlohy. Pokud nedosáhnete na přerušení (nebo pokračování), které změní průběh zpracování, a používáte transakce, provede se potvrzení založené na nastavení úlohy DataConnect. Pokud úloha DataConnect používá transakce a sled prací dosáhne na přerušení (nebo pokračování), transakce se odvolají nebo potvrdí na základě nastavení úspěchu nebo selhání v přerušení. Zpracování pokračuje v rozsahu určeném v přerušení (nebo pokračování). Aktuální rozsah představuje úlohu, ve které se nacházíte. Typ přerušení průběhu znamená, že se má pokračovat ve zpracování na úloze po úloze DataConnect. Typ pokračování průběhu znamená, že se má pokračovat na další řádek v dávce pracovní tabulky pro tuto úlohu. Vybraný blok znamená přerušení (nebo pokračování) na úloze DataConnect.
Volání sledu prací Pokud sled prací s úlohou DataConnect zavolá jiné sledy prací, dané sledy prací bude možná nutné aktualizovat kvůli kontrole nastavení Integrace a kvůli případné změně příznaku Šířit stav integrace.
12
© Copyright IBM Corp. 2011, 2015
Můžete analyzovat existující sledy prací, které může zavolat sled prací kvůli přesunu dat. Pokud v rámci sledu prací existují kroky, které nesmí být spuštěny při volání ze sledu prací integrace, zkontrolujte nastavení Integrace pomocí úlohy přepnutí nebo v úloze spuštění. Pokud sled prací nesmí šířit stav Integrace, vymažte příznak Šířit stav integrace v úloze spuštění. Hodnota 1 u příznaku Integrace znamená, že je povolený.
Validace běhových dat Běhové prostředí DataConnect provádí některé validace dat. Pokud například v pracovní tabulce existuje pole s měrnou jednotkou, jehož hodnota je neplatná. Když úloha DataConnect zjistí nezdařený řádek, ukončí zpracování a iterace DataConnect se nezdaří (ale ne celá úloha DataConnect). Řádek se v pracovní tabulce označí jako Nezdařený. Zde si můžete vybrat, zda chcete pokračovat s další iterací, nebo zda chcete opustit úlohu. Umístěte přerušení do sledu prací, abyste sdělili, jak má pokračovat. Pokud nepřidáte přerušení, úloha DataConnect bude pokračovat ve zpracování. Úloha DataConnect obsahuje následující vestavěné validace běhových dat: v Hodnoty měrné jednotky a lokátoru jsou platné. v Datový typ je platný pro pole. v Název formuláře je platný pro objekt. v Poskytnutý název projektu je platný pro systém. Další validace dat a pročištění můžete přidat pomocí vlastnosti Použít dočasná data.
Stavy iterace Jako u většiny iterací úloh si úloha DataConnect pamatuje informace z poslední iterace, včetně stavu. Například, můžete sestavit sled prací, který má dvě úlohy DataConnect, jednu obsaženou ve druhé. Pokud řádek selže v rámci vnitřní iterace a vy chcete na konci nastavit vhodný stav, uložte daný řádek v proměnné. Tato praktika zajistí, že se neztratí stav.
Dočasná data Když vyberete vlastnost Použít dočasná data v úloze DataConnect, umožníte úlohám sledu prací v rámci úlohy DataConnect zpracovat příchozí záznamy z pracovní tabulky v relaci. Jinak řečeno, s daty je možné manipulovat před jejich uložením do databáze. Použijte úlohu Načíst dočasný záznam k načtení dočasného záznamu a použijte úlohu Uložit trvalý záznam k uložení změn aktuální relace. Úloha Přerušit může odebrat specifickou iteraci z relace nebo zcela vymazat relaci. V úloze Přerušit může také selhat specifický řádek pracovní tabulky nebo mohou selhat všechny řádky pracovní tabulky od posledního uložení trvalého záznamu. Když zaškrtnete volbu Použít dočasná data, po zpracování sledu prací představuje záznam úlohy DataConnect trvalý záznam beze změn z pracovní tabulky. Záznamem pro úlohu Načíst dočasný záznam jsou také aktualizované nebo příchozí hodnoty z pracovní tabulky. Tento proces umožňuje validaci dat a pročištění příchozích hodnot v rámci sledu prací a dokonce i mapování dat při aktualizaci, pokud jsou pole prázdná v pracovní tabulce.
Příklad jediné úlohy DataConnect s dočasnými daty Následující výňatek ze sledu prací ukazuje jedinou úlohu DataConnect, která zpracuje dočasná data.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
13
Obrázek 2. Jediná úloha DataConnect, která zpracuje dočasná data Tabulka 6. Nastavení úlohy DataConnect Pole
Popis
Použít dočasná data
Vybráno
Tabulka 7. Nastavení úlohy Přerušit Pole
Popis
Typ toku
Pokračovat
Stav úlohy
Úspěch
Rozsah přerušení
Aktuální rozsah
Zahodit dočasná data
Vše
Selhané stavové řádky
Vybráno, nastaveno na Vše
Úloha DataConnect iteruje skrze záznamy pracovní tabulky, přičemž umístí vložené nebo aktualizované záznamy do relace. Sled prací načte dočasný záznam pro každou iteraci, něco s ním provede a rozhodne, zda se má uchovat. Chcete-li uchovat záznam, uložte záznam trvale pomocí úlohy Uložit trvalý záznam. Podmínka selhání úlohy Přepnout používá nastavení v úloze Přerušit/Pokračovat k zahození všech dat relace. V podmínce selhání také selžou stavové řádky, které se použijí k vygenerování záznamu v relaci, a podmínka bude pokračovat na další záznam v iteraci. V tomto příkladu jediné úlohy DataConnect by nastavení pole Zahodit dočasná data v úloze Přerušit na volbu Aktuální místo Vše mělo stejný výsledek.
14
© Copyright IBM Corp. 2011, 2015
Příklad více úloh DataConnect s dočasnými daty Následující výňatek ze sledu prací ukazuje úlohu DataConnect, která obsahuje druhou, podřízenou úlohu DataConnect. Tento výňatek je rozšířením dříve ukázaného příkladu nákupní objednávky.
Obrázek 3. Více úloh DataConnect, které zpracují dočasná data
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
15
Tabulka 8. Nastavení vnější úlohy DataConnect Pole
Popis
Použít dočasná data
Vybráno
Tabulka 9. Nastavení vnější úlohy Přerušit Pole
Popis
Typ toku
Pokračovat
Stav úlohy
Úspěch
Rozsah přerušení
Aktuální rozsah
Zahodit dočasná data
Vše
Selhané stavové řádky
Vybráno, nastaveno na Vše
Vnější úloha DataConnect iteruje skrze pracovní tabulku POBody. Sled prací načte dočasný záznam pro každou iteraci, něco s ním provede a rozhodne, zda se má uchovat. Pokud existuje problém se záznamem POBody, sled prací spustí úlohu Přerušit/Pokračovat a zahodí všechna data relace, ve sledu prací selže řádek a přesune se na další záznam POBody. Pokud záznam POBody projde úlohou Přepnout, zpracování bude pokračovat s vnitřní úlohou DataConnect, aby se zpracovaly řádky POLines pro tento záznam POBody. Sled prací může provést jednu z několika činností podle toho, co najde, a podle nastavení úlohy Přerušit. Můžete mít několik úloh Přepnout/Přerušit a v závislosti na zpracování může ve sledu prací selhat vše, nebo pouze jeden řádek. Následující scénáře ukazují různé způsoby použití úlohy Přerušit a co se může stát se zpracováním a relací: v Selhání aktuálního řádku POLine, odebrání záznamu, který vytvořil nebo upravil z relace, a selhání pouze daného řádku pracovní tabulky. Zpracování bude pokračovat dalším řádkem POLine záznamu POBody. Úloha Přerušit vnitřní úlohy DataConnect použije následující vlastnosti: Tabulka 10. Nastavení vnitřní úlohy Přerušit Pole
Popis
Typ toku
Pokračovat
Stav úlohy
Úspěch
Rozsah přerušení
Aktuální rozsah
Zahodit dočasná data
Aktuální
Selhané stavové řádky
Vybráno, nastaveno na Aktuální
v Vymazání aktuální iterace POBody, odebrání záznamu, který vytvořil nebo upravil z relace, selhání řádku pracovní tabulky záznamu POBody, vymazání řádků POLines a selhání řádků pracovní tabulky POLines. Zpracování bude pokračovat s dalším záznamem POBody. Úloha Přerušit vnitřní úlohy DataConnect použije následující vlastnosti: Tabulka 11. Nastavení vnitřní úlohy Přerušit
16
Pole
Popis
Typ toku
Pokračovat
Stav úlohy
Úspěch
Rozsah přerušení
Vybráno Blokovat, Zpracovat příchozí záznam POBody
© Copyright IBM Corp. 2011, 2015
Tabulka 11. Nastavení vnitřní úlohy Přerušit (pokračování) Pole
Popis
Zahodit dočasná data
Vše
Selhané stavové řádky
Vybráno, nastaveno na Vše
v Nic (Žádná úloha Přerušit ve vnitřní úloze DataConnect). Pokud se na konci vnitřní úlohy DataConnect (POLine) bude nacházet úloha Uložit trvalý záznam, zajistíte, že platforma uloží záznam POBody a jeho řádky POLines.
Agent DataConnect Agent DataConnect kontroluje položky v tabulce DC_JOB (DataConnect Job Control) a spouští položky ve stavu Připraveno. Vlastnost DATACONNECT_SLEEP_TIME v souboru TRIRIGAWEB.properties pro aplikační server, na kterém běží agent DataConnect, řídí, jak často agent kontroluje tabulku DC_JOB (DataConnect Job Control). Když nalezne úlohu v tabulce DC_JOB (DataConnect Job Control), která se nachází ve stavu Připraveno, agent DataConnect provede následující kroky: v Vytvoří záznam pro záznam označený v položce úlohy DataConnect. Tento záznam je instance obchodního objektu řízení úloh, který byl vytvořen v tabulce triDataConnectJob. v Naplní záznam informacemi z položky úlohy, včetně čísla úlohy, typu úlohy, ID zdrojového systému, data vytvoření, data aktualizace, uživatele a stavu. v Nastaví stav položky tabulky DC_JOB na Zpracování. v Odešle událost sledu prací SYSTEM DC PROCESS JOB spolu se záznamem, čímž se spustí sled prací. v Pokud existují problémy s položkou tabulky DC_JOB nebo s vytvořením obchodního objektu řízení úloh, stav položky tabulky DC_JOB se nastaví na Nezdařilo se. Příčina poruchy se zaprotokoluje do souboru server.log. Jakmile bude problém opraven, můžete se znovu pokusit spustit úlohu v rámci konzoly administrátora. v Další informace o správci agentů naleznete v Uživatelské příručce konzoly administrátora produktu IBM TRIRIGA Application Platform 3. Další informace o souboru TRIRIGAWEB.properties naleznete v Instalační a implementační příručce produktu IBM TRIRIGA Application Platform 3.
Zpracování sledu prací Když se spustí sled prací s událostí SYSTEM DC PROCESS JOB a obchodním objektem Řízení úlohy, úloha DataConnect ve sledu prací provede jisté kroky. Tento proces předpokládá, že daný sled prací byl definován s povolenou vlastností integrace (true). Úloha DataConnect provede následující kroky: v Použije konfigurované informace k určení typu záznamu ke zpracování, stavu, ve kterém se ponechá nový záznam, typu korelace a nastavení transakce. Použije záznam na úloze spuštění jako zdroj pro použité číslo úlohy. v V úlohách DataConnect získá název pracovní tabulky pro záznam, který je zapotřebí zpracovat, a dotáže se na řádky s odpovídajícím číslem úlohy. V závislosti na nastaveních konfigurace pro číslo korelace použije dané číslo k řazení podle, nebo v klauzuli Where jej použije k vyhledání položek s číslem korelace. Získá položky pracovní tabulky na základě čísla úlohy, čísla korelace, pořadového čísla, akce a cesty. v Pro každý načtený řádek vytvoří nebo aktualizuje inteligentní záznam. Umístí záznam do stavu, který je určen v definici úlohy DataConnect (nepřejde do daného stavu). Změní stav řádku v pracovní tabulce. Nastaví projekt a formulář. V závislosti na příznaku Použít Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
17
dočasná data mohou být změny trvalé nebo provedené v relaci. Spustí kroky, které jsou definovány v rámci iterátoru, přičemž vytvoří vztahy nadřízený-podřízený a bude postupovat podle zpracování obchodní logiky. v Spustí sled prací předběžného vytvoření na nových záznamech. Nechcete-li, aby se spustil sled prací předběžného vytvoření, aktualizujte jej a zaškrtněte příznak integrace, aby se vynechal, když jej zavolá sled prací integrace. v Pokud existuje volání do jiného sledu prací, zkontroluje nastavení stavu integrace, aby změnila zpracování na základě toho, zda byl sled prací zavolán z procesu integrace. v Pokud existuje událost, zkontroluje sloupec FROM_INTEGRATION, aby určila, zda je stav integrace nastaven v kontextu sledu prací. v Zpracuje transakci na základě nastavení konfigurace úlohy DataConnect.
Agent vyčištění Agent vyčištění zpracovává automatické vyčištění úloh DataConnect. Použijte správce agentů v konzole administrátora, chcete-li nadefinovat název procesoru, na kterém je spuštěný agent vyčištění. V souboru TRIRIGAWEB.properties nastavte vlastnost DC_HISTORY_RETENTION_DAYS. Pokud se položka DataConnect v tabulce DC_JOB nachází ve stavu Zastaralý nebo Dokončený po počet dní určených ve vlastnosti DC_HISTORY_RETENTION_DAYS, spustí se agent vyčištění. Agent vyčištění pak provede následující kroky: v Najde číslo řízení úlohy položky a odstraní položky v pracovních tabulkách pro dané číslo řízení úlohy. v Odstraní položku tabulky DC_JOB. Agent vyčištění neodstraní položky obchodního objektu řízení úloh (obchodního objektu v triDataConnectJob). Postupujte podle obchodních pravidel vaší společnosti pro správu nepotřebných položek triDataConnectJob. Můžete je přímo odstranit ze systému nebo pomocí vámi vytvořené nabídky. Další informace o správci agentů naleznete v Uživatelské příručce konzoly administrátora produktu IBM TRIRIGA Application Platform 3. Další informace o souboru TRIRIGAWEB.properties naleznete v Instalační a implementační příručce produktu IBM TRIRIGA Application Platform 3.
Běžné problémy s nástrojem DataConnect Běžné problémy s nástrojem DataConnect produktu IBM TRIRIGA zahrnují chybějící pracovní tabulky nebo pole pracovní tabulky, neplatné sloupce tabulky a pozměněné obchodní objekty, které je nutné znovu publikovat. Tabulka 12. Běžné problémy s nástrojem DataConnect Chybová zpráva
Kde se nachází
Jak ji opravit
Obchodní objekt: XX nemá pracovní tabulku.
Od běhového prostředí úlohy DataConnect, když je spuštěný sled prací, je výjimka WFRuntimeException v souboru server.log
Chybí pracovní tabulka pro obchodní objekt XX. Úloha selže ve sledu prací.
[XX = název obchodního objektu]
18
© Copyright IBM Corp. 2011, 2015
Tabulka 12. Běžné problémy s nástrojem DataConnect (pokračování) Chybová zpráva
Kde se nachází
Jak ji opravit
Dojde k chybě během zpracování stavových záznamů: XX.
Od běhového prostředí úlohy DataConnect, když je spuštěný sled prací
Došlo k chybě během úloha úlohy DataConnect. Jednou z možných příčin je, že při aktualizaci sloupec DC_PATH nepřesně definoval objekt smart určený k aktualizaci.
Uživatelské rozhraní
Zpracovávaná úloha DataConnect se musí nejprve dokončit, než bude možné odstranit obchodní objekt. Odstraňte po dokončení úlohy zpracování.
Momentálně nelze publikovat Uživatelské rozhraní obchodní objekt. Existují úlohy DataConnect ve stavu ČEKÁNÍ nebo ZPRACOVÁNÍ. Tyto se musí nejprve dokončit, než bude možné dokončit publikování.
Zpracovávanou nebo čekající úlohu DataConnect je nutné nejprve vymazat, než bude publikování objektu úspěšné. Obojí musí být vymazáno bez zásahu. Znovu publikujte, až nebudou existovat žádné nevyřízené úlohy.
[XX = pole záznamu pracovní tabulky] Nelze odstranit obchodní objekt, existují nevyřízené úlohy DataConnect.
Agent DataConnect Obchodní objekt triDataConnectJob nelze nalézt. Ujistěte se, že provedete import před použitím agenta DataConnect.
Od agenta DataConnect Agent je výjimka PlatformRuntime v souboru server.log
Použijte nejnovější balík migrace objektu triDataConnectJob, než spustíte nebo použijete nástroj DataConnect.
Agent DataConnect Agent Obchodní objekt triDataConnectJob má chybnou verzi. Ujistěte se, že provedete import před použitím agenta DataConnect.
Od agenta DataConnect Agent je výjimka PlatformRuntime v souboru server.log
Použijte nejnovější balík migrace objektu triDataConnectJob, než spustíte nebo použijete nástroj DataConnect.
DataConnectTaskHandler Od běhového prostředí úlohy DataConnect, když je Stavová tabulka: XX neobsahuje stavové pole: YY. spuštěný sled prací, je položka varování v souboru [XX = název pracovní server.log tabulky] [YY = název pole] DataConnectTaskHandler: Nelze najít nadřízený objekt smart, jehož cesta k objektu je: XX.
V pracovní tabulce chybí očekávaná pole. Tento výsledek může nastat v případě, že pracovní tabulka není synchronizovaná s obchodním objektem. Znovu publikujte obchodní objekt po dokončení úlohy DataConnect.
Od běhového prostředí úlohy DataConnect, když je spuštěný sled prací, je položka varování v souboru server.log
Běhové prostředí nemůže vyhledat nadřízeného, který je identifikovaný ve sloupci DC_PATH pole pracovní tabulky. Vytvoří se objekt smart; pouze se pro něj nenastaví nadřízený.
Od běhového prostředí úlohy DataConnect, když je spuštěný sled prací, je výjimka WFRuntimeException v souboru server.log
Zkontrolujte přechody stavu obchodního objektu úlohy, abyste se ujistili, že definovala přechody stavu v základním objektu triDataConnectJob.
[XX = sloupec DC_PATH z pracovní tabulky] DataConnectTaskHandler: provedení akce přechodu s neplatným stavem, XX na objektu smart: YY. [XX = stav] [YY = ID objektu smart]
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
19
Tabulka 12. Běžné problémy s nástrojem DataConnect (pokračování) Chybová zpráva
Kde se nachází
Od agenta DataConnect je Obchodní objekt pro úlohu YY, XX není platný obchodní informační položka v objekt. protokolu server.log Z tabulky DC_JOB [XX = BO_NAME]
Jak ji opravit Sloupec BO_NAME v tabulce DC_JOB pro úlohu YY není platný obchodní objekt. Ujistěte se, že je název správný a že se nachází v modulu triDataConnectJob. Opravte položku a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
[YY = JOB_NUMBER] Sloupec JOB_RUN_CTL XX Od agenta DataConnect je není platný pro úlohu YY. informační položka v protokolu server.log Z tabulky DC_JOB [XX = JOB_RUN_CTL] [YY = JOB_NUMBER] Sloupec JOB_TYPE XX je neplatný pro úlohu YY.
Sloupec JOB_RUN_CTL pro úlohu YY je neplatný v tabulce DC_JOB. Pouze hodnoty 0 (jediný podproces) nebo 1 (s podporou více podprocesů) jsou platné položky. Opravte položku a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Od agenta DataConnect je informační položka v protokolu server.log
Sloupec JOB_TYPE pro úlohu YY je neplatný pro tabulku DC_JOB. Je platná pouze hodnota 1 (příchozí). Opravte položku a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Od agenta DataConnect je informační položka v protokolu server.log
Agent nebyl schopen použít sloupec USER_ID k přidružení nově vytvořené úlohy DataConnect k uživateli. Ujistěte se, že USER_ID je platné spec_id profilu T_MYPROFILE. Opravte položku a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Od agenta DataConnect je informační položka v protokolu server.log
Agent nebyl schopen vytvořit objekt smart úlohy DataConnect. Ujistěte se, že je název správný a že se nachází v modulu triDataConnectJob. Opravte položku a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Od agenta DataConnect je informační položka v protokolu server.log
Agent nebyl schopen namapovat nezbytná pole na nově vytvořenou úlohu DataConnect. Ujistěte se, že obchodní objekt XX nadefinoval všechna pole v základním obchodním objektu triDataConnectJob. Opravte položku nebo obchodní objekt, případně znovu publikujte obchodní objekt, pokud došlo ke změně, a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Z tabulky DC_JOB [XX = JOB_TYPE] [YY = JOB_NUMBER] Nelze přidružit BB ID uživatele pro úlohu YY pomocí obchodního objektu BO XX. Z tabulky DC_JOB [BB = USER_ID] [XX = BO_NAME] [YY = JOB_NUMBER] Nelze vytvořit obchodní objekt pro úlohu YY pomocí obchodního objektu. Z tabulky DC_JOB [XX = BO_NAME] [YY = JOB_NUMBER] Nelze namapovat pole, která jsou nezbytná pro řádné fungování úlohy DataConnect, pro úlohu YY pomocí obchodního objektu XX. Z tabulky DC_JOB [XX = BO_NAME] [YY = JOB_NUMBER]
20
© Copyright IBM Corp. 2011, 2015
Tabulka 12. Běžné problémy s nástrojem DataConnect (pokračování) Chybová zpráva
Kde se nachází
Jak ji opravit
Nelze zaslat událost sledu prací SYSTEM DC PROCESS JOB pro úlohu YY pomocí obchodního objektu XX.
Od agenta DataConnect je informační položka v protokolu server.log
Agent nebyl schopen zaslat událost sledu prací pro nově vytvořenou úlohu DataConnect. Příčinou může být skutečnost, že neexistuje publikovaný sled prací pro úlohu SYSTEM DC PROCESS JOB a pro obchodní objekt XX. Ujistěte se, že je sled prací publikovaný pro událost a obchodní objekt XX. Opravte položku nebo sled prací a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Nelze publikovat, existují úlohy DataConnect, které se zpracovávají nebo čekají na obchodní objekt.
Od agenta publikování je výjimka PlatformRuntime v souboru server.log
Zpracovávanou nebo čekající úlohu DataConnect je nutné nejprve vymazat, než bude publikování objektu úspěšné. Obojí musí být vymazáno bez zásahu. Znovu publikujte, až nebudou existovat žádné nevyřízené úlohy.
Nelze převést úlohu do triDCStartProcessing pro úlohu YY pomocí obchodního objektu XX.
Od agenta DataConnect je informační položka v protokolu server.log
Zkontrolujte přechody stavu pro obchodní objekt XX, abyste se ujistili, že XX nadefinoval přechody stavu v základním objektu triDataConnectJob v modulu triDataConnectJob. Opravte položku nebo obchodní objekt, případně znovu publikujte obchodní objekt, pokud došlo ke změně, a resetujte STAV na PŘIPRAVENO (nebo na hodnotu 1).
Z tabulky DC_JOB [XX = BO_NAME] [YY = JOB_NUMBER]
Z tabulky DC_JOB [XX = BO_NAME] [YY = JOB_NUMBER]
Rady pro ovládání nástroje DataConnect Následující rady můžete použít ke zlepšení způsobu, jakým váš podnik pracuje s nástrojem DataConnect produktu IBM TRIRIGA. Tabulka 13. Rady pro ovládání nástroje DataConnect Rada
Popis
Úloha schválení
Úlohu schválení nemůžete spustit v rámci úlohy DataConnect.
Úloha DataConnect zůstane ve stavu Zpracování; sled prací pravděpodobně neobsahuje akci spouštěče k přesunu úlohy do stavu Nezdařený nebo Dokončený.
Pokud úloha DataConnect zůstane ve stavu Zpracování, zkontrolujte instanci sledu prací úlohy. Je pravděpodobné, že se sled prací dokončil, ale neexistuje žádná úloha sledu prací, která by úloha převedla do stavu Dokončeno nebo Nezdařený.
Sloupec DC_PATH v pracovní tabulce můžete použít k nastavení hierarchie při vložení. Při aktualizaci musí být DC_PATH záznamem, který se má aktualizovat.
Sloupec DC_PATH v pracovní tabulce se musí použít během aktualizace. Sloupec DC_PATH musí být nastaven na záznam, který chcete aktualizovat. Musí to být sloupec IBS_SPEC.OBJECT_PATH záznamu, který chcete aktualizovat. Sloupec DC_PATH použitý spolu s vložením může úloze DataConnect označit, kam má umístit záznam do hierarchie. Podřízení musí mít cestu nadřízeného ve sloupci DC_PATH. Úloha DataConnect pomocí této cesty nastaví hierarchii. Objekty na vrcholu hierarchie nebo objekty mimo hierarchii musí mít prázdný sloupec DC_PATH.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
21
Tabulka 13. Rady pro ovládání nástroje DataConnect (pokračování) Rada
Popis
Plán provedení
Aby nedošlo k ovlivnění databázových spojení a podprocesů, které jsou k dispozici pro aplikační server, naplánujte úlohy DataConnect, aby se spustily mimo špičku.
Problémy nalezené agentem DataConnect jsou zaprotokolovány do souboru server.log
Většinu běžných problémů s položkami v tabulce DC_JOB (DataConnect Job) zpracuje agent DataConnect. Problém se zaprotokoluje do souboru server.log a položka úlohy DataConnect se nastaví na stav Nezdařeno. Další informace můžete získat, pokud zapnete protokolování ladění v agentovi DataConnect. Po vyřešení problému můžete zopakovat úlohu z konzoly administrátora pomocí odkazu Zopakovat úlohu.
Obchodní objekt řízení úloh
Obchodní objekt pro sled prací, který obsahuje úlohu DataConnect, musí být dílčím typem triDataConnectJob, to znamená vytvořený v modulu triDataConnectJob. Pokud tomu tak není, systém vygeneruje chybu.
Měrná jednotka pole s číslem
Pokud jste nastavili vlastnost Pole pracovní tabulky pro pole s číslem pomocí souvisejícího pole s měrnou jednotkou, které je definováno v obchodním objektu, nastavte vlastnost Pole pracovní tabulky pro související pole Měrná jednotka.
Pole pracovní tabulky pocházejí ze sekce Obecné
Pouze pole, která se nacházejí v sekci Obecné, jsou podporována jako pole pracovní tabulky. Chcete-li stáhnout data z jiných sekcí, použijte dočasné pole v obchodním objektu a použijte generátor sledu prací k přesunu data do odpovídajících polí jiných sekcí. Jinak použijte obchodní objekt pomocníka ke stažení všech dat a použijte generátor sledu prací k přesunu dat do skutečného obchodního objektu.
Název pracovní tabulky
Použijte spravovaný objekt DataConnect v konzole administrátora ke zjištění názvu pracovní tabulky. Klepněte na volbu Obchodní objekty s pracovními tabulkami. Název pole databáze je vypsán spolu s ostatními informacemi. Odkaz Rozbalit data obsahuje další informace pro vybrané řádky jako např. názvy polí v pracovní tabulce a úlohy, které používají pracovní tabulku.
Pozastavený sled prací
Sled prací nelze pozastavit, zatímco zpracovává úlohu DataConnect.
Pokud má obchodní objekt sekci smart, kterou je nutné naplnit skrze Proces DataConnect může zpracovat obchodní objekty se integraci, přidejte dodatečné pole do obchodního objektu jako pole přidružením sekce smart. pracovní tabulky. Naplňte dané pole v pracovní tabulce identifikátorem, na který je možné se dotázat za účelem vyhledání záznamu, který chcete přidružit k novému objektu smart. Ve sledu prací se dotažte na záznam a přidružte jej k novému objektu smart. Počáteční stav je ten, ve kterém je sekce smart vytvořena; nepřechází.
22
© Copyright IBM Corp. 2011, 2015
Pokud integrace chce, aby objekt smart přešel do stavu, nastavte počáteční stav na hodnotu Null v úloze DataConnect. V těle úlohy DataConnect použijte akci spouštěče k přechodu objektu do požadovaného stavu.
Tabulka 13. Rady pro ovládání nástroje DataConnect (pokračování) Rada
Popis
Sledování chyb
Možná budete chtít vytvořit záznam ke sledování chyb, ke kterým dojde během validací sledu prací. Jeden způsob představuje vytvoření vlastního obchodního objektu cstDataMigrationError v modulu triIntermediate. Tento obchodní objekt může zahrnovat následující pole: v triCreatedSY: Datum a čas vytvořené systémem. v triNameTX [Error Type]: Ukládá migraci, která způsobila chybu. v triLinkedRecordTX: Pole lokátoru, které odkazuje na skutečný záznam, u kterého se nezdařila validace. Nezapomeňte nadefinovat přidružení mezi chybovým obchodním objektem a jakýmkoli dalším obchodním objektem, který se používá ve validaci. v triDescriptionTX [Error Message]: Uchovává podrobnosti o specifické chybě. v Pak vytvořte formulář pro záznam chyby migrace dat.
Úloha akce uživatele
Úlohu akce uživatele nemůžete spustit v rámci úlohy DataConnect.
Výjimky sledu prací
Úloha DataConnect selže, pokud sled prací zjistí pevnou výjimku během zpracování sledu prací.
Kapitola 1. Integrace dat s nástrojem DataConnect TRIRIGA
23
24
© Copyright IBM Corp. 2011, 2015
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA Můžete naimportovat data oddělená tabulátory z externího systému do obchodních objektů produktu IBM TRIRIGA pomocí nástroje Integrátor dat. Pomocí nástroje Integrátor dat můžete také provádět hromadné aktualizace existujících dat.
Přehled procesu integrátoru dat produktu TRIRIGA Nástroj DataConnect produktu IBM TRIRIGA slouží k importu dat do obchodních objektů bez zapsání technických skriptů. Data záznamu mohou pocházet z libovolného zdroje, jako např. z databáze, souboru produktu Microsoft Excel nebo z externího systému. Bez ohledu na zdroj dat, nástroj Integrátor dat přijme pouze soubory oddělené tabulátory s příponou .txt file. Nástroj Integrátor dat vám poskytuje schopnost zachytit a přenést skupiny záznamů do produktu IBM TRIRIGA bez nutnosti ručně zadávat jeden záznam po druhém. Import již existující databáze šetří čas a odstraňuje problémy s integritou dat a s kvalitou, které se vyznačují při ručním zadání záznamů. Integrátor dat vždy naimportuje data do základních tabulek jazyků produktu IBM TRIRIGA. Import přeložených dat do lokalizovaných tabulek není podporován. Integrátor dat může vytvořit přidružení mezi dvěma záznamy. Nadřízený záznam musí existovat v systému, než budete moci vytvořit přidružení. Způsob, jakým navrhujete moduly v systému IBM TRIRIGA, určuje, jaká data budete moci naimportovat a přidružit k sobě. Integrátor dat můžete také použít k provádění hromadných aktualizací existujících záznamů. Chcete-li aktualizovat hodnotu obchodního objektu napříč několika existujícími záznamy, můžete použít Integrátor data, abyste hromadně změnili hodnoty pole. Tato metoda se vyhýbá interaktivní spolupráci s uživatelským rozhraním, aby aktualizovala každý jednotlivý záznam. Jako se všemi přenosy integrátoru dat se odešle oznámení uživateli, který zahájil přenos. Oznámení je informuje o úspěchu přenosu, nebo že došlo k chybám. Aby uživatel obdržel oznámení, musí mít ve svém domovském portálu sekci portálu Oznámení. Existuje několik systémových zásad, které zajiš ují řádný import dat. První řádek souboru se záznamy oddělenými tabulátory (.txt) nebo souboru záhlaví musí obsahovat sloupec pro každý název pole v obchodním objektu, kde importujete nebo aktualizujete data. K usnadnění vytváření souboru záhlaví má integrátor dat vestavěný nástroj k vytvoření souboru, který je kompatibilní s produktem Microsoft Excel, jenž obsahuje názvy polí v prvním řádku. Tento soubor záhlaví se stane šablonou přenosu, kam se zadají všechny záznamy.
Typy polí Určité typy polí můžete použít s integrátorem dat a pouze s přijatým formátování pole dat záznamu. Nedodržení těchto pokynů bude mít za následek částečně úspěšný nebo nezdařený přenos záznamů. Pokud typ pole nemá příklad v tabulce, znamená to, že daný typ pole není podporován integrátorem dat. Prohlédněte si komentáře kvůli příčině.
© Copyright IBM Corp. 2011, 2015
25
Tabulka 14. Typy polí záznamu Typ pole
Přípona
Použití
Tlačítko akce AB
Obrázek na obrazovce, který se používá jako tlačítko, na které se dá klepnout.
Logická hodnota
Obsahuje hodnotu, která je bu TRUE, nebo FALSE.
Obchodní objekt
BL
BO
Formát importu
Příklad
Komentáře Není určeno pro použití s integrátorem dat. Definováno pouze v nástroji Tvůrce formulářů. Je nutná úprava.
FALSE = není vybráno
triReservableBL = TRUE
TRUE = vybráno BOTypeName (Typ obchodního objektu)
Používá se k přidružení lokality, organiz ace nebo zeměpisné oblasti k záznamu.
FullPath (Úplná cesta)
Není určeno pro použití s integrátorem dat. Vygenerováno systémovým sledem prací.
RecordName (Název záznamu) SysModified DateTime (Čas aktualizace)
26
Klasifika ce
CL
Obsahuje hodnotu, která je vybrána z definované hierarchie hodnot.
Nasčítání klasifikace
CR
Používá se pro nasčítání součtů klasifik ací.
Barva
CO
Obsahuje barvu.
© Copyright IBM Corp. 2011, 2015
Přesný pravopis a velikost písmen.
Nový objekt klasifikace vyžaduje hierarchický přenos.
Hierarchický modul. Vyžaduje, aby soubor záhlaví obsahoval: Parent = \Classifications a úplnou cestu podřízené klasifikace. Neukončujte cestu lomítkem (\). Není určeno pro použití s integrátorem dat. Naplnil systém, bu sledem prací, nebo akcí Nasčítat.
Hodnota barvy s přesným pravopisem a velikostí písmen.
Zadejte hodnoty barev pomocí znaku čísla (#), za kterým bude následovat hexadecimální hodnota čísla. Například černá je #000000.
Tabulka 14. Typy polí záznamu (pokračování) Typ pole
Přípona
Použití
Kontrolní číslo
CN
Používá se k vygenerování čísel jedinečných ID a také je obsahuje.
Formát importu
Příklad
Komentáře Kontrolní čísla naplní systém při akci Publikovat nebo Vytvořit na základě kritérií, která jsou uvedena na kartě Publikovat v obchodním objektu. Nepožaduje se, pokud pole s kontrolním číslem automaticky naplní sled prací, nebo pokud je standardně nastaveno na naplnění.
Datum
DA
Obsahuje datum.
Výchozí formát data.
triStartDateDA = 01/01/2006
Datum a čas
DT
Obsahuje kombinaci data a času.
Dlouhé celé číslo v mili sekundách.
triDateDT představující 08/21/2006 15:30:00 = 1156199400000
Doba trvání
DU
Obsahuje délku časového intervalu. Popsáno jako #Years (#Roky) #Months (#Měsíce) #Weeks (#Týdny) #Days (#Dny) #Hours (#Hodiny) #Minutes (#Minuty) #Seconds (#Sekundy.).
Vyjádřeno v následujícím formátu:
cstDurationDU představující 5 dnů, 6 hodiny a 30 minut = 5d6h30m0s
Finanční sestava se sbalenými řádky
FR
Obsahuje celkové součty z ostatních polí, která jsou zahrnutá ve finančních transakcích.
8.x - use #w#d#h#m #s
Formáty pro 8.x, 9.x a 10.x se liší. Dbejte na to, abyste převzali vhodný formát pro váš systém.
9.x – use #y#M#w#d #h#m#s 10.x – use #y#M#w#d #h#m#s
Není určeno pro použití s integrátorem dat. Naplnil systém, bu sledem prací, nebo akcí Nasčítat.
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
27
Tabulka 14. Typy polí záznamu (pokračování) Typ pole
Přípona
Použití
Obraz
IM
Obsahuje obraz.
Formát importu
Příklad
Komentáře
triImageIM = //Company-1 /fileMyImage Name.jpg
Všechny obrazy musí existovat ve složce [kořenová instalační složka]/userfiles/ images, než zahájíte přenos. Cesty k obrazům až dolů k názvům souborů se musí přesně shodovat. Všechny soubory s obrazem musí začínat na slovo "file", aby se řádně zobrazily.
28
Není určeno k importu. Definováno pouze v nástroji Tvůrce formulářů. Je nutná úprava.
Pouze popisek
LA
Používá se k uvedení popisku bez odpovídajíc ího pole.
Seznam
LI
Používá se k výběru hodnoty se seznamu hodnot.
Poznámka
NO
Obsahuje formátovaný text s libovolné délky.
Číslo
NU
Obsahuje čísla.
Normální čísla s nezbytným nastavením desetinných míst.
Heslo
PA
Obsahuje upravitelnou textovou hodnotu, kterou nelze zobrazit v uživatelském rozhraní.
Alfa numerický text.
Jen pro čtení systémem
SY
Používá se k přístupu k informacím o záznamu a obchodním objektu, který se použije k jeho vytvoření.
Naplněno systémovými sledy prací produktu IBM TRIRIGA. Není nutné importovat.
© Copyright IBM Corp. 2011, 2015
Přesný pravopis a velikost písmen.
triMonthLI = Prosinec
Integrátor dat nepodporuje pole s poznámkami.
triGross MeasuredNU = 12000.5
Nevyžadují se čárky, znak $ nebo jiné formátování, ledaže by existovala desetinná místa. Zašifrováno.
Tabulka 14. Typy polí záznamu (pokračování) Formát importu
Typ pole
Přípona
Použití
Text
TX
Obsahuje textové hodnoty.
Normální text.
Jediné omezení představuje omezení počtu znaků pole obchodního objektu. Pokud přenesete 30 znaků do pole se 20 znaky, 10 znaků bude oříznuto.
Čas
TI
Obsahuje denní dobu.
Přeneste jako dlouhé celé číslo v mili sekundách.
triStartTimeTI představující čas 9:30:35 večer = 77435000
Měrná jednotka
UO
Používá se k přidružení měrné jednotky k poli nebo k obchodnímu objektu.
Přesný pravopis a velikost písmen.
Adresa URL
UR
Obsahuje adresu URL.
Úplná cesta k adresáři, včetně http, ftp nebo \\.
Karta Systém: Sekce s informacemi o záznamu
Příklad
Komentáře
Obecně tato pole naplní sledy prací. Existuje riziko vytvoření smyčky sledu prací, když přenesete data do těchto polí, což je důvod, proč jsou tato pole jen pro čtení v mnoha oblastech. Některé příklady zahrnují následující pole: LocationName (umístění grafiky) OrgName (název organizace) GeographyName (název zeměpisné oblasti)
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
29
Tabulka 14. Typy polí záznamu (pokračování) Typ pole
Přípona
Pole lokátoru
Použití Odkaz na pole do jiného záznamu obchodního objektu.
Formát importu Vyžaduje úplnou cestu pro hierarchické záznamy nebo hodnotu zobrazenou v poli.
Příklad
Komentáře Může vyžadovat asociativní přenos, pokud zobrazený název není jedinečný v sadě výsledků dotazu, který používá pole lokátoru.
Názvy publikování V datovém modeláři v nástroji Mapování obchodního objektu označují vlastnosti mapování, jaká pole obsahují název publikování záznamu, který byl vytvořen z obchodního objektu. Prvních 100 znaků kombinace hodnot polí v názvu publikování jedinečně identifikuje záznam napříč všemi záznamy, které byly vytvořeny ze stejného obchodního objektu. Soubory se záznamy oddělenými tabulátory, které má zpracovat integrátor dat, musí zahrnovat pole, ve kterých se poskytnou jedinečné hodnoty pro pole názvu publikování. Pokud poskytnete hodnoty polí pro název publikování existujícího záznamu, integrátor dat aktualizuje existující záznam s dodatečnými hodnotami polí, které jste poskytli v přeneseném souboru. Pokud přenesený soubor se záznamy oddělenými tabulátory neposkytuje jedinečné názvy publikování, integrátoru dat se možná nepodaří vytvořit záznam. V opačném případě může vytvořit záznam namísto jeho aktualizace, nebo může aktualizovat chybný záznam. Je také možné, že se může prvních 100 znaků ze souboru se záznamy oddělenými tabulátory shodovat s názvem záznamu, ale po těchto 100 znacích se název záznamu již nemusí shodovat. V tomto případě se záznam odmítne a nedojde k žádné aktualizaci nebo vytvoření.
Číselná pole Pole svázaná se součty v sekcích smart více záznamů určují, že pole na seznamu polí sekce smart musí být sečtená. Pole se vytvoří v sekci Obecné v obchodním objektu, který se automaticky naplní vybranými součty ze seznamu polí. Produkt IBM TRIRIGA používá tato pole v některých obchodních objektech pro souhrnné sekce a sestavy. Jsou to číselná pole. Hodnotu měrné jednotky pro číselná pole řídíte na úrovni obchodního objektu. Získáte výchozí hodnotu nadefinovanou v datovém modeláři pro daný obchodní objekt.
Pole kontrolních čísel Integrátor dat nemůže zpracovat aktualizace záznamů pro obchodní objekty s názvy publikování, které obsahují pole kontrolního čísla s označeným zaškrtávacím políčkem Generovat při vytvoření. V tomto scénáři není integrátor dat schopen určit, že existuje záznam z přeneseného souboru, což způsobí, že se pokaždé vytvoří nové záznamy, když je soubor přenesen.
Požadavky Integrátor dat vyžaduje, aby byl spuštěný agent importu dat ve správci agentů konzoly administrátora. Také vyžaduje, že přenášený soubor musí obsahovat vhodná pole názvu publikování pro importovaný obchodní objekt.
30
© Copyright IBM Corp. 2011, 2015
Avšak, pokud přenášený soubor také neobsahuje požadovaná pole pro daný obchodní objekt, pak uživatel, který se přihlásí a otevře záznam v produktu IBM TRIRIGA, uvidí chybu povinného pole. Nové importované záznamy musí také obsahovat hodnoty povinných polí k zajištění hladkého zážitku uživatele. V důsledku toho existují dva typy požadavků na integrátor dat, a to funkčnost a použitelnost. Nesplnění některého z těchto požadavků může mít nežádoucí následky. Pokud nejsou splněny funkční požadavky, integrátor dat selže při přenosu. Nejsou-li splněny požadavky na použitelnost, data se úspěšně přenesou, ale způsobí problémy s uživatelským zážitkem. Je vždy dobrým zvykem otestovat všechny soubory integrátoru dat vůči kopii dat produkčního systému, než provedete skutečný přenos nebo aktualizaci.
Funkční požadavky Integrátor dat má několik funkčních požadavků, které ovlivňují názvy publikování, formáty souborů se záznamy oddělenými tabulátory a nadřízené cesty. Jakmile splníte tyto požadavky, soubor záhlaví bude v kompatibilním formátu.
Názvy publikování Všechny obchodní objekty musíte publikovat, než k nim uživatelé budou moci přistoupit. Položka nabídky Publikovat se nachází na kartě Nástroje v datovém modeláři. Je důležité, abyste přenosu dat zahrnuli všechna pole, která definují název publikování obchodního objektu. Jako název publikování se obvykle použije pole s názvem nebo ID, ale můžete použít i jiná pole. Například, pokud se název publikování obchodního objektu triPeople skládá z příjmení, křestního jména a ID, pak názvem publikování je "Smith, John - 10025884". Definici názvu publikování obchodního objektu si můžete prohlédnout, když otevřete daný obchodní objekt v datovém modeláři a zobrazíte si vlastnosti mapování obchodního objektu v nabídce Nástroje. U názvů publikování, které obsahují pole s kontrolním čísly, musíte název publikování znovu definovat na jedinečnou hodnotu, která nepoužívá kontrolní číslo. Po dokončení přenosu můžete název publikování změnit zpět, aby používal pole s kontrolním číslem. Upozornění: Název publikování nesmí obsahovat pole s kontrolním číslem, když aktualizujete existující záznamy v produktu IBM TRIRIGA. Tato situace má za následek, že se místo toho vytvoří nový záznam.
Formát souboru se záznamy oddělenými tabulátory Pokud se všechna pole názvu publikování nachází v souboru záhlaví a jsou správně napsána, jediným dalším funkčním požadavkem je, že soubor musí být mít výstup do souboru se záznamy oddělenými tabulátory. Přípona souboru musí být .txt, ale název souboru může být jakýkoli.
Nadřízené cesty Chcete-li přenést data hierarchického záznamu do hierarchických modulů a obchodních objektů, sloupec Nadřízený musí obsahovat úplnou cestu nadřízeného záznamu přeneseného záznamu. Selhání při definování vhodné cesty k nadřízenému bude mít za následek osiřelé záznamy, které se nezobrazí v okně hierarchie.
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
31
Požadavky na použitelnost Ačkoliv se může zdát, že soubory byly úspěšně přeneseny, přenos představuje pouze první požadavek. Když uživatel otevře záznam, nemusí se naplnit povinné pole, což vygeneruje chybovou zprávu. Povinná pole, výpočty a souhrny jsou všechno instance, kde může použitelnost představovat problém.
Povinní pole Ačkoli integrátor dat vyžaduje k přenosu dat správně napsané názvy publikování se správnou velikostí písmen, existují i další požadavky. U nových záznamů musí obsahovat soubor záhlaví integrátoru dat všechna povinná pole. Kromě toho musí mít všechna pole, která jsou vypsaná v řádku záhlaví v souboru integrátoru dat, správnou velikost písmen a vyžadují správný pravopis. Pokud soubor záhlaví neobsahuje povinná pole, může být přenos záznamu proběhnout úspěšně. Avšak, uživatel, který se přihlásí a otevře záznam, uvidí chybovou zprávu, že chybí povinné pole. Pak musí daný uživatel naplnit všechna povinná pole, než bude moci na záznamu úspěšně spustit jakoukoli akci přechodu stavu. Pokud také proces přenosu dat převede záznam do stavu jen pro čtení, uživatel nemůže převést záznam do upravitelného stavu, aby zadal hodnoty do povinných polí. Tomuto scénáři můžete zabránit, zahrnete-li všechna povinná pole do souboru záhlaví k přenesení. Můžete otevřít nástroj Tvůrce formulářů, chcete-li identifikovat, která pole jsou povinná, a přidat je do souboru záhlaví.
Výpočty Musíte spustit vlastní sled prací, chcete-li spustit výpočty, které naplní pole se vzorci jen pro čtení. Nenaplňujte pole jen pro čtení přímo. Místo toho spus te logiku sledu prací ke spuštění výpočtů po přenosu.
Nasčítání Musíte spustit vlastní sled prací, chcete-li nasčítat informace napříč více obchodními objekty. Ujistěte se, že jste zapsali sled prací, který projde celou cestu od nejnižšího podřízeného až k nejvyššímu nadřízenému napříč všemi objekty v hierarchii.
Vlastní sledy prací Vlastní sledy prací definují veškerou logikou přenosu vůči záznamu. Vytvořte je jen pro tento případ a spus te je při přenosu. Sled prací může například spustit akce přechodu stavu, která opustí stav Null, ne asynchronní sled prací při události přidružení. Upozornění: Jisté sledy prací, jako jsou např. sledy prací přidružené k nasčítání nebo k výpočtům, musíte deaktivovat, než spustíte přenos integrátoru dat.
Soubory se záznamy oddělenými tabulátory Soubor se záznamy oddělenými tabulátory obsahuje řádky s daty. Každý řádek s daty obsahuje jednu nebo více částí dat. Každá část dat se nazývá pole. Soubory se záznamy oddělenými tabulátory, které má číst integrátor dat, musí obsahovat stejný počet polí na každém řádku, avšak v každém poli nemusí být hodnota. Než integrátor dat začne číst soubor se záznamy oddělenými tabulátory, uživatel k souboru přiřadí modul, obchodní objekt a formulář. Tyto informace přikáží integrátoru dat, kam se musí data v souboru dostat po přenosu.
32
© Copyright IBM Corp. 2011, 2015
Integrátor dat použije datová pole na každém řádku (kromě prvního) souboru se záznamy oddělenými tabulátory k vytvoření nebo aktualizaci záznamu v produktu IBM TRIRIGA Application Platform. Pokud integrátor dat určí, že obchodní objekt přiřazený k souboru již obsahuje odeslaný záznam, aktualizuje daný záznam na hodnoty ze souboru. Pokud integrátor dat určí, že odeslaný záznam dosud neexistuje, použije k souboru přidružený obchodní objekt a formulář k vytvoření záznamu. Integrátor dat musí určit, které pole obsahuje jaká data z každého pole na řádku souboru se záznamy oddělenými tabulátory. Integrátor dat zjistí, kam umístit data z každého pole, pohledem na první řádek, který se nazývá Záhlaví, v souboru se záznamy oddělenými tabulátory. Nepoužije první řádek souboru jako data k vytvoření nebo aktualizaci záznamu. Místo toho očekává, že pole na první řádku obsahují název pole v obchodním objektu, který je přidružený k souboru. Název pole identifikuje pole, kam se umístí data pro dané pole. Nejsnadnější způsob, jak generovat tento soubor, je použít aplikaci, která může generovat soubor se záznamy oddělenými tabulátory, a umístit názvy polí na první řádek. Některé aplikace mohou například exportovat nebo vytisknout sestavu do souboru se záznamy oddělenými tabulátory. Pokud můžete zadat záhlaví každého sloupce, pravděpodobně to znamená, že aplikace může umístit hodnotu záhlaví do polí na prvním řádku. Pracujete-li s aplikací, abyste vygenerovali soubory se záznamy oddělenými tabulátory pro integrátor dat, zadejte záhlaví sloupců, která odpovídají názvům polí produktu IBM TRIRIGA, kam chcete umístit hodnoty polí. Jakmile správně nastavíte záhlaví sloupců, aby se shodovala s názvy polí objektu produktu IBM TRIRIGA, stane se z vytváření souborů pro integrátor dat automatizovaný proces. Pokud aplikace nemůže umístit záhlaví do souboru se záznamy oddělenými tabulátory, můžete z něj přesto použít data pro integrátor dat. Avšak, proces přípravy souboru pro integrátor dat vyžaduje další práci. Pokud program, ze kterého chcete naimportovat data, nemůže umístit názvy sloupců na první řádek souboru, můžete je přidat, upravíte-li soubor. Použijte produkt Microsoft Excel k úpravě souborů se záznamy oddělenými tabulátory. Když upravíte soubor se záznamy oddělenými tabulátory pomocí produktu Excel, produkt Excel vás může vyzvat, abyste uvedli některé informace o souboru. Produkt Excel klade tyto otázky, aby se ujistil, že rozumí souboru, který chcete upravit. Produkt Excel se může zeptat, zda se jedná o soubor s oddělenými záznamy, nebo o soubor s pevnou šířkou. Odpovězte na tuto otázku výběrem volby Oddělený. Produkt Excel vás pak může vyzvat, abyste vybrali oddělovače používané v souboru. Vyberte volbu 'tabulátor'. Nevybírejte žádné jiné oddělovače nebo volby. Jakmile vložíte nový první řádek, který obsahuje názvy polí, uložte soubor jako textový soubor se záznamy oddělenými tabulátory. Pokud jste soubor produktu Excel dříve uložili v jeho nativním formátu, můžete ignorovat všechna varování, že soubor může obsahovat součásti, které nejsou kompatibilní s formátem oddělení pomocí tabulátorů. Soubor se záznamy oddělenými tabulátory je nyní připraven ke zpracování pomocí integrátoru dat. Můžete použít integrátor dat k importu dat z aplikace, která nemůže vytvořit soubor se záznamy oddělenými tabulátory, pokud aplikace může exportovat data ve formátu čitelném pro produkt Excel. Může-li aplikace vytvořit soubor, který je čitelný pro produkt Excel, pak daný soubor přečtěte do produktu Excel. Podle potřeby přidejte první řádek do souboru, který obsahuje odpovídající názvy polí. Pak soubor uložte jako textový soubor se záznamy oddělenými tabulátory. Pokud potřebujete upravit datový soubor, abyste přidali první řádek obsahující názvy polí, není nutné, abyste ručně zadali názvy daných polí. K vytvoření prvního řádku můžete použít integrátor dat.
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
33
Soubory záhlaví Soubor záhlaví je šablona importu, kde první řádek záhlaví deklaruje názvy, kam se naimportují data. Toto záhlaví můžete vytvořit několika způsoby. Co je nejdůležitější, záhlaví pole šablony se musí shodovat s názvy odpovídajících polí obchodního objektu ve velikosti písmen a pravopisu a musí obsahovat pole názvu publikování pro obchodní objekt. Existují dva typy modulů v produktu IBM TRIRIGA: Nehierarchické a hierarchické. Proces vytváření souboru záhlaví je stejný pro oba typy. Avšak, u hierarchický přenosů existuje výjimka, že tyto přenosy vyžadují sloupec Nadřízený, který obsahuje úplnou cestu k nadřízenému záznamu přeneseného záznamu.
Soubory záhlaví pro nehierarchické moduly Nehierarchické objekty jsou prosté objekty, které nemají přidružení nadřízený-podřízený a nejsou závislé na existenci nadřízeného objektu. Příklad nehierarchických obchodních objektů produktu IBM TRIRIGA jsou are triPeople, triSpecification a triAsset. Můžete se přesvědčit, zda se jedná o nehierarchický modul v datovém modeláři, pokud vyberete modul a přezkoumáte jeho vlastnosti. Jakmile vytvoříte soubor záhlaví, musíte mít zabezpečený přístup k integrátoru dat, chcete-li přenést soubor. Když budete správně postupovat a hodnoty dat budou vyhovovat formátování pole, přenos bude úspěšný. Jako u všech přenosů integrátoru dat vám systém zašle oznámení o stavu přenosu.
Soubory záhlaví pro hierarchické moduly Hierarchické objekty mají přidružení nadřízený-podřízený, kde podřízený závisí na existenci nadřízeného objektu. Příklady hierarchický obchodních objektů produktu IBM TRIRIGA jsou Zeměpisná oblast, Lokalita a Organizace. Můžete se přesvědčit, zda se jedná o hierarchický modul v datovém modeláři, pokud vyberete modul a přezkoumáte jeho vlastnosti. Hierarchické moduly jsou jedinečné v tom, že vyžadují dodatečné pole v řádku záhlaví v souboru záhlaví integrátoru dat. Klíčové slovo je Nadřízený, které odkazuje podřízený záznam na odpovídající nadřízený obchodní objekt ve stromu. Každý hierarchický strom má kořen, který je stejný jako název modulu. Pro obchodní objekty organizace je kořenem Organizace. Pro lokální objekty organizace je Lokalita. Pro obchodní objekty zeměpisné oblasti je kořenem Zeměpisná oblast. Kromě importování dat může být nezbytné, abyste naimportovali nebo připojili záznamy, které jsou podřízené záznamy, k jinému obchodnímu objektu. Například, záznamy budovy jsou podřízení kořene lokality. Záznamy podlaží jsou podřízení budov. Záznamy prostoru jsou podřízení podlaží. V souboru záhlaví ručně přidejte dodatečný sloupec s názvem Nadřízený. Klíčové slovo Nadřízený je jedno z vyhrazených slov v produktu IBM TRIRIGA a nepovažuje se za volbu při vytváření záhlaví.
Vytváření souborů záhlaví Můžete použít integrátor dat k vytvoření souboru záhlaví pro nehierarchický nebo hierarchický modul.
34
© Copyright IBM Corp. 2011, 2015
Postup 1. V hlavním navigačním panelu vyberte volby Nástroje > Administrace > Integrátor dat. 2. Vyberte modul s obchodním objektem, který musí integrátor dat přidružit k souboru. Pole zobrazuje všechny definované moduly. 3. Vyberte obchodní objekt, který musí integrátor dat přidružit k souboru. Pole zobrazuje všechny publikované obchodní objekty ve vybraném modulu. 4. Vyberte formulář (grafické rozhraní), které se přidruží k záznamům v souboru. Pole zobrazí všechny publikované formuláře pro vybraný obchodní objekt. Během přenosu je možné, že pro vybraný formulář se specifickým názvem publikování neexistuje záznam. Pokud ale existuje jiný záznam se stejným názvem publikování a s jiným formulářem, přenesená data se připojí k existujícímu záznamu, i když má jiný formulář. 5. Vyberte volbu Vytvořit záhlaví. 6. Přezkoumejte obrazovku Zobrazit sloupce, která se objeví. Obsahuje zaškrtávací políčko pro každé pole ve vybraném obchodním objektu nebo formuláři. 7. Vyberte požadovaná pole. Když klepnete na zaškrtávací políčko, systém přidá název odpovídajícího pole do rámečku Pořadí sloupců vpravo nahoře. Ujistěte se, že zahrnete všechny prvky názvu publikování a všech povinných polí. Pole v sekci Pořadí sloupců jsou standardně zobrazena v pořadí, ve kterém je vyberete. Posloupnost v sekci Pořadí sloupců představuje pořadí, ve kterém se pole zobrazí v souboru záhlaví. 8. Chcete-li změnit posloupnost polí, klepnutím vyberte název pole a klepněte na šipku nahoru nebo na šipku dolů, abyste přemístili pole. 9. Jakmile dokončíte seznam polí v sekci Pořadí sloupců a pole se nacházejí ve správné posloupnosti, vyberte volbu Exportovat. 10. Vyberte volbu Uložit. 11. Vyberte cíl na lokálním počítači. Ačkoliv integrátor dat přiřadí k souboru příponu .csv, soubor se v podstatě vytvoří ve formátu .htm. Změňte příponu názvu souboru z .csv na .htm, změňte volbu Uložit jako typ na Všechny soubory a vyberte volbu Uložit. 12. Najděte a otevřete uložený soubor v produktu Microsoft Excel. Všimněte si, že vámi vybrané názvy polí jsou na prvním řádku formuláře. 13. Pokud je tento soubor záhlaví určen pro hierarchický modul, zadejte klíčové slovo Nadřízený do první neobsazené buňky na prvním řádku. Je-li tento soubor záhlaví určen pro nehierarchický modul, vynechejte tento krok. a. Sloupec Nadřízený obsahuje úplnou cestu k nadřízenému přeneseného záznamu. Musíte zadat úplnou cestu k nadřízenému obchodnímu objektu pro integrátor dat, abyste našli nadřízeného a připojili nový podřízený záznam ve stromu hierarchie. b. Vždy zahrňte úplnou cestu nadřízeného obchodního objektu, včetně prvního zpětného lomítka (\). Nezadávejte ale lomítko (\) na konec cesty k nadřízenému. 14. Zadejte data do odpovídajících sloupců. Pokud nezadáváte data přímo do souboru záhlaví, vynechejte tento krok. a. Změňte všechny buňky v tabulce produktu Microsoft Excel na textový formát. Pomocí tohoto nastavení můžete zadat libovolnou hodnotu a vyvarovat se tak formátování převodu dat. Vyberte buňku v horním levém rohu (nad číslem 1 a vedle písmene A), čímž vyberete celou tabulku. Pak vyberte volby Formát > Buňky > Text > OK. b. Hodnoty na seznamu a klasifikace se musí přesně shodovat jak v pravopisu, tak i ve velikosti písmen. 15. Uložte soubor jako soubor .txt se záznamy oddělenými tabulátory. Ověřte, že název souboru končí na .txt a že je volba Uložit jako typ nastaven na Text (oddělený tabulátory)(*.txt). 16. Vyberte volbu Ano. Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
35
Příprava asociativních přenosů Import záznamů dat s přidruženími vyžaduje více práce než hierarchický přenos. Pomocí funkce asociativního přenosu v integrátoru dat můžete přidružit záznamy k sobě navzájem, například propojíte-li osoby s organizacemi, aktiva s prostory a aktiva s osobami. Toto propojení můžete nadefinovat pomocí řetězce přidružení mezi dvěma libovolnými záznamy dat.
Řetězce přidružení Než budete moci vytvořit přenos s přidruženími, potvrte existenci řetězců přidružení, které se použijí v asociativním přenosu spolu s integrátorem dat. Existují dvě metody potvrzení řetězců přidružení: přezkoumáním karet přidružení na záznamech a pomocí správce přidružení. Každý obchodní objekt má několik přidružení, která jsou nadefinována s jinými obchodními objekty. Je důležité, abyste porozuměli vztahu, který je nadefinován k přidružení dvou obchodních objektů. Podle potřeby nejprve nadefinujte přidružení a zpětné přidružení ve správci přidružení.
Identifikace přidružení Většina záznamů produktu IBM TRIRIGA má kartu Přidružení na svých příslušných formulářích. Tuto kartu Přidružení můžete použít k identifikaci pro přidružení záznam-úroveň a jejich odpovídajících řetězců přidružení pro specifický záznam.
Informace o této úloze Tento příklad nahlíží na přidružení pro oborový záznam.
Postup 1. Z hlavního navigačního panelu vyberte nabídku Portfolio. Objeví se stránka Portfolio. 2. Vyberte volbu Oddělení v sekci portálu Organizace. 3. Vyberte název libovolného záznamu na stránce Oddělení. 4. V záznamu vyberte kartu Přidružení. 5. Vyberte modul. 6. Vyberte obchodní objekt. 7. Přezkoumejte výsledky. Na seznamu Záznamy aplikace zobrazí všechny záznamy, které mají přidružení ze záznamu otevřeného ve formuláři. Hodnota řetězce, která je také známá jako Řetězec přidružení, je fráze příkazového slova, která popisuje přidružení, které existuje mezi dvěma záznamy.
Ověření pravidel přidružení Pomocí Správce přidružení můžete potvrdit pravidla přidružení obchodní objekt-úroveň a jejich odpovídající řetězce přidružení.
Postup 1. V hlavním navigačním panelu vyberte volby Nástroje > Nástroje tvůrce > Správce přiřazení. 2. V podokně modulu vyberte ten modul, kam plánujete odeslat záznamy pomocí Integrátoru dat. 3. V hlavním podokně vyhledejte a potvrte pravidla přidružení ve sloupci Přidružení.
36
© Copyright IBM Corp. 2011, 2015
Přidání přidružení k hlavičkovým souborům Můžete vytvořit přidružení mezi záznamy, které existují v prostředí produktu IBM TRIRIGA Application Platform, a záznamy, které jsou přeneseny Integrátorem dat. Chcete-li uspořádat tento proces, můžete přidat specifickou informaci pro definování každého přidružení k hlavičkovému souboru oddělených karet.
Informace o této úloze Specifické informace identifikují: v Modul s obchodním objektem, který se použil k vytvoření záznamu, který se přidruží k přeneseným záznamům. v Obchodní objekt, který se použil k vytvoření záznamu, který se přidruží k přeneseným záznamům. v Název přidružení z existujícího záznamu k novým záznamům. Po dokončení přenosu, který využívá propojení přidružení, dva záznamy odráží vztah na kartě Přidružení. Přidružení je vytvořeno "z" existujícího záznamu ve sloupci Přidružit "k" záznamu, který se aktualizuje. Pokud ve Správci přidružení existuje přidružení obchodní objekt-úroveň pro řetězec přidružení, který je uveden ve sloupci Přidružení, odpovídající přidružení se vytvoří v opačném směru. Integrátor dat nelze použít k naplnění sekce smart a jistých typů polí lokátoru. Možná budete muset vytvořit vlastní sled prací pro každý typ přidružení, pro připojení přidruženého záznamu k sekci smart nebo poli lokátoru. Pouhé přidružení dvou záznamů je nezobrazí v sekcích smart nebo polích lokátoru. Výjimkou je sekce dotazů, která využívá stejné přidružení.
Postup 1. Zadejte klíčové slovo Přidružit do nového sloupce hned napravo od posledního sloupce dat. 2. Vložte dva řádky mezi řádek záhlaví a první řádek dat. Data nyní začínají na řádku 4. 3. Na řádku 2 sloupce Přidružení zadejte úplný název obchodního objektu a uzavřete jej do dvojitých symbolů procent. Například %%triPeople:triPeople%%. Tento řádek odráží modul a obchodní objekt záznamu, ze kterých se vytvoří přidružení takto %%Module:BusinessObject%%. 4. Do třetího řádku sloupce Přidružení zadejte řetězec přidružení a uzavřete jej do dvojitých symbolů procent. Například %%Manages%%. Tento řetězec musí být řetězcem přidružení, který je definován v %%Module:BusinessObject%% na řádku 2 do obchodního objektu pro přenášený soubor. 5. Pro každý řádek tabulky ve sloupci Přidružení zadejte název existujícího záznamu, ze kterého se přidruží nový záznam.
Příprava úloh sledu prací pro asociativní přenos Úlohy sledu prací nejsou povinné pro asociativní přenosy, protože asociativní přenos může existovat samostatně, chcete-li vytvořit přidružení. Když ale musí být záznam ve sloupci Přidružení také připojen do sekce smart, Integrátor dat může také se sledem prací zpracovat asociativní přenos.
Informace o této úloze V tomto scénáři dočasný řetězec přidružení ve sloupci Přidružení spustí sled prací, který připojuje záznam do správné sekce přeneseného záznamu nebo mapuje cokoliv jiného. Poté sled prací odebere dočasné přidružení, které je vytvořeno Integrátorem dat, a vytvoří správné Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
37
pomocí mapování záznamu do sekce smart nebo pole lokátoru. Po namapování záznamu systém IBM TRIRIGA automaticky vytvoří správné přidružení mezi záznamy v sekci. Upozornění: Ve vašem sledu prací použijte řetězec přidružení, který momentálně nepoužívá ani jeden z objektů. Tento postup zajistí, že sled prací bude spuštěn jen tehdy, když budou záznamy přidruženy z přenosu, a ne jinou akcí uživatele. Ujistěte se, že použijete řetězec přidružení, který je na seznamu Typů přidružení ve Správci seznamů. V případě potřeby můžete přidat do seznamu vlastní řetězec. Směr přidružení je důležitý. Přidružení je vytvořeno "ze" záznamu ve sloupci Přidružit "k" záznamu, který se aktualizuje nebo aktualizoval. Pokud pro přidružení neexistuje typ objekt-úroveň, který je uveden ve sloupci Přidružení, přidružení se nevytvoří v opačném směru. V tomto scénáři existuje pouze jedno přidružení (a odpovídající událost Přidružení) vytvořené "ze" záznamu organizace "do" přeneseného nebo aktualizovaného záznamu triPeople. Protože pro tento typ přidružení specifikovaného v přenosu Integrátoru dat neexistovalo žádné přidružení typu obchodní objekt-úroveň, v opačném směru není definováno žádné přidružení.
Postup 1. Přezkoumejte soubor Ingtegrátoru dat. V tomto scénáři sloupec Přidružení určuje, že přidružení typu Přidružení přenosu je vytvořeno "ze" záznamu specifikované organizace "do" záznamu triPeople. 2. Pokud soubor Integrátoru dat používá řetězec přidružení, který neexistuje v systému, musíte jej přidat na seznam Typů přidružení ve Správci seznamů. 3. Chcete-li otevřít Správce seznamů, vyberte volby Nástroje > Administrace > Seznamy. 4. V sekci Spravuje vyberte seznam Typy přidružení. Může to trvat déle než minutu, než se tento seznam načte. 5. Zadejte řetězec přidružení ze souboru Integrátoru dat do pole Hodnota. 6. Vyberte volbu Uložit položky. 7. Vytvořte nový sled prací v modulu organizace takto. Počáteční úloha definuje podmínky spuštění pro sled prací. Když je v tomto scénáři záznam organizace přidružen k záznamu triPeople s řetězcem Přidružení přenosu, sled prací se spustí. 8. Nastavte Úpravu úlohy na mapování primárního záznamu sledu prací na sekundární záznam. Jinými slovy primární záznam sledu prací je obchodní objekt počáteční úlohy. Mezitím je sekundární záznam sekundárním obchodním objektem z druhého konce přidružení v počáteční úloze. V tomto scénáři mapujete z Organizace na záznam triPeople, abyste mapovali záznam organizace do sekce smart v záznamu osob. 9. Vyberte volbu Upravit mapování, chcete-li otevřít okno Mapování objektu. 10. Výběrem volby Vymazat vše odeberete všechna mapování polí. Může to trvat několik okamžiků, než se mapování odstraní. 11. Přejděte do spodní části sekce smart triPrimaryOrganization. 12. Vyberte ikonu Vyhledávat. 13. Nastavte sekci na Zdroj. Toto nastavení mapuje záznam zdroje (Organizace) do sekce záznamu cíle (triPeople) a vytvoří odkaz a přidružení pro naplnění sekce smart. 14. Posuňte se zpět nahoru a klepněte na tlačítko OK. 15. Zvolte záznam Záznamy přidružení z podokna Nová úloha. Tato úloha se změní, aby zrušila přidružení další úlohy.
38
© Copyright IBM Corp. 2011, 2015
16. Změňte volbu z Přidružit pomocí na Odebrat přidružení a přidružení na Přidružení přenosu. Tato úloha zruší dočasné přidružení, které se používá ke spuštění tohoto sledu prací, jak je uvedeno v obou souborech Integrátoru dat a Počáteční úloze s oddělenými kartami. 17. Nastavte sekci Kde se nachází přidružený záznam do sekundárního obchodního objektu (což je záznam triPeople). Pokud přenášíte vložené záznamy, úloha zrušení přidružení musí být spuštěna před úlohou upravení (záznam mapování), aby se předešlo duplicitním přidružením. 18. Publikujte svůj sled prací. Možná budete potřebovat vymazat mezipamě sledu prací serveru, pokud je toto prostředí produkčním prostředím.
Přenos dat Můžete přenést data do aplikace produktu IBM TRIRIGA pomocí integrátoru dat, jeden soubor po druhém, nebo v dávkovém režimu. Název souboru, který importujete do integrátoru dat, nesmí překročit 50 znaků.
Načtení dat ručně Po vytvoření hlavičkového souboru, naplnění informacemi o záznamu a uložení jako oddělené karty jste připraveni přenést soubor do Integrátoru dat.
Informace o této úloze Postup je stejný bez ohledu na typ přenosu, který máte spuštěn: Asociační, hierarchický nebo nehierarchický. Jediným požadavkem je zajistit výběr vhodné kombinace Module::BusinessObject::Form. Selhání při výběru vhodných nastavení má za následek selhání přenosu nebo úspěšný přenos záznamu do nesprávného objektu. Když je záznam poprvé vytvořen, je ve speciálním stavu nazvaném null. Záznamy ve stavu null zmizí po dokončení operace, která momentálně používá záznam. Pro Integrátor dat je důležité spustit akci na nově vytvořených záznamech, a odebrat je tak ze stavu null. Pokud akce neodeberete záznamy ze stavu null, záznam okamžitě po vytvoření zmizí. Všechny volby na seznamu Akce jsou akce, které převádí záznamy ze stavu null.
Postup 1. V hlavním navigačním panelu vyberte volby Nástroje > Administrace > Integrátor dat. 2. Ověřte, že hodnoty v polích Modul, Obchodní objekt a Formulář odpovídají hlavičkovému souboru. Hodnota pole Typ importu musí být Přidat. Hodnota Přidat znamená, že pokud řádek obsahuje hodnotu pro pole Název publikace záznamu, která se shoduje s existujícím záznamem, ostatní hodnoty na řádku aktualizují záznam. Pokud řádek obsahuje hodnotu pro pole Název publikace záznamu, která se neshoduje s žádným existujícím záznamem, data v řádku se použijí k vytvoření nového záznamu. 3. Ze seznamu Akce vyberte akci ke spuštění na záznamu, až jej Integrátor dat vytvoří nebo aktualizuje. Tento seznam obsahuje platné akce pro nový záznam, na základě řady přechodu stavů, který používá zvolený obchodní objekt. 4. Pokud se musí sled prací spustit, až Integrátor dat vytvoří záznam, musíte spustit sled prací s dílčí akcí, která je připojena k akci na seznamu Akce. 5. Jediná hodnota Typu souboru jsou oddělené karty (*.txt). Ale ze seznamu Znaková sada souboru vyberte znakovou sadu, ve které byl importovaný soubor napsán. 6. Ověřte, že je zaškrtávací políčko Dávkový přenos prázdné. Zrušení této volby umožní Integrátoru dat číst uvedený datový soubor pouze jednou. 7. Vyberte volbu Procházet, chcete-li najít a otevřít hlavičkový soubor, který jste vytvořili. Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
39
8. Vyberte volbu Přenést soubor. 9. Vyberte volbu OK. Data se načtou z uvedeného souboru. Po dokončení procesu přenosu je odesláno oznámení do sekce Oznámení vašeho domovského portálu. 10. Ověřte, že všechny záznamy byly importovány správně zobrazením souvisejícího portálu nebo stránky.
Přenos dat pomocí dávkových přenosů Pomocí dávkových přenosů můžete automatizovat proces přenosu a naplánovat události, aby produkt IBM TRIRIGA Application Platform automaticky přenesl definovaný soubor v souladu s naplánovanými nastaveními. Tato funkce je užitečná pro automatizaci integrace dat z externího systému, aniž byste potřebovali pevně naprogramované skripty nebo vývoj integrace.
Nastavení dávkového přenosu Soubor TRIRIGAWEB.properties obsahuje nastavení pro dávkový přenos, která definují cesty ke vstupu, zpracování, výstupu, chybám a protokolům souboru. Složky uvedené v parametrech BatchInputLoc, BatchProcessLoc, BatchOutputLoc, BatchErrorLoc a BatchLogLoc v souboru TRIRIGAWEB.properties musí existovat a jejich názvy se musí přesně shodovat. Než naimplementujete dávkové přenosy, spus te skript CreateBatchProcess.bat (Windows), nebo CreateBatchProcess.sh (Linux), v adresáři [instalační adresář aplikace TRIRIGA]\userfiles, abyste vytvořili výchozí adresáře, které jsou zapotřebí k provedení zpracování. Dávkový přenos je obvykle nejlepší volba tehdy, když integrátor dat pravidelně čte datové soubory, které jsou uspořádány stejným způsobem do stejného typu záznamů.
Plánování dávkových přenosů Po vytvoření hlavičkového souboru, naplnění informacemi o záznamu a uložení jako oddělené karty jste připraveni automatizovat proces přenosu a naplánovat dávkové přenosy s Integrátorem dat.
Informace o této úloze Když je záznam poprvé vytvořen, je ve speciálním stavu nazvaném null. Záznamy ve stavu null zmizí po dokončení operace, která momentálně používá záznam. Pro Integrátor dat je důležité spustit akci na nově vytvořených záznamech, a odebrat je tak ze stavu null. Pokud akce neodeberete záznamy ze stavu null, záznam okamžitě po vytvoření zmizí. Všechny volby na seznamu Akce jsou akce, které převádí záznamy ze stavu null. Často zjistíte, že interval mezi spuštěními Integrátoru dat se stejnoměrně dělí do 24 hodin. Pokud tomu tak je, data jsou čtena ze souboru každý den ve stejný čas. Pokud si zvolíte interval, který se stejnoměrně nedělí na 24 hodin, jako např. 5 hodin, data se čtou ze souboru každý den ve stejný čas. Jinými slovy, každý den ve stejný čas, který je uveden v poli Vynulovat hodiny každý den v, jsou naplánována data, která budou načtena z uvedeného souboru. Poté dojde k opětovnému naplánování v uvedeném intervalu. Předpokládejme například, že proces přenosu začíná každý den v 9 hodin ráno. Pokud nastavíte interval na 5 hodin, 0 minut, dávkový proces se spustí v 9 hodin ráno a zvýší se pokaždé o 5 hodin po dalších 24 hodin. Proto se bude spouštět každý den v 9 hodin, 14 hodin, 19 hodin, 24 hodin a 5 hodin. Poté se znovu spustí v 9 hodin se stejným opakováním časových přírůstků.
40
© Copyright IBM Corp. 2011, 2015
Spuštěný agent se spouští přibližně každých 10 sekund. Agent se opakuje přes všechny objekty dávkového zpracování, které se vytváří, a na základě aktuálního času, spouští dávkové objekty ve správnou dobu. Protože je přesný čas, kdy se agent spouští, neznámý, produkt IBM TRIRIGA Application Platform vloží minutovou vyrovnávací pamě na počáteční čas každého časového přírůstku. Pokud se například agent spouští v 9:00:10, proces běží od kontroly platformy mezi 9:00 a 9:01. V příkladu s pětihodinovými přírůstky se spouští dávkové soubory, pokud je aktuální čas mezi 9:00 - 9:01, 14:00 - 14:01, 19:00 - 19:01, 24:00 24:01 a 5:00 - 5:01.
Postup 1. V hlavním navigačním panelu vyberte volby Nástroje > Administrace > Integrátor dat. 2. Ověřte, že hodnoty v polích Modul, Obchodní objekt a Formulář odpovídají hlavičkovému souboru. Hodnota pole Typ importu musí být Přidat. Hodnota Přidat znamená, že pokud řádek obsahuje hodnotu pro pole Název publikace záznamu, která se shoduje s existujícím záznamem, ostatní hodnoty na řádku aktualizují záznam. Pokud řádek obsahuje hodnotu pro pole Název publikace záznamu, která se neshoduje s žádným existujícím záznamem, data v řádku se použijí k vytvoření nového záznamu. 3. Ze seznamu Akce vyberte akci ke spuštění na záznamu, až jej Integrátor dat vytvoří nebo aktualizuje. Tento seznam obsahuje platné akce pro nový záznam, na základě řady přechodu stavů, který používá zvolený obchodní objekt. 4. Pokud se musí sled prací spustit, až Integrátor dat vytvoří záznam, musíte spustit sled prací s dílčí akcí, která je připojena k akci na seznamu Akce. 5. Jediná hodnota Typu souboru jsou oddělené karty (*.txt). Ale ze seznamu Znaková sada souboru vyberte znakovou sadu, ve které byl importovaný soubor napsán. 6. Označte zaškrtávací políčko Dávkový přenos. Pole, která jsou označena Přenést data dávky každých ___ hodin ___ minut, řídí, jak často je Integrátor dat naplánován ke čtení dat. 7. V poli Přenést data dávky každých nastavte časový přírůstek pro intervaly přenosu, které začínají od času v poli Vynulovat hodiny každý den v. Předvolba je 0 hodin a 0 minut. 8. Nastavte hodnotu Vynulovat hodiny každý den v na čas, kdy chcete, aby proces dávkového přenosu začal každý den. Pokud hodnota Vynulovat hodiny každý den v obsahuje hodnotu větší než 24 hodin, k přenosům dojde pouze jednou za den v určený čas v poli Vynulovat hodiny každý den v. 9. Uvete název hlavičkového souboru do pole Název souboru (*.txt). Soubor musí být v adresáři, ve kterém se spouští produkt IBM TRIRIGA Application Platform. Pokud je nalezen označený soubor v odpovídajícím umístění, platforma jej zpracuje a umístí čas zpracování do pole Čas posledního spuštění obchodního objektu Přenos dat. 10. Zadejte adresu potvrzovacího e-mailu. Po každém pokusu, kdy se Integrátor dat pokusí dávkově přenést soubor, se odešle e-mail na uvedenou adresu. Tento e-mail se odešle bez ohledu na to, zda byl přenos úspěšný. 11. Vyberte volbu Přenést soubor. 12. Vyberte volbu OK. Platforma naplánuje přenos uvedeného souboru a pokračuje v plánování přenosu souboru v uvedené intervaly na neurčitou dobu. Data se načtou z uvedeného souboru. Po dokončení každého procesu přenosu, se odešle e-mailové oznámení na adresu potvrzovacího e-mailu. 13. Ověřte, že všechny záznamy byly importovány správně zobrazením souvisejícího portálu nebo stránky.
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
41
Ukončení dávkového přenosu Chcete-li změnit libovolné parametry dávkového přenosu, musíte nejprve ukončit plánování dávkového přenosu a pak vytvořit náhradní dávkový přenos. Na navigačním panelu vyberte volby Nástroje > Nastavení systému > Systém > Přenos dat, abyste odstranili záznamy dávkového přenosu.
Rady pro ovládání integrátoru dat Následující rady můžete použít ke zlepšení způsobu, jakým váš podnik pracuje s nástrojem Integrátor dat produktu IBM TRIRIGA. Tabulka 15. Rady pro ovládání integrátoru dat Rada
Popis
Přidružení existujících záznamy
Jakmile vytvoříte všechny záznamy, znovu použijte soubor záhlaví k vytvoření souboru záhlaví asociativního přenosu. Zavedení přidružení po vytvoření všech záznamů odstraní problémy, které obklopují neexistující záznamy.
Kontrola chyb přenosu dat
Pokaždé, když se integrátor dat spustí a má chyby, vytvoří záznam chyby přenosu dat. Chcete-li najít záznam chyby přenosu dat, vyberte volby Nástroje > Nastavení systému > Systém > Chyba přenosu dat. Posouvejte se záznamy na stránce výsledků. Klepněte na hypertextový odkaz názvu souboru.
Potvrzení prostřednictvím stránky výsledků obchodního objektu
Jakmile data úspěšné vytvoří oznámení, přezkoumejte data prostřednictvím stránky výsledků obchodního objektu. U hierarchických objektů se ujistěte, že se podřízené záznamy objeví pod správným nadřízeným záznamem v okně hierarchie.
Upozornění integrátoru dat
Integrátor dat provádí méně kontrol dat než formulář, kam ručně zadáváte data: v Vytvoří nebo aktualizuje záznamy s chybějícími hodnotami povinných polí. v Umožňuje zadat libovolnou hodnotu do pole seznamu, i když se daná hodnota nenachází na seznamu. v Nespouští vyžadovaná ověřování na hodnotách pole. Pokud přenos výslovně nenastaví organizaci a zeměpisnou oblast jím vytvořených záznamů, zabezpečený přístup k těmto záznamům nemusí být podle očekávání. Možná budete muset zahrnout pole organizace nebo zeměpisné oblasti do záznamů prostých textových souborů, abyste zajistili vhodný zabezpečený přístup k vytvořeným záznamům.
42
Záznamy přenosu dat
Pokaždé, když použijete integrátor dat k zahájení čtení dat, vytvoří záznam přenosu dat. Pokud zahájíte časový plán dávkových přenosů, stále bude existovat pouze jeden záznam přenosu dat. Po dokončení přenosu se můžete dozvědět, jak přenos proběhl, podíváte-li se na záznam přenosu dat, který odpovídá přenosu. Záznam přenosu dat má sekci smart, která obsahuje záznamy chyb přenosu dat. Pokud došlo k jakýmkoli chybám, uvidíte je v sekci smart. Chcete-li najít záznam přenosu dat, vyberte volby Nástroje > Nastavení systému > Systém > Chyba přenosu dat. Posouvejte se záznamy na stránce výsledků. Klepněte na hypertextový odkaz názvu souboru.
Vyčištění složky
Procesy administrace systému pro dávkové přenosy integrátoru dat musí zahrnovat pravidelná vyčištění složek vstupu a protokolů.
© Copyright IBM Corp. 2011, 2015
Tabulka 15. Rady pro ovládání integrátoru dat (pokračování) Rada
Popis
Správa souborů na přenos
Když přenesete soubory v dávkovém režimu, přenos se provede bez přímé účasti osoby. Platforma vyhledá soubory na počítači, na kterém je spuštěná, spíše než na počítači, který používá osoba. Chcete-li identifikovat počítač a adresář, který se používá pro dávkové přenosy dat, možná se budete muset poradit s osobou, která spravuje prostředí produktu IBM TRIRIGA Application Platform ve vaší organizaci. Abyste zajistili řádné zpracování souborů, dodržte následující pravidla ohledně toho, kdy a jak umístit soubor do adresáře ke zpracování: v Než umístíte soubor do adresáře pro dávkový přenos, nejprve zkontrolujte, zda v adresáři již existuje soubor se stejným názvem. Pokud ano, znamená to, že poslední soubor s daným názvem nebyl zpracován. Po zpracování se soubor přesune do jiného adresáře. v Chcete-li zajistit správné zpracování souboru v adresáři, počkejte, dokud soubor nezmizí, než do adresáře umístíte nový soubor se stejným názvem. v Až bude čas vložit soubor do adresáře, neumístěte jej do adresáře tak, že jej zkopírujete z jiného umístění. Problém s kopírováním je ten, že se soubor umístí do adresáře po částech. Jinak řečeno, pokud soubor zkopírujete do adresáře, bude se v adresáři po určitou dobu nacházet pouze část souboru. Pokud se produkt IBM TRIRIGA Application Platform pokusí zpracovat soubor, když soubor není celý v adresáři, nemusí jej zpracovat správně. v Místo toho, abyste souboru zkopírovali do adresáře, umístěte jej někam jinam na stejný systém souborů, kde se nachází adresář. Pak jej přejmenujte nebo přesuňte do adresáře. Když přejmenujete nebo přesunete soubor v rámci stejného systému souborů, neprovede se žádné kopírování souboru. Místo toho se do adresáře přidá položka, která ukazuje na jeho umístění.
Zpracování celé dávky
Je možné mít sled prací, který zpracuje všechny záznamy v dávce po vytvoření nebo aktualizaci jednotlivých záznamů. Jakmile se dokončí přenos souboru se záznamy oddělenými tabulátory, platforma spustí akci Použít na záznamu přenosu dat, který je přidružený k přenosu. Během zpracovávání záznamů se vytvoří přidružení ze záznamu přenosu dat k ovlivněným záznamům. Název přidružení je Stav načtení dat. Můžete použít správce přidružení k nadefinování přidružení s tímto názvem z obchodního objektu Stav načtení dat k druhému příslušnému obchodnímu objektu. Pokud tak učiníte, může sled prací, který spustila akce Použít na záznamu přenosu dat, zpracovat všechny přenesené záznamy. Můžete použít úlohu Načíst sled prací k načtení záznamů, které jsou řazeny podle pořadí jejich hodnot v konkrétním poli. Proto můžete použít libovolné pole v záznamech, chcete-li určit pořadí, ve kterém je sled prací zpracuje.
Deaktivace vzorce, nasčítání a V produkčních prostředích musíte deaktivovat všechny vzorce, sledy prací výpočtu nasčítání a sledy prací výpočtu vůči obchodnímu objektu, než spustíte přenos. Tato procedura zajistí, že se záznamy vytvoří, aniž by byla platforma donucena spustit zbytečné sledy prací vůči dílčím datům. Také pomáhá odstranit zacyklení, které se může vyskytnout u hierarchických objektů. Po úspěšném dokončení přenosu znovu publikujte sledy prací vůči nové datové sadě.
Kapitola 2. Integrace dat s Integrátorem dat produktu TRIRIGA
43
Tabulka 15. Rady pro ovládání integrátoru dat (pokračování) Rada
Popis
Spuštění všech souborů mimo V závislosti na množství přenesených informací může dojít k vytížení špičku prostředků serveru a k poklesu výkonu. Uživatelé si mohou všimnout zpomalení výkonu, což může mít za následek falešnou pozitivitu a volání do střediska podpory. Časování zpracování záznamů Produkt IBM TRIRIGA Application Platform nemusí nutně zpracovat přenesené záznamy ve stejném pořadí, v jakém se objeví v souboru se záznamy oddělenými tabulátory. Přečte data z každého záznamu odděleného tabulátory v posloupnosti a pak použije jiný podproces ke zpracování dat, aby vytvořil nebo aktualizoval záznam. Ve většině případů nezáleží na tom, v jakém pořadí se zpracují záznamy. Pokud musíte zpracovat záznamy dávky ve stejném pořadí, v jakém se čtou, musíte přinutit integrátor dat, aby zpracoval všechny záznamy pomocí stejného podprocesu. Chcete-li provést tuto úlohu, nastavte počet podprocesů, které používá agent importu dat, na hodnotu 1. TRIRIGAWEB.properties pro dávkový přenos
Soubor TRIRIGAWEB.properties obsahuje nastavení souboru pro dávkový přenos, zejména pro vstup, zpracování, výstup, chyby a protokol. Soubor definované v souboru TRIRIGAWEB.properties musí existovat a názvy souborů se musí shodovat.
Přenos záznamů jako prvních
Nepřenášejte soubor integrátoru dat se všemi poli a všemi přidruženími do jednoho souboru. Nejprve vytvořte všechny záznamy pro všechny obchodní objekty. Jakmile naimportujete všechny záznamy, zahajte úlohu přidružení záznamu k sobě navzájem.
Přenesení sad záznamů
Neodesílejte velké množství dat v jediném souboru integrátoru dat. Použijte sady o velikosti 5000 záznamů na jeden soubor integrátoru dat. Tato praktika snižuje počet chyb, které souvisejí s kapacitou paměti a systému.
Přenos obrázků
Musíte-li přiřadit obrázky k nově přeneseným záznamům, můžete použít následující formát. Předpokládejte, že se pole s obrázkem jmenuje triImageIM. triImageIM //Company-1/file123.jpg Název souboru musí začínat na slovo "file", např. filemůjnázevobrázku.jpg nebo file12345.gif. Na základě příkladu musíte soubor umístit do adresáře [instalační adresář aplikace TRIRIGA]\userfiles\Company-1, než přenesete soubor integrátoru dat.
44
© Copyright IBM Corp. 2011, 2015
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA Můžete naimportovat data z externího systému do databáze produktu TRIRIGA pomocí nástroje Správce načtení dat. Proces načítání dat zahrnuje konfiguraci a postupné načítání několika obchodních objektů, poskytuje tak mechanismus k monitorování průběhu načítání dat a identifikování chyb. Následující obrázek ilustruje, jak můžete použít Správce načítání dat k definování interakcí mezi sady načtení dat, položkami načtení dat, integračními objekty a úlohami DataConnect. Můžete také vygenerovat tabulku, která je přizpůsobená pro sady načtení dat. Pomocí tabulky můžete také organizovat a ověřovat svá externí data před tím, než je zavedete do produktu TRIRIGA. TRIRIGA Správce načtení dat
Tabulková data
Sada načtení dat
Document Manager
1:M Položky načtení dat
Úlohy DataConnect
Integrační objekty
1:M Integrační objekt Instance
Šablona tabulek
1:M Instance integrace Záznamy selhání
Poznámka: Správce načtení dat produktu TRIRIGA podporuje pouze ty integrační objekty, které jsou definované pomocí schématu Soubor na DC (DataConnect). Funkce vytváření a přenosu tabulek načtení dat a přidání nových položek načtení dat jsou navrženy speciálně pro integrační objekty, které jsou definované pomocí schématu Soubor na DC. Tyto funkce nefungují pro integrační objekty, které jsou definované pomocí jiných schémat. Jakákoli jiná funkčnost je testována pouze pomocí integračních objektů se schématem Soubor na DC a nemusí fungovat u integračních objektů, které jsou definované pomocí jiných schémat.
Sady načtení dat Sada načtení dat je obchodní objekt TRIRIGA, který se používá k definování seskupení integračních objektů, které jsou zpracovány postupně. Například “Zaměpisná oblast” může být název sady načtení dat, která může obsahovat odkazy na integrační objekty pro “Světový region”, “Zemi”, “Stát” a “Město”. Do sady načtení dat můžete přidat libovolné integrační objekty, které nemusí nutně jakkoliv souviset.
© Copyright IBM Corp. 2011, 2015
45
Následující obrázek ilustruje vztahy mezi sadami načtení dat, položkami načtení dat a integračními objekty.
TRIRIGA Správce načtení dat
Sada načtení dat
1:M Položky načtení dat
Integrační objekty
Vytváření sad načtení dat a položek načtení dat Když vytvoříte nebo vyberete existující sadu načtení dat, musíte nadefinovat položky načtení dat a posloupnost zpracování těchto položek. Sada načtení dat používá položky načtení dat k odkázání na integrační objekty. Sadu načtení dat použijte k mapování dat z externího zdroje na existující obchodní objekty produktu TRIRIGA.
Než začnete Než vytvoříte nové položky načtení dat, musíte nejprve uvést výchozí volby integračního objektu tak, že upravíte integrační objekt Načtení DC - Šablona.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > Integrace > Správce načtení dat > Sady načtení dat. 2. Přidejte sadu načtení dat. 3. Uvete název sady načtení dat a typ procesu. 4. Přidejte existující položky načtení dat, nebo vytvořte nové položky načtení dat, které se zahrnou do sady načtení dat. a. Uvete zaváděcí modul, zaváděcí obchodní objekt, formulář pracovní tabulky a úlohu DataConnect. b. Vytvořte a uložte položku načtení dat. 5. Uvete posloupnost zpracování položek načtení dat. 6. Vytvořte a uložte sadu načtení dat. 7. Zpracujte integraci.
46
© Copyright IBM Corp. 2011, 2015
8. Prozkoumejte chyby.
Zpracování sad načtení dat ve Správci načtení dat Data můžete integrovat do produktu TRIRIGA zpracování několika položek načtení dat z jediného formuláře sady načtení dat nebo zpracováním dat přímo z formuláře položky načtení dat. Položky načtení dat v rámci sad načtení dat jsou zpracovávány postupně. Sada načtení dat je obchodní objekt TRIRIGA, který se používá k definování seskupení integračních objektů, které jsou zpracovány postupně. Zpracování integračního objektu generuje jednu nebo více instancí integračního objektu, úlohy DataConnect a záznamy o selhání instance integračního objektu.
Zpracování dat pomocí formuláře sady načtení dat Data můžete zpravovat ze všech položek načtení dat do sady načtení dat. Datové soubory můžete připojit k položkám načtení dat ke zpracování. Na základě uvedeného typu procesu ke zpracování dojde jedním z následujících způsobů: Zpracování celé sady Postupné zpracování každé položky načtení dat ve stavu "Připraveno" do sady načtení dat. Zpracování sady do selhání Postupné zpracování každé položky načtení dat ve stavu "Připraveno" do sady načtení dat. Zpracování poběží, dokud bu neselže jedna z položek načtení dat, nebo nebude dosaženo konce sady načtení dat. Zpracování další položky Zpracování pouze té položky načtení dat ve stavu "Připraveno" s nejnižším pořadovým číslem. Po dokončení zpracování vyhodno te historii zpracování a protokol selhání zpracování, abyste zobrazili, zda byly záznamy z datových souborů načteny.
Zpracování dat pomocí formuláře položek načtení dat Data můžete zpracovat přímo z jednotlivých položek načtení dat. K položce načtení dat můžete připojit datový soubor, který se zpracuje. Po dokončení zpracování vyhodno te historii zpracování a protokol selhání zpracování, abyste zobrazili, zda byl záznam z datových souborů načten. Následující obrázek ilustruje průběh:
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
47
TRIRIGA Správce načtení dat
Úlohy služby Data Connect
Integrační objekty
1:M Integrační objekt Instance
1:M Instance integrace Záznamy selhání
Generování tabulky ze Správce načtení dat Můžete vygenerovat tabulky načtení dat pro shromáždění a ověření sad načtení dat pro použití v produktu TRIRIGA. Tabulky načtení dat slouží následujícím funkcím: v Poskytnout upravenou tabulku pro sadu načtení dat, která organizuje a ověří vaše externí data, než je přenesete do svého produktu TRIRIGA. v Exportovat existující záznamy z produktu TRIRIGA pomocí tabulky načtení dat. Toto použití vám umožní ověřit existující záznamy vzhledem k externím datům, která jsou přenesena. Následující obrázek ilustruje, jak můžete použít Správce načtení dat ke generování tabulek načtení dat. TRIRIGA Správce načtení dat
Načtení dat tabulky s / bez exportovaných dat
Sada načtení dat
1:M Položky načtení dat
48
© Copyright IBM Corp. 2011, 2015
Document Manager
Načtení dat šablona tabulky součástí produktu
Vytváření tabulek načtení dat Můžete vygenerovat tabulku, která je přizpůsobená pro sadu načtení dat, chcete-li uspořádat a validovat externí data, než je načtete do produktu TRIRIGA. Můžete také vygenerovat tabulku, jež obsahuje existující záznamy, které se již nacházejí v produktu TRIRIGA.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > Integrace > Správce načtení dat > Sady načtení dat. 2. Otevřete záznam sady načtení dat, pro který chcete vytvořit tabulku. 3. Chcete-li exportovat existující záznamy z produktu TRIRIGA do tabulky, označte zaškrtávací políčko Exportovat data ve formuláři v sekci Vytvořit tabulku načtení dat. Data se neexportují do sloupců stavové tabulky DC_... (kromě DC_PATH), sekce smart DataConnect (generováno, když je vybrána volba Používá DataConnect v datovém modeláři), ..._UOM (měrná jednotka) a ..._UOMTYP (typ měrné jednotky). Tyto sloupce stavové tabulky můžete použít k přenosu dat do produktu TRIRIGA. 4. Klepněte na volbu Uložit a pak na volbu Vytvořit. 5. V poli Soubor tabulky klepněte na volbu Zobrazit obsah k zobrazení tabulky.
Výsledky Když si prohlížíte tabulku, má každý obchodní objekt, na který odkazuje sada načtení dat, v tabulce následující listy: Přehled Zahrnuje popis maker a konfigurační data protokolování. Klasifikace Používá se k uložení dat klasifikace. Seznamy Používá se k uložení dat seznamu. Lokátory Používá se k uložení dat lokátoru. Hierarchie objektu Používá se k uložení informací o hierarchických datech. Pole
Používá se k uložení metadat na úrovni pole.
Data
Záhlaví sloupců v datových listech odpovídají polím, jež jsou uvedena v mapování dat integračních objektů, na které odkazuje sada načtení dat.
Makra ověření tabulek načtení dat Šablona tabulky načtení dat zahrnuje sadu maker, která můžete spustit pro ověření dat obchodních objektů, dříve než načtete data do produktu IBM TRIRIGA. Spuštění maker ověření ověří kritéria dat. Při vytvoření tabulky můžete stáhnout soubor, vstupní data a spustit libovolné z maker, které jsou označeny v následující tabulce:
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
49
Tabulka 16. Makra ověření tabulek
50
Makro
Klávesová zkratka
ValidateDataSheet
Spuštění z
Popis
Ctrl-Shift-V
Pole nebo datové listy
Ověří data na jednotlivém listu v sešitu. Použije listy pole k ověření dat, která jsou uvedena v odpovídajícím datovém listu. Všechny podmínky, které jsou uvedeny, budou zkontrolovány. Podrobné chybové zprávy se přidají do sloupce VALIDATION_ERRORS v datovém listu a jsou také přidány do souboru protokolu. Pro datový list se automaticky vygeneruje soubor s oddělenými kartami.
ValidateAllDataSheets
Ctrl-Shift-A
Libovolný list
Ověří data na všech listech v sešitu.
ClearAllValidationErrors
Ctrl-Shift-C
Libovolný list
Vymaže chybové zprávy, které jsou obsaženy ve sloupci VALIDATION_ERRORS všech datových listů.
GenerateTextFile
Ctrl-Shift-T
Datový list
Vygeneruje textový soubor s oddělenými kartami pro datový list. Parametry Jednotka a Cesta, které jsou uvedeny na listu Přehled, se použijí k definování umístění souboru. Výchozí umístění pro soubory je složka C:\TRIRIGA. Pokud tato složka neexistuje, bude vytvořena. Soubor, který je generován, lze použít k načtení dat do produktu TRIRIGA. Generovaný soubor sleduje formát pojmenování:BOName.txt
© Copyright IBM Corp. 2011, 2015
Tabulka 16. Makra ověření tabulek (pokračování) Makro
Klávesová zkratka
Spuštění z
Popis
GenerateDCPathAllSheets
Ctrl-Shift-G
Libovolný list
Generuje hodnoty DC_PATH pro všechny datové listy v sešitu. Používá pole DC_PATH_PARENT pro generování hodnot DC_PATH. Pole DC_PATH_PARENT identifikuje název nadřízeného záznamu pomocí hodnoty pole TRINAMETX v nadřízeném listu. Všechny záznamy v hierarchické cestě musí být zahrnuty do tabulky, abyste vygenerovali DC_PATH. Řádek Nadřízení v odpovídajícím listu polí se používá k určení toho, které listy se mají prohledat pro hodnotu TRINAMETX, která se shoduje s hodnotou ve sloupci DC_PATH_PARENT. List ObjectHierarchy identifikuje kořenový záznam v hierarchii.
HideFieldSheets
Ctrl-Shift-H
Libovolný list
Skryje všechny listy polí v sešitu.
UnHideFieldSheets
Ctrl-Shift-U
Libovolný list
Odkryje všechny listy polí v sešitu.
ConvertDateToUnixFormat
Ctrl-Shift-E
Pole nebo datové listy
Převede všechny hodnoty pole s datem do číselných hodnot UNIX Epoch, které představují datum v počtu milisekund od 1. ledna 1970.
ConvertUnixFormatToDate
Ctrl-Shift-D
Pole nebo datové listy
Převede všechny hodnoty polí s datem, které obsahují číselné hodnoty UNIX Epoch, tzn. počet milisekund od 1. ledna 1970, na odpovídající hodnoty data.
Následující tabulka poskytuje podrobnosti o kritériích, která jsou ověřena při spuštění maker ověření: Tabulka 17. Kritéria ověřená makry ověření tabulek Kritéria
Popis makra
Požadovaná pole
Pokud má vlastnost Požadované uvedená v tabulce pole hodnotu true, makro zkontroluje, zda všechny hodnoty tohoto pole v odpovídajících datových listech nejsou null.
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
51
Tabulka 17. Kritéria ověřená makry ověření tabulek (pokračování) Kritéria
Popis makra
Typ číselného pole
Zkontrolujte, zda všechny hodnoty pro toto pole v odpovídajícím datovém listu obsahují číselné hodnoty.
Datový typ dat
Zkontrolujte, zda všechny hodnoty pro toto pole v odpovídajícím datovém listu obsahují bu platné hodnoty data, nebo platné hodnoty Epoch, tzn. číselné hodnoty větší než 0.
Logický datový typ
Zkontrolujte, zda všechny hodnoty pro toto pole v odpovídajícím datovém listu obsahují logické hodnoty. Makro převede hodnotu sloupce na malá písmena a ověří, že je bu true, nebo false.
Sloupec vyhledání klasifikace existuje
Zkontroluje, zda list Klasifikace obsahuje sloupec s hodnotou záhlaví, která se shoduje s hodnotou Klasifikace na listu Pole.
Hodnota klasifikace
Ověří, že hodnota pole v datovém listu odpovídá hodnotě v odpovídajícím sloupci na listu Klasifikace.
Sloupec vyhledání seznamu existuje
Zkontroluje, zda list Seznamy obsahuje sloupec s hodnotou záhlaví, která se shoduje s hodnotou Seznam na listu Pole.
Hodnota v seznamu
Ověří, že hodnota pole v datovém listu odpovídá hodnotě v odpovídajícím sloupci na listu Seznamy.
Délka textového pole
Zkontrolujte, zda hodnoty pro toto pole překračují velikost, která je uvedena pro velikost pole. Je-li hodnota pole prázdná, validace se neprovede.
Sloupec vyhledání pole lokátoru existuje
Zkontroluje, zda list Lokátory obsahuje sloupec s hodnotou záhlaví, která se shoduje s hodnotou Lokátor na listu Pole.
Hodnota pole lokátoru
Ověří, že hodnota pole v datovém listu odpovídá hodnotě v odpovídajícím sloupci na listu Lokátory.
Klíčové pole pracovní tabulky
Když je hodnota pro klíč pracovní tabulky true pro jedno nebo více polí na listu Pole, makro použije tato pole k vygenerování jedinečného klíče pro každý řádek na datovém listu a identifikuje řádky, které obsahují duplicitní klíč.
Nadřízená hierarchie
Zkontroluje, zda hodnoty DC_PATH na datovém listu jsou uvedeny na jednom z nadřízených datových listů. Nadřízené datové listy jsou identifikovány řádkem Nadřízení v odpovídajícím listu pole. List ObjectHierarchy identifikuje nejvyšší úroveň v hierarchii.
Duplicitní cesty
Zkontroluje všechny záznamy v datovém listu a označí kritéria, kde existuje řádek se stejnou cestou DC Path použitou k načtení tohoto záznamu.
Následující tabulka poskytuje podrobnosti o vlastnostech listu Pole tabulky načtení dat:
52
© Copyright IBM Corp. 2011, 2015
Tabulka 18. Vlastnosti v listu Pole tabulky načtení dat Název vlastnosti
Popis vlastnosti
Sloupec datového listu
Identifikuje název odpovídajícího sloupce záhlaví na datovém listu.
Typ pole
Identifikuje datový typ TRIRIGA.
Velikost pole
Identifikuje maximální velikost pro další pole. Hodnota je prázdná pro všechna ostatní pole.
Klasifikace
Identifikuje název klasifikace a jedinečný identifikátor. Formát je classificationName:identifier.
Seznam
Identifikuje jedinečný identifikátor pro tento seznam.
Povinné
Hodnota true označuje, že je toto pole povinné.
Klíč pracovní tabulky
Hodnota true označuje, že toto pole je klíčem stavové tabulky.
Lokátor
Identifikuje název lokátoru a jedinečný identifikátor. Formát je locatorName: identifier.
Nadřízení
Identifikuje všechny potenciální nadřízené formuláře pro tento obchodní objekt. Hodnoty jsou k dispozici pouze tehdy, pokud modul obsahuje hierarchická data.
Zpracování a načtení ukázkových dat pomocí Správce načtení dat Sady načtení ukázkových dat a integrační objekty jsou součástí produktu TRIRIGA. Ukázky můžete upravit a použít je k načtení zeměpisné oblasti, lokality, organizace, osob, specifikací a dat portfolia aktiv. Každá sada načtení ukázkových dat odkazuje na několik ukázkových integračních objektů. Každý integrační objekt obsahuje ukázkový soubor dat s daty záhlaví a několik řádků ukázkových dat, která se shodují s mapováním dat. Úlohy služby DataConnect a sledy prací jsou také součástí pro každý typ dat.
Zpracování ukázkových dat Můžete zpracovat ukázková načtení dat, která jsou zahrnutá v produktu TRIRIGA. Pak můžete načíst tato ukázková data pomocí aplikace Sady načtení dat ve Správci načtení dat.
Než začnete Chcete-li načíst ukázková data, musíte nejprve zpracovat ukázková načtení dat, která jsou zahrnutá v produktu.
Postup 1. “Konfigurace ukázkových dat” na stránce 54 načtených ukázkových sad a integračních objektů zahrnutých v produktu a můžete použít datový modelář ke konfiguraci pracovních tabulek. 2. “Úprava zdroje dat” na stránce 54, chcete-li zahrnout pověření pro lokální databázi produktu TRIRIGA. 3. “Implementace změn načtení dat” na stránce 54 do položek načtení dat, které chcete načíst do produktu TRIRIGA. 4. “Načtení ukázkových dat” na stránce 55 pomocí aplikace Sady načtení dat. Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
53
Konfigurace ukázkových dat Můžete nakonfigurovat ukázkové sady načtení sad a integrační objekty zahrnuté v produktu a můžete použít datový modelář ke konfiguraci pracovních tabulek.
Než začnete Chcete-li zajistit, že agent DataConnect Agent efektivně načte ukázková data ze stavových tabulek, administrátor aplikačního serveru produktu TRIRIGA může upravit soubor TRIRIGAWEB.properties a nastavit vlastnost DATACONNECT_SLEEP_TIME = -10. Změna vlastnosti nakonfiguruje agenta DataConnect Agent, aby kontroloval ukázková data každých 10 sekund, což je nejkratší podporovaný interval.
Postup 1. Přejděte na nabídku Nástroje > Nástroje tvůrce > Datový modelář. 2. Nakonfigurujte každý integrační objekt, který chcete zpracovat. a. Vyberte přidružený obchodní objekt. b. V datovém modeláři vyberte volbu Nástroje > Revidovat obchodní objekt. Revidujte přidružený obchodní objekt nastavením vlastnosti Stavová tabulka na volbu DataConnect a uložte obchodní objekt. c. Na Seznamu polí identifikujte a vyberte pole obchodního objektu, které se přidají nebo odeberou z pracovní tabulky. U každého pole vyberte nebo zrušte výběr vlastnosti Pole pracovní tabulky a uložte pole. d. Vyberte volby Nástroje > Publikovat obchodní objekt v rámci okna datového modeláře, abyste publikovali objekt a vytvořili nebo upravili pracovní tabulku.
Úprava zdroje dat Můžete upravit zdroj dat, chcete-li zahrnout pověření pro lokální databázi produktu TRIRIGA.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > Integrace > Správce načtení dat > Zdroje dat. 2. Vyberte zdroj dat DB-DataLoad a upravte pověření databáze. 3. Vyberte odkaz Otestovat připojení k databázi, abyste ověřili, že se můžete úspěšně připojit k databázi pomocí upravených pověření. 4. Uložte a zavřete, abyste použili změny na tento zdroj dat a na existující integrační objekty, které uvádějí tento zdroj dat.
Implementace změn načtení dat Můžete upravit položky načtení dat, které chcete načíst do produktu TRIRIGA. Úpravy mohou zahrnovat změny zdrojů dat, mapování dat a datových souborů.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > Integrace > Správce načtení dat > Sady načtení dat. 2. Vyberte sadu načtení dat, kterou chcete upravit. 3. Přidejte nebo odeberte položky načtení dat ze sady načtení dat. 4. Vyberte položku načtení dat, kterou chcete upravit. 5. Vyberte pole Integrační objekt, abyste upravili položku načtení dat. 6. V sekci Zdroj dat ve formuláři integračního objektu vyberte odkaz Otestovat připojení k databázi, abyste ověřili, že existuje pracovní tabulka. 7. Na kartě Mapování dat přidejte nebo odeberte pole.
54
© Copyright IBM Corp. 2011, 2015
8. Uložte a zavřete integrační objekt. 9. Na kartě Podrobnosti formuláře položky načtení dat stáhněte a upravte soubor, který je uložený v poli Datový soubor. 10. Přeneste změněný soubor.
Načtení ukázkových dat Můžete načíst ukázková data, včetně zeměpisné oblasti, lokality, organizace, osob, specifikací a dat portfolia aktiv, pomocí aplikace Sady načtení dat.
Postup 1. Přejděte do nabídky Nástroje > Nastavení systému > Integrace > Správce načtení dat > Sady načtení dat. 2. Vyberte sadu načtení dat, která obsahuje integrační objekty, jež chcete zpracovat. 3. Vyberte typ procesu. 4. Klepněte na volbu Zpracovat, abyste spustili integrační objekty, které obsahuje sada načtení dat.
Jak pokračovat dále Chcete-li získat další informace o načtení ukázkových dat, můžete provést následující akce: v Obnovte sekci Položky načtení dat, abyste si zobrazili aktualizovaný stav každé položky načtení dat. v Obnovte sekci historie procesu, abyste si zobrazili podrobný stav zpracování. Když úspěšně načtete jeden nebo více záznamů do pracovní tabulky, vytvoří se úloha DataConnect a záznamy zpracuje agent DataConnect. v Vyberte kartu Úlohy DataConnect, abyste si zobrazili seznam zpracovaných úloh. Alternativně použijte konzolu administrátora k zobrazení stavu úlohy. v Vyberte kartu Protokol selhání zpracování, abyste si zobrazili všechny chyby identifikované během validace.
Ukázková data portfolia TRIRIGA poskytuje sadu načtení dat a ukázková data portfolia integračního objektu pro použití ve Správci načtení dat. Následující tabulka poskytuje podrobnosti o dostupných sadách načtení dat a ukázkových datech portfolia integračního objektu: Tabulka 19. Ukázková data portfolia integračního objektu Název sady načtení dat
Datový typ
Název integračního objektu
Zeměpisná oblast
Světové regiony
DC - Zeměpisná oblast triWorldRegion
Země
DC - Zeměpisná oblast triCountry
Státy
DC - Zeměpisná oblast - triState
Regiony
DC - Zeměpisná oblast triRegion
Metropolitní území
DC - Zeměpisná oblast triMetropolitanArea
Okresy
DC - Zeměpisná oblast triCounty
Města
DC - Zeměpisná oblast - triCity
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
55
Tabulka 19. Ukázková data portfolia integračního objektu (pokračování) Název sady načtení dat
Datový typ
Název integračního objektu
Lokalita
Vlastnost
DC - Lokalita - triProperty
Budovy
DC - Lokalita - triBuilding
Pozemek
DC - Lokalita - triLand
Podlaží
DC - Lokalita - triFloor
Prostor
DC - Lokalita - triSpace
Moje společnost
DC - Organizace triMyCompany
Útvary
DC - Organizace - triDivision
Oddělení
DC - Organizace - triDepartment
Externí společnosti
DC - Organizace triExternalCompany
Pracovní skupiny
DC - Organizace - triWorkGroup
Zaměstnanci
DC - triPeople - triEmployee
Konzultanti
DC - triPeople - triConsultant
Externí kontakty
DC - triPeople triExternalContact
Vybavení budov
DC - triSpecification triBuildingEquipmentSpec
Spotřební materiál
DC - triSpecification triConsumablesSpec
Příslušenství
DC - triSpecification triFixtureSpec
Vybavení stravovací služby
DC - triSpecification triFoodServiceEquipmentSpec
Nábytek
DC - triSpecification triFurnitureSpec
Vybavení kanceláře
DC - triSpecification triOfficeEquipmentSpec
Vybavení místa prodeje
DC - triSpecification triPointofSaleEquipmentSpec
Zabezpečení
DC - triSpecification triSecurityEquipmentSpec
Služby
DC - triSpecification triServicesSpec
Standardy prostoru
DC - triSpecification triSpaceStandardSpec
Technologie
DC - triSpecification triTechnologyAssetsSpec
Telefony
DC - triSpecification triTelephoneSpec
Nástroje & Testovací vybavení
DC - triSpecification triToolsandTestEquipmentSpec
Vozidla
DC - triSpecification triVehicleSpec
Organizace
Osoby
Specifikace
56
© Copyright IBM Corp. 2011, 2015
Tabulka 19. Ukázková data portfolia integračního objektu (pokračování) Název sady načtení dat
Aktivum
Přidružení správy prostoru
Datový typ
Název integračního objektu
zásuvky na pracovišti
DC - triSpecification triWorkAreaOutletsSpec
Vybavení budov
DC - triAsset triBuildingEquipment
Příslušenství
DC - triAsset - triFixture
Vybavení stravovací služby
DC - triAsset triFoodServiceEquipment
Nábytek
DC - triAsset - triFurniture
Vybavení kanceláře
DC - triAsset triOfficeEquipment
Vybavení místa prodeje
DC - triAsset triPointofSaleEquipment
Zabezpečení
DC - triAsset triSecurityEquipment
Technologie
DC - triAsset triTechnologyAssets
Telefony
DC - triAsset - triTelephones
Nástroje & Testovací vybavení
DC - triAsset triToolsandTestEquipment
Vozidla
DC - triAsset - triVehicles
zásuvky na pracovišti
DC - triAsset triWorkAreaOutlets
Přidružení
DC - Přidružení triSpaceAllocation triSpaceLevelAllocation Přidružení – Lokátory
Přidružení
DC - Přidružení - triPeople triEmployee - Má primární lokalitu \ primární organizaci Sekce Smart
Přidružení
DC - Přidružení - Datové obslužné programy triPeopleReportsToDTO - Hlásí se - DTO
Kapitola 3. Integrace dat se Správcem načtení dat produktu TRIRIGA
57
58
© Copyright IBM Corp. 2011, 2015
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čí.
© Copyright IBM Corp. 2011, 2015
59
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.
60
© Copyright IBM Corp. 2011, 2015
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í.
Upozornění
61
62
© Copyright IBM Corp. 2011, 2015
Vytištěno v Dánsku společností IBM Danmark A/S.