Budowanie aplikacji dla IBM TRIRIGA Application Platform 3

Transkrypt

IBM TRIRIGA Application Platform
Wersja 3 Wydanie 4.2
Budowanie aplikacji dla
IBM TRIRIGA Application Platform:
Zarządzanie danymi
Uwaga
Przed użyciem niniejszych informacji i produktu, którego one dotyczą, należy zapoznać się z treścią sekcji “Uwagi” na stronie 63.
Niniejsze wydanie dotyczy wersji 3, edycji 4, modyfikacji 2 produktu IBM TRIRIGA Application Platform oraz wszystkich
kolejnych edycji i modyfikacji, dopóki w nowych wydaniach nie zostanie wskazana inna wersja i edycja.
© Copyright IBM Corporation 2011, 2015.
Spis treści
Rozdział 1. Integracja danych z
narzędziem TRIRIGA DataConnect . . . 1
Przegląd procesu TRIRIGA DataConnect . . . . . . 1
Pakiety migracji obiektów . . . . . . . . . . 1
Ustawienia tabeli pomostowej . . . . . . . . 2
Publikowanie obiektów biznesowych . . . . . 3
Usuwanie obiektu biznesowego . . . . . . . 3
Obiekty biznesowe zadania . . . . . . . . . 3
Mechanizmy umożliwiające przenoszenie danych do
tabel . . . . . . . . . . . . . . . . 4
Pola tabeli pomostowej. . . . . . . . . . 5
Pola tabeli DC_JOB . . . . . . . . . . 7
Mapy ETL . . . . . . . . . . . . . 9
Przepływy pracy umożliwiające przenoszenie danych do
rekordów . . . . . . . . . . . . . . . 9
Ustawienia zadania w przepływie pracy . . . . 10
Wywołania przepływu pracy. . . . . . . . 13
Sprawdzenie poprawności danych w środowisku
wykonawczym . . . . . . . . . . . . 13
Statusy iteracji . . . . . . . . . . . . 13
Dane tymczasowe . . . . . . . . . . . 14
Agent DataConnect . . . . . . . . . . 19
Przetwarzanie przepływu pracy . . . . . . . 19
Agent czyszczenia . . . . . . . . . . . . 20
Powszechne problemy z narzędziem DataConnect . . . 21
Obsługa narzędzia DataConnect – porady . . . . . . 24
narzędziem TRIRIGA Data Integrator . . 27
Przegląd procesu TRIRIGA Data Integrator . . . .
Typy pól . . . . . . . . . . . . .
Wymagania . . . . . . . . . . . . .
Wymagania funkcjonalne . . . . . . .
Wymagania dotyczące użyteczności . . . .
Pliki danych oddzielane tabulatorami . . . . .
Pliki nagłówkowe . . . . . . . . . .
Pliki nagłówkowe dla modułów innych niż
hierarchiczne . . . . . . . . . . .
Pliki nagłówkowe dla modułów hierarchicznych .
Tworzenie plików nagłówkowych . . . . . . .
Wysyłanie powiązane - przygotowanie. . . . . .
© Copyright IBM Corp. 2011, 2015
.
.
.
.
.
.
.
27
28
33
33
34
35
36
.
.
.
.
37
37
37
39
Łańcuchy powiązania . . . . . . . . . . .
Identyfikowanie powiązań . . . . . . . . .
Weryfikowanie reguł powiązań . . . . . . . .
Dodawanie powiązań do plików nagłówkowych . . .
Przygotowanie zadania w przepływie pracy - wysyłanie
powiązane . . . . . . . . . . . . . .
Wysyłanie danych . . . . . . . . . . . . .
Ręczne wysyłanie danych . . . . . . . . .
Wsadowe wysyłanie danych . . . . . . . . .
Ustawienia wysyłania wsadowego . . . . . .
Planowanie operacji wysyłania wsadowego . . .
Przerwanie wysyłania wsadowego . . . . . .
Obsługa narzędzia Data Integrator – porady . . . . .
39
39
39
40
40
42
42
43
43
43
45
45
Menedżerem ładowania danych
TRIRIGA . . . . . . . . . . . . . . 49
Zestawy ładowania danych . . . . . . . . .
Tworzenie zestawów ładowania danych i pozycji
ładowania danych . . . . . . . . . . .
Przetwarzanie zestawów ładowania danych w
Menedżerze ładowania danych . . . . . . .
Generowanie arkuszy kalkulacyjnych z poziomu
Menedżera ładowania danych . . . . . . . .
Tworzenie arkusza kalkulacyjnego ładowania danych
Makra sprawdzające poprawność arkuszy
kalkulacyjnych ładowania danych . . . . .
Przetwarzanie i ładowanie przykładowych danych za
pomocą Menedżera ładowania danych . . . . . .
Przetwarzanie przykładowych danych . . . . .
Konfigurowanie przykładowych danych . . .
Modyfikowanie źródła danych . . . . . .
Implementowanie zmian ładowania danych . .
Ładowanie przykładowych danych . . . . .
Przykładowe dane portfela . . . . . . . .
. 49
. 50
. 51
. 52
53
. 54
.
.
.
.
.
.
.
58
58
58
59
59
60
60
Uwagi . . . . . . . . . . . . . . . 63
Strategia ochrony prywatności .
Znaki towarowe . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 65
. 65
iii
iv
Rozdział 1. Integracja danych z narzędziem TRIRIGA
DataConnect
Istnieje możliwość zaimportowania danych z systemu zewnętrznego do bazy danych IBM®
TRIRIGA z tabelami pomostowymi i zadaniami przepływu pracy, używając narzędzia
DataConnect.
Przegląd procesu TRIRIGA DataConnect
IBM TRIRIGA DataConnect to narzędzie do importowania danych zewnętrznych do bazy
danych IBM TRIRIGA. Jest ono przydatne do wstępnego wczytywania danych oraz
wsadowego wstawiania i aktualizowania danych w określonych cyklach.
Za pomocą narzędzia DataConnect można zapisać dane ze źródła zewnętrznego bezpośrednio
w tabelach pomostowych produktu IBM TRIRIGA. Następnie przy użyciu przepływów pracy
można przetwarzać dane w celu wstawienia do obiektów biznesowych IBM TRIRIGA.
Oprócz przekazywania danych możliwe jest również przechowywanie danych w tabelach
języków.
Implementacja procesu DataConnect składa się z następujących kroków podstawowych:
v Przygotuj tabele pomostowe przeznaczone dla obiektów biznesowych, które zostaną
wypełnione lub zaktualizowane z użyciem źródła zewnętrznego.
v Przygotuj obiekt biznesowy sterowania zadaniem DataConnect. Obiekt biznesowy steruje
instancją integracji.
v Przygotuj mechanizmy przenoszenia danych ze źródła zewnętrznego do odpowiednich
tabel pomostowych obiektów biznesowych i tabeli sterowania zadaniem DataConnect.
Można używać map ETL lub SQL.
v Przygotuj zadania przenoszenia danych z tabel pomostowych obiektu biznesowego do
nowych lub zaktualizowanych rekordów. Przepływy robocze zainicjowane przez agenta
DataConnect mogą również służyć do sprawdzania poprawności danych wejściowych oraz
implementowania innej logiki biznesowej.
Pakiety migracji obiektów
W zależności od wersji aplikacji IBM TRIRIGA niektóre pakiety migracji obiektów
DataConnect należy zastosować w aktualizacjach. Te pakiety to: triDataConnectJob.zip,
triDataConnectJobLog.zip. Znajdują się one w katalogu instalacyjnym IBM TRIRIGA w
folderze \userfiles\upgrades.
Jeśli w module triDataConnectJob obiekt biznesowy triDataConnectJob nie jest dostępny
podczas instalacji, należy zastosować pakiet migracji obiektów triDataConnectJob. Jeśli w
module triLog obiekt biznesowy triDataConnectJobLog nie jest dostępny podczas instalacji,
należy zastosować pakiet migracji obiektów triDataConnectJob.
Narzędzie DataConnect współpracuje z bazą danych aplikacji TRIRIGA 8.x. Po
zaimportowaniu pakietu migracji obiektów triDataConnectJob pole triCreatedBy jest puste.
Ten warunek nie stanowi problemu i nie można go modyfikować. Agent DataConnect
wypełnia pola za pomocą nazwy użytkownika IBM TRIRIGA pobranej z wpisu zadania
DataConnect.
1
Ustawienia tabeli pomostowej
Aby z obiektem biznesowym powiązać tabelę pomostową, właściwość Zawiera tabelę
przemieszczania obiektu biznesowego musi być włączona. Ponadto pola w obiekcie
biznesowym muszą być określone jako pola tabeli pomostowej – właściwość Pole tabeli
pomostowej musi być włączona. Opublikowanie obiektu biznesowego powoduje
zdefiniowanie tabeli pomostowej lub jej zaktualizowanie. Obiekt biznesowy może zawierać
tylko jedną tabelę pomostową.
Obiekty biznesowe z tabelami pomostowymi
W IBM TRIRIGA Konsoli administratora należy wybrać obiekt zarządzany DataConnect, a
następnie Obiekty biznesowe z tabelami pomostowymi, aby wyświetlić listę obiektów
biznesowych z tabelami pomostowymi.
Aby wyświetlić pola tabeli pomostowej dla określonego wpisu, należy wybrać pozycję i
kliknąć przycisk Rozwiń dane. W kolumnie Pola będzie widoczna nazwa IBM TRIRIGA
pola, myślnik i nazwa bazy danych pola. Jeśli pole jest polem kluczowym używanym do
wykonywania operacji wstawiania/aktualizacji, nazwa pola zawiera znak gwiazdki. Klucze
sekcji inteligentnej DataConnect wyświetlają nazwę sekcji, po której następuje nazwa pola.
Definicje pól są przydatne do określenia odpowiednich pól tabeli pomostowej dla danych
przychodzących. Więcej informacji zawiera dokumentacja IBM TRIRIGA Application
Platform 3 — Podręcznik użytkownika konsoli administratora.
Zawiera tabelę pomostową
Właściwość Zawiera tabelę pomostową identyfikuje obiekty biznesowe, w przypadku
których w programie IBM TRIRIGA jest dostępna tabela pomostowa. Jeśli właściwość jest
włączona, a obiekt biznesowy jest opublikowany, tabela pomostowa jest aktualizowana lub
tworzona. Jeśli właściwość jest wyłączona, a obiekt biznesowy jest opublikowany, proces
publikowania usuwa tabelę pomostową (o ile tabela istnieje). Domyślnie właściwość Zawiera
tabelę pomostową jest wyłączona.
Po wprowadzeniu obiektu biznesowego z użyciem procedury migracji obiektu, podczas której
obiekt biznesowy zostaje opublikowany, tabela pomostowa jest tworzona dla obiektu
biznesowego, w przypadku którego określono właściwość Zawiera tabelę pomostową.
Pole tabeli pomostowej
Właściwość Pole tabeli pomostowej identyfikuje pola przeznaczone do uwzględnienia w
tabeli pomostowej obiektu biznesowego. Jeśli właściwość jest włączona, pole jest
uwzględniane w tabeli pomostowej. Zmiany wprowadzane we właściwości po utworzeniu
tabeli pomostowej nie są odzwierciedlane w tabeli do momentu ponownego opublikowania
obiektu biznesowego. Domyślnie właściwość Pole tabeli pomostowej jest wyłączona, o ile nie
jest ono wymagane.
Właściwość Pole tabeli pomostowej jest obsługiwana w przypadku następujących typów pól:
Wartość logiczna (Boolean), Obiekt biznesowy, Klasyfikacja, Kolor, Data, Data i godzina,
Czas trwania, Lista, Lokator, Numer, Hasło, Tekst, Czas, JM i URL. Tylko pola w sekcji
Ogólne można określić jako pola tabeli pomostowej. Pól w sekcji inteligentnej nie można
dodać do tabeli pomostowej. W przypadku wszystkich wymaganych pól właściwość Pole
tabeli pomostowej jest włączona.
Jeśli właściwość Pole tabeli pomostowej zostanie określona dla pola numerów, które w
obiekcie biznesowym jest powiązane z polem JM, właściwość Pole tabeli pomostowej
należy również określić dla pola JM. Właściwość Pole tabeli pomostowej należy także
2
określić dla powiązanej JM, jeśli importowana JM różni się od bazowej JM. Przykładowo:
jeśli bazową JM powierzchni jest stopa kwadratowa, a importowaną JM jest akr, to
właściwość Pole tabeli pomostowej należy określić dla importowanej JM.
W tabelach pomostowych można również uwzględnić wartości sformatowane Data, Data i
godzina, Czas trwania i Czas. Jeśli właściwość dla tych pól formatu DataConnect zostanie
włączona, dane pola zostaną uwzględnione w tabeli pomostowej. Do nazwy pola w tabeli
pomostowej jest dołączany ciąg _F. Przykładowo: jeśli właściwośćPole tabeli pomostowej w
przypadku pola daty o nazwie TRIDATEDA zostanie włączona, to w tabeli pomostowej
zostanie uwzględnione pole TRIDATEDA_F. Format tych pól jest uzależniony od
skonfigurowanych preferencji użytkownika. Nie ma obowiązku stosowania pól formatu. Aby
uwzględnić pola formatu w tabeli pomostowej, należy opublikować obiekt biznesowy w celu
zastosowania zmian.
Klucz tabeli pomostowej
Właściwość Klucz tabeli pomostowej identyfikuje pola przeznaczone do użycia jako klucze
pozwalające na wyszukiwanie rekordów za pomocą czynności Wstaw/aktualizuj lub
Aktualizuj. Ta właściwość nie jest używana w przypadku czynności Wstaw. Domyślnie
właściwość Klucz tabeli pomostowej jest wyłączona. Można ją wybrać tylko po zaznaczeniu
właściwości Pole tabeli pomostowej.
Właściwość Klucz tabeli pomostowej jest obsługiwana w przypadku następujących typów
pól: Wartość logiczna (Boolean), Obiekt biznesowy, Klasyfikacja, Kolor, Data, Data i
godzina, Czas trwania, Lista, Lokator, Numer, Hasło, Tekst, Czas, JM i URL.
Publikowanie obiektów biznesowych
Wybranie czynności Publikuj OB w odniesieniu do obiektu biznesowego zawierającego
włączoną właściwość Zawiera tabelę pomostową powoduje wyzwolenie określonych
mechanizmów kontrolnych. Jeśli istnieją zadania w stanie Przetwarzanie lub Gotowy
korzystające z tabeli pomostowej i obiektu biznesowego, operacja publikowania kończy się
niepowodzeniem, a użytkownik otrzymuje komunikat informacyjny.
Operacja publikowania obiektu biznesowego jest obsługiwana przez agenta i nie jest
czynnością natychmiastową. Więc agent obsługujący publikowanie ponownie sprawdza
zadanie, kontrolując, czy nowe zadanie nie zostało uruchomione lub czy stan istniejących
zadań nie uległ zmianie. Jeśli istnieją zadania w stanie Przetwarzanie lub Gotowy
korzystające z tabeli pomostowej i obiektu biznesowego, operacja publikowania obiektu
biznesowego kończy się niepowodzeniem. Następnie system IBM TRIRIGA przesyła
powiadomienie i zapisuje w pliku server.log szczegóły dotyczące niepowodzenia publikacji.
Usuwanie obiektu biznesowego
Wybranie czynności Usuń OB w odniesieniu do obiektu biznesowego zawierającego
włączoną właściwość Zawiera tabelę pomostową powoduje wyzwolenie określonych
mechanizmów kontrolnych. Jeśli istnieje zadanie w stanie Przetwarzanie korzystające z tabeli
pomostowej i obiektu biznesowego, operacja usuwania kończy się niepowodzeniem, a
użytkownik otrzymuje komunikat informacyjny. Jeśli istnieje zadanie w stanie Oczekiwanie,
obiekt biznesowy i tabela pomostowa zostaną usunięte, a stan zadania zostanie zmieniony na
Przestarzałe.
Obiekty biznesowe zadania
Tabela Sterowanie zadaniem DataConnect (DC_JOB) zarządza zadaniami obsługującymi
przenoszenie danych z tabel pomostowych do bazy danych IBM TRIRIGA. Dla każdego
procesu integracji musi istnieć obiekt biznesowy w module triDataConnectJob. Obiekt
biznesowy w module triDataConnectJob jest tworzony tylko raz dla danego procesu
integracji.
Rozdział 1. Integracja danych z narzędziem TRIRIGA DataConnect
3
Każdy proces integracji wymaga obiektu biznesowego Sterowanie zadaniem DataConnect.
Przykładowo: podczas wypełniania zamówień ze źródła zewnętrznego obiektem biznesowym
Sterowania zadaniem DataConnect może być obiekt biznesowy cstPurchaseOrderJob.
Następnie w procesie mogą zostać pobrane dane dla obiektów biznesowych
cstPurchaseOrderBody i cstPurchaseOrderLine (w obydwu obiektach właściwość Zawiera
tabelę pomostową jest włączona).
Ogólny proces tworzenia obiektu biznesowego jest następujący:
v Otwórz moduł triDataConnectJob za pomocą Projektanta danych.
v Utwórz obiekt biznesowy w module triDataConnectJob.
Po utworzeniu nowego obiektu biznesowego można utworzyć formularz i opracować
poruszanie się w menu dla obiektu biznesowego. Produkt DataConnect jest wyposażony w
formularz podstawowy i menu podstawowe przeznaczone do stosowania w przypadku
podstawowego obiektu biznesowego triDataConnectJob.
Przejścia między stanami w nowych obiektach biznesowych są dziedziczone z podstawowego
obiektu biznesowego i nie można ich modyfikować. Podstawowy obiekt biznesowy
triDataConnectJob umożliwia przechodzenie między następującymi stanami:
v Null -> triDCStartProcessing -> W przetwarzaniu
v W przetwarzaniu -> triDCCompleted -> Ukończony
v W przetwarzaniu -> triDCFailed -> Niepowodzenie
Wszystkie pola w pierwszej części służą tylko do odczytu. Druga część zawiera rekordy
dziennika odnoszące się do tego zadania DataConnect. Rekordy dziennika to rekordy
triDataConnectLog w triLog. Klikając pozycję wiersza, można wyświetlić szczegóły
dotyczące tego zdarzenia. Domyślnie w drugiej części wyświetlane są problemy występujące
podczas działania narzędzia DataConnect. Jednak po wybraniu pozycji Środowisko
wykonawcze DataConnect w obiekcie zarządzanym Rejestrowanie platformy w IBM
TRIRIGA konsoli administratora w drugiej części również wyświetlane są informacje o
rekordach, które zostały wstawione lub zaktualizowane.
Poziomy rejestrowania w przypadku różnych argumentów są określane przez ustawienia
dziennika platformy oraz ustawienia log4j na serwerze, na którym pracuje agent. W narzędziu
DataConnect używane są dwa agenty. Pierwszy z nich to agent DataConnect tworzący obiekty
zadań i przekazujący je asynchronicznie do Agenta przepływu pracy za pośrednictwem
zdarzenia. Jego działanie się kończy po utworzeniu obiektu zadania i przesłaniu zdarzenia.
Drugi agent (Agent przepływu pracy) obsługuje logikę biznesową (przepływy pracy), a
następnie zadania DataConnect tworzące i aktualizujące obiekty w bazie danych IBM
TRIRIGA. Aby wyświetlić raporty dotyczące obiektów zadań, gdy nie występują problemy,
należy określić rejestrowanie środowiska wykonawczego DataConnect na serwerze agenta
przepływu pracy. Skonfigurowanie tego ustawienia na serwerze agenta DataConnect nie
zapewnia żadnych wyników, ponieważ agent przepływu pracy obsługuje przepływ pracy oraz
operacje tworzenia i aktualizacji obiektów z tabel pomostowych.
Mechanizmy umożliwiające przenoszenie danych do tabel
Użytkownik musi zapewnić mechanizm (za pomocą narzędzia ETL lub bezpośredniej
instrukcji SQL) umożliwiający przenoszenie danych ze źródła zewnętrznego do właściwych
tabel w bazie danych IBM TRIRIGA. Te tabele obejmują tabele pomostowe obiektów
biznesowych i tabelę sterowania zadaniem DataConnect.
Mechanizm musi utworzyć unikatowy numer zadania w celu zapewnienia odniesienia w
tabeli sterowania zadaniem DataConnect oraz tabelach pomostowych obiektu biznesowego.
Ponadto mechanizm może obejmować co najmniej jedną korelację i kolejne liczby.
4
Wartość numeru zadania nie ma żadnego znaczenia, jednak mysi to być niepowtarzalny
identyfikator. Jeden ze sposobów utworzenia numeru zadania polega na użyciu generatora
niepowtarzalnych identyfikatorów globalnych (GUID) lub uniwersalnie niepowtarzalnych
identyfikatorów (UUID). Następnie można przeprowadzić próbę wstawienia wpisu w tabeli
sterowania zadaniem DataConnect ze stanem Nowy. Jeśli próba zakończy się pomyślnie, tego
numeru zadania można używać w przypadku wpisów zapisanych w tabelach pomostowych.
Jeśli próba zakończy się niepowodzeniem i zostanie wyświetlony błąd dotyczący
powielonego klucza, należy wygenerować kolejny identyfikator GUID/UUID/FUID i
spróbować ponownie.
Można użyć narzędzia Spoon pochodzącego z Adobe Kettle. Ta metoda jest podobna do
sposobu używania przez produkty IBM TRIRIGA Workplace Performance Management i
IBM TRIRIGA Real Estate Environmental Sustainability narzędzia Spoon w celu tworzenia
odwzorowań ETL w przypadku tabel faktów pobierających dane z tabel IBM TRIRIGA.
Pola tabeli pomostowej
Poza polami identyfikowanymi za pomocą właściwości Pole tabeli pomostowej wszystkie
tabele pomostowe zawierają określone pola.
Tabela 1. Pola tabeli pomostowej
Nazwa
kolumny
Klucz Typ
Domyśl.
Możliwa
wartość
NULL
Opis
DC_JOB
_NUMBER
T
NUMBER
(20)
N
Numer identyfikacyjny zadania.
DC_CID
T
NUMBER
(20)
N
Numer identyfikacyjny korelacji
używany w przypadku relacji
nadrzędny-podrzędny z tabeli
pomostowych.
DC
_SEQUENCE
_ID
T
NUMBER
(20)
N
Numer kolejny grupy wpisów.
DC_STATE
N
NUMBER
(4)
0
N
Identyfikator stanu wskazujący
aktualny stan tego wpisu podczas
przetwarzania zadania DataConnect.
Wartości: 0 - Nowy, 1 - Gotowy, 2
-Przetwarzanie, 3 - Ukończony, 4 Niepowodzenie, 5 - Przestarzały.
DC_ACTION
N
NUMBER
(4)
1
N
Podejmowana czynność. Wartości: 1
- Wstawianie, 2 - Aktualizacja, 4 Wstawianie/aktualizacja.
5
Tabela 1. Pola tabeli pomostowej (kontynuacja)
Możliwa
wartość
NULL
Opis
Nazwa
kolumny
Klucz Typ
DC_PATH
N
VARCHAR
()
T
Ścieżka (wraz z nazwą rekordu)
obsługiwanego obiektu. W przypadku
Wstawiania pole może wskazać
zadaniu DataConnect, gdzie w
hierarchii należy wstawić rekord.
Elementy podrzędne muszą zawierać
ścieżkę nadrzędną w kolumnie
DC_PATH. Jeśli obiekt znajduje się
na szczycie hierarchii lub poza nią,
kolumna DC_PATH musi być pusta.
Jeśli w przypadku Aktualizacji nie
istnieją żadne klucze, to pole należy
określić dla rekordu, który zostanie
zaktualizowany,
IBS_SPEC.OBJECT_PATH rekordu
do zaktualizowania.
DC_GUI
_NAME
N
VARCHAR
(100)
T
Nazwa formularza, który będzie
używany przez nowe lub
zaktualizowane wiersze. Po
wstawieniu jeśli ten formularz nie jest
określony, dla obiektu biznesowego
system używa formularza
domyślnego (o ile istnieje). W
przeciwnym razie obiekt nie zawiera
powiązanego formularza. Po
aktualizacji jeśli ten formularz nie
jest określony, system nie modyfikuje
bieżącego ustawienia formularza.
DC_PROJECT
N
VARCHAR
(100)
T
Po wstawieniu lub aktualizacji
określa projekt dla rekordu, jeśli nie
jest pusty. Ta wartość jest
wyświetlana w pasku menu portalu
po wybraniu projektu. W kolumnie
DC_PROJECT musi być stosowany
format Idprojektu-NazwaProjektu.
Domyśl.
Projekt ulega zmianie tylko w
przypadku rekordu uwzględnionego
w operacji wstawiania lub
aktualizowania. Elementy podrzędne
tego rekordu nie ulegają zmianie.
Jeśli użytkownik wstawia lub
aktualizuje dane z relacją
nadrzędny-podrzędny, należy się
upewnić, że w przypadku wszystkich
danych określono właściwy projekt.
6
Tabela 1. Pola tabeli pomostowej (kontynuacja)
Nazwa
kolumny
Klucz Typ
Nazwy kolumn N
są określane
przez
oprogramowanie
IBM TRIRIGA
Application
Platform. Za
pomocą konsoli
administratora
można wyszukać
nazwę tabeli
pomostowej i
bazy danych.
Domyśl.
Zależny od
typu kolumny
IBM
TRIRIGA
Application
Platform.
Możliwa
wartość
NULL
Opis
T
Pola w obiekcie biznesowym z
włączoną funkcją Pole tabeli
pomostowej. W tabeli pomostowej
wstawiana jest dodatkowa kolumna
przeznaczona na pola: Data, Data i
godzina, Czas trwania i Czas. Do
nazwy tych pól jest dołączany ciąg
_F. W oparciu o właściwość Klucz
tabeli pomostowej pola mogą być
kluczami. Używane podczas operacji
aktualizowania i Upsert.
W przypadku operacji Upsert zadanie
DataConnect generuje kod SQL,
stosując wyznaczone wartości
kluczowe w tabeli pomostowej w
celu określenia, czy rekord istnieje.
Jeśli rekord istnieje (znaleziono jeden
rekord), jest on aktualizowany za
pomocą danych w tabeli pomostowej.
Jeśli istnieje więcej niż jeden rekord,
wiersz tabeli pomostowej jest
oznaczany jako Niepowodzenie. Jeśli
rekord nie istnieje (nie znaleziono
żadnego rekordu), nowy rekord jest
wstawiany, za pomocą danych w
tabeli pomostowej.
W przypadku aktualizacji, jeśli
zdefiniowano klucze w tabeli
pomostowej, zadanie DataConnect
generuje kod SQL, stosując wartości
kluczowe w tabeli pomostowej w
celu określenia, czy rekord istnieje.
Jeśli rekord istnieje (znaleziono jeden
rekord), jest on aktualizowany za
pomocą danych w tabeli pomostowej.
Jeśli istnieje więcej niż jeden rekord,
wiersz tabeli pomostowej jest
oznaczany jako Niepowodzenie. Jeśli
rekord nie istnieje (nie znaleziono
żadnego rekordu), wiersz w tabeli
pomostowej jest oznaczany jako
Niepowodzenie.
Pola tabeli DC_JOB
Tabela DC_JOB jest wypełniana z użyciem procesu zewnętrznego, a aktualizacja jest
wykonywana za pomocą agenta DataConnect i asynchronicznych przepływów pracy. Tabela
jest usuwana za pomocą agenta czyszczenia. Tabela DC_JOB zawiera określone pola.
7
Tabela 2. Pola tabeli DC_JOB
Nazwa
kolumny
Klucz Typ
JOB
_NUMBER
T
NUMBER
(20)
JOB_TYPE
T
NUMBER
(4)
JOB_NAME
N
JOB_RUN
_CTL
Domyśl.
Możliwa
wartość
NULL
Opis
N
Numer identyfikacyjny zadania.
N
Identyfikator typu zadania. Wartość
wynosi : 1 - Tworzenie/aktualizacja
rekordów IBM TRIRIGA, dane
przychodzące.
VARCHAR
(100)
T
Nazwa zadania.
N
VARCHAR
(100)
N
Steruje współbieżnością. Agent
DataConnect za pomocą
JOB_RUN_CTL z JOB_NAME
przyspiesza własne działanie. Jeśli
zadanie jest jednowątkowe, żadne
inne zadanie o nazwie JOB_NAME
nie zostanie uruchomione do
momentu zakończenia lub
zakończenia niepowodzeniem
bieżącego zadania. Wartość : 1 –
pojedynczy wątek, 2 - wiele wątków.
BO_NAME
N
VARCHAR
(100)
T
Nazwa obiektu biznesowego dla
rekordu, który jest tworzony w celu
reprezentowania zadania. Ten obiekt
biznesowy należy utworzyć w
module triDataConnectJob.
USER_ID
N
NUMBER
(20)
T
ID użytkownika używany podczas
przetwarzania. Musi to być
prawidłowy ID użytkownika w
programie IBM TRIRIGA ID
(T_MYPROFILE ID).
STATE
N
NUMBER
(4)
N
Identyfikator stanu wskazujący
aktualny stan zadania. Wartości: 0 Nowy, 1 - Gotowy, 2 - Przetwarzanie,
3 - Ukończony, 4 - Niepowodzenie, 5
- Przestarzały.
SOURCE
_SYS_ID
N
VARCHAR
(100)
T
Identyfikator w systemie, który
utworzył zadanie (używany do
raportowania informacyjnego).
PROCESS
_SYS_ID
N
VARCHAR
(100)
T
Identyfikator w systemie, który
przetwarza/przetworzył zadanie
(używany do raportowania
informacyjnego). Nie trzeba
wprowadzać tych danych.
CREATED
_DATE
N
DATETIME
N
Data i godzina dodania wpisu
(domyślnie).
UPDATED
_DATE
N
DATETIME
T
Data i godzina ostatniej zmiany
wpisu. Nie trzeba wprowadzać tych
danych.
1
0
Data
Za pomocą konsoli administratora można wyświetlić zawartość tabeli DC_JOB. W tym celu
należy wybrać zadania DataConnect w obiekcie zarządzanym DataConnect w konsoli
8
administratora. Dodatkowe informacje na temat konsoli administratora i zarządzanych
obiektów DataConnect: IBM TRIRIGA Application Platform 3 — Podręcznik użytkownika
konsoli administratora.
Mapy ETL
Rodzaj implementacji integracji DataConnect określa sposób przenoszenia danych do tabel
pomostowych: za pomocą narzędzia ETL lub bezpośrednich instrukcji SQL. Bez względu na
sposób przenoszenia danych ze źródła zewnętrznego do tabeli pomostowej przed
uruchomieniem odwzorowania dane muszą zostać wypełnione w źródle zewnętrznym.
Jeśli używane jest narzędzie ETL, funkcja integracji określa, które mapy ETL należy
opracować, aby przenieść dane ze źródła zewnętrznego do tabel pomostowych. Za pomocą
tego narzędzia można zdefiniować odwzorowanie ETL między źródłem zewnętrznym i
tabelami pomostowymi. Jednym z narzędzi tego typu jest Spoon z pakietu Pentaho Kettle.
Można również użyć innego, wybranego narzędzia.
Po uruchomieniu procedury odwzorowania muszą zostać wykonane następujące zadania:
v Należy utworzyć niepowtarzalny numer zadania.
v Należy utworzyć wpis w tabeli Sterowanie zadaniem DataConnect (DC_JOB) określający
stan jako Nowy.
v Należy wypełnić tabele pomostowe w przypadku obiektów biznesowych z uwzględnieniem
podrzędnych tabel pomostowych. Wpisy obejmują numer zadania, co najmniej jeden
numer korelacji i czynność. W przypadku czynności Aktualizuj bez zdefiniowanych kluczy
ścieżka jest wymagana, a w przypadku czynności Wstaw jest ona opcjonalna.
v Opcjonalnie: Należy zaktualizować wpis w tabeli Sterowanie zadaniem DataConnect
(DC_JOB), wybierając stan Gotowy. Aktualizację można wprowadzić ręcznie za pomocą
konsoli administratora. W tym celu należy wybrać obiekt zarządzany DataConnect, zadanie
DataConnect job i określić czynnośćZadanie gotowe.
Przepływy pracy umożliwiające przenoszenie danych do
rekordów
Za pomocą przepływów pracy w oprogramowaniu IBM TRIRIGA można przenosić dane z
tabel pomostowych do rzeczywistych rekordów obiektów biznesowych. Szczegółowe
działanie logiki przepływu pracy jest uzależnione od reguł biznesowych w danej firmie i
wypełnianego obiektu biznesowego. Przepływy pracy sterujące DataConnect należy utworzyć
w module triDataConnectJob.
Za pomocą zadania w przepływie pracy DataConnect można pobrać rekordy przemieszczenia
i przetworzyć wpisy przemieszczenia, tworząc lub aktualizując dla każdego z nich rekord
inteligentny. Zadania w przepływie pracy DataConnect można zagnieżdżać, zapewniając
obsługę relacji nadrzędny-podrzędny i logiki biznesowej.
Działanie zadania DataConnect jest dwuetapowe:
v Pobiera ono z odpowiedniej tabeli pomostowej zestaw rekordów w celu opracowania ich
(zgodnie z określonymi ustawieniami właściwości zadania DataConnect).
v Działa jako iterator w przypadku następujących zadań:
– Tworzy lub aktualizuje rekordy w przypadku każdego wiersza danych z tabeli
pomostowej.
– Uruchamia zestaw zadań DataConnect dla każdego wiersza. W zestawie zadań
DataConnect można umieścić inne zadania.
W ramach zadań w przepływie pracy DataConnect wartością statusu Recenzja w przypadku
zadania jest WSTAW, AKTUALIZUJ lub NIEPOWODZENIE. Wartość jest określana w
9
oparciu o aktualną czynność procesu przetwarzania zdania. Po zamknięciu zadania w
przepływie pracy DataConnect określany jest status Ukończony lub Niepowodzenie (jeśli
wystąpił błąd w przypadku dowolnego wiersza tabeli pomostowej).
Przykładowy przepływ pracy zadania DataConnect
W poniższym przykładzie wykorzystywane jest zamówienie oraz pozycje wiersza
zamówienia. Najpierw przedstawiono ukończony przepływ pracy.
Rysunek 1. Przepływ pracy zawierający zadanie DataConnect
Ustawienia zadania w przepływie pracy
W narzędziu Budowniczy przepływów pracy należy utworzyć przepływ pracy za pomocą
modułu triDataConnectJob. Przykładowy przepływie pracy polega na obsłudze wielu
kluczowych zadań w przepływie pracy oraz ustawień zadania.
10
Zadanie rozpoczęcia
Typ obiektu powiązany z triDataConnectJob i zdarzenie SYSTEM DC PROCESS JOB
identyfikują prawidłowy przepływ pracy dla agenta DataConnect. Agent DataConnect pobiera
pole BO_NAME, które musi stanowić nazwę typu obiektu z wpisu DC_JOB zadania.
Tabela 3. Ustawienia zadania rozpoczęcia
Pole
Opis
Nazwa
W zadaniu rozpoczęcia w przepływie pracy określ nazwę przepływu
pracy, stosując standardy nazewnictwa IBM TRIRIGA.
Współbieżność, Integracja
Dla opcji Współbieżność wybierz ustawienie Asynchroniczna.
Wybierz flagę Integracja, co umożliwia wdrożenie zadań
DataConnect jako części przepływu pracy.
Moduł
Dla Modułu wybierz pozycję triDataConnectJob.
Typ obiektu
Jako Typ obiektu wybierz obiekt biznesowy utworzony w module
triDataConnectJob.
Zdarzenie
Jako Zdarzenie wybierz SYSTEM DC PROCESS JOB. Jest to
zdarzenie DataConnect.
Propaguj status integracji,
Integracja
Wybierz flagę Propaguj status integracji. Dzięki temu flaga
Integracja jest propagowana, gdy ten przepływ pracy wywoła inny
przepływ pracy.
Zadanie DataConnect
Zadanie DataConnect pobiera rekordy z tabeli pomostowej i iteruje we wpisach
pomostowych, aktualizując lub tworząc rekord inteligentny dla każdego wpisu.
Tabela 4. Ustawienia zadania DataConnect
Pole
Opis
Etykieta, Opis
Utwórz treść przepływu pracy z użyciem zadania DataConnect, gdy
jest to wymagane. Wprowadź Etykietę i Opis.
Moduł, Obiekt biznesowy
Określ Moduł i Obiekt biznesowy, na których będzie działać zadanie
DataConnect.
Stan początkowy
Wybierz Stan początkowy jako stan określany dla nowego
utworzonego rekordu. Zadanie DataConnect ignoruje Stan
początkowy, jeśli rekord jest aktualizowany. W polu listy można
wybrać pozycje zdefiniowane dla obiektu biznesowego. Rekord
zostanie utworzony z użyciem wybranego stanu – jego stan nie
zostanie zmieniony na wybrany stan. Aby zmienić stan rekordu, w
zadaniu DataConnect należy utworzyć obiekt opisany stanem pustym.
Następnie należy użyć zadania wyzwolenia działania w treści zadania
DataConnect, aby zmienić stan rekordu na wybrany stan.
Użyj danych tymczasowych
Aby w zadaniu DataConnect używać danych tymczasowych, należy
wybrać opcję Użyj danych tymczasowych. Gdy zadanie DataConnect
z włączoną opcją Użyj danych tymczasowych zostanie zastosowane do
przychodzących danych, system wstawi lub zastosuje aktualizacje w
danych tymczasowych, a nie trwałych. Przykłady i dodatkowe
informacje zawarto w sekcji dotyczącej używania danych
tymczasowych.
11
Tabela 4. Ustawienia zadania DataConnect (kontynuacja)
Pole
Opis
W kolejności, Krok zadania
W sekcji Korelacja:
v Oznaczanie W kolejności wskazuje, że korelacja między wpisem
przemieszczania i numerem kolejnym jest używana do określania
kolejności przetwarzania rekordów. Jest to domyślny i jednocześnie
najczęściej stosowany scenariusz, o ile nie występują zadania
DataConnect umieszczone w innych zadaniach DataConnect.
v Oznaczanie Krok zadania wskazuje, że źródłem korelacji musi być
obejmujące zadanie DataConnect, które musi być stosowane w
klauzuli Where w celu określenia, które wpisy zostaną
przetworzone. Przykładowo: Numer zadania + Numer korelacji,
sortowanie wg Numeru kolejnego. Krok zadania pozwala zadaniu
DataConnect na pobranie numeru korelacji z jednego z
obejmujących zadań DataConnect.
Brak, Na X iteracji,
Wszystkie iteracje
W sekcji Transakcja należy wybrać zakres.
v Brak: rekord jest zatwierdzany natychmiast po utworzeniu lub
zaktualizowaniu.
v Na X iteracji: nowy kontekst jest tworzony dla X iteracji i
zatwierdzany po zakończeniu określonej liczby iteracji.
v Wszystkie iteracje: nowy kontekst jest tworzony, zanim zadanie
rozpocznie przetwarzanie, a zatwierdzenie jest wykonywane po
zakończeniu wszystkich iteracji.
Zadanie wyzwolenia działania
Ostatnim krokiem w przepływie pracy musi być zadanie wyzwolenia działania określające
status zadania jako Ukończony lub Niepowodzenie.
Tabela 5. Ustawienia zadania wyzwolenia działania
Pole
Opis
Etykieta, Działanie
We właściwościach zadania wyzwolenia działania w polu Etykieta
wybierz opcję Oznacz zadanie jako ukończone i wybierz pozycję
triDCCompleted dla pola Działanie.
Przejmij, zadania, Użyj,
Typ obiektu
W sekcji Rekordy w polu Przejmuj wybierz Obiekt biznesowy, a w
polu zadania wybierz Uruchom (loDCPurchaseOrder). Zaznacz opcję
Użyj i wybierz pozycję loDCPurchaseOrder w polu Typ obiektu.
Zadanie przerywania
Aby wycofać transakcje, w treści zadania DataConnect należy wstawić oznaczenie Przerwij
(lub Kontynuuj). Za pomocą zadania Przerwij (lub Kontynuuj) można sprawdzić status
zadania DataConnect i określić blok, który zostanie wybrany. Użytkownik może również
wybrać kontynuowanie iteracji lub jej przerwanie (Kontynuuj lub Przerwij) oraz określić, czy
zostanie wykonane zatwierdzenie lub wycofanie (Powodzenie lub Awaria). Ustawienia
transakcji w zadaniu DataConnect współpracują z ustawieniami zadania Przerwij (lub
Kontynuuj).
W zadaniu Przerwij są również dostępne opcje sterowania danymi tymczasowymi. Przykłady
i dodatkowe informacje zawarto w sekcji dotyczącej używania danych tymczasowych.
12
Jeśli zadanie DataConnect nie używa transakcji, wiersze są zatwierdzane w każdym kroku
zadania. Jeśli nie zostanie osiągnięte Przerwanie (lub Kontynuowanie) zmieniające przepływ
przetwarzania (a używane są transakcje), wykonywane jest zatwierdzenie w oparciu o
ustawienia zadania DataConnect.
Jeśli zadanie DataConnect używa transakcji, a przepływ pracy zostanie Przerwany (lub
Kontynuowany), transakcje są wycofywane lub zatwierdzane w oparciu o ustawienie
Powodzenie lub Niepowodzenie przerwania. Przetwarzanie jest wykonywane w zakresie
określonym w Przerwaniu (lub Kontynuowaniu). Bieżący zakres oznacza zadanie
DataConnect aktualnie obsługiwane. Typ Przerwij przepływ oznacza kontynuowanie
przetwarzania w przypadku zadania po zadaniu DataConnect. Typ Kontynuuj przepływ
oznacza kontynuowanie do następnego wiersza w partii tabeli pomostowej dla tego zadania.
Wybrany blok oznacza Przerwanie (lub Kontynuowanie) w przypadku zadania DataConnect.
Wywołania przepływu pracy
Jeśli przepływ pracy zawierający zadanie DataConnect wywoła inne przepływy pracy, może
być wymagane uaktualnienie tych przepływów w celu sprawdzenia ustawienia Integracja i
zmiany flagi Propaguj status integracji zgodnie z wymaganiami.
Można przeanalizować istniejące przepływy pracy, które mogą zostać wywołane przez
przepływ pracy w celu przeniesienia danych. Jeśli w przepływie pracy znajdują się etapy,
których nie wolno wyzwolić, jeśli są wywoływane z przepływu pracy Integracja, należy
sprawdzić ustawienie Integracjaw przypadku zadania przełączania lub zadania rozpoczęcia.
Jeśli w przepływie pracy nie można propagować statusu Integracja, należy wyczyścić flagę
Propaguj status integracji w zadaniu rozpoczęcia.
Wartość 1 dla flagi Integracja oznacza, że flaga jest włączona.
Sprawdzenie poprawności danych w środowisku wykonawczym
W środowisku wykonawczym DataConnect są przeprowadzane określone zadania
sprawdzania poprawności danych. Przykładowo: czy w tabeli pomostowej istnieje pole
jednostki miary (JM) i czy jego wartość jest nieprawidłowa. Gdy zadanie DataConnect
napotka błędny wiersz, przetwarzanie jest zatrzymywane i iteracja (nie całe zadanie
DataConnect) DataConnect kończy się niepowodzeniem. Ten wiersz zostaje oznaczony w
tabeli pomostowej jako Niepowodzenie.
Użytkownik może wykonać następną iterację lub rozbić zadanie. Wstawienie rozbicia do
przepływu pracy pozwala na określenie dalszego działania przepływu pracy. Jeśli rozbicie nie
zostanie dodane, przetwarzanie zadania DataConnect jest kontynuowane.
Narzędzie DataConnect zawiera następujące wbudowane mechanizmy sprawdzania
poprawności:
v Sprawdzenie poprawności jednostek miar i wartości lokatora.
v Sprawdzenie poprawności typu danych w określonym polu.
v Sprawdzenie poprawności nazwy formularza.
v Sprawdzenie poprawności nazwy projektu, o ile wprowadzono w systemie.
Za pomocą właściwości Użyj danych tymczasowych można dodać kolejne mechanizmy
sprawdzania poprawności i czyszczenia.
Statusy iteracji
Podobnie jak w przypadku większości iteratorów zadań w zadaniu DataConnect są
zapisywane informacje z poprzedniej iteracji (np. status). Przykładowo: można utworzyć
przepływ pracy zawierający dwa zadania DataConnect — jedno umieszczone wewnątrz
drugiego. Jeśli obsługa wiersza w ramach wewnętrznej iteracji zakończy się niepowodzeniem,
13
a użytkownik chce określić na koniec prawidłowy stan, to ten wiersz należy zapisać w
zmiennej. W ten sposób można się upewnić, że status nie zostanie utracony.
Dane tymczasowe
Wybranie właściwości Użyj danych tymczasowych w zadaniu DataConnect zapewnia
zadaniom w przepływie pracy w zadaniu DataConnect możliwość przetwarzania w sesji
rekordów przychodzących z tabeli pomostowej. Oznacza to, że dane można obsługiwać,
zanim zostaną one zapisane w bazie danych.
Dzięki zadaniu pobierania rekordu tymczasowego można odtworzyć rekord tymczasowy i za
pomocą zadania zapisywania rekordu trwałego zapisać zmiany w sesji. Zadanie Przerwij
pozwala usunąć z sesji wybraną iterację lub całkowicie wyczyścić sesję. Za pomocą tego
zadania można również zakończyć niepowodzeniem wybrany wiersz w tabeli pomostowej lub
zakończyć niepowodzeniem wszystkie wiersze od ostatniego zapisania rekordu trwałego.
Po zaznaczeniu opcji Użyj danych tymczasowych i rozpoczęciu przetwarzania przepływu
pracy rekord w zadaniu DataConnect jest rekordem trwałym, który nie zawiera zmian z tabeli
pomostowej. Ponadto rekord zadania Pobierz rekord tymczasowy stanowi zaktualizowane lub
przychodzące wartości z tabeli pomostowej. W ramach tego procesu można sprawdzać
poprawność danych i oczyszczać wartości przychodzące w przepływie pracy, a nawet
odwzorowania danych podczas aktualizacji, jeśli pola w tabeli pomostowej są puste.
Przykład pojedynczego zadania DataConnect zawierającego dane
tymczasowe
Poniższy wycinek przepływu pracy zawiera pojedyncze zadanie DataConnect pozwalające na
przetwarzanie danych tymczasowych.
14
Rysunek 2. Pojedyncze zadanie DataConnect pozwalające na przetwarzanie danych tymczasowych
Tabela 6. Ustawienia zadania DataConnect
Pole
Opis
Wybrane
Tabela 7. Ustawienia zadania przerywania
Pole
Opis
Typ przepływu
Kontynuacja
Status zadania
Powodzenie
Zakres przerwania
Bieżący zakres
Odrzuć dane tymczasowe
Wszystkie
Zakończ niepowodzeniem
wiersze pomostowe
Wybrane, określa Wszystkie
Zadanie DataConnect przetwarza rekordy w tabeli pomostowej i umieszcza wstawione lub
zaktualizowane rekordy w sesji. Podczas każdej sesji przepływ pracy uzyskuje rekord
tymczasowy, wykonuje na nim operację i określa, czy rekord zostanie zachowany.
Aby zachować rekord, zapisz rekord trwale za pomocą zadania Zapisz rekord trwały.
Warunek niepowodzenia w zadaniu przełączania korzysta z ustawień w zadaniu
Przerwij/Kontynuuj w celu odrzucenia wszystkich danych w sesji. Warunek niepowodzenia
zakańcza niepowodzeniem także wiersze pomostowe używane do generowania rekordu w
sesji i przechodzi do następnego rekordu w iteracji.
15
W tym przykładzie pojedynczego zadania DataConnect wybranie dla ustawienia Odrzuć
dane tymczasowe w zadaniu przerywania opcji Bieżące, a nie opcji Wszystko zapewniłoby
taki sam wynik.
Przykład wielu zadań DataConnect zawierających dane tymczasowe
Poniższy wycinek przepływu pracy obejmuje zadanie DataConnect zawierające drugie
zadanie DataConnect; jest to zadanie podrzędne. Ten fragment jest rozszerzeniem przykładu
dotyczącego zamówienia, który przedstawiono wcześniej.
16
Rysunek 3. Wiele zadań DataConnect pozwalających na przetwarzanie danych tymczasowych
Tabela 8. Zewnętrzne ustawienia zadania DataConnect
Pole
Opis
Wybrane
Tabela 9. Zewnętrzne ustawienia zadania przerwania
Pole
Opis
Typ przepływu
Kontynuacja
17
Tabela 9. Zewnętrzne ustawienia zadania przerwania (kontynuacja)
Pole
Opis
Status zadania
Powodzenie
Zakres przerwania
Bieżący zakres
Wszystkie
wiersze pomostowe
Zewnętrzne zadanie DataConnect przetwarza tabelę pomostową POBody. Podczas każdej
sesji przepływ pracy uzyskuje rekord tymczasowy, wykonuje na nim operację i określa, czy
rekord zostanie zachowany. Jeśli w przypadku rekordu POBody wystąpi problem, przepływ
pracy wykonuje zadanie przerwania/kontynuowania i odrzuca wszystkie dane sesji, zakańcza
niepowodzeniem wiersz i przechodzi do następnego rekordu POBody.
Jeśli rekord POBody pomyślnie ukończy zadanie przełączania, przetwarzanie jest
kontynuowane z użyciem wewnętrznego zadania DataConnect zapewniającego obsługę
wierszy POLine dla tego rekordu POBody. W oparciu o wyszukane dane i ostawienia zadania
przerywania przepływ pracy może wykonać jedną z kilku operacji. Użytkownik może
dysponować kilkoma przełączeniami/przerwaniami, a zależnie od przetwarzania proces
roboczy może wszystkie (lub tylko wybrane) wiersze zakończyć niepowodzeniem.
W poniższych scenariuszach przedstawiono różne zastosowania przerwania i odpowiednie
zachowania przetwarzania oraz sesji:
v Zakończ niepowodzeniem bieżący wiersz POLine, usuń rekord utworzony lub
zmodyfikowany w sesji i zakończ niepowodzeniem tylko ten wiersz w tabeli pomostowej.
Przetwarzany jest kolejny wiersz POLine w rekordzie POBody. Zadanie przerwania w
wewnętrznym zadaniu DataConnect używa następujących właściwości:
Tabela 10. Ustawienia wewnętrznego zadania przerywania
Pole
Opis
Typ przepływu
Kontynuacja
Status zadania
Powodzenie
Zakres przerwania
Bieżący zakres
Bieżące
wiersze pomostowe
Wybrane, określa Bieżące
v Wyczyść bieżącą iterację POBody, usuń rekord utworzony lub zmodyfikowany w sesji,
zakończ niepowodzeniem wiersz tabeli pomostowej POBody, wyczyść wiersze POLine i
zakończ niepowodzeniem wiersze tabeli pomostowej POLine. Przetwarzany jest kolejny
element POBody. Zadanie przerwania w wewnętrznym zadaniu DataConnect używa
następujących właściwości:
Tabela 11. Ustawienia wewnętrznego zadania przerywania
18
Pole
Opis
Typ przepływu
Kontynuacja
Status zadania
Powodzenie
Zakres przerwania
Wybrany blok, przetwarzanie przychodzących POBody
Wszystkie
Tabela 11. Ustawienia wewnętrznego zadania przerywania (kontynuacja)
Pole
Opis
wiersze pomostowe
v Nic (brak zadań przerwania w wewnętrznym zadaniu DataConnect).
Dysponowanie zadaniem Zapisz rekord trwały po zakończeniu wewnętrznego zadania
(POLine) DataConnect gwarantuje, że platforma zapisze POBody i przynależne wiersze
POLine.
Agent DataConnect
Agent DataConnect sprawdza wpisy w tabeli Sterowanie zadaniem DataConnect i uruchamia
je w stanie Gotowy. W pliku TRIRIGAWEB.properties właściwość
DATACONNECT_SLEEP_TIME dotycząca serwera aplikacji obsługującego Agenta
DataConnect steruje częstotliwością sprawdzania tabeli Sterowanie zadaniem DataConnect
przez agenta.
Gdy zostanie wyszukane zadanie w tabeli Sterowanie zadaniem DataConnect (DC_JOB)
znajdujące się w stanie Gotowy, Agent DataConnect wykonuje następujące operacje:
v Tworzy rekord dla rekordu wskazanego we wpisie zadania DataConnect. Ten rekord jest
instancją obiektu biznesowego Sterowania zadaniem utworzonego w module
triDataConnectJob.
v Uzupełnia rekord informacjami pobranymi z wpisu zadania, jak na przykład: numer
zadania, typ zadania, ID systemu źródłowego, ID systemu przetwarzającego, data
utworzenia, data aktualizacji, użytkownik i stan.
v Ustawia stan Przetwarzanie dla wpisu w tabeli Sterowanie zadaniem DataConnect.
v Przesyła zdarzenie przepływu pracy SYSTEM DC PROCESS JOB wraz z rekordem, co
powoduje rozpoczęcie przepływu pracy.
v Jeśli występują problemy dotyczące wpisu w tabeli Sterowanie zadaniem DataConnect lub
tworzenia obiektu biznesowego Sterowanie zadaniem, dla wpisu w tabeli DC_JOB
wybierany jest stan Niepowodzenie. Przyczyna niepowodzenia jest zapisywana w pliku
server.log. Po usunięciu problemu można przeprowadzić ponowną próbę uruchomienia
zadania z poziomu konsoli administratora.
v
Dodatkowe informacje na temat Menedżera agentów zawarto w dokumentacji IBM TRIRIGA
Application Platform 3 — Podręcznik użytkownika konsoli administratora. Dodatkowe
informacje na temat pliku TRIRIGAWEB.properties zawarto w dokumentacji IBM TRIRIGA
Application Platform 3 Podręcznik instalacji i implementacji.
Przetwarzanie przepływu pracy
Gdy zostanie wyzwolony proces roboczy ze zdarzeniem SYSTEM DC PROCESS JOB i
obiektem biznesowym Sterowanie zadaniem, zadanie DataConnect w przepływie pracy
uruchamia określone kroki. W ramach tego procesu przyjmuje się, że w przepływie pracy
zdefiniowano włączoną właściwość Integracja (prawda).
Podczas zadania DataConnect wykonywane są następujące kroki:
v Za pomocą skonfigurowanych informacji określ typ rekordu do przetworzenia, stan, w
jakim rekord zostanie pozostawiony, typ korelacji i ustawienie transakcji. Użyj rekordu w
zadaniu rozpoczęcia jako elementu źródłowego numeru zadania, które zostanie użyte.
v W zadaniach DataConnect uzyskaj nazwę tabeli pomostowej dla rekordu, który zostanie
przetworzony i względem którego zostaną przesłane zapytania o wiersze z odpowiednim
19
v
v
v
v
v
numerem zadania. W zależności od ustawienia konfiguracji dla numeru korelacji użyj tego
numeru w celu określenia kolejności lub w klauzuli Where w celu wyszukania wpisów z
numerem korelacji. Uzyskaj wpisy z tabeli pomostowej w oparciu o numer zadania, numer
korelacji, numer kolejny, czynność i ścieżkę.
Dla każdego pobranego wiersza utwórz lub zaktualizuj rekord inteligentny. Dla rekordu
wybierz stan określony przez definicję zadania DataConnect (nie przechodzi on do tego
stanu). Zmień stan wiersza w tabeli pomostowej. Określ projekt i formularz. W zależności
od ustawienia flagi Użyj danych tymczasowych zmiany będą trwałe lub wprowadzone w
sesji. Wykonaj kroki zdefiniowane w iteratorze, tworząc relacje nadrzędny-podrzędny i
zgodnie z logiką biznesową.
W odniesieniu do nowych rekordów wykonaj przepływ pracy przed utworzeniem. Aby nie
wykonywać tego przepływu pracy, zaktualizuj przepływ pracy przed utworzeniem
wybierając flagę Integracja, co zapewni, że wywołanie tego przepływu pracy przez
przepływ pracy Integracja spowoduje jego pominięcie.
Jeśli istnieje odwołanie do innego przepływu pracy, sprawdź ustawienie statusu Integracja,
aby zmienić przetwarzanie w oparciu o fakt, czy przepływ pracy został wywołany przez
proces Integracja.
Jeśli istnieje zdarzenie, sprawdź kolumnę FROM_INTEGRATION, aby określić, czy status
Integracja jest określony w kontekście przepływu pracy.
Przetwórz transakcję w oparciu o ustawienia konfiguracji zadania DataConnect.
Agent czyszczenia
Agent czyszczenia wykonuje automatyczne czyszczenie zadań DataConnect. Za pomocą
Menedżera agentów dostępnego w konsoli administratora można zdefiniować nazwę
procesora obsługującego Agenta czyszczenia. W pliku TRIRIGAWEB.properties należy
określić właściwość DC_HISTORY_RETENTION_DAYS.
Gdy stan wpisu DataConnect w tabeli starowania zadaniem DataConnect utrzymuje się jako
Przestarzały lub Ukończony przez określoną liczbę dni we właściwości
DC_HISTORY_RETENTION_DAYS, uruchamiany jest Agent czyszczenia. Następnie w
Agencie czyszczenia wykonywane są następujące operacje:
v Wyszukiwany jest numer kontrolny zadania wpisu i usuwane są wpisy w tabelach
pomostowych dla danego numeru kontrolnego zdania.
v Usuwany jest wpis w tabeli Sterowanie zadaniem DataConnect (DC_JOB).
Agent czyszczenia nie usuwa wpisów obiektów biznesowych Sterowanie zadaniem (obiekt
biznesowy w triDataConnectJob). W przypadku niepotrzebnych wpisów triDataConnectJob
należy się dostosować do reguł biznesowych obowiązujących w danej firmie. Wpisy można
usunąć z systemu bezpośrednio lub za pomocą utworzonego menu.
Dodatkowe informacje na temat Menedżera agentów zawarto w dokumentacji IBM TRIRIGA
Application Platform 3 — Podręcznik użytkownika konsoli administratora. Dodatkowe
informacje na temat pliku TRIRIGAWEB.properties zawarto w dokumentacji IBM TRIRIGA
Application Platform 3 Podręcznik instalacji i implementacji.
20
Powszechne problemy z narzędziem DataConnect
Do częstych problemów związanych z narzędziem IBM TRIRIGA DataConnect można
zaliczyć brakujące tabele pomostowe lub pola tabel pomostowych, nieprawidłowe kolumny
tabeli i zmienione obiekty biznesowe, które mogą wymagać ponownego publikowania.
Tabela 12. Powszechne problemy z narzędziem DataConnect
Komunikat o błędzie
Miejsce
Rozwiązanie
Obiekt biznesowy: XX nie
zawiera tabeli pomostowej.
W środowisku
wykonawczym zadania
DataConnect, gdy działa
przepływ pracy, wyjątek
WFRuntimeException w
pliku server.log
Brak tabeli pomostowej dla obiektu
biznesowego XX. Zadanie kończy się
niepowodzeniem w przepływie pracy.
W środowisku
wykonawczym zadania
przepływ pracy
Wystąpił błąd podczas wykonywania
zadania DataConnect. Jedna możliwość
wystąpienia błędu zachodzi podczas
aktualizacji DC_PATH, gdzie nie
określono dokładnej definicji obiektu
inteligentnego do zaktualizowania.
Nie można usunąć obiektu
biznesowego, ponieważ
istnieją oczekujące zadania
DataConnect.
Interfejs użytkownika
Operacja przetwarzania zadania
DataConnect musi zostać zakończona,
zanim będzie można usunąć obiekt
biznesowy. Usuń obiekt po
zakończeniu przetwarzania zadania.
Teraz nie można
opublikować obiektu
biznesowego. Istnieją
OCZEKUJĄCE lub
PRZETWARZANE zadania
DataConnect. Te operacje
muszą zostać zakończone,
zanim będzie można
zakończyć publikowanie.
Interfejs użytkownika
Przetwarzane lub oczekujące zadanie
DataConnect należy wyczyścić, zanim
będzie można pomyślnie zakończyć
publikowanie obiektu. Obydwie
operacje muszą zostać wyczyszczone
bez interwencji. Zadanie należy
ponownie opublikować, gdy zostaną
zakończone wszystkie zadania
oczekujące.
Agent DataConnect – nie
można znaleźć obiektu
biznesowego
triDataConnectJob. Obiekt
należy zaimportować, przed
użyciem agenta DataConnect.
Z poziomu agenta
DataConnect,
PlatformRuntime
Wyjątek w pliku server.log
Przed uruchomieniem lub użyciem
narzędzia DataConnect należy
zastosować najnowszy pakiety migracji
obiektów triDataConnectJob.
Agent DataConnect –
nieprawidłowa wersja
obiektu biznesowego
triDataConnectJob. Obiekt
należy zaimportować, przed
użyciem agenta DataConnect.
Z poziomu agenta
DataConnect,
PlatformRuntime
Wyjątek w pliku server.log
Przed uruchomieniem lub użyciem
narzędzia DataConnect należy
zastosować najnowszy pakiety migracji
obiektów triDataConnectJob.
DataConnectTaskHandler –
tabela pomostowa : XX nie
zawiera pola pomostowego:
YY.
W środowisku
wykonawczym zadania
przepływ pracy, wpis
ostrzegawczy w pliku
server.log
W tabeli pomostowej brak pól, które
powinny się w niej znajdować. Taka
sytuacja może wystąpić, gdy tabela
pomostowa nie jest zsynchronizowana
z obiektem biznesowym. Obiekt
biznesowy należy opublikować
ponownie po zakończeniu zadania
DataConnect.
[XX = nazwa obiektu
biznesowego]
Błąd występuje podczas
przetwarzania rekordów
pomostowych: XX.
[XX = pola rekordów tabeli
pomostowej]
[XX = nazwa tabeli
pomostowej]
[YY = nazwa pola]
21
Tabela 12. Powszechne problemy z narzędziem DataConnect (kontynuacja)
Miejsce
Rozwiązanie
DataConnectTaskHandler:
nie można znaleźć
nadrzędnego obiektu
inteligentnego
wskazywanego przez ścieżkę:
XX.
W środowisku
wykonawczym zadania
przepływ pracy, wpis
ostrzegawczy w pliku
server.log
Środowisko wykonawcze nie może
znaleźć elementu nadrzędnego
określonego w polu tabeli pomostowej
DC_PATH. Obiekt inteligentny został
utworzony, ale nie określono dla niego
elementu nadrzędnego.
W środowisku
wykonawczym zadania
przepływ pracy, wyjątek
WFRuntimeException w
pliku server.log
Należy sprawdzić zmiany stanów
obiektu biznesowego, aby się upewnić,
że zmiany stanu są zdefiniowane w
podstawowej właściwości
triDataConnectJob.
Z poziomu agenta
DataConnect, wpis
informacyjny w pliku
server.log
Kolumna BO_NAME w tabeli
DC_JOB dla zadania YY nie jest
prawidłowym obiektem biznesowym.
Należy się upewnić, że nazwa jest
poprawna i znajduje się w module
triDataConnectJob. Popraw wpis i
przywróć stan GOTOWY (lub 1).
Z poziomu agenta
DataConnect, wpis
server.log
Kolumna JOB_RUN_CTL dla zadania
YY jest nieprawidłowa w tabeli
DC_JOB. Tylko 0 (pojedynczy wątek)
lub 1 (wiele wątków) stanowią
prawidłowe wpisy. Popraw wpis i
Z poziomu agenta
DataConnect, wpis
server.log
Kolumna JOB_TYPE dla zadania YY
jest nieprawidłowa w tabeli DC_JOB.
Tylko wartość 1 (przychodzące) jest
prawidłowa. Popraw wpis i przywróć
stan GOTOWY (lub 1).
Z poziomu agenta
DataConnect, wpis
server.log
Agent nie mógł użyć kolumny
USER_ID w celu powiązania nowego
zadania DataConnect z użytkownikiem.
Upewnij się, że identyfikator USER_ID
jest prawidłowym identyfikatorem
T_MYPROFILE spec_id. Popraw wpis
i przywróć stan GOTOWY (lub 1).
[XX = DC_PATH z tabeli
pomostowej]
DataConnectTaskHandler:
podczas czynności zmiany
stanu zastosowano
nieprawidłowy stan XX w
obiekcie inteligentnym: YY.
[XX = stan]
[YY = ID obiektu
inteligentnego]
OB zadania YY, XX nie jest
prawidłowym OB.
Z tabeli DC_JOB
[XX = BO_NAME]
[YY = JOB_NUMBER]
Kolumna JOB_RUN_CTL
XX jest nieprawidłowa dla
zadania YY.
Z tabeli DC_JOB
[XX = JOB_RUN_CTL]
[YY = JOB_NUMBER]
Kolumna JOB_TYPE XX
jest nieprawidłowa dla
zadania YY.
Z tabeli DC_JOB
[XX = JOB_TYPE]
[YY = JOB_NUMBER]
Nie można powiązać ID
użytkownika OB dla zadania
YY za pomocą OB XX.
Z tabeli DC_JOB
[BB = USER_ID]
[XX = BO_NAME]
[YY = JOB_NUMBER]
22
Tabela 12. Powszechne problemy z narzędziem DataConnect (kontynuacja)
Miejsce
Rozwiązanie
Nie można utworzyć OB dla
zadania YY za pomocą OB
XX.
Z poziomu agenta
DataConnect, wpis
server.log
Agent nie mógł utworzyć obiektu
inteligentnego zadania DataConnect.
Należy się upewnić, że nazwa jest
poprawna i znajduje się w module
Z poziomu agenta
DataConnect, wpis
server.log
Agent nie mógł odwzorować
wymaganych pól na zadanie
DataConnect. Należy się upewnić, że
obiekt biznesowy XX zdefiniował
wszystkie pola w podstawowym OB
obiekt biznesowy. Prawdopodobnie
wymagane będzie ponowne
publikowanie, jeśli obiekt biznesowy
uległ zmianie. Przywróć stan
GOTOWY (lub 1).
Z poziomu agenta
DataConnect, wpis
server.log
Agent nie mógł przesłać zdarzenia
przepływu pracy dla nowego zadania
DataConnect. Prawdopodobna
przyczyna: brak opublikowanego
przepływu pracy dla zadania SYSTEM
DC PROCESS JOB oraz obiektu
biznesowego XX. Należy się upewnić,
że obiekt biznesowy został
opublikowany dla zdarzenia i obiektu
biznesowego XX. Popraw wpis lub
przepływ pracy i przywróć stan
GOTOWY (lub 1).
Z tabeli DC_JOB
[XX = BO_NAME]
[YY = JOB_NUMBER]
Nie można odwzorować pól
wymaganych do poprawnego
działania DataConnect w
przypadku zadania YY za
pomocą OB XX.
Z tabeli DC_JOB
[XX = BO_NAME]
[YY = JOB_NUMBER]
Nie można przesłać zdarzenia
przepływu pracy SYSTEM
DC PROCESS JOB dla
zadania YY za pomocą OB
XX.
Z tabeli DC_JOB
[XX = BO_NAME]
[YY = JOB_NUMBER]
Nie można opublikować.
Istnieją przetwarzane lub
oczekujące zadania
DataConnect związane z tym
obiektem biznesowym.
Z poziomu agenta publikacji, Przetwarzane lub oczekujące zadanie
DataConnect należy wyczyścić, zanim
PlatformRuntime
Wyjątek w pliku server.log będzie można pomyślnie zakończyć
publikowanie obiektu. Obydwie
operacje muszą zostać wyczyszczone
bez interwencji. Zadanie należy
ponownie opublikować, gdy zostaną
zakończone wszystkie zadania
oczekujące.
Nie można przenieść zadania
do triDCStartProcessing w
przypadku zadania YY za
pomocą OB XX.
Z poziomu agenta
DataConnect, wpis
server.log
Z tabeli DC_JOB
[XX = BO_NAME]
[YY = JOB_NUMBER]
Należy sprawdzić zmiany stanów
obiektu biznesowego XX, aby
zapewnić, że XX definiuje zmiany
stanu w podstawowej właściwości
triDataConnectJob w module
obiekt biznesowy. Prawdopodobnie
wymagane będzie ponowne
publikowanie, jeśli obiekt biznesowy
uległ zmianie. Przywróć stan
GOTOWY (lub 1).
23
Obsługa narzędzia DataConnect – porady
Dzięki poniższym poradom można rozszerzyć zakres obsługi narzędziaIBM TRIRIGA
DataConnect w firmie.
Tabela 13. Obsługa narzędzia DataConnect – porady
Porada
Opis
Zadanie zatwierdzenia
Zadania zatwierdzenia nie można uruchomić z poziomu zadania
DataConnect.
Ustawionym stanem zadania
DataConnect pozostanie
Przetwarzanie. Przepływ
pracy prawdopodobnie nie
zawiera wyzwolenia działania
pozwalającego na wybranie
stanu Niepowodzenie lub
Ukończony.
Jeśli stanem zadania DataConnect pozostanie Przetwarzanie, należy
sprawdzić instancję przepływu pracy pod kątem tego zadania.
Prawdopodobnie przepływ pracy został ukończony, ale nie istnieje
zadanie w przepływie pracy pozwalające na zmianę stanu na
Ukończony lub Niepowodzenie.
Kolumnę DC_PATH w tabeli
pomostowej można użyć w
celu ustawienia hierarchii
podczas wstawiania. Podczas
aktualizacji DC_PATH musi
być rekordem przeznaczonym
do aktualizacji.
Kolumna DC_PATH w tabeli pomostowej musi być użyta podczas
aktualizacji. W kolumnie DC_PATH należy określić rekord, który
zostanie zaktualizowany. Musi to być ścieżka
IBS_SPEC.OBJECT_PATH rekordu, który zostanie zaktualizowany.
Harmonogram realizacji
Aby uniknąć negatywnego wpływu na połączenia z bazą danych i
wątki dostępne na serwerze aplikacji, działanie zadań DataConnect
należy zaplanować w okresie najmniejszego obciążenia.
Problemy wyszukane przez
agenta DataConnect są
zapisywane w pliku dziennika
server.log.
Większość popularnych problemów dotyczących wpisów w tabeli
DataConnect (DC_JOB) jest obsługiwanych przez agenta
DataConnect. W przypadku wystąpienia problemu jest on rejestrowany
w pliku server.log, a wpis zadania DataConnect jest określany jako
Niepowodzenie. Dodatkowe informacje można uzyskać, włączając
funkcję rejestrowania debugowania w agencie DataConnect.
Użycie DC_PATH wraz z operacją wstawiania umożliwia wskazanie
zadaniu DataConnect, gdzie w hierarchii należy wstawić rekord.
Elementy podrzędne muszą zawierać ścieżkę elementów nadrzędnych
w kolumnie DC_PATH. Dzięki tej ścieżce zadanie DataConnect
ustawia hierarchię. Kolumna DC_PATH w przypadku obiektów
znajdujących się na szczycie hierarchii lub poza nią musi być pusta.
Po usunięciu problemu można przeprowadzić ponowną próbę
uruchomienia zadania z poziomu konsoli administratora. W tym celu
należy kliknąć odsyłacz Spróbuj ponownie.
24
Obiekt biznesowy sterowania
zadaniem
Obiekt biznesowy dla przepływu pracy zawierającego zadanie
DataConnect musi być podtypem triDataConnectJob to znaczy, że
obiekt musi być utworzony w module triDataConnectJob. W
przypadku wszystkich innych typów obiektów system wygeneruje
błąd.
JM pola numeru
Jeśli właściwość Pole tabeli pomostowej zostanie określona dla pola
numerów z powiązanym polem JM, które jest zdefiniowane w obiekcie
biznesowym, właściwość Pole tabeli pomostowej należy określić dla
pola JM.
Tabela 13. Obsługa narzędzia DataConnect – porady (kontynuacja)
Porada
Opis
Pola tabeli pomostowej
pochodzą z sekcji Ogólne
Tylko pola w sekcji Ogólne można określić jako pola tabeli
pomostowej. Aby pobrać dane z innych sekcji, należy użyć pól
tymczasowych w obiekcie biznesowym i za pomocą mechanizmów
przepływu pracy przenieść dane do odpowiednich pól innych niż
Ogólne. W przeciwnym razie należy użyć obiektu biznesowego
programu pomocy i pobrać wszystkie dane, a następnie za pomocą
mechanizmu przepływu pracy przenieść je do rzeczywistego obiektu
biznesowego.
Nazwa tabeli pomostowej
Za pomocą obiektu zarządzanego DataConnect w konsoli
administratora można wyszukać nazwę tabeli pomostowej. W tym celu
należy kliknąć pozycję Obiekty biznesowe z tabelami pomostowymi.
Nazwa pola bazy danych zostanie wyświetlona wraz z innymi
informacjami. Kliknięcie odsyłacza Rozwiń dane powoduje
wyświetlenie dodatkowych informacji dotyczących wybranych
wierszy, np. nazwy pól w tabeli pomostowej i zadania korzystające z
tabeli pomostowej.
Zawieszony przepływy pracy
Przepływu pracy nie można zawiesić podczas przetwarzania zadania
DataConnect.
Proces DataConnect
obsługuje obiekty biznesowe
z powiązanymi sekcjami
inteligentnymi.
Jeśli obiekt biznesowy zawiera sekcję inteligentną, którą należy
wypełnić poprzez integrację, do obiektu biznesowego należy wstawić
dodatkowe pole jako pole tabeli pomostowej. Następnie to pole należy
wypełnić w tabeli pomostowej z użyciem identyfikatora, względem
którego można określić zapytanie w celu wyszukania rekordu, który
zostanie powiązany z nowym obiektem inteligentnym. Podczas
przepływu pracy można określićzapytanie o rekord i powiązać go z
nowym obiektem inteligentnym.
Stan początkowy to stan, z
którym obiekt inteligentny
został utworzony. Nie jest to
stan, który można wybrać.
Jeśli w ramach integracji ma zostać wybrany ten stan obiektu
inteligentnego, dla stanu początkowego należy określić wartość null w
zadaniu DataConnect. Aby określić żądany stan obiektu, w treści
zadania DataConnect należy użyć czynności wyzwolenia.
Śledzenie błędów
Użytkownik może utworzyć rekord pozwalający na śledzenie błędów,
które wystąpiły podczas sprawdzania poprawności przepływ pracy.
Jeden ze sposobów polega na utworzeniu niestandardowego obiektu
biznesowego cstDataMigrationError w module triIntermediate. Obiekt
biznesowy może zawierać następujące pola:
v triCreatedSY: utworzona przez system data i godzina.
v triNameTX [typ błędu]: przechowuje migrację powodującą błąd.
v triLinkedRecordTX: pole lokatora łączące rzeczywisty rekord, w
przypadku którego podczas sprawdzania poprawności wystąpiły
błędy. Należy pamiętać o zdefiniowaniu powiązania między
obiektem biznesowym zawierającym błąd i dowolnym innym
obiektem biznesowym użytym podczas sprawdzania poprawności.
v triDescriptionTX [komunikat o błędzie]: przechowuje szczegóły
danego błędu.
v
Następnie należy utworzyć formularz dla rekordu błędu migracji
danych.
Zadanie Czynność
użytkownika
Zadania Czynność użytkownika nie można uruchomić z poziomu
zdania DataConnect.
Wyjątki w przepływie pracy
Działanie zadania DataConnect zakończy się niepowodzeniem, jeśli
przepływ pracy napotka poważny wyjątek podczas przetwarzania
przepływu pracy.
25
26
Rozdział 2. Integracja danych z narzędziem TRIRIGA Data
Integrator
Możliwe jest zaimportowanie danych rozdzielanych znakami tabulacji z systemu
zewnętrznego do bazy danych IBM TRIRIGA za pomocą narzędzia Data Integrator. Możliwe
są również masowe aktualizacje istniejących danych za pomocą narzędzia Data Integrator.
Przegląd procesu TRIRIGA Data Integrator
Narzędzie IBM TRIRIGA Data Integrator służy do importowania danych do obiektów
biznesowych bez potrzeby tworzenia skryptów technicznych. Dane rekordów mogą
pochodzić z dowolnego źródła, np. z bazy danych, pliku Microsoft Excel lub systemu
zewnętrznego. Bez względu na źródło danych program Data Integrator akceptuje tylko pliki
.txt w formacie rozdzielanym znakami tabulacji.
Narzędzie Data Integrator umożliwia przechwytywanie i wysyłanie grup rekordów do
oprogramowania IBM TRIRIGA bez potrzeby ręcznego wprowadzania kolejnych rekordów.
Importowanie istniejącej bazy danych zapewnia oszczędność czasu i zabezpiecza integralność
danych oraz zapobiega występowaniu problemów dot. jakości, które mogą występować w
przypadku ręcznego wprowadzania danych.
W oprogramowaniu Data Integrator dane są zawsze importowane do podstawowych tabel
językowych IBM TRIRIGA. Funkcja importowania do lokalizowanych tabel nie jest
obsługiwana.
Program Data Integrator może utworzyć powiązania pomiędzy dwoma rekordami. Rekord
nadrzędny musi istnieć w systemie przed utworzeniem powiązania. Sposób, w jaki tworzone
są moduły w systemie IBM TRIRIGA określa, które dane można zaimportować i powiązać ze
sobą.
Program Data Integrator może również zostać użyty do masowych aktualizacji istniejących
rekordów. Aby aktualizować wartość obiektu biznesowego w wielu istniejących rekordach,
można użyć narzędzia Data Integrator w celu grupowej zmiany wartości pól. Dzięki tej
metodzie nie trzeba aktualizować każdego rekordu pojedynczo za pomocą interfejsu
użytkownika.
Po wysłaniu wszystkich danych przez aplikację Data Integrator użytkownik inicjujący proces
wysyłania otrzymuje powiadomienie. Powiadomienie zawiera informacje o pomyślnym
zakończeniu wysyłania lub o błędach, które wystąpiły. Aby otrzymać powiadomienie,
użytkownik musi dysponować sekcją portalu Powiadomienia w obszarze głównym portalu.
W systemie obowiązuje kilka zasad zapewniających prawidłowe importowanie danych.
Pierwszy wiersz pliku rozdzielonego znakami tabulacji (.txt) lub plik nagłówkowy musi
zawierać kolumny odpowiadające wszystkim nazwom pól w obiekcie biznesowym, w
przypadku którego wykonywany jest proces importowania lub aktualizowania danych. W celu
ułatwienia tworzenia pliku nagłówkowego oprogramowanie Data Integrator wyposażono w
narzędzie umożliwiające utworzenie pliku zgodnego z oprogramowaniem Microsoft Excel.
Plik ten zawiera nazwy pól w pierwszym wierszu. Plik nagłówkowy staje się szablonem
wysyłania, do którego są wprowadzane wszystkie rekordy.
27
Typy pól
Niektórych typów pól można używać w narzędziu Data Integrator tylko gdy pola danych
rekordów są sformatowane w akceptowany sposób. Niedostosowanie się do tych wytycznych
może spowodować wystąpienie błędów podczas wysyłania rekordów lub wysyłanie może nie
zakończyć się w pełni pomyślnie.
Jeśli typ pola nie zawiera przykładu w tabeli, oznacza to, że ten typ pola nie jest obsługiwany
przez narzędzie Data Integrator. Powody zawarto w komentarzach.
Tabela 14. Typy pól rekordów
Typ pola
Przyr.
Użycie
Przycisk
czynności
AB
Obraz na
ekranie
używany jako
przycisk,
który można
kliknąć.
Logiczne
BL
Może
zawierać
wartość
TRUE lub
FALSE.
Obiekt
biznesowy
OB
Format
import.
Przykład
Komentarze
Nieprzeznaczone do
używania w narzędziu
Data Integrator.
Definiowany tylko w
narzędziu Budowniczy
formularzy. Wymagana
modyfikacja.
FALSE =
niewybrany
triReservableBL =
TRUE
TRUE =
wybrany
BOTypeName
(typ obiektu
biznesowego)
Służy do
powiązania
Lokalizacji,
Organizacji
lub Geografii
z rekordem.
FullPath (pełna
ścieżka)
Nieprzeznaczone do
Data Integrator.
Wygenerowany w
systemie przez
przepływ pracy.
RecordName
(nazwa rekordu)
SysModified
DateTime
(aktualizacja
godziny)
28
Klasyfik
acja
CL
Może
zawierać
wartość
wybraną ze
zdefiniowanej
hierarchii
wartości.
Klasyfik
acja grupowanie
CR
Służy do
grupowania
sum wg
klasyfik
acji.
Zachowanie
pisowni i
wielkości
liter.
Nowy obiekt
klasyfikacji
wymaga
wysyłania
hierarchicznego.
Moduł hierarchiczny.
Wymaga, aby plik
nagłówkowy zawierał:
Nadrzędny=
\Klasyfikacje oraz
pełną ścieżkę do
klasyfikacji
podrzędnej. Ścieżka nie
może się kończyć
znakiem ukośnika (\).
Nieprzeznaczone do
Data Integrator.
Wypełniane w
systemie przez
przepływ pracy lub
czynność grupowania.
Tabela 14. Typy pól rekordów (kontynuacja)
Format
import.
Typ pola
Przyr.
Użycie
Kolor
CO
Służy do
przechow.
koloru.
Numer
kontrolny
CN
Służy do
generowania i
przechow.
niepowtarz.
numerów ID.
Przykład
Wartość
koloru z
zachowaniem
pisowni i
wielkości
liter.
Komentarze
Należy wprowadzić
wartość wraz z
symbolem numeru (#),
a następnie
wprowadzić wartość
szesnastkową koloru.
Przykładowo: wartość
koloru czarnego to
#000000.
Numery kontrolne są
wypełniane przez
system podczas
publikowania lub
tworzenia. Operacja
jest wykonywana na
podstawie kryteriów
określonych na karcie
Publikuj obiektu
biznesowego.
Niewymagany, jeśli
pole Numer kontrolny
jest automatycznie
wypełniane przez
przepływ pracy lub
domyślnie określono
dla niego wypełnianie.
Data
DA
Służy do
przechow.
daty.
Format
domyślny
daty.
triStartDateDA =
01/01/2006
Data i
godzina
DT
Służy do
przechow.
daty i
godziny
kombin
acji.
Długa liczba
całkowita w
mili
sekundach.
triDateDT
odzwierciedla
08/21/2006
15:30:00 =
1156199400000
Czas trwania
DU
Służy do
przechow.
długości
odstępu
czasowego.
Opis: #Years
#Months
#Weeks
#Days
#Hours
#Minutes
#Seconds.
Wyrażany w cstDurationDU
następującym oznacza 5 dni, 6
godzin i 30 minut
formacie:
= 5d6h30m0s
8.x - użyj
#w#d#h#m
#s
Formaty 8.x, 9.x i 10.x
różnią się od siebie.
Należy się upewnić, że
do danego systemu
zostanie dostosowany
odpowiedni format.
9.x – użyj
#y#M#w#d
#h#m#s
10.x – użyj
#y#M#w#d
#h#m#s
Rozdział 2. Integracja danych z narzędziem TRIRIGA Data Integrator
29
Typ pola
Przyr.
Użycie
Zestawienie
finansowe
FR
Służy do
przechow.
sum innych
pół uwzgl. w
transakcjach
finansowych.
Obraz
IM
Służy do
przechow.
obrazu.
Format
import.
Przykład
Komentarze
Nieprzeznaczone do
Data Integrator.
Wypełniane w
systemie przez
przepływ pracy lub
czynność grupowania.
triImageIM =
//Company-1
/fileMojObraz
Nazwa.jpg
Wszystkie obrazy
muszą się znajdować w
folderze [główny
folder
instalacyjny]/
userfiles/images
przed rozpoczęciem
wysyłania. Ścieżki
obrazów wraz z
nazwami plików muszą
być w pełni zgodne.
Aby obrazy były
poprawnie
wyświetlane, nazwy
wszystkich plików
obrazów muszą się
zaczynać ciągiem
„file”.
30
Tylko
etykieta
LA
Służy do
określania
etykiety bez
odpow.
pola.
Lista
LI
Służy do
wybierania
wartości na
liście
wartości.
Uwaga
NO
Służy do
przechow.
tekstu
sformat. o
dowolnej
długości.
Numer
NU
Służy do
przechow.
daty.
Nieprzeznaczone do
importowania.
Definiowane tylko z
poziomu narzędzia
Budowniczy
formularzy. Wymagana
modyfikacja.
Zachowanie
pisowni i
wielkości
liter.
triMonthLI =
Grudzień
Pola uwag nie są
obsługiwane przez
narzędzie Data
Integrator.
Wartość
triGross
liczbowa z
MeasuredNU =
możliwością 12000.5
wprowadzenia
ułamka
dziesiętnego.
Przecinki, znaki $ ani
inne elementy
formatowania nie są
wymagane, o ile nie
wprowadzono wartości
dziesiętnych.
Format
import.
Typ pola
Przyr.
Użycie
Przykład
Hasło
PA
Tekst
Służy do
alfanum.
przechow.
wartości
tekstowych,
które można
modyfikować,
ale nie
wyświetlać w
interfejsie
użytkownika.
Tylko do
odczytu system
SY
Służy do
uzyskiwania
dostępu do
informacji o
rekordzie i
obiekcie
biznesowym,
za pomocą
którego
utworzono
dany rekord.
Wypełniane
przez
przepływy
pracy w
systemie IBM
TRIRIGA .
Importowanie
nie jest
wymagane.
Tekst
TX
Służy do
przechow.
wartości
tekstowych.
Zwykły tekst. Jedyne
ograniczenie to
liczba znaków w
polu obiektu
biznesowego. Jeśli
do pola
obsługującego 20
znaków zostanie
wysłanych 30
znaków, to 10 z
nich zostanie
obciętych.
Czas
TI
Służy do
przechow.
godziny.
Wczytywanie triStartTimeTI
długiej liczby oznacza 9:30:35
całkowitej
PM = 77435000
wyrażonej w
mili
sekundach.
UOM
UO
Służy do
powiązania
jednostki
miary z
polem lub
obiektem
biznesowym.
Zachowanie
pisowni i
wielkości
liter.
Adres URL
UR
Służy do
przechow.
adresu URL.
Pełna ścieżka
do katalogu,
wraz z
ciągiem http,
ftp lub \\.
Komentarze
Szyfrowane.
31
Typ pola
Przyr.
Użycie
Format
import.
Karta
systemowa::
Sekcja
Informacje o
rekordzie
Przykład
Komentarze
Ogólnie te pola są
wypełniane przez
przepływ pracy. W
przypadku wysyłana
danych do tych pól
istnieje ryzyko
powstania pętli
przepływu pracy,
dlatego wiele z tych
obszarów służy tylko
do odczytu.
Przykładowe pola:
NazwaLokalizacji
(lokalizacja graficzna)
NazwaOrganizacji
(nazwa organizacji)
Nazwa położenia
geogr. (nazwa
położenia
geograficznego)
Pole
Lokalizator
Odniesienie
pola do
innego
rekordu
obiektu
biznesowego.
Wymaga
pełnej ścieżki
w przypadku
rekordów
hierarch. lub
wartości,
która jest
wyświetlana
w polu.
Może wymagać
wczytywania
powiązanego, jeśli
nazwa wyświetlana nie
jest niepowtarzalna w
zestawie wyników
zapytania używanym
przez pole lokalizatora.
Nazwy publikowane
W narzędziu Projektant danych (w narzędziu Odwzorowanie OB) właściwości odwzorowania
określają pola zawierające Nazwę publikowaną dla rekordu tworzonego na podstawie obiektu
biznesowego. Pierwszych 100 znaków kombinacji wartości pól w Nazwie publikowanej
niepowtarzalnie identyfikuje rekord pośród wszystkich rekordów utworzonych na podstawie
tego samego obiektu biznesowego. Pliki danych oddzielane tabulatorami, które będą
przetwarzane przez narzędzie Data Integrator, muszą zawierać pola zapewniające
niepowtarzalne wartości dla pól Nazwa publikowana. Jeśli wartości pól dla Nazwy
publikowanej są dostarczane w przypadku istniejącego rekordu, narzędzie Data Integrator
aktualizuje istniejący rekord z zastosowaniem dodatkowych wartości pól wprowadzonych w
przesłanym pliku.
Jeśli przesłany plik danych oddzielonych tabulatorami nie zapewnia niepowtarzalnych Nazw
publikowanych, rekord może nie zostać utworzony w narzędziu Data Integrator. W
przeciwnym razie rekord może zostać utworzony w sytuacji, gdy oczekiwano jego
aktualizacji lub może dojść do zaktualizowania nieprawidłowego rekordu. Możliwe jest
również, że pierwszych 100 znaków w pliku oddzielonym tabulatorami może odpowiadać
nazwie rekordu, ale po 100 znakach zgodność może nie być zachowana. W takim przypadku
rekord jest odrzucany bez wykonania operacji aktualizacji ani tworzenia.
32
Pola numerów
Pola powiązane z sumami w sekcjach inteligentnych zawierających wiele rekordów określają,
że pola na liście pól sekcji inteligentnej muszą być zsumowane. Pola są tworzone w sekcji
Ogólnej obiektu biznesowego, która jest wypełniana automatycznie za pomocą sum
wybranych z listy pól. Oprogramowanie IBM TRIRIGA używa tych pól w niektórych
obiektach biznesowych w sekcjach podsumowań i w raportach. Są to pola numerów.
Sterowanie wartością Jednostka miary w przypadku pól Numer odbywa się na poziomie
obiektu biznesowego. Użytkownik uzyskuje wartość domyślną która została zdefiniowana w
projektancie danych dla tego obiektu biznesowego.
Pola liczb kontrolnych
Narzędzie Data Integrator nie może obsługiwać aktualizacji rekordów w przypadku obiektów
biznesowych opisanych publikowanymi nazwami zawierającymi pole liczby kontrolnej, gdy
zaznaczone jest pole wyboru Generuj na podstawie tworzenia. W tym scenariuszu
narzędzie Data Integrator nie może określić, czy istnieje rekord pliku wysyłania, co powoduje
tworzenie nowych rekordów po każdym wysłaniu pliku.
Wymagania
Program Data Integrator do pracy wymaga uruchomienia Agenta importu danych w
Menedżerze agentów w Konsoli administratora. Ponadto wysyłany plik musi zawierać
odpowiednie pola nazwy publikowanej w przypadku importowanego obiektu biznesowego.
Jeśli jednak wysyłany plik nie zawiera wymaganych pól w przypadku danego obiektu
biznesowego, po zalogowaniu i otwarciu rekordu w oprogramowaniu IBM TRIRIGA jest
wyświetlany błąd dotyczący braku wymaganego pola. Nowe, zaimportowane rekordy muszą
również zawierać odpowiednie wartości w polach, aby działania użytkownika przebiegały
bezproblemowo.
Istnieją dwa typy wymagań w odniesieniu do oprogramowania Data Integrator: funkcyjne i
użytkowe. Niespełnienie dowolnego z nich może spowodować wystąpienie
nieprzewidzianych skutków. W przypadku niespełnienia wymagań funkcyjnych występują
błędy podczas wysyłania danych w oprogramowaniu Data Integrator. Niespełnienie wymagań
dotyczących użyteczności powoduje, że dane zostaną wysłane pomyślnie, ale wystąpią
problemy związane z obsługą aplikacji.
Przed wykonaniem rzeczywistej aktualizacji lub przesłania danych zawsze zaleca się
przetestować wszystkie pliki Data Integrator względem kopii danych w systemie
produkcyjnym.
Wymagania funkcjonalne
W narzędziu Data Integrator obowiązuje kilka wymagań funkcjonalnych wpływających na
nazwy publikowane, formaty plików oddzielonych tabulatorami i ścieżki nadrzędne.
Spełnienie tych wymagań gwarantuje opracowanie zgodnego pliku nagłówkowego.
Nazwy publikowane
Wszystkie obiekty biznesowe muszą zostać opublikowane, zanim użytkownicy będą mogli
uzyskać do nich dostęp. Menu Publikuj znajduje się na karcie Narzędzia w Projektancie
danych. W wysyłanych danych należy uwzględnić wszystkie pola definiujące nazwę
publikowaną obiektu biznesowego. Zazwyczaj jako nazwa publikowana służy pole nazwy lub
ID. Można jednak również użyć innych pól.
33
Przykładowo: jeśli nazwa publikowana obiektu biznesowego triPeople składa się z nazwiska,
imienia i ID, to nazwą publikowaną będzie „Smith, John - 10025884”. Definicję nazwy
publikowanej obiektu biznesowego można wyświetlić, otwierając obiekt biznesowy w
Projektancie danych i wyświetlając właściwości Odwzorowanie OB w menu Narzędzia.
Aby nazwy publikowane zawierały pola numerów kontrolnych, nazwy należy ponownie
zdefiniować z użyciem niepowtarzalnej wartości, która nie korzysta z numeru kontrolnego. Po
zakończeniu wysyłania można zmienić ustawienia nazwy publikowanej i ponownie
uwzględnić pole numeru kontrolnego.
Ostrzeżenie: Nazwa publikowana nie może zawierać pola Numer kontrolny, gdy istniejące
rekordy są aktualizowane w oprogramowaniu IBM TRIRIGA. W takiej sytuacji zostanie
utworzony nowy rekord.
Format pliku oddzielanego tabulatorami
Jeśli wszystkie pola Nazwa publikowana znajdują się w pliku nagłówkowym i są bezbłędnie
zapisane, to ostatni warunek funkcjonalny polega na zapisaniu pliku w formacie wartości
oddzielonych tabulatorami. Wymaganym rozszerzeniem jest .txt, ale nazwa pliku jest
dowolna.
Ścieżki nadrzędne
Aby móc wysłać dane rekordów hierarchicznych do modułów hierarchicznych i obiektów
biznesowych, kolumna Nadrzędny musi zawierać pełną ścieżkę elementu nadrzędnego
wysyłanego rekordu. Błędne zdefiniowanie ścieżki nadrzędnej powoduje powstanie
osieroconych rekordów, które nie są wyświetlane w oknie hierarchii.
Wymagania dotyczące użyteczności
Pliki mogą wyglądać na wysłane pomyślnie, ale wysyłka to tylko pierwsze z wymagań, które
należy spełnić. Po otwarciu rekordu przez użytkownika wymagane pole może nie być
wypełnione, co spowoduje wyświetlenie komunikatu o błędzie. Wymagane pola, obliczenia i
grupowania to obszary, w których mogą wystąpić problemy związane z użytecznością.
Pola wymagane
Narzędzie Data Integrator wymaga bezbłędnie (z uwzględnieniem wielkości liter) zapisanych
publikowanych nazw. Tylko wtedy dane zostaną wysłane poprawnie. Istnieją jednak jeszcze
inne wymagania. W przypadku nowych rekordów plik nagłówkowy Data Integrator musi
zawierać wszystkie wymagane pola. Ponadto we wszystkich polach zawartych w wierszu
nagłówka w pliku Data Integrator są rozpoznawane małe i wielkie litery, a wszystkie nazwy
muszą być zapisane poprawnie.
Jeśli wymagane pola nie zostaną zawarte w pliku nagłówkowym, rekord może nie zostać
wysłany pomyślnie. Użytkownik, który się zaloguje i otworzy rekord, zobaczy komunikat o
błędzie dotyczącym braku wymaganego pola. W takiej sytuacji użytkownik musi wypełnić
wszystkie wymagane pola, zanim możliwe będzie wykonanie zmiany stanu rekordu. Jeśli w
ramach wysyłania danych określony zostanie stan tylko do odczytu, użytkownik nie może
zmienić tego stanu na stan przeznaczony do edycji i nie może wprowadzać wartości w
wymaganych polach.
Takiej sytuacji można uniknąć, uwzględniając wszystkie wymagane pola w pliku
nagłówkowym przed wysłaniem. Za pomocą narzędzia Budowniczy formularzy można
określić, które pola są wymagane i dodać je do pliku nagłówkowego.
34
Obliczenia
Uruchomienie obliczeń wypełniających pola formuły przeznaczone tylko do odczytu wymaga
zastosowania niestandardowego przepływu pracy. Pól przeznaczonych tylko do odczytu nie
można wypełnić bezpośrednio. Należy natomiast użyć logiki przepływu pracy pozwalającej
na uruchomienie obliczeń po zakończeniu wysyłania.
Grupowanie
Użytkownik musi zastosować niestandardowy przepływ pracy, aby zgrupować informacje z
wielu obiektów biznesowych. Nie można zapomnieć o zapisaniu przepływu pracy
przeglądającego elementy od najniższego elementu podrzędnego do najwyższego elementu
nadrzędnego we wszystkich obiektach w danej hierarchii.
Niestandardowe przepływy pracy
Niestandardowe przepływy pracy definiują całą logikę wysyłania w odniesieniu do rekordu.
Należy je tworzyć na bieżąco i wyzwalać podczas wysyłania. Przykładowo: przepływ pracy
można wyzwolić poprzez czynność zmiany stanu null na inny lub poprzez asynchroniczny
przepływ pracy podczas zdarzenia Powiąż.
Ostrzeżenie: Niektóre przepływy pracy (np. powiązane z grupowaniem lub obliczeniami)
należy wycofać przed rozpoczęciem wczytywania w narzędziu Data Integrator.
Pliki danych oddzielane tabulatorami
Plik oddzielany tabulatorami zawiera wiersze danych. Każdy wiersz danych zawiera co
najmniej jeden fragment danych. Każdy fragment danych jest nazywany polem. Aby pliki
rozdzielane tabulatorami odczytać w programie Data Integrator, w każdym wierszu muszą
one zawierać taką samą liczbę pól, ale nie wszystkie pola muszą zawierać wartości.
Zanim w programie Data Integrator zostanie rozpoczęty odczyt pliku oddzielonego
tabulatorami, do pliku użytkownik musi przypisać moduł, obiekt biznesowy i formularz.
Dzięki tym informacjom w programie Data Integrator można określić położenie danych w
pliku po wysłaniu.
W programie Data Integrator pola danych w każdym wierszu (poza pierwszym) pliku
oddzielonego tabulatorami są używane do utworzenia lub zaktualizowania rekordu w
programie IBM TRIRIGA Application Platform. Jeśli obiekt biznesowy przypisany do pliku
już zawiera wysłany rekord, ten rekord jest aktualizowany z użyciem wartości z tego pliku.
Jeśli wysłany rekord jeszcze nie istnieje, zostanie on utworzony za pomocą obiektu
biznesowego i formularza powiązanych z pikiem.
W programie Data Integrator należy określić, które pola zawierają dane z określonych pól w
wierszach pobranych z pliku oddzielonego tabulatorami. Następnie docelowe położenie
danych pochodzących z pól jest określane na podstawie pierwszego wiersza nazywanego
nagłówkiem. Pierwszy wiersz pliku oddzielonego tabulatorami nie jest obsługiwany jak
wiersz danych, na podstawie których jest tworzony lub aktualizowany rekord. Pola w
pierwszym wierszu powinny natomiast zawierać nazwę pola w obiekcie biznesowym
powiązanym z plikiem. Nazwa pola określa pole, w którym zostaną wstawione dane z
określonego pola.
Najprostszy sposób generowania pliku oddzielonego tabulatorami polega na użyciu aplikacji,
za pomocą której można wygenerować taki plik i wstawić nazwy pól w pierwszym wierszu.
Przykładowo: niektóre aplikacje umożliwiają eksportowanie lub drukowanie raportu do pliku
rozdzielanego znakami tabulacji. Jeśli użytkownik może określić nagłówek każdej kolumny,
35
prawdopodobnie oznacza to, że dana aplikacja zapewnia możliwość wstawiania wartości
nagłówka w polach w pierwszym wierszu. Podczas pracy z aplikacją generującą pliki
oddzielone tabulatorami przeznaczone do użycia w programie Data Integrator należy określić
nagłówki kolumn odpowiadające nazwom pól w programie IBM TRIRIGA, w których
powinny zostać wstawione wartości. Po prawidłowym skonfigurowaniu nagłówków kolumn
(aby odpowiadały one nazwom pól obiektu IBM TRIRIGA) tworzenie plików oddzielonych
tabulatorami przeznaczonych do użycia w programie Data Integrator odbywa się
automatycznie.
Jeśli w aplikacji nie można wstawić nagłówków do pliku oddzielonego tabulatorami, danych
z tego pliku nadal można nadal używać w programie Data Integrator. Jednak proces
przygotowywania pliku oddzielonego tabulatorami dla programu Data Integrator wymaga
wykonania dodatkowych działań. Jeśli w programie, z którego użytkownik chce
zaimportować dane, nie można wstawić nazw pól w pierwszym wierszu pliku oddzielonego
tabulatorami, nazwy można dodać, edytując plik ręcznie. W celu edycji plików oddzielonych
tabulatorami należy użyć programu Microsoft Excel.
Podczas edytowania pliku oddzielonego tabulatorami za pomocą programu Excel w
programie Excel może zostać wyświetlony monit o wprowadzenie informacji o pliku. Monit
w programie Excel jest wyświetlany w celu umożliwienia jednoznacznego określenia typu
edytowanego pliku. Jedno z pytań wyświetlanych w programie Excel może się odnosić do
sposobu przechowywania danych w pliku (dane rozdzielane czy o stałej szerokości). Należy
wybrać opcję Rozdzielane. Następnie w programie Excel jest wyświetlany monit o wybranie
znaku rozdzielającego wartości. Należy wybrać znak tabulacji. Nie należy określać innych
znaków oddzielających ani żadnych opcji.
Po wstawieniu pierwszego wiersza zawierającego nazwy pól należy zapisać plik w formacie
danych oddzielonych znakami tabulacji. Jeśli wcześniej zapisano plik Excel w formacie
macierzystym, można zignorować ostrzeżenia dotyczące funkcji nieobsługiwanych w
formacie danych oddzielanych tabulatorami. Teraz plik oddzielony tabulatorami można
przetworzyć w programie Data Integrator.
W programie Data Integrator można zaimportować dane z aplikacji, która nie umożliwia
tworzenia plików oddzielonych tabulatorami, jeśli za pomocą tej aplikacji możliwe jest
wyeksportowanie danych w formacie, który można otworzyć w programie Excel. Jeśli w
aplikacji można utworzyć plik obsługiwany przez program Excel, to taki plik należy wczytać
do programu Excel. Jeśli to konieczne, należy dodać pierwszy wiersz zawierający
odpowiednie nazwy pól. Następnie należy zapisać plik jako plik tekstowy oddzielany
tabulatorami.
Aby edytować plik danych w celu dodania pierwszego wiersza zawierającego nazwy pól, tych
nazw nie trzeba wpisywać ręcznie. Pierwszy wiersz można utworzyć w programie Data
Integrator.
Pliki nagłówkowe
Plik nagłówkowy to ważny szablon, w którym pierwszy wiersz nagłówka określa nazwy pól,
do których importowane są dane. Ten plik można utworzyć na kilka sposobów. Jednak
najważniejszym jest, aby nagłówki pola szablonu odpowiadały nazwom pól obiektu
biznesowego pod względem wielkości liter oraz zapisu i zawierały pola Nazwa publikowana
przeznaczone dla obiektu biznesowego.
W oprogramowaniu IBM TRIRIGA występują dwa typy modułów: hierarchiczne i inne niż
hierarchiczne. W obydwu przypadkach proces tworzenia pliku nagłówkowego jest taki sam.
Różnicą jest, że w przypadku wysyłania hierarchicznego wymagana jest kolumna Nadrzędny
zawierająca pełną ścieżkę do rekordu nadrzędnego względem wysyłanego rekordu.
36
Pliki nagłówkowe dla modułów innych niż hierarchiczne
Obiekty inne niż hierarchiczne to obiekty płaskie, pozbawione powiązania
nadrzędny-podrzędny. Tego typu obiekty mogą istnieć bez obiektów nadrzędnych.
Przykładowe, inne niż hierarchiczne obiekty biznesowe IBM TRIRIGA to triPeople,
triSpecification i triAsset.
Użytkownik może potwierdzić, że moduł jest inny niż hierarchiczny w projektancie danych.
W tym celu należy wybrać moduł i zapoznać się z jego właściwościami.
Po utworzeniu pliku nagłówkowego należy go wysłać. W tym celu w narzędziu Data
Integrator są wymagane odpowiednie uprawnienia dostępu. Gdy odpowiednie kroki zostaną
wykonane prawidłowo, a dane są zgodne z formatowaniem pola, wysyłanie zostanie
wykonane pomyślnie. Podobnie jak w przypadku wszystkich operacji wysyłania w narzędziu
Data Integrator system przesyła użytkownikowi powiadomienie o statusie wysyłki.
Pliki nagłówkowe dla modułów hierarchicznych
Obiekty hierarchiczne zawierają powiązania nadrzędny-podrzędny. Oznacza to, że element
podrzędny jest uzależniony od obecności obiektu nadrzędnego. Przykładowe, hierarchiczne
obiekty biznesowe IBM TRIRIGA to Geografia, Lokalizacja i Organizacja.
Użytkownik może potwierdzić, że moduł jest hierarchiczny w Projektancie danych. W tym
celu należy wybrać moduł i zapoznać się z jego właściwościami.
Moduły hierarchiczne są wyjątkowe, ponieważ wymagają dodatkowego pola w wierszu
nagłówka w pliku nagłówkowym Data Integrator. Słowem kluczowym jest Nadrzędny.
Umożliwia ono powiązanie rekordu podrzędnego z odpowiednim obiektem biznesowym w
drzewie.
Wszystkie drzewa hierarchiczne zawierają element główny, który jest taki sam jak nazwa
modułu. W przypadku obiektów biznesowych organizacji elementem głównym jest
Organizacja. W przypadku obiektów biznesowych lokalizacji elementem głównym jest
Lokalizacja. W przypadku obiektów biznesowych geografii elementem głównym jest
Geografia.
Poza importowaniem danych niezbędne może się okazać zaimportowanie lub dołączenie
rekordów podrzędnych względem innego obiektu biznesowego. Przykładowo: rekordy
budynków stanowią elementy podrzędne dla elementu głównego lokalizacji. Rekordy
kondygnacji stanowią elementy podrzędne budynku. Rekordy powierzchni są elementami
podrzędnymi kondygnacji.
W pliku nagłówkowym należy ręcznie dodać kolumnę Nadrzędny. Słowo kluczowe
Nadrzędny jest jednym ze słów zarezerwowanych w oprogramowaniu IBM TRIRIGAi nie
jest nigdy używane jako opcja podczas tworzenia nagłówka.
Tworzenie plików nagłówkowych
Za pomocą narzędzia Data Integrator można utworzyć plik nagłówkowy dla modułu
hierarchicznego i innego niż hierarchiczny.
Procedura
1. Z poziomu głównego paska nawigatora wybierz pozycje Narzędzia > Administracja >
Data Integrator.
2. Wybierz moduł zawierający obiekt biznesowy, który narzędzie Data Integrator musi
powiązać z plikiem. W polu są wyświetlane wszystkie zdefiniowane moduły.
37
3. Wybierz obiekt biznesowy, który narzędzie Data Integrator musi powiązać z plikiem. To
pole zawiera wszystkie opublikowane obiekty biznesowe w wybranym module.
4. Wybierz formularz (GUI), który zostanie powiązany z rekordami w pliku. To pole
zawiera wszystkie opublikowane formularze w przypadku wybranego obiektu
biznesowego. Podczas wysyłania możliwe jest, że nie istnieje rekord wybranego
formularza dla określonej nazwy publikowanej. Jeśli jednak istnieje inny rekord o tej
samej nazwie publikowanej w przypadku innego formularza, wysłane dane są dołączane
do istniejącego rekordu, pomimo tego że zawiera on inny formularz.
5. Wybierz pozycję Utwórz nagłówek.
6. Skontroluj informacje na ekranie Wyświetl kolumny. Dla każdego pola w wybranym
obiekcie biznesowym lub formularzu dostępne jest pole wyboru.
7. Wybierz żądane pola. Po kliknięciu pola wyboru system dodaje nazwę odpowiedniego
pola do pola Kolejność kolumn w prawym górnym narożniku. Należy się upewnić, że
wszystkie elementy Nazwy publikowanej i wszystkie wymagane pola zostaną
uwzględnione. Domyślnie pola w sekcji Kolejność kolumn są wyświetlane w porządku
ich wybierania. Porządek w sekcji Kolejność kolumn jest zgodna z kolejnością
wyświetlania pól w pliku nagłówkowym.
8. Aby zmienić kolejność pól, wybierz nazwę pola i kliknij strzałkę w górę lub w dół.
9. Gdy lista pól w sekcji Kolejność kolumn jest uzupełniona, a pola są umieszczone w
prawidłowej kolejności, wybierz pozycję Eksport.
10. Wybierz opcję Zapisz.
11. Wybierz położenie docelowe na komputerze lokalnym. Rozwiązanie Data Integrator
pozwala zapisać plik w formacie .csv, jednak plik jest technicznie generowany w
formacie .htm. Zmień rozszerzenie pliku .csv na .htm, zmień opcję Zapisz jako typ na
Wszystkie pliki i wybierz przycisk Zapisz.
12. Wyszukaj i otwórz zapisany plik w Microsoft Excel. Zauważ, że wybrane nazwy pól
znajdują się w pierwszym wierszu formularza.
13. Jeśli ten plik nagłówkowy jest przeznaczony dla modułu hierarchicznego, słowo
kluczowe Nadrzędny znajduje się w pierwszej, wolnej komórce pierwszego wiersza.
Jeśli ten plik nagłówkowy jest przeznaczony dla modułu innego niż hierarchiczny,
należy pominąć ten krok.
a. Kolumna Nadrzędny zawiera pełną ścieżkę elementu nadrzędnego wysyłanego
rekordu. Należy wprowadzić pełną ścieżkę nadrzędnego obiektu biznesowego, aby
narzędzie Data Integrator mogło znaleźć element nadrzędny i dołączyć nowy rekord
podrzędny w drzewie hierarchii.
b. Zawsze należy uwzględniać pełną ścieżkę nadrzędnego obiektu biznesowego wraz z
pierwszym ukośnikiem odwrotnym (\). Na końcu ścieżki nadrzędnej nie należy
umieszczać ukośnika odwrotnego (\).
14. Wprowadź dane w odpowiednich kolumnach. Jeśli dane nie są wprowadzane
bezpośrednio w pliku nagłówkowym, ten krok należy pominąć.
a. Zmień format wszystkich komórek w arkuszu kalkulacyjnym Microsoft Excel na
komórki tekstowe. Za pomocą tego ustawienia można wprowadzić dowolną wartość,
unikając formatowania konwersji danych. Wybierz komórkę w lewym górnym
narożniku (ponad 1 i na lewo od A); w ten sposób zostanie wybrany cały arkusz
kalkulacyjny. Następnie wybierz pozycje Format > Komórki > Tekst > OK.
b. Wartości Lista i Klasyfikacja muszą być w pełni zgodne (z zachowaniem pisowni i
wielkości liter).
15. Zapisz plik w formacie .txt rozdzielonym tabulatorami. Upewnij się, że nazwa pliku
kończy się rozszerzeniem .txt i że na liścieZapisz jako typ wybrano pozycję Tekst
(rozdzielony znakami tabulacji)(*.txt).
16. Wybierz przycisk Tak.
38
Wysyłanie powiązane - przygotowanie
Importowanie rekordów danych z powiązaniami wymaga większego nakładu pracy, niż
wysyłanie hierarchiczne. Za pomocą funkcji wysyłania powiązanego w narzędziu Data
Integrator można powiązać rekordy ze sobą; można np. połączyć osoby z organizacjami,
zasoby z miejscami i zasoby z osobami. Za pomocą łańcucha powiązania można ustanowić
powiązanie między dwoma rekordami danych.
Łańcuchy powiązania
Przed utworzeniem pakietu do wysłania zawierającego powiązania należy potwierdzić
obecność łańcuchów powiązania, które zostaną użyte w procesie wysyłania powiązanego w
narzędziu Data Integrator. Dostępne są dwie metody potwierdzania łańcuchów powiązania:
kontrola karty Powiązania dotyczącej rekordów i za pomocą Menedżera powiązania.
Każdy obiekt biznesowy zawiera kilka powiązań z innymi obiektami biznesowymi. Należy
zrozumieć znaczenie wyrażenia czasownikowego relacji, które zostało zdefiniowane w celu
powiązania dwóch obiektów biznesowych. Jeśli to konieczne, najpierw należy zdefiniować
powiązanie i powiązanie odwrotne w Menedżerze powiązania.
Identyfikowanie powiązań
Większość rekordów IBM TRIRIGA zawiera kartę Powiązania w odpowiednich
formularzach. Za pomocą karty Powiązania można identyfikować powiązania na poziomie
rekordu i odpowiednie łańcuchy powiązań dla określonych rekordów.
O tym zadaniu
W tym przykładzie przedstawiono powiązania dla rekordu działu.
Procedura
1. Z poziomu głównego paska nawigatora wybierz menu Portfel .Zostanie wyświetlona
strona Portfel.
2. W sekcji portalu Organizacje wybierz pozycję Działy.
3. Wybierz nazwę każdego rekordu na stronie Działy.
4. W rekordzie wybierz kartę Powiązania.
5. Wybierz moduł.
6. Wybierz obiekt biznesowy.
7. Przejrzyj wyniki. Na liście Rekordy wyświetlane są wszystkie rekordy zawierające
powiązanie od rekordu otwartego w formularzu. Wartość łańcucha (nazywana również
łańcuchem powiązania) to wyrażenie czasownikowe opisujące powiązanie istniejące
między dwoma rekordami.
Weryfikowanie reguł powiązań
Za pomocą Menedżera powiązania można potwierdzić poprawność reguł powiązania na
poziomie obiektu biznesowego i odpowiednich łańcuchów powiązania.
Procedura
1. Z poziomu głównego paska nawigatora wybierz pozycje Narzędzia > Narzędzia do
budowania > Menedżer powiązania.
2. W panelu Moduł wybierz moduł, do którego zostaną wysłane rekordy za pomocą
narzędzia Data Integrator.
3. W panelu głównym znajdź i potwierdź reguły powiązania widoczne w kolumnie
Powiązanie.
39
Dodawanie powiązań do plików nagłówkowych
Użytkownik może tworzyć powiązania między rekordami w środowisku IBM TRIRIGA
Application Platform i rekordami wysyłanymi przez narzędzie Data Integrator. Aby
zastosować ten proces, w pliku nagłówkowym rozdzielonym tabulatorami można dodać
określone informacje w celu zdefiniowania każdego powiązania.
O tym zadaniu
Informacje pozwalają zidentyfikować:
v Moduł zawierający obiekt biznesowy użyty do utworzenia rekordu przeznaczonego do
powiązania z wysłanymi rekordami.
v Obiekt biznesowy użyty do utworzenia rekordu przeznaczonego do powiązania z
wysłanymi rekordami.
v Nazwę powiązania między istniejącymi rekordami i nowymi rekordami.
Po zakończeniu procesu wysyłania wykorzystującego powiązanie dwa rekordy
odzwierciedlają relację na karcie Powiązanie. Powiązanie jest tworzone „od” rekordu
istniejącego w kolumnie Powiąż „do” wysyłanego rekordu. Jeśli powiązanie na poziomie
obiektu biznesowego istnieje w Menedżerze powiązania dla łańcucha powiązania określonego
w kolumnie Powiąż, odpowiednie powiązanie jest tworzone w przeciwnym kierunku.
Narzędzia Data Integrator nie można używać w celu wypełniania sekcji inteligentnej ani
niektórych typów pól lokalizatora. W tym celu należy utworzyć niestandardowy przepływ
pracy dla każdego typu powiązania i za jego pomocą dołączyć powiązany rekord do sekcji
inteligentnej lub pola lokalizatora. Samo powiązanie dwóch rekordów nie powoduje ich
wyświetlenia w sekcjach inteligentnych ani polach lokalizatora. Wyjątkiem jest sekcja
zapytania korzystająca z tego samego powiązania.
Procedura
1. W nowej kolumnie po prawej stronie ostatniej kolumny danych wprowadź słowo
kluczowe Associate.
2. Wstaw dwa wiersze między wiersz nagłówka i pierwszy wiersz danych. Dane teraz
rozpoczynają się w wierszu 4.
3. W wierszu 2. kolumny Powiąż wprowadź w pełni kwalifikowaną nazwę obiektu
biznesowego i ujmij ją w podwójne symbole procentu. Przykładowo:
%%triPeople:triPeople%%. Ten wiersz odzwierciedla moduł i obiekt biznesowy
rekordów, od których powiązanie jest przedstawiane jako
%%Module:BusinessObject%%.
4. W wierszu 3. kolumny Powiąż wprowadź łańcuch powiązania i ujmij go w podwójne
symbole procentu. Przykładowo: %%Manages%%. Łańcuch powiązania musi być
zdefiniowany od %%Module:BusinessObject%% w wierszu 2. do obiektu
biznesowego dla wysłanego pliku.
5. W każdym wierszu arkusza kalkulacyjnego w kolumnie Powiąż wprowadź nazwę
istniejącego rekordu, od którego zostanie przeprowadzone powiązanie nowego rekordu.
Przygotowanie zadania w przepływie pracy - wysyłanie
powiązane
Zadania w przepływie pracy nie są wymagane podczas wysyłania powiązanego, ponieważ ta
operacja może istnieć samodzielnie i tworzyć powiązania. Jeśli jednak rekord w kolumnie
Powiąż również należy dołączyć do sekcji inteligentnej, narzędzie Data Integrator może
przetworzyć operację wysyłania powiązanego z zastosowaniem przepływu pracy.
40
O tym zadaniu
W tym scenariuszu tymczasowy łańcuch powiązania w kolumnie Powiąż wyzwoli przepływ
pracy, który dołączy rekord do właściwej sekcji wysłanego rekordu lub odwzoruje inne
elementy. Następnie przepływ pracy usunie powiązanie tymczasowe utworzone przez
narzędzie Data Integrator i utworzy prawidłowe powiązanie poprzez odwzorowanie rekordu
na sekcję inteligentną lub pole lokalizatora. Po odwzorowywaniu rekordu system IBM
TRIRIGA automatycznie utworzy prawidłowe powiązanie między rekordami w sekcji.
Ważne: W przepływie pracy użyj łańcucha powiązania nieużywanego aktualnie przez
żaden obiekt. W ten sposób można zapewnić wyzwolenie przepływu pracy wyłącznie po
powiązaniu rekordów w wyniku operacji wysyłania, a nie przez czynność użytkownika.
Upewnij się, że jest używany łańcuch powiązania znajdujący się na liście Typy powiązań w
Menedżerze list. W razie potrzeby do listy można dodać własny łańcuch.
Kierunek powiązania jest istotny. Powiązanie jest tworzone „od” rekordu w kolumnie Powiąż
„do” wysyłanego lub aktualizowanego rekordu. O ile nie istnieje powiązanie na poziomie
obiektu biznesowego dla powiązania określonego w kolumnie Powiąż, to powiązanie nie
zostanie utworzone w przeciwnym kierunku.
W tym scenariuszu istnieje tylko powiązanie (oraz odpowiednie zdarzenie Powiąż) utworzone
„od” rekordu organizacji „do” wysłanego lub zaktualizowanego rekordu triPeople. Ponieważ
nie istniało powiązanie na poziomie obiektu biznesowego dla typu powiązania określonego w
operacji wysyłania Data Integrator, żadne powiązanie nie zostanie zdefiniowane w
przeciwnym kierunku.
Procedura
1. Skontroluj plik Data Integrator. W tym scenariuszu kolumna Powiąż określa, że
powiązanie typu Wyślij powiązane jest tworzone „od” danego rekordu organizacji „do”
rekordu triPeople.
2. Jeśli plik Data Integrator używa łańcucha powiązania, który nie istnieje w systemie,
należy go dodać do listy Typy powiązań w Menedżerze list.
3. Aby otworzyć Menedżera list, wybierz opcje Narzędzia > Administracja > Listy.
4. W sekcji Zarządzanie wg wybierz listę Typy powiązań. Ładowanie listy może potrwać
dłużej niż minutę.
5. Wprowadź łańcuch powiązania od pliku Data Integrator w polu Wartość.
6. Wybierz przycisk Zapisz wpisy.
7. Utwórz nowy przepływ pracy w module organizacji zgodnie z poniższym opisem.
Zadanie rozpoczęcia definiuje warunek wyzwolenia przepływu pracy. W tym
scenariuszu przepływ pracy zostanie uruchomiony po powiązaniu rekordu organizacji z
rekordem triPeople za pomocą łańcucha Wyślij powiązane.
8. W zadaniu modyfikacji określ odwzorowanie rekordu podstawowego przepływu pracy
na rekord dodatkowy. To znaczy, że rekord podstawowy przepływu pracy jest obiektem
biznesowym zadania rozpoczęcia. A rekord dodatkowy jest dodatkowym obiektem
biznesowym na drugim końcu powiązania w zadaniu rozpoczęcia. W tym scenariuszu
zostanie wykonane odwzorowanie rekordu Organizacja na rekord triPeople, co pozwoli
na odwzorowanie rekordu organizacji na sekcję inteligentną w rekordzie osób.
9. Wybierz pozycję Edytuj odwzorowanie, aby otworzyć okno Odwzorowanie obiektu.
10. Kliknij przycisk Wyczyść wszystkie, aby usunąć wszystkie odwzorowania pól.
Usuwanie odwzorowań może potrwać chwilę.
11. Przewiń w dół do sekcji inteligentnej triPrimaryOrganization.
12. Kliknij ikonę Szukaj.
41
13. Dla sekcji wybierz pozycję Źródłowa. To ustawienie powoduje odwzorowanie rekordu
źródłowego (Organizacja) na sekcję rekordu docelowego (triPeople) i utworzenie
odwołania oraz powiązania, co pozwala na wypełnienie sekcji inteligentnej.
14. Przewiń ekran do góry i kliknij przycisk OK.
15. Wybierz zadanie Powiąż rekordy dostępne w panelu Nowe zadanie. Następnie to
zadanie zostanie zmienione na Anuluj powiązanie.
16. Zmień opcję Powiąż za pomocą na Usuń powiązanie, a powiązanie na Wyślij
powiązane. To zadanie anuluje tymczasowe powiązanie używane do wyzwalania tego
przepływu pracy zgodnie z ustawieniami w pliku Data Integrator rozdzielonym
tabulatorami oraz w zadaniu rozpoczęcia.
17. W sekcji Gdzie jest powiązany rekord wybierz dodatkowy obiekt biznesowy (rekord
triPeople). W przypadku wysyłania rekordów osadzonych zadanie anulowania
powiązania należy uruchomić przed zadaniem modyfikacji (Odwzoruj rekord), aby
uniknąć powielonych powiązań.
18. Opublikuj przepływ pracy. W przypadku środowisk produkcyjnych wymagane może być
usunięcie pamięci podręcznej przepływu pracy serwera.
Wysyłanie danych
Dane do aplikacji IBM TRIRIGA można wysłać za pomocą narzędzia Data Integrator,
przesyłając pliki pojedynczo lub wsadowo. Nazwa pliku importowanego do narzędzia Data
Integrator nie może być dłuższa niż 50 znaków.
Ręczne wysyłanie danych
Po utworzeniu pliku nagłówkowego wypełnionego informacjami o rekordach i zapisaniu go
jako pliku rozdzielanego tabulatorami można wysłać plik do narzędzia Data Integrator.
O tym zadaniu
Procedura jest taka sama bez względu na typ wysyłania: Powiązane, Hierarchiczne, Inne niż
hierarchiczne. Należy się tylko upewnić, że wybrano prawidłowe ustawienie
Module::BusinessObject::Form. Wybranie nieprawidłowego ustawienia powoduje
zakończenie operacji wysyłania niepowodzeniem; rekord może również zostać wysłany do
nieprawidłowego obiektu.
Po utworzeniu rekord jest opatrzony specjalnym stanem null. Rekordy ze stanem null znikają
po zakończeniu operacji aktualnie korzystającej z tych rekordów. Ważnym jest, aby narzędzie
Data Integrator wykonało czynność w odniesieniu do nowych rekordów, co pozwoli na
zmianę ich aktualnego stanu null. Jeśli czynność nie spowoduje zmiany stanu null, rekord po
utworzeniu natychmiast znika. Wszystkie opcje na liście Czynność to czynności powodujące
zmianę stanu null rekordu na inny.
Procedura
Data Integrator.
2. Sprawdź, czy wartości w polach Moduł, Obiekt biznesowy i Formularz odpowiadają
wartościom w pliku nagłówkowym. Wartością Typ importu musi być Dodaj. Wartość
Dodaj oznacza, że jeśli wiersz zawiera wartości dla pól rekordu Nazwa publikowana
odpowiadające istniejącemu rekordowi, inne wartości w wierszu aktualizują rekord. Jeśli
wiersz zawiera wartości dla pól rekordu Nazwa publikowana nieodpowiadające
istniejącemu rekordowi, dane w wierszu służą do utworzenia nowego rekordu.
3. Na liście Czynność wybierz odpowiednią czynność do uruchomienia względem rekordu
po utworzeniu lub zaktualizowaniu go przez narzędzie Data Integrator. Lista zawiera
42
4.
5.
6.
7.
prawidłowe czynności w odniesieniu do nowego rekordu, w oparciu o rodzinę zmiany
stanu używaną przez wybrany obiekt biznesowy.
Jeśli przepływ pracy musi zostać uruchomiony po utworzeniu rekordu przez narzędzie
Data Integrator, należy uruchomić przepływ pracy z czynnością podrzędną dołączoną do
czynności na liście Czynność.
Jedyną wartością Typ pliku jest plik rozdzielony tabulatorami (*.txt). Ale na liście
Zestaw znaków w pliku wybierz zestaw znaków użyty do zapisania zaimportowanego
pliku.
Upewnij się, że pole wyboru Wysyłanie wsadowe nie jest zaznaczone. Usunięcie
zaznaczenia tego pola powoduje, że narzędzie Data Integrator odczyta określony plik
danych tylko raz.
Kliknij przycisk Przeglądaj, aby wyszukać i otworzyć utworzony plik nagłówkowy.
8. Wybierz pozycję Wyślij plik.
9. Naciśnij przycisk OK. Dane są odczytywane z określonego pliku. Po zakończeniu
procesu wysyłania do sekcji Powiadomienia w Portalu głównym jest wysyłane
powiadomienie.
10. Wyświetl powiązany portal lub stronę i sprawdź, czy wszystkie rekordy zostały
prawidłowo zaimportowane.
Wsadowe wysyłanie danych
Funkcja wysyłania wsadowego pozwala na automatyczne wysyłanie danych i planowanie
zdarzeń pozwalających na automatyczne wysyłanie plików w oprogramowaniu IBM
TRIRIGA Application Platform zgodnie z ustawieniami harmonogramu. Ta funkcja jest
użyteczna podczas automatyzowania integracji danych z systemu zewnętrznego i nie wymaga
stosowania zakodowanych skryptów ani wdrażania integracji.
Ustawienia wysyłania wsadowego
Plik TRIRIGAWEB.properties zawiera ustawienia funkcji Wysyłanie wsadowe definiujące
ścieżki danych wejściowych, przetwarzanie, dane wyjściowe, błędy i pliki dzienników.
Foldery określone w parametrach BatchInputLoc, BatchProcessLoc,
BatchOutputLoc, BatchErrorLoc, and BatchLogLoc w pliku właściwości
TRIRIGAWEB.properties muszą istnieć, a ich nazwy muszę być zgodne z podanymi.
Przed rozpoczęciem wysyłania wsadowego należy uruchomić skrypty
CreateBatchProcess.bat (Windows) lub CreateBatchProcess.sh (Linux) w katalogu
[katalog instalacyjny TRIRIGA]\userfiles w celu utworzenia katalogów domyślnych
wymaganych do przeprowadzenia przetwarzania.
Wysyłanie wsadowe jest zazwyczaj najlepszym rozwiązaniem, gdy narzędzie Data Integrator
okresowo odczytuje pliki danych zorganizowane w taki sam sposób do rekordów tego samego
typu.
Planowanie operacji wysyłania wsadowego
Po utworzeniu pliku nagłówkowego wypełnionego informacjami o rekordach i zapisaniu go
jako pliku rozdzielanego tabulatorami można zautomatyzować proces wysyłania i za pomocą
narzędzia Data Integrator zaplanować operacje wysyłania wsadowego.
O tym zadaniu
Po utworzeniu rekord jest opatrzony specjalnym stanem null. Rekordy ze stanem null znikają
po zakończeniu operacji aktualnie korzystającej z tych rekordów. Ważnym jest, aby narzędzie
Data Integrator wykonało czynność w odniesieniu do nowych rekordów, co pozwoli na
43
zmianę ich aktualnego stanu null. Jeśli czynność nie spowoduje zmiany stanu null, rekord po
utworzeniu natychmiast znika. Wszystkie opcje na liście Czynność to czynności powodujące
zmianę stanu null rekordu na inny.
Często interwał określony między uruchomieniami narzędzia Data Integrator równo dzieli się
na 24 godziny. W takim przypadku dane są odczytywane z pliku o tej samej porze każdego
dnia.
Jeśli użytkownik wybierze interwał, który nie dzieli się równo na 24 godziny (np. 5 godzin),
dane są odczytywane z pliku o tych samych porach każdego dnia. To znaczy: codziennie w
porze określonej w polu Resetuj zegar codziennie o planowane jest odczytywanie danych z
określonego pliku. Następna operacja zostaje zaplanowana zgodnie z określonym interwałem.
Przykładowo: proces wysyłania rozpoczyna się codziennie o godzinie 9:00 rano. Jeśli
użytkownik określi interwał wynoszący 5 godzin i 0 minut, proces wsadowy zostanie
uruchomiony o 9:00 rano i będzie wykonywany co 5 godzin przez następne 24 godziny. Czyli
będzie uruchamiany każdego dnia o 9:00, 14:00, 19:00, 00:00 i 5:00. Następnego dnia cały
proces powtarza się w taki sam sposób.
Agent jest uruchamiany co około 10 sekund. Agent przegląda wszystkie utworzone obiekty
procesów wsadowych i w oparciu o bieżący czas uruchamia obiekty wsadowe w danej
godzinie. Dokładny czas uruchomienia agenta nie jest znany, więc przy każdym przyroście
oprogramowanie IBM TRIRIGA Application Platform dodaje 1-minutowy bufor do godziny
rozpoczęcia. Przykładowo: jeśli agent zostanie uruchomiony o godzinie 9:00:10, to proces
działa, ponieważ platforma wykonuje sprawdzenie między 9:00 i 9:01. W przykładzie
zawierającym 5-godzinne przyrosty pliki wsadowe są uruchamiane, jeśli aktualny czas
zawiera się w przedziałach 9:00 - 9:01, 14:00 - 14:01, 19:00 - 19:01, 00:00 - 00:01 i 5:00 5:01.
Procedura
Data Integrator.
2. Sprawdź, czy wartości w polach Moduł, Obiekt biznesowy i Formularz odpowiadają
wartościom w pliku nagłówkowym. Wartością Typ importu musi być Dodaj. Wartość
Dodaj oznacza, że jeśli wiersz zawiera wartości dla pól rekordu Nazwa publikowana
odpowiadające istniejącemu rekordowi, inne wartości w wierszu aktualizują rekord. Jeśli
wiersz zawiera wartości dla pól rekordu Nazwa publikowana nieodpowiadające
istniejącemu rekordowi, dane w wierszu służą do utworzenia nowego rekordu.
3. Na liście Czynność wybierz odpowiednią czynność do uruchomienia względem rekordu
po utworzeniu lub zaktualizowaniu go przez narzędzie Data Integrator. Lista zawiera
prawidłowe czynności w odniesieniu do nowego rekordu, w oparciu o rodzinę zmiany
stanu używaną przez wybrany obiekt biznesowy.
4. Jeśli przepływ pracy musi zostać uruchomiony po utworzeniu rekordu przez narzędzie
Data Integrator, należy uruchomić przepływ pracy z czynnością podrzędną dołączoną do
czynności na liście Czynność.
5. Jedyną wartością Typ pliku jest plik rozdzielony tabulatorami (*.txt). Ale na liście
Zestaw znaków w pliku wybierz zestaw znaków użyty do zapisania zaimportowanego
pliku.
6. Zaznacz pole wyboru Wysyłanie wsadowe. Pola Wysyłaj dane wsadowe co ___ godz.
___ min. sterują częstotliwością odczytywania danych przez narzędzie Data Integrator.
7. W polu Wysyłaj dane wsadowe co określ przyrost czasowy interwałów wysyłania
rozpoczynających się o godzinie ustawionej w polu Resetuj zegar codziennie o.
Wartość domyślna to 0 godzin i 0 minut.
8. W polu Resetuj zegar codziennie o wybierz godzinę, o której codziennie będzie
uruchamiany proces wysyłania wsadowego. Jeśli w polu Resetuj zegar codziennie o
44
9.
10.
11.
12.
13.
wprowadzono wartość większą niż 24 godziny, operacja wysyłania jest wykonywana raz
dziennie o godzinie określonej przez opcję Resetuj zegar codziennie o.
W polu Nazwa pliku (*.txt) określ nazwę pliku nagłówkowego. Plik musi się
znajdować w katalogu obsługiwanym przez oprogramowanie IBM TRIRIGA
Application Platform. Jeśli dany plik znajduje się w odpowiedniej lokalizacji, platforma
przetworzy go i wstawi czas przetwarzania w polu Ostatni czas uruchomienia obiektu
biznesowego wysyłania danych.
Wprowadź adres E-mail potwierdzenia. Po każdej próbie wykonania wysyłania
wsadowego przez narzędzie Data Integrator na podany adres jest wysyłana wiadomość
e-mail. Wiadomość jest wysyłana bez względu na to, czy operacja wysyłania zakończyła
się powodzeniem lub niepowodzeniem.
Wybierz pozycję Wyślij plik.
Naciśnij przycisk OK. Platforma planuje wysyłanie określonego pliku i określa dalsze
planowane wysyłki pliku w określonych interwałach bez określania zakończenia
działania. Dane są odczytywane z określonego pliku. Po każdorazowym zakończeniu
procesu wysyłania na adres E-mail potwierdzenia jest wysyłane powiadomienie.
Wyświetl powiązany portal lub stronę i sprawdź, czy wszystkie rekordy zostały
prawidłowo zaimportowane.
Przerwanie wysyłania wsadowego
Aby zmienić parametry wysyłania wsadowego, najpierw należy zakończyć działanie
harmonogramu wysyłania wsadowego, a następnie utworzyć zastępczą operację wysyłania
wsadowego. Z poziomu głównego paska nawigatora wybierz pozycje Narzędzia >
Konfiguracja systemu > System > Wysyłanie danych, aby usunąć rekordy wczytywania
wsadowego.
Obsługa narzędzia Data Integrator – porady
Dzięki poniższym poradom można rozszerzyć zakres obsługi narzędziaIBM TRIRIGA Data
Integrator w firmie.
Tabela 15. Obsługa narzędzia Data Integrator – porady
Porada
Opis
Tworzenie powiązań
istniejących rekordów
Po utworzeniu wszystkich rekordów ponownie użyj pliku
nagłówkowego, aby utworzyć plik nagłówkowy wczytywania
powiązanego. Określenie powiązań po utworzeniu wszystkich
rekordów eliminuje problemy dotyczące nieistniejących rekordów.
Sprawdzanie danych pod
kątem błędów wysyłania
Każdorazowe uruchomienie programu Data Integrator i wykrycie
błędów powoduje utworzenie rekordu Błąd podczas wysyłania danych.
Aby wyszukać rekord Błąd podczas wysyłania danych, wybierz
pozycje Narzędzia > Konfiguracja systemu > System > Błąd
podczas wysyłania danych. Przewiń stronę wyników zawierającą
rekordy. Kliknij hiperłącze nazwy pliku.
Potwierdzanie za pomocą
strony wyników OB
Po uzyskaniu komunikatu o pomyślnym wykonaniu operacji przejrzyj
dane z poziomu strony wyników OB. W przypadku obiektów
hierarchicznych upewnij się, że rekordy podrzędne są wyświetlane w
kontekście właściwych elementów nadrzędnych w oknie hierarchii.
45
Tabela 15. Obsługa narzędzia Data Integrator – porady (kontynuacja)
Porada
Opis
Data Integrator – ostrzeżenia
W ramach narzędzia Data Integrator jest wykonywanych mniej
kontroli danych niż w przypadku formularza, do którego dane są
wprowadzane ręcznie:
v Narzędzie Data Integrator tworzy lub aktualizuje rekordy z
brakującymi danymi w polach wymagających danych.
v W polu listy można wprowadzić dowolną wartość nawet, jeśli dana
wartość nie znajduje się na liście.
v Narzędzie nie wykonuje żądanych operacji weryfikacji w przypadku
wartości pól.
Jeśli w ramach wysyłania nie zostaną jednoznacznie określone
wartości geograficzne i organizacyjne tworzonych rekordów,
uprawnienia dostępu w przypadku tych rekordów mogą nie zapewniać
oczekiwanych wyników. Wymagane może być uwzględnienie pól
geograficznych lub organizacyjnych w rekordach zwykłych plików w
celu zapewniania poprawnych uprawnień dostępu w przypadku
utworzonych rekordów.
46
Rekordy wysyłania danych
Podczas każdorazowego użycia narzędzia Data Integrator w celu
zainicjowania odczytu danych tworzone są rekordy wczytywania
danych. Jeśli użytkownik zainicjuje harmonogram wysyłania
wsadowego, nadal istnieje tylko jeden rekord wysyłania danych. Po
zakończeniu wysyłania można sprawdzić wyniki operacji,
przeglądając rekord wysyłania danych odpowiadający określonemu
przesyłowi. Rekord wysyłania danych zawiera sekcję inteligentną
uwzględniającą rekordy Błąd podczas wysyłania danych. W przypadku
wystąpienia błędów są one wyświetlane w sekcji inteligentnej. Aby
wyszukać rekord Błąd podczas wysyłania danych, wybierz pozycje
Narzędzia > Konfiguracja systemu > System > Wysyłanie danych.
Przewiń stronę wyników zawierającą rekordy. Kliknij hiperłącze
nazwy pliku.
Czyszczenie folderu
Procesy administrowania systemem w przypadku wysyłania
wsadowego w ramach narzędzia Data Integrator muszą zawierać
operacje okresowego czyszczenia folderów dzienników i danych
wejściowych.
Porada
Opis
Zarządzanie plikami
przeznaczonymi do wysłania
Przesyłanie plików w trybie wsadowym odbywa się bez
bezpośredniego udziału użytkownika. System wyszukuje pliki na
komputerze, na którym pracuje, a nie na komputerze
wykorzystywanym przez użytkownika.
Aby określić komputer i katalog używany podczas operacji
wsadowego wysyłania danych, użytkownik powinien się skontaktować
z administratoremIBM TRIRIGA Application Platformdanego
środowiska w organizacji.
W celu zapewnienia, że pliki są prawidłowo przetwarzane należy się
dostosować do poniższych zasad
v Przed wstawieniem pliku do katalogu w celu wykonania wysyłania
wsadowego należy sprawdzić, czy w katalogu już znajduje się plik o
tej samej nazwie. Jeśli taki plik jest dostępny, oznacza to, że ostatni
plik o tej nazwie nie zostanie przetworzony. Po przetworzeniu pliku
jest on przenoszony do innego katalogu.
v W celu upewnienia się, że plik w katalogu został poprawnie
przetworzony, należy poczekać, aż plik zniknie i dopiero wtedy
wstawić do katalogu nowy plik o tej samej nazwie.
v W momencie wstawiania pliku w katalogu nie należy go
umieszczać poprzez kopiowanie z innej lokalizacji. Problem
dotyczący kopiowania polega na tym, że plik podczas kopiowania
jest umieszczany w katalogu fragment po fragmencie. Innymi
słowy: jeśli plik jest kopiowany do katalogu, to w pewnym
momencie w katalogu znajduje się tylko jego część.Jeśli w
programie IBM TRIRIGA Application Platform zachodzi próba
przetworzenia pliku, który nie znajduje się w całości w katalogu,
może wystąpić błąd.
v Zamiast kopiować plik do katalogu, najpierw należy go umieścić w
innej lokalizacji w tym samym systemie plików co dany katalog.
Następnie należy zmienić nazwę pliku lub przenieść go do danego
katalogu. Jeśli nazwa pliku zostanie zmieniona w tym samym
systemie plików (lub plik zostanie przeniesiony), operacja
kopiowania nie jest wykonywana. Zamiast tego w katalogu
dodawany jest wpis wskazujący położenie pliku.
Przetwarzanie całej partii
Po utworzeniu lub zaktualizowaniu pojedynczych rekordów
użytkownik może skorzystać z przepływu pracy przetwarzającego
wszystkie rekordy jednocześnie. Gdy wysyłanie pliku oddzielonego
tabulatorami zostanie ukończone, uruchamiana jest czynność Zastosuj
w odniesieniu do rekordu wysyłania danych powiązanego z
wysyłanymi danymi.
Podczas przetwarzania rekordów tworzone jest powiązanie między
rekordem wysyłania danych i danym innym rekordem. Nazwą
powiązania jest Status ładowania danych. Za pomocą Menedżera
powiązania można zdefiniować powiązanie o tej nazwie łączące obiekt
biznesowy Status ładowania danych z innym odpowiadającym
obiektem biznesowym. Jeśli użytkownik wykona tę operację, to za
pomocą przepływu pracy uruchamianego przez czynność Zastosuj
względem rekordu Wysyłanie danych można przetworzyć wszystkie
wysłane rekordy.
Dzięki zadaniu pobierania w przepływie pracy można pobrać rekordy
posortowane wg wartości określonego pola. Dlatego można użyć
dowolnego pola rekordu w celu określenia kolejności przetwarzania
rekordów w przepływie pracy.
47
Porada
Opis
Wycofywanie przepływów
pracy dotyczących obliczeń,
formuł i grupowania
W środowiskach produkcyjnych wszystkie przepływy pracy dotyczące
formuł grupowania i obliczeń należy wycofać z obiektu biznesowego
przed uruchomieniem wysyłania. Dzięki tej procedurze można
zagwarantować, że rekordy są tworzone bez uruchamiania w systemie
niepotrzebnych przepływów pracy względem danych częściowych.
Ułatwia ona również wyeliminowanie zapętlania, co może
występować w przypadku obiektów hierarchicznych. Po pomyślnym
wysłaniu należy ponownie opublikować i uruchomić przepływ pracy
względem nowych zestawów danych.
Pliki należy uruchamiać, gdy
system nie jest maksymalnie
obciążony
W zależności od ilości wysyłanych danych zasoby serwera mogą być
przeciążone, co powoduje obniżenie wydajności operacji.
Użytkownicy zaniepokojeni niską wydajnością mogą częściej
otrzymywać nieprawidłowe wyniki i częściej kontaktować się z
działem pomocy technicznej.
Czas przetwarzania rekordów
Program IBM TRIRIGA Application Platform nie musi przetwarzać
wysłanych rekordów w kolejności ich wyświetlania w pliku
oddzielonym tabulatorami. Program odczytuje dane z każdego rekordu
kolejno, a następnie przetwarza je za pomocą różnych wątków i
tworzy lub aktualizuje rekordy.
Zazwyczaj kolejność przetwarzania rekordów nie ma znaczenia. Jeśli
wymagane jest wsadowe przetwarzanie rekordów w kolejności ich
odczytu, należy wymusić w narzędziu Data Integrator przetwarzanie
rekordów w tym samym wątku.
Aby wykonać to zadanie, należy określić liczbę wątków używanych
przez agenta importu danych wynoszącą 1.
TRIRIGAWEB.properties wysyłanie wsadowe
Plik TRIRIGAWEB.properties zawiera ustawienia dotyczące
wysyłania wsadowego obejmujące wprowadzanie danych,
przetwarzanie, dane wyjściowe, błędy i dziennik. Pliki zdefiniowane w
pliku TRIRIGAWEB.properties muszą istnieć, a ich nazwy muszę
być zgodne z podanymi.
Najpierw wysyłaj rekordy
Nie należy wysyłać pliku Data Integrator, gdy wszystkie pola i
powiązania są zawarte w jednym pliku. Najpierw należy utworzyć
rekordy dla wszystkich obiektów biznesowych. Po zaimportowaniu
wszystkich rekordów, należy rozpocząć zadanie kojarzenia rekordów
ze sobą.
Wysyłaj zestawy rekordów
Nie należy umieszczać dużych ilości danych w pojedynczym pliku
Data Integrator. W pojedynczym pliku Data Integrator należy zawierać
maksymalnie 5000 rekordów. W ten sposób można uniknąć błędów
powodujących niską wydajność pracy systemu.
Wysyłanie obrazów
Jeśli użytkownik musi przypisać obrazy do nowych wysłanych
rekordów, należy zastosować następujący format. Zakłada się, że
nazwą pola obrazu jest triImageIM.
triImageIM
//Company-1/file123.jpg
Nazwa pliku musi się zaczynać od słowa "file", np.
filemyimagename.jpg lub file12345.gif.
Zgodnie z przykładem plik należy umieścić w położeniu [katalog
instalacyjny TRIRIGA ]\userfiles\Company-1, a dopiero później
wysłać plik Data Integrator.
48
Rozdział 3. Integracja danych z Menedżerem ładowania danych
TRIRIGA
Za pomocą Menedżera ładowania danych można zaimportować dane z systemu zewnętrznego
do bazy danych TRIRIGA. Proces ładowania danych obejmuje kolejne konfigurowanie i
ładowanie wielu obiektów biznesowych. W ramach tego procesu działają mechanizmy
monitorowania postępu ładowania danych oraz wyszukiwania błędów.
Na poniższym rysunku przedstawiono zastosowanie Menedżera ładowania danych w celu
zdefiniowania interakcji między zestawami ładowania danych, pozycjami ładowania danych,
obiektami integracji i zadaniami DataConnect. Można również wygenerować arkusz
kalkulacyjny dostosowany do obsługi zestawów ładowania danych. Za pomocą arkusza
kalkulacyjnego można organizować dane zewnętrzne i sprawdzać ich poprawność przed
załadowaniem ich do oprogramowania TRIRIGA.
TRIRIGA
Menedżer ładowania danych
Dane arkusza
kalkulacyjnego
Zestaw ładowania danych
1:M
Menedżer dokumentów
Szablon arkusza
kalkulacyjnego
Zadania DataConnect
Pozycje ładowania danych
Obiekty integracji
1:M
Obiekt integracji
Instancje
1:M
Instancja integracji
Rekordy z błędami
Uwaga: Menedżer ładowania danych TRIRIGA obsługuje tylko obiekty integracji
zdefiniowane z użyciem schematuPlik do procesu DC (DataConnect). Funkcje tworzenia i
wysyłania arkuszy kalkulacyjnych ładowania danych oraz dodawania pozycji ładowania
danych zaprojektowano z myślą o obiektach integracji zdefiniowanych z użyciem schematu
Plik do procesu DC. Te funkcje nie współpracują z obiektami integracji zdefiniowanymi z
użyciem innych schematów. Inne funkcje przetestowano tylko z użyciem obiektów integracji
zdefiniowanych za pomocą schematu Plik do procesu DC i mogą one nie działać z obiektami
integracji zdefiniowanymi z użyciem innych schematów.
Zestawy ładowania danych
Zestaw ładowania danych to obiekt biznesowy TRIRIGA, który jest używany do
definiowania grup obiektów integracji przetwarzanych sekwencyjnie.
49
Przykładowo: „Geografia” może być nazwą zestawu ładowania danych, który może zawierać
odwołania do obiektów integracji „Region świata”, „Kraj", „Stan” i „Miasto”. Do zestawu
ładowania danych można dodać dowolne obiekty integracji, które nie muszą być powiązane w
żaden sposób.
Na poniższym rysunku przedstawiono relacje między zestawami ładowania danych i
pozycjami ładowania danych oraz obiektami integracji.
TRIRIGA
Zestaw ładowania
danych
1:M
Pozycje ładowania
danych
Obiekty integracji
Tworzenie zestawów ładowania danych i pozycji ładowania
danych
Podczas tworzenia zestawu ładowania danych lub wybierania istniejącego zestawu ładowania
danych należy zdefiniować pozycje ładowania danych oraz ich kolejność przetwarzania.
Zestaw ładowania danych korzysta z pozycji ładowania danych w celu odwoływania się do
obiektów integracji. Zestaw ładowania danych służy do odwzorowywania danych ze źródła
zewnętrznego na istniejące obiekty biznesowe TRIRIGA.
Zanim rozpoczniesz
Przed utworzeniem nowych pozycji ładowania danych można określić opcje domyślne
obiektu integracji, modyfikując obiekt integracji DC Load - Template.
Procedura
1. Wybierz kolejno opcje Narzędzia > Konfiguracja systemu > Integracja > Menedżer
ładowania danych > Zestawy ładowania danych.
2. Dodaj zestaw ładowania danych.
3. Określ nazwę zestawu ładowania danych i typ procesu.
4. Dodaj istniejące pozycje ładowania danych lub utwórz nowe pozycje ładowania danych w
celu uwzględnienia w zestawie ładowania danych.
50
5.
6.
7.
8.
a. Określ moduł ładowania, obiekt biznesowy ładowania, formularz tabeli pomostowej i
zadanie DataConnect.
b. Utwórz i zapisz pozycję ładowania danych.
Określ kolejność przetwarzania pozycji ładowania danych.
Utwórz i zapisz zestaw ładowania danych.
Przetwórz integrację.
Sprawdź, czy wystąpiły jakieś błędy.
Przetwarzanie zestawów ładowania danych w Menedżerze
ładowania danych
Dane można zintegrować z oprogramowaniem TRIRIGA poprzez przetworzenie wielu
pozycji ładowania danych do postaci pojedynczego formularza zestawu ładowania danych.
Można również przetworzyć dane bezpośrednio z formularza pozycji ładowania danych.
Pozycje ładowania danych w zestawach ładowania danych są przetwarzane kolejno.
Zestaw ładowania danych to obiekt biznesowy TRIRIGA, który jest używany do
definiowania grup obiektów integracji przetwarzanych sekwencyjnie. Przetwarzanie obiektu
integracji powoduje utworzenie co najmniej jednej instancji obiektu integracji, zadania
DataConnect i rekordu błędu instancji obiektu integracji.
Przetwarzanie danych za pomocą formularza Zestaw ładowania
danych
Użytkownik może przetworzyć dane ze wszystkich pozycji ładowania danych w zestawie
ładowania danych. Pliki danych można dołączyć do każdej pozycji ładowania danych, która
zostanie przetworzona. W oparciu o określony typ przetwarzanie jest wykonywane w jeden z
poniżej pisanych sposobów:
Przetwarzaj cały zestaw
Kolejno przetwarzana jest każda pozycja ładowania danych opisana statusem
Gotowy zawarta w zestawie ładowania danych.
Przetwarzaj zestaw do niepowodzenia
Kolejno przetwarzana jest każda pozycja ładowania danych opisana statusem
Gotowy zawarta w zestawie ładowania danych. Przetwarzanie działa do momentu
wystąpienia błędu w jednej z pozycji ładowania danych lub osiągnięcia końca
zestawu ładowania danych.
Przetwarzaj następną pozycję
Przetwarzana jest tylko pozycja ładowania danych opisana statusem Gotowy
opatrzona najniższym kolejnym numerem.
Po zakończeniu przetwarzania należy przejrzeć historię przetwarzania i dziennik błędów
przetwarzania, aby sprawdzić, czy rekordy z plików danych zostały załadowane.
Przetwarzanie danych za pomocą formularza Pozycja ładowania
danych
Użytkownik może przetworzyć dane bezpośrednio z poziomu pojedynczej pozycji ładowania
danych. Plik danych można dołączyć do pozycji ładowania danych, która zostanie
przetworzona.
Po zakończeniu przetwarzania należy przejrzeć historię przetwarzania i dziennik błędów
przetwarzania, aby sprawdzić, czy rekord z pliku danych został załadowany.
Rozdział 3. Integracja danych z Menedżerem ładowania danych TRIRIGA
51
Na poniższym rysunku przedstawiono procedurę:
TRIRIGA
Zadanie łączenia
danych
Obiekty integracji
1:M
Obiekt integracji
Instancje
1:M
Instancja integracji
Rekordy z błędami
Generowanie arkuszy kalkulacyjnych z poziomu Menedżera ładowania
danych
Użytkownik może wygenerować arkusze kalkulacyjne ładowania danych w celu zebrania
zestawów ładowania danych i sprawdzania ich poprawności z przeznaczeniem do
wykorzystania w oprogramowaniu TRIRIGA.
Arkusze kalkulacyjne ładowania danych zapewniają:
v Możliwość określenia dostosowanego arkusza kalkulacyjnego dla zestawu ładowania
danych, co pozwala na zorganizowanie danych zewnętrznych i sprawdzanie ich
poprawności przed wysłaniem do oprogramowania TRIRIGA.
v Możliwość eksportowania rekordów z oprogramowania TRIRIGAza pomocą arkuszy
kalkulacyjnych ładowania danych. W ten sposób można sprawdzić poprawność
istniejących rekordów względem wysyłanych danych zewnętrznych.
Na poniższym rysunku przedstawiono zastosowanie Menedżera ładowania danych w celu
wygenerowania arkuszy kalkulacyjnych ładowania danych.
52
TRIRIGA
Menedł er żadowania danych
Ładowanie danych
arkusz kalkulacyjny z/bez
wyeksportowanych danych
Zestaw żadowania
danych
Ładowanie danych
Menedżer dokumentów
szablon arkusza kalkulacyjnego
uwzględniony w produkcie
1:M
Pozycje ładowania danych
Tworzenie arkusza kalkulacyjnego ładowania danych
Użytkownik może wygenerować arkusz kalkulacyjny dostosowany do zestawu ładowania
danych, co pozwalana organizowanie danych zewnętrznych i sprawdzanie ich poprawności
przed załadowaniem do oprogramowania TRIRIGA. Można również wygenerować arkusz
kalkulacyjny zawierający istniejące rekordy, które już się znajdują w oprogramowaniu
TRIRIGA.
Procedura
2. Otwórz rekord zestawu ładowania danych, dla którego zostanie utworzony arkusz
kalkulacyjny.
3. Aby wyeksportować istniejące rekordy z oprogramowania TRIRIGA do arkusza
kalkulacyjnego, zaznacz pole wyboru Wyeksportuj dane dostępne w sekcji Utwórz
arkusz kalkulacyjny ładowania danych formularza. Dane nie są eksportowane do kolumn
tabeli pomostowej DC_... (z wyjątkiem DC_PATH), Sekcja inteligentna - DataConnect
(wygenerowana, gdy funkcja Używane przez DataConnect jest wybrana w projektancie
danych), ..._UOM (jednostka miary) i ..._UOMTYP (typ jednostki miary). Za pomocą
tych kolumn tabeli pomostowej można wysłać dane do oprogramowania TRIRIGA.
4. Kliknij przycisk Zapisz, a następnie kliknij przycisk Utwórz.
5. W polu Plik arkusza kalkulacyjnego kliknij pozycję Zobacz treść, aby wyświetlić
arkusz kalkulacyjny.
Wyniki
Podczas wyświetlania arkusza kalkulacyjnego każdy obiekt biznesowy z odniesieniem w
zestawie ładowania danych zawiera następujące arkusze w arkuszu kalkulacyjnym:
Przegląd
Zawiera opisy makr i dane konfiguracji rejestrowania.
Klasyfikacje
Służy do przechowywania danych klasyfikacji.
Listy
Służy do przechowywania danych list.
Lokalizatory
Służy do przechowywania danych lokalizatorów.
Hierarchia obiektów
Służy do przechowywania informacji na temat danych hierarchicznych.
Pola
Służy do przechowywania metadanych na poziomie pola.
53
Dane
Nagłówki kolumn w arkuszach danych odpowiadają polom określonym w mapie
danych obiektów integracji z odwołaniami w zestawie ładowania danych
Makra sprawdzające poprawność arkuszy kalkulacyjnych
ładowania danych
Szablon arkusza kalkulacyjnego ładowania danych zawiera zestaw makr, za pomocą których
można sprawdzić poprawność danych obiektu biznesowego przed załadowaniem danych do
programu IBM TRIRIGA. Uruchamianie makra sprawdzania poprawności pozwala
zweryfikować warunki danych.
Po utworzeniu arkusza kalkulacyjnego można pobrać plik, wprowadzić dane i uruchomić
dowolne makro opisane w poniżej tabeli:
Tabela 16. Makra sprawdzające poprawność arkuszy kalkulacyjnych
54
Makra
Skrót klawiaturowy
Uruchomienie w
ramach
ValidateDataSheet
Ctrl-Shift-V
Pola lub arkusz danych
Sprawdza poprawność
danych w pojedynczym
arkuszu w skoroszycie.
Używa arkusza pól w
celu sprawdzania
poprawności danych
określonych w
odpowiednim arkuszu
danych. Sprawdzane są
wszystkie określone
warunki. Szczegółowe
komunikaty o błędach
są dodawane do
kolumny
VALIDATION_
ERRORS w arkuszu
danych oraz do pliku
dziennika. Dla arkusza
danych jest
automatycznie
generowany plik
rozdzielany
tabulatorami.
ValidateAllDataSheets
Ctrl-Shift-A
Dowolny arkusz
Sprawdza poprawność
wszystkich arkuszy w
skoroszycie.
ClearAllValidationErrors Ctrl-Shift-C
Dowolny arkusz
Czyści komunikaty o
błędach zawarte w
kolumnie
VALIDATION_
ERRORS we
wszystkich arkuszach
danych.
Opis
Tabela 16. Makra sprawdzające poprawność arkuszy kalkulacyjnych (kontynuacja)
Makra
Skrót klawiaturowy
Uruchomienie w
ramach
GenerateTextFile
Ctrl-Shift-T
Arkusz danych
Generuje plik tekstowy
rozdzielany
tabulatorami dla arkusza
danych. Parametry
drive i path określone
w arkuszu Przegląd
służą do definiowania
lokalizacji pliku.
Domyślnie pliki
znajdują się w
folderzeC:\TRIRIGA.
Jeśli folder nie istnieje,
zostanie utworzony. Za
pomocą
wygenerowanego pliku
można załadować dane
do narzędzia TRIRIGA.
Format nazwy
wygenerowanego pliku
jest zgodny z:
BOName.txt
GenerateDCPathAll
Sheets
Ctrl-Shift-G
Dowolny arkusz
Generuje wartości
DC_PATH dla
wszystkich arkuszy
danych w skoroszycie.
Za pomocą pola
DC_PATH_PARENT
generuje wartości
DC_PATH. Pole
DC_PATH_PARENT
identyfikuje nazwę
rekordu nadrzędnego,
używając wartości pola
TRINAMETX w
arkuszu nadrzędnym. W
celu wygenerowania
DC_PATH wszystkie
rekordy w ścieżce
hierarchii muszą być
uwzględnione w
arkuszu kalkulacyjnym.
Wiersz Parents w
odpowiednim arkuszu
pól służy do określania,
które arkusze będą
przeszukane pod kątem
wartości TRINAMETX
odpowiadającej
wartości w kolumnie
DC_PATH_PARENT.
Arkusz ObjectHierarchy
identyfikuje rekord
główny w hierarchii.
HideFieldSheets
Ctrl-Shift-H
Dowolny arkusz
Ukrywa wszystkie
arkusze pól w
skoroszycie.
Opis
55
Tabela 16. Makra sprawdzające poprawność arkuszy kalkulacyjnych (kontynuacja)
Makra
Skrót klawiaturowy
Uruchomienie w
ramach
UnHideFieldSheets
Ctrl-Shift-U
Dowolny arkusz
Wyłącza ukrywanie
wszystkich arkuszy pól
w skoroszycie.
ConvertDateToUnix
Format
Ctrl-Shift-E
Przekształca wszystkie
wartości pola
datyUNIXna wartości
numeryczne systemu
Epoch reprezentujące
liczbę milisekund, które
upłynęły od daty 1
stycznia 1970.
ConvertUnixFormatTo
Date
Ctrl-Shift-D
Przekształca wszystkie
wartości pola daty
zawierające wartości
numeryczne UNIX
Epoch (reprezentujące
liczbę milisekund, które
upłynęły od daty 1
stycznia 1970).
Opis
W poniższej tabeli przedstawiono szczegółowe informacje na temat warunków
weryfikowanych przez makra sprawdzania poprawności danych.
Tabela 17. Warunki weryfikowane przez makra sprawdzania poprawności arkuszy
kalkulacyjnych
56
Warunek
Opis makra
Pole wymagane
Kontroluje, czy wszystkie wartości tego pola w
odpowiednim arkuszu danych nie są puste, gdy
wymaganą właściwością określoną w przypadku
arkuszy pól jest true.
Typ pola numerycznego
odpowiednim arkuszu danych zawierają wartości
numeryczne.
Typ danych – data
odpowiednim arkuszu danych zawierają
prawidłowe wartości daty lub prawidłowe
wartości Epoch (wartości numeryczne większe od
0).
Typ danych logicznych
odpowiednim arkuszu danych zawierają wartości
logiczne. To makro przekształca wartość kolumny
i określa ją jako zapisaną małymi literami oraz
sprawdza poprawność wybranej opcji; dozwolone
są ustawienia true lub false.
Istnieje kolumna wyszukiwania klasyfikacji
Kontroluje, czy arkusz Classifications zawiera
kolumnę, której wartość nagłówka odpowiada
wartości Classification w arkuszu pól.
Wartość klasyfikacji
Kontroluje, czy wartość pola w arkuszu danych
odpowiada wartości w odpowiedniej kolumnie w
arkuszu Klasyfikacja.
Tabela 17. Warunki weryfikowane przez makra sprawdzania poprawności arkuszy
kalkulacyjnych (kontynuacja)
Warunek
Opis makra
Istnieje kolumna wyszukiwania listy
Kontroluje, czy arkusz Lists zawiera kolumnę,
której wartość nagłówka odpowiada wartości List
w arkuszu pól.
Wartość listy
arkuszu Listy.
Długość pola tekstowego
Kontroluje, czy jakiekolwiek wartości tego pola
przekraczają rozmiar określony w ustawieniu
wielkości pola. Jeśli wartość pola jest pusta,
sprawdzenie poprawności nie jest wykonywane.
Istnieje kolumna wyszukiwania pola lokalizatora
Kontroluje, czy arkusz Locators zawiera kolumnę,
której wartość nagłówka odpowiada wartości
Locator w arkuszu pól.
Wartość pola lokalizatora
arkuszu Locators.
Pole klucza tabeli pomostowej
Gdy wartością klucza tabeli pomostowej jest true
w przypadku co najmniej jednego pola w arkuszu
pól, makro używa tych pól w celu wygenerowania
unikatowego klucza dla każdego wiersza w
arkuszu danych i identyfikuje dowolny wiersz
zawierający powielony klucz.
Hierarchia nadrzędna
Kontroluje, czy wartości DC_PATH w arkuszu
danych są określone w jednym z nadrzędnych
arkuszy danych. Nadrzędne arkusze danych są
identyfikowane przez wiersz Nadrzędne w
odpowiednim arkuszu pól. Arkusz
ObjectHierarchy identyfikuje najwyższy poziom
hierarchii.
Powielone ścieżki
Sprawdza wszystkie rekordy w arkuszu danych i
identyfikuje warunek, gdy istnieje wiersz o tej
samej ścieżce DC, która jest używana do
ładowania tego rekordu.
W poniższej tabeli przedstawiono szczegółowe informacje na temat właściwości w arkuszu
pól w przypadku arkusza kalkulacyjnego ładowania danych.
Tabela 18. Właściwości w arkuszu pól w przypadku arkusza kalkulacyjnego ładowania
danych
Nazwa właściwości
Opis właściwości
Data sheet column
Identyfikuje nazwę odpowiedniej kolumny
nagłówka w arkuszu danych.
Field type
Identyfikuje typ danych TRIRIGA.
Field size
Określa maksymalny rozmiar pól tekstowych. W
przypadku wszystkich pozostałych pól określona
jest wartość pusta.
Classification
Identyfikuje nazwę klasyfikacji oraz unikatowy
identyfikator. Format:
NazwaKlasyfikacji:identyfikator.
List
Identyfikuje unikatowy identyfikator listy.
57
Tabela 18. Właściwości w arkuszu pól w przypadku arkusza kalkulacyjnego ładowania
danych (kontynuacja)
Nazwa właściwości
Opis właściwości
Required
Wartość true oznacza, że to pole jest wymagane.
Staging table key
Wartość true oznacza, że to pole jest kluczem
tabeli pomostowej.
Locator
Identyfikuje nazwę lokalizatora oraz unikatowy
identyfikator. Format: NazwaLokalizatora:
identyfikator.
Parents
Identyfikuje wszystkie potencjalne formularze
nadrzędne tego obiektu biznesowego Wartości są
dostępne wyłącznie, gdy moduł zawiera dane
hierarchiczne.
Przetwarzanie i ładowanie przykładowych danych za pomocą
Menedżera ładowania danych
Przykładowe zestawy ładowania danych i obiekty integracji dostarczono wraz
oprogramowaniem TRIRIGA. Przykłady można modyfikować i używać ich do ładowania
danych geograficznych, organizacyjnych, osobowych, specyfikacji i portfela zasobów.
Każdy przykładowy zestaw ładowania danych zawiera odwołania do wielu przykładowych
obiektów integracji. Każdy obiekt integracji zawiera przykładowy plik danych obejmujących
dane nagłówka i wiersze przykładowych danych odpowiadające mapie danych. Ponadto typy
danych obejmują zadania DataConnect i przepływy pracy.
Przetwarzanie przykładowych danych
Użytkownik może przetwarzać przykładowe elementy ładowania danych zawarte w
oprogramowaniu TRIRIGA. Następnie przykładowe dane można załadować za pomocą
aplikacji Zestaw ładowania danych dostępnej w Menedżerze ładowania danych.
Zanim rozpoczniesz
Aby załadować przykładowe dane, najpierw należy przetworzyć przykładowe elementy
ładowania danych zawarte w produkcie.
Procedura
1. “Konfigurowanie przykładowych danych” - ładowanie zestawów i obiektów integracji
zawartych w produkcie, za pomocą Projektanta danych konfigurowane są tabele
pomostowe.
2. “Modyfikowanie źródła danych” na stronie 59 - uwzględnianie poświadczeń lokalnej
bazy danych TRIRIGA.
3. “Implementowanie zmian ładowania danych” na stronie 59 - pozycje ładowania danych,
które zostaną załadowane do oprogramowania TRIRIGA.
4. “Ładowanie przykładowych danych” na stronie 60 - za pomocą aplikacji Zestaw
ładowania danych.
Konfigurowanie przykładowych danych
Użytkownik może skonfigurować przykładowe zestawy ładowania danych i obiekty integracji
uwzględnione w produkcie i za pomocą Projektanta danych skonfigurować tabele pomostowe.
58
Zanim rozpoczniesz
Aby upewnić się, że Agent DataConnect wydajnie ładuje przykładowe dane z tabel
pomostowych, administrator serwera aplikacji TRIRIGA może wyedytować plik
TRIRIGAWEB.properties i określić właściwość DATACONNECT_SLEEP_TIME = -10.
Zmiana tej właściwości powoduje, że Agent DataConnect sprawdza system w poszukiwaniu
przykładowych danych co 10 sekund (jest to najkrótszy obsługiwany interwał).
Procedura
1. Kliknij pozycje Narzędzia > Narzędzia do budowania > Projektant danych.
2. Skonfiguruj wszystkie obiekty integracji, które zostaną przetworzone.
a. Wybierz powiązany obiekt biznesowy.
b. W oknie projektanta danych wybierz pozycje Narzędzia > Skoryguj OB. Skoryguj
powiązany obiekt biznesowy, określając dla właściwości Tabela pomostowa
ustawienie DataConnect, i zapisz obiekt biznesowy.
c. Z poziomu Listy pól określ i wybierz pola obiektów biznesowych, które zostaną
dodane lub usunięte w ramach tabeli pomostowej. W przypadku każdego pola zaznacz
właściwość (lub usuń jego zaznaczenie) Pole tabeli pomostowej i zapisz pole.
d. W oknie projektanta danych wybierz pozycje Narzędzia > Publikuj OB, aby
opublikować obiekt biznesowy i utworzyć lub zmodyfikować tabelę pomostową.
Modyfikowanie źródła danych
Źródło danych można zmodyfikować w celu uwzględnienia poświadczeń lokalnej bazy
danych TRIRIGA.
Procedura
ładowania danych > Źródła danych.
2. Wybierz źródło danych DB-DataLoad i zmodyfikuj poświadczenia bazy danych.
3. Wybierz odsyłacz Testuj połączenie z BD, aby zweryfikować możliwość pomyślnego
połączenia z bazą danych z użyciem zmodyfikowanych poświadczeń.
4. Zapisz i zamknij, aby zastosować zmiany w tym źródle danych i w istniejących obiektach
integracji, które określają to źródło danych.
Implementowanie zmian ładowania danych
Pozycje ładowania danych, które zostaną załadowane do TRIRIGA można
zmodyfikować.Modyfikacje mogą obejmować zmiany źródeł danych, map danych i plików
danych.
Procedura
2. Wybierz zestaw ładowania danych, który zostanie zmodyfikowany.
3. Dodaj lub usuń pozycje ładowania danych w ramach tego zestawu ładowania danych.
4. Wybierz pozycję ładowania danych, która zostanie zmodyfikowana.
5. Wybierz pole Obiekt integracji, aby zmodyfikować pozycję ładowania danych.
6. W sekcji Źródło danych formularza obiektu integracji wybierz odsyłacz Testuj
połączenie z BD, aby zweryfikować, czy tabela pomostowa istnieje.
7. Dodaj lub usuń pola na kacie Mapa danych.
8. Zapisz i zamknij obiekt integracji.
59
9. Na karcie Szczegóły formularza pozycji ładowania danych pobierz i zmodyfikuj plik
przechowywany w polu Plik danych.
10. Wyślij zmodyfikowany plik.
Ładowanie przykładowych danych
Użytkownik może załadować przykładowe dane w tym dane dotyczące geografii, lokalizacji,
organizacji, osób, specyfikacji i portfela zasobów, korzystając z aplikacji Zestaw ładowania
danych.
Procedura
2. Wybierz zestaw ładowania danych zawierający obiekty integracji, które zostaną
przetworzone.
3. Wybierz typ procesu.
4. Kliknij pozycje Przetwarzaj, aby wykonać operację na obiektach integracji zawartych w
zestawie ładowania danych.
Co dalej
Aby uzyskać dodatkowe informacje na temat ładowania przykładowych danych, można
wykonać poniższe czynności:
v Odśwież sekcję Pozycje ładowania danych, aby wyświetlić zaktualizowany status każdej
pozycji ładowania danych.
v Odśwież sekcję historii procesu, aby wyświetlić szczegółowy status przetwarzania. Gdy co
najmniej jednej rekord zostanie pomyślnie załadowany do tabeli pomostowej, zostanie
utworzone zadanie łączenia danych, a rekordy zostaną przetworzone za pomocą agenta
łączenia danych.
v Wybierz kartę Zadania DataConnect, aby wyświetlić listę przetworzonych zadań. Status
zadania można również wyświetlić za pomocą Konsoli administratora.
v Wybierz kartę Dziennik awarii procesu, aby wyświetlić błędy, które wystąpiły podczas
sprawdzania poprawności.
Przykładowe dane portfela
Program TRIRIGA udostępnia przykładowe zestawy ładowania danych i dane portfela
obiektów integracji do wykorzystania w Menedżerze ładowania danych.
W poniższej tabeli przedstawiono szczegółowe informacje na temat dostępnych
przykładowych zestawów ładowania danych i danych portfela obiektów integracji.
Tabela 19. Przykładowe dane portfela obiektów integracji
60
Nazwa zestawu ładowania
danych
Typ danych
Nazwa obiektu integracji
Położenie geograficzne
Regiony świata
DC - Geography triWorldRegion
Kraje
DC - Geography - triCountry
Stany
DC - Geography - triState
Regiony
DC - Geography - triRegion
Obszary metropolitalne
DC - Geography triMetropolitanArea
Hrabstwa
DC - Geography - triCounty
Tabela 19. Przykładowe dane portfela obiektów integracji (kontynuacja)
danych
Lokalizacja
Organizacja
Osoby
Specyfikacja
Typ danych
Miasta
DC - Geography - triCity
Właściwość
DC - Location - triProperty
Budynki
DC - Location - triBuilding
Grunty
DC - Location - triLand
Kondygnacje
DC - Location - triFloor
Powierzchnie
DC - Location - triSpace
Moja firma
DC - Organization triMyCompany
Oddziały
DC - Organization - triDivision
Wydziały
DC - Organization triDepartment
Przedsiębiorstwa zewnętrzne
DC - Organization triExternalCompany
Grupy robocze
DC - Organization triWorkGroup
Pracownicy
DC - triPeople - triEmployee
Konsultanci
DC - triPeople - triConsultant
Kontakty zewnętrzne
DC - triPeople triExternalContact
Wyposażenie budynku
DC - triSpecification triBuildingEquipmentSpec
Materiały eksploatacyjne
DC - triSpecification triConsumablesSpec
Osprzęt
DC - triSpecification triFixtureSpec
Sprzęt gastronomiczny
DC - triSpecification triFoodServiceEquipmentSpec
Meble
DC - triSpecification triFurnitureSpec
Urządzenia biurowe
DC - triSpecification triOfficeEquipmentSpec
Wyposażenie punktu sprzedaży
DC - triSpecification triPointofSaleEquipmentSpec
Ochrona
DC - triSpecification triSecurityEquipmentSpec
Usługi
DC - triSpecification triServicesSpec
Standardy powierzchni
DC - triSpecification triSpaceStandardSpec
Technika
DC - triSpecification triTechnologyAssetsSpec
Telefony
DC - triSpecification triTelephoneSpec
Narzędzia i przyrządy testowe
DC - triSpecification triToolsandTestEquipmentSpec
61
Tabela 19. Przykładowe dane portfela obiektów integracji (kontynuacja)
danych
Konfiguracje zasobów
Zarządzanie powierzchnią powiązania
62
Typ danych
Pojazdy
DC - triSpecification triVehicleSpec
Miejsca pracy
DC - triSpecification triWorkAreaOutletsSpec
Wyposażenie budynku
DC - triAsset triBuildingEquipment
Osprzęt
DC - triAsset - triFixture
Sprzęt gastronomiczny
DC - triAsset triFoodServiceEquipment
Meble
DC - triAsset - triFurniture
Urządzenia biurowe
DC - triAsset triOfficeEquipment
Wyposażenie punktu sprzedaży
DC - triAsset triPointofSaleEquipment
Ochrona
DC - triAsset triSecurityEquipment
Technika
DC - triAsset triTechnologyAssets
Telefony
DC - triAsset - triTelephones
Narzędzia i przyrządy testowe
DC - triAsset triToolsandTestEquipment
Pojazdy
DC - triAsset - triVehicles
Miejsca pracy
DC - triAsset triWorkAreaOutlets
Powiązanie
DC - Powiązanie triSpaceAllocation triSpaceLevelAllocation Przydziela – Lokalizatory
Powiązanie
DC - Association - triPeople triEmployee - Ma lokalizację
podstawową \ Organizacja
podstawowa - sekcja inteligentna
Powiązanie
DC - Powiązanie - Narzędzia
danych triPeopleReportsToDTO Raportowanie do - DTO
Uwagi
Niniejsza publikacja została przygotowana z myślą o produktach i usługach oferowanych w
Stanach Zjednoczonych.
IBM może nie oferować w innych krajach produktów, usług lub opcji, omawianych w tej
publikacji. Informacje o produktach i usługach dostępnych w danym kraju można uzyskać od
lokalnego przedstawiciela IBM. Odwołanie do produktu, programu lub usługi IBM nie
oznacza, że można użyć wyłącznie tego produktu, programu lub usługi. Zamiast nich można
zastosować ich odpowiednik funkcjonalny pod warunkiem, że nie narusza to praw własności
intelektualnej IBM. Jednakże cała odpowiedzialność za ocenę przydatności i sprawdzenie
działania produktu, programu lub usługi pochodzących od producenta innego niż IBM
spoczywa na użytkowniku.
IBM może posiadać patenty lub złożone wnioski patentowe na towary i usługi, o których
mowa w niniejszej publikacji. Używanie tego dokumentu nie daje żadnych praw do tych
patentów. Wnioski o przyznanie licencji można zgłaszać na piśmie pod adresem:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
Zapytania dotyczące zestawów znaków dwubajtowych (DBCS) należy kierować do lokalnych
działów własności intelektualnej IBM (IBM Intellectual Property Department) lub wysłać je
na piśmie na adres:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japonia
Poniższy akapit nie obowiązuje w Wielkiej Brytanii, a także w innych krajach, w których jego
treść pozostaje w sprzeczności z przepisami prawa miejscowego: FIRMA
INTERNATIONAL BUSINESS MACHINES CORPORATION DOSTARCZA TĘ
PUBLIKACJĘ W TAKIM STANIE, W JAKIM SIĘ ZNAJDUJE, "AS IS", BEZ
UDZIELANIA JAKICHKOLWIEK GWARANCJI (W TYM TAKŻE RĘKOJMI),
WYRAŹNYCH LUB DOMNIEMANYCH, A W SZCZEGÓLNOŚCI DOMNIEMANYCH
GWARANCJI PRZYDATNOŚCI HANDLOWEJ ORAZ PRZYDATNOŚCI DO
OKREŚLONEGO CELU LUB GWARANCJI, ŻE PUBLIKACJA NIE NARUSZA PRAW
OSÓB TRZECICH. Ustawodawstwa niektórych krajów nie dopuszczają zastrzeżeń
dotyczących gwarancji wyraźnych lub domniemanych w odniesieniu do pewnych transakcji;
w takiej sytuacji powyższe zdanie nie ma zastosowania.
Informacje zawarte w niniejszej publikacji mogą zawierać nieścisłości techniczne lub błędy
drukarskie. Informacje te są okresowo aktualizowane, a zmiany te zostaną ujęte w kolejnych
wydaniach tej publikacji. IBM zastrzega sobie prawo do wprowadzania ulepszeń i/lub zmian
w produktach i/lub programach opisanych w tej publikacji w dowolnym czasie, bez
wcześniejszego powiadomienia.
63
Wszelkie wzmianki w tej publikacji na temat stron internetowych innych przedsiębiorstw
zostały wprowadzone wyłącznie dla wygody użytkowników i w żadnym wypadku nie
stanowią zachęty do ich odwiedzania. Materiały dostępne na tych stronach nie są częścią
materiałów opracowanych dla tego produktu IBM, a użytkownik korzysta z nich na własną
odpowiedzialność.
IBM ma prawo do używania i rozpowszechniania informacji przysłanych przez użytkownika
w dowolny sposób, jaki uzna za właściwy, bez żadnych zobowiązań wobec ich autora.
Licencjobiorcy tego programu, którzy chcieliby uzyskać informacje na temat programu w
celu: (i) wdrożenia wymiany informacji między niezależnie utworzonymi programami i
innymi programami (łącznie z tym opisywanym) oraz (ii) wspólnego wykorzystywania
wymienianych informacji, powinni skontaktować się z:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Informacje takie mogą być udostępnione, o ile spełnione zostaną odpowiednie warunki, w
tym, w niektórych przypadkach, zostanie uiszczona odpowiednia opłata.
Licencjonowany program opisany w niniejszej publikacji oraz wszystkie inne licencjonowane
materiały dostępne dla tego programu są dostarczane przez IBM na warunkach określonych w
Umowie IBM z Klientem, Międzynarodowej Umowie Licencyjnej IBM na Program lub w
innych podobnych umowach zawartych między IBM a użytkownikami.
Informacje dotyczące produktów innych przedsiębiorstw zostały uzyskane od dostawców tych
produktów, z opublikowanych przez nich zapowiedzi lub innych powszechnie dostępnych
źródeł. IBM nie testował tych produktów i nie może potwierdzić dokładności pomiarów
wydajności, kompatybilności ani żadnych innych danych związanych z produktami innymi
niż produkty IBM. Pytania dotyczące możliwości produktów innych przedsiębiorstw należy
kierować do dostawców tych produktów.
Publikacja ta zawiera przykładowe dane i raporty używane w codziennej działalności
biznesowej. W celu kompleksowego ich zilustrowania, podane przykłady zawierają nazwiska
osób prywatnych, nazwy przedsiębiorstw oraz nazwy produktów. Wszystkie te
nazwy/nazwiska są fikcyjne i jakiekolwiek podobieństwo do istniejących nazw/nazwisk i
adresów jest całkowicie przypadkowe.
LICENCJA NA PRAWA AUTORSKIE:
Niniejsza publikacja zawiera przykładowe aplikacje w kodzie źródłowym, ilustrujące techniki
programowania w różnych systemach operacyjnych. Użytkownik może kopiować,
modyfikować i rozpowszechniać te programy przykładowe w dowolnej formie bez uiszczania
opłat na rzecz IBM, w celu rozbudowy, użytkowania, handlowym lub w celu
rozpowszechniania aplikacji zgodnych z aplikacyjnym interfejsem programowym dla tego
systemu operacyjnego, dla którego napisane były programy przykładowe. Programy
przykładowe nie zostały gruntownie przetestowane. IBM nie może zatem gwarantować lub
sugerować niezawodności, użyteczności i funkcjonalności tych programów. Programy
przykładowe są dostarczane w stanie, w jakim się znajdują ("AS IS"), bez jakichkolwiek
gwarancji, w tym także rękojmi. IBM nie ponosi odpowiedzialności za jakiekolwiek szkody
wynikające z używania programów przykładowych.
64
Strategia ochrony prywatności
Produkty programowe IBM, w tym oprogramowanie udostępniane w postaci usług
(„Oprogramowanie”) może używać plików cookie lub innych rozwiązań technicznych do
zbierania informacji o sposobie korzystania z produktu w celu doskonalenia interakcji z
użytkownikiem, dopasowania interakcji do preferencji konkretnego użytkownika lub w
innych celach. W wielu przypadkach Oprogramowanie nie zbiera żadnych informacji
umożliwiających identyfikację tożsamości osób. W niektórym Oprogramowaniu dostępna jest
opcja umożliwiająca użytkownikowi zbieranie takich informacji. Jeśli Oprogramowanie
używa plików cookie do zbierania informacji umożliwiających identyfikację tożsamości, to
konkretne informacje o sposobie wykorzystania plików cookie przez to Oprogramowanie są
podane poniżej.
Niniejsze Oprogramowanie nie używa plików cookie ani innych rozwiązań technicznych do
zbierania informacji umożliwiających identyfikację tożsamości osób.
Jeśli konfiguracje, w jakich to Oprogramowanie zostało wdrożone, umożliwiają klientowi
zbieranie informacji umożliwiających identyfikację tożsamości użytkowników końcowych za
pośrednictwem plików cookie i innych rozwiązań technicznych, to klient powinien zwrócić
się we własnym zakresie o poradę prawną dotyczącą obowiązujących go przepisów
dotyczących zbierania takich danych, w szczególności obowiązków informacyjnych i
konieczności uzyskania zgody użytkowników.
Więcej informacji o stosowaniu różnych rozwiązań technicznych, w tym plików cookie, do
wspomnianych wyżej celów zawiera strategia IBM w zakresie ochrony prywatności dostępna
pod adresem http://www.ibm.com/privacy oraz oświadczenie IBM dotyczące ochrony
prywatności w Internecie, dostępne pod adresem http://www.ibm.com/privacy/details, a w
szczególności jego sekcja zatytułowana „Pliki cookie, sygnalizatory WWW i inne
rozwiązania techniczne”, jak również oświadczenie IBM dotyczące prywatności w
oprogramowaniu, w tym oprogramowaniu udostępnianym w postaci usług, dostępne pod
adresem http://www.ibm.com/software/info/product-privacy/.
Znaki towarowe
IBM, logo IBM i ibm.com są znakami towarowymi lub zastrzeżonymi znakami towarowymi
International Business Machines Corp., zarejestrowanymi w wielu systemach prawnych na
całym świecie. Nazwy innych produktów i usług mogą być znakami towarowymi IBM lub
innych firm. Aktualna lista znaków towarowych IBM jest dostępna w serwisie WWW, w
sekcji “Copyright and trademark information” (Informacje o prawach autorskich i znakach
towarowych), pod adresem www.ibm.com/legal/copytrade.shtml.
Java™ oraz wszystkie znaki towarowe i logo dotyczące języka Java są znakami towarowymi
lub zastrzeżonymi znakami towarowymi Oracle i/lub przedsiębiorstw afiliowanych.
Linux jest znakiem towarowym Linusa Torvaldsa w Stanach Zjednoczonych i/lub innych
krajach.
Microsoft, Windows, Windows NT i logo Windows są znakami towarowymi firmy Microsoft
Corporation w Stanach Zjednoczonych i/lub innych krajach.
UNIX jest zastrzeżonym znakiem towarowym The Open Group w Stanach Zjednoczonych i
innych krajach.
Nazwy innych produktów i usług mogą być znakami towarowymi IBM lub innych firm.
Uwagi
65
66
Drukowane w USA

Budowanie aplikacji dla IBM TRIRIGA Application Platform 3

Transkrypt

Podobne dokumenty

AKUMULATOR DO MIERNIKA SYGNAŁU

gps-usb-holux-mini - Meditronik.com.pl

certyfikat

rozruchy CD V1_3 16-09-12

Rafał Czubik IBM Polska sp. z o.o.

schemat hydrauliczny 2 - Eco-Term

VI Forum Sektora Finansowego 23 czerwca 2010 r. Adgar Plaza Ul