Właściwości specyfikacji aktywowania

Właściwości specyfikacji aktywowania przechowują informacje o konfiguracji przetwarzania zdarzeń przychodzących dla punktu końcowego komunikatu. Mogą one być ustawiane zarówno przez kreatora wykrywania usług przedsiębiorstwa, jak i Konsolę administracyjną produktu WebSphere Process Server.

Podczas konfigurowania adaptera należy określić wymienione poniżej właściwości specyfikacji aktywowania.

Właściwości specyfikacji aktywowania dla produktu Adapter for FTP

Właściwość Type Opis Globalizacja Wymagana Wartość domyślna
DataSourceJNDIName String Nazwa JNDI źródła danych używana przez funkcję utrwalania zdarzeń do uzyskiwania połączenia z bazą danych JDBC. Źródło danych musi zostać utworzone na serwerze WebSphere Process Server. Nazwa bazy danych określona podczas tworzenia źródła danych powinna już istnieć. Tak Tak Brak
EventTableName String Nazwa tabeli, która będzie używana przez adapter na potrzeby utrwalania zdarzeń. Jeśli jest używanych wiele specyfikacji aktywowania, ta wartość musi być w każdym przypadku unikalna. Identyczna nazwa tabeli nie powinna być używana przez inne instancje tego samego lub innego adaptera. Jeśli tabela nie istnieje w bazie danych, adapter ją utworzy. Tak Tak Brak
DatabaseSchemaName String Nazwa schematu bazy danych używana przez funkcję utrwalania zdarzeń. Tak Nie Brak
DatabaseUsername String Nazwa użytkownika używana przez funkcję utrwalania zdarzeń do uzyskiwania ze źródła danych połączenia z bazą danych JDBC. Tak Nie Brak
DatabasePassword String Hasło używane przez funkcję utrwalania zdarzeń do uzyskiwania ze źródła danych połączenia z bazą danych JDBC. Tak Nie Brak
CreateTable boolean Jeśli ta właściwość jest ustawiona na wartość true, tworzona jest tabela zdarzeń razem z pokrewnymi indeksami. Aby rozwiązać problemy z błędami tworzenia tabeli, należy ustawić tę właściwość na wartość false. Tabelę i indeksy można utworzyć ręcznie. Nie Nie true
EventDirectory String Adres URL serwera FTP, z którego pobierane są pliki zdarzeń dla operacji przetwarzania danych przychodzących.

Składnia adresu URL serwera FTP: ftp://[ID_użytkownika:hasło@]
serwer_FTP[:port]
[zdalny_katalog_zdarzeń]

Można także określić następujące informacje:
  • Nazwa i hasło użytkownika, który ma uprawnienia do nawiązywania połączenia z serwerem FTP i wykonywania operacji FTP. Jeśli tych informacji nie podano we właściwości EventDirectory, należy określić je za pomocą właściwości Username i Password.
  • Port FTP. Jeśli nie jest określony we właściwości EventDirectory, adapter używa domyślnego portu FTP.
  • Zdalny katalog zdarzeń. Jeśli nie jest określony we właściwości EventDirectory, adapter odpytuje pliki zdarzeń znajdujące się w katalogu, z którym nawiązano połączenie na serwerze FTP.
Tak Tak Brak
EventFileMask String Filtr plików zdarzeń. Filtr plików to kwalifikowane wyrażenie regularne zawierające znaki alfanumeryczne oraz znaki wieloznaczne * i ?. Tak Tak *.*
SortEventFiles String Określa porządek sortowania odpytywanych plików zdarzeń. Obsługiwane wartości:
  • Filename – sortowanie w porządku rosnącym według nazwy pliku.
  • Timestamp – sortowanie w porządku rosnącym wg znacznika czasu ostatniej modyfikacji.
  • <Puste> - bez sortowania.
Kolejność plików zdarzeń, z których muszą zostać dostarczone zdarzenia, ma zastosowanie tylko w przypadku, gdy właściwość specyfikacji aktywowania DeliveryType jest ustawiona na wartość ORDERED. Sortowanie nazw plików odbywa się zgodnie z ustawieniami narodowymi serwera FTP. Do śledzenia ustawień narodowych i powiązanych z nimi reguł będzie używany pakiet ICU4J.
Nie Nie <Pusty> (= bez sortowania)
FTPArchiveDirectory String Względna ścieżka katalogu archiwum na serwerze FTP. Katalog ten musi już istnieć. Dostępnych jest wiele opcji umożliwiających używanie tej właściwości do określania sposobu archiwizowania:
  • Określenie wartości tej właściwości bez podawania wartości właściwości FTPRenameExt, powoduje, że adapter dodaje znacznik czasu do nazwy pliku zdarzeń i przenosi go do katalogu archiwum serwera FTP określonego w tym atrybucie.
  • Określenie wartości tej właściwości oraz wartości właściwości FTPRenameExt sprawia, że adapter zmienia nazwę pliku przetworzonego zdarzenia z użyciem znacznika czasu i wartości określonej we właściwości FTPRenameExt, a następnie przenosi ten plik do katalogu archiwum serwera FTP określonego w tej właściwości.
  • Brak wartości tej właściwości lub właściwości FTPRenameExt powoduje, że adapter zasobów usuwa plik przetworzonego zdarzenia bez jego archiwizowania.
  • Jeśli nie określono wartości tej właściwości, ale określono wartość właściwości FTPRenameExt, adapter zmienia nazwę pliku przetworzonego zdarzenia, dodając do niej znacznik czasu i wartość podaną we właściwości FTPRenameExt.
Tak Nie Brak
FTPRenameExtension String Rozszerzenie pliku lub przyrostek, który jest używany przez adapter do modyfikowania nazwy zdalnego pliku na serwerze FTP po odpytaniu przez konektor. Zmiana nazwy pliku zapobiega odpytywaniu tego samego pliku przez konektor w następnym cyklu odpytywania. Adapter można skonfigurować w taki sposób, aby zmieniał nazwę pliku przetworzonego zdarzenia i przenosił go do katalogu archiwum. Tak Nie Brak
UserName String Nazwa użytkownika z uprawnieniami do nawiązywania połączenia z serwerem FTP i wykonywania operacji FTP. Nie jest konieczne określanie wartości tej właściwości, jeśli nazwę użytkownika dołączono do adresu URL określonego we właściwości EventDirectory. Tak Nie Brak
Password String Hasło użytkownika z uprawnieniami do nawiązywania połączenia z serwerem FTP i wykonywania operacji FTP. Nie jest konieczne określanie wartości tej właściwości, jeśli hasło dołączono do adresu URL określonego we właściwości EventDirectory. Tak Nie Brak
FTPGetQuantity Integer Określa liczbę plików, które są pobierane ze zdalnego serwera FTP (określonego przy użyciu adresu URL) w ramach jednej operacji zdalnego odpytywania. Nie Tak 10
FTPPollFrequency Integer Określa częstotliwość odpytywania serwera FTP przez adapter, która jest wyrażana jako liczba standardowych cykli odpytywania. Jeśli na przykład atrybut PollPeriod ustawiono na wartość 10000, a atrybut FTPPollFrequency ustawiono na wartość 6, adapter odpytuje katalog LocalEventDirectory co 10 sekund, a zdalny katalog EventDirectory co 60 sekund. Adapter wykonuje operacje odpytywania serwera FTP tylko w przypadku, gdy określono wartość tej właściwości. Jeśli atrybut PollPeriod ustawiono na wartość 0, do obliczeń używana jest wartość 1. Jeśli wynikiem obliczenia jest 0, adapter nie wykonuje operacji odpytywania FTP. Nie Tak 5
EISEncoding String Kodowanie serwera FTP. Należy użyć tej wartości w celu ustawienia kodowania dla połączenia sterującego z serwerem FTP.
  • Jeśli właściwość EISEncoding określona na poziomie adaptera oraz właściwość EISEncoding określona na poziomie specyfikacji aktywowania nie są ustawione (tzn. obydwie mają wartość null), podczas komunikacji z serwerem FTP nie jest ustawiana żadna wartość dla połączenia sterującego.
  • Jeśli właściwość EISEncoding określona na poziomie adaptera jest ustawiona, a właściwość EISEncoding określona na poziomie specyfikacji aktywowania nie jest ustawiona, podczas komunikacji z serwerem FTP dla połączenia sterującego ustawiana jest wartość określona na poziomie adaptera. Jest to pomocne, gdy jest używanych wiele specyfikacji aktywowania i jest ustawione takie samo kodowanie. W takim przypadku wartość na poziomie adaptera należy ustawić w taki sposób, aby wszystkie połączenia miały takie samo kodowanie na potrzeby połączenia sterującego.
  • Jeśli właściwość EISEncoding określona na poziomie adaptera nie jest ustawiona, a właściwość EISEncoding określona na poziomie specyfikacji aktywowania jest ustawiona, podczas komunikacji z serwerem FTP dla połączenia sterującego ustawiana jest wartość określona na poziomie specyfikacji aktywowania. Ponieważ ta wartość jest określona na poziomie specyfikacji aktywowania, rozwiązanie ma zastosowanie wyłącznie dla tej specyfikacji aktywowania.
  • Jeśli właściwość EISEncoding określona na poziomie adaptera oraz właściwość EISEncoding określona na poziomie specyfikacji aktywowania są ustawione, wartość określona na poziomie specyfikacji aktywowania ma pierwszeństwo.

Dla tego atrybutu należy określić dowolny zestaw kodowania obsługiwany przez język Java.

Nie Nie Brak
LocalEventDirectory String Katalog w systemie lokalnym, do którego adapter zasobów pobiera pliki zdarzeń z serwera FTP. Należy określić wartość tej właściwości, aby adapter mógł przetwarzać zdarzenia. Tak Tak Brak
LocalArchiveDirectory String Bezwzględna ścieżka do lokalnego katalogu archiwum. Ten katalog musi być poprawny i już istnieć. Tak Nie Brak
FailedArchiveExt String Rozszerzenie pliku używanego do archiwizowania tych obiektów biznesowych z pliku zdarzeń, które nie zostały pomyślnie przetworzone. Ta właściwość jest używana tylko w przypadku, gdy katalog LocalArchiveDirectory jest poprawny i istnieje. Tak Nie fail
OriginalArchiveExt String Rozszerzenie pliku używane do archiwizowania oryginalnego pliku zdarzeń. Umożliwia ono zachowanie całego pliku zdarzeń w celach informacyjnych na wypadek niepowodzenia przetwarzania dowolnego obiektu biznesowego w tym pliku zdarzeń. Ta właściwość jest używana tylko w przypadku, gdy katalog LocalArchiveDirectory jest poprawny i istnieje. Tak Nie original
SuccessArchiveExt String Rozszerzenie pliku używanego do archiwizowania wszystkich pomyślnie przetworzonych obiektów biznesowych. Ta właściwość jest używana tylko w przypadku, gdy katalog LocalArchiveDirectory jest poprawny i istnieje. Tak Nie success
IncludeEndBODelimiter boolean Gdy właściwość zostanie ustawiona na wartość true, separator jest wysyłany razem z treścią obiektu biznesowego do dalszego przetwarzania. Ta właściwość ma zastosowanie tylko podczas dzielenia plików zdarzeń na podstawie separatora. Nie Nie false
DataConnectionMode String Tryb połączenia danych używany przez serwer FTP podczas przesyłania plików. Można używać następujących ustawień: active (aktywny) lub passive (pasywny). Nie Nie active
FileTransferType Integer Typ przesyłania plików używany podczas operacji przetwarzania danych przychodzących. Można używać następujących ustawień: ASCII (kod ASCII) lub binary (binarny). Nie Nie binary
CustomParserClassName String Pełna nazwa klasy niestandardowego analizatora składni, który służy do analizowania danych wyjściowych komendy ls –l. Jest używany tylko w przypadku, gdy dane wyjściowe komendy ls –l różnią się od standardowych danych. Nie Nie Brak
FilePassByReference boolean Właściwość określająca, że treść pliku zdarzeń nie jest wysyłana do punktu końcowego.

Jeśli właściwość zostanie ustawiona na wartość true, do pliku zostanie dodany znacznik czasu, a następnie ten plik zostanie wysłany do katalogu LocalArchiveDirectory. Znacznik czasu zapobiega błędom oraz nadpisywaniu pliku w przypadku odebrania pliku z taką samą nazwą. Tę właściwość można ustawić na wartość true tylko w przypadku, gdy właściwość LocalArchiveDirectory została ustawiona, a określony katalog istnieje. Właściwość jest używana tylko w przypadku operacji przetwarzania danych przychodzących z użyciem tranzytu. Jeśli włączono tę opcję, plik nie jest dzielony na porcje.

Nie Nie false
SplittingFunctionClass
Nazwa
String Ta wartość przechowuje pełną nazwę klasy dla pliku klasy, której użycie umożliwi dzielenie plików. Są wymagane dwie wartości:
  • Klasa com.ibm.j2ca.extension.
    utils.filesplit.SplitByDelimiter służąca do dzielenia pliku zdarzeń na podstawie separatora.
  • Klasa com.ibm.j2ca.extension.
    utils.filesplit.SplitBySize służąca do dzielenia pliku zdarzeń na podstawie jego wielkości.
Separator lub wielkość pliku określa się we właściwości SplitCriteria. Jeśli właściwość EventContentType zostanie ustawiona na wartość null, jej wartość zostanie automatycznie ustawiona na nazwę klasy wykonującej dzielenie na podstawie rozmiaru pliku.
Nie Nie com.ibm.
j2ca.
extension.
utils.
filesplit.
SplitBySize
FileContentEncoding String Kodowanie używane do odczytu plików zdarzeń na podstawie właściwości EndBODelimiter, a także podczas konwersji łańcucha do typu byte[]. Jeśli ta właściwość nie zostanie określona, adapter podejmie próbę odczytu bez żadnego określonego kodowania. Można określić dowolny zestaw kodowania obsługiwany przez język Java. Nie Nie Brak
SplitCriteria String Ta właściwość przyjmuje różne wartości w zależności od wartości ustawionej dla właściwości SplittingFunctionClassName.
  • Jeśli właściwość SplittingFunctionClassName określa, że pliki są dzielone na podstawie separatora, właściwość SplitCriteria zawiera separator służący do rozdzielania obiektów biznesowych w pliku zdarzeń.
  • Jeśli właściwość SplittingFunctionClassName została ustawiona na wartość określającą dzielenie na podstawie wielkości, właściwość SplitCriteria zawiera prawidłowa liczbę reprezentującą wielkość wyrażoną w bajtach.
    • Jeśli plik zdarzeń jest większy niż ta wartość, adapter dzieli ten plik na porcje o wielkości zgodnej z tą wartością, a następnie wszystkie porcje są wysyłane.
    • Jeśli plik zdarzeń jest mniejszy niż ta wartość, jest wysyłany w całości. W przypadku gdy atrybut SplitCriteria ma wartość 0, funkcja dzielenia na porcje jest wyłączona.
Jeśli właściwość FilePassByReference jest włączona podczas przetwarzania danych przychodzących z użyciem tranzytu, plik zdarzeń nie jest dzielony.
Tak Nie 0
SocksProxyHost String Nazwa hosta komputera używanego jako serwer proxy, poprzez który żądania adaptera są kierowane do serwera FTP. Tak Nie Brak
SocksProxyPort String Numer portu serwera proxy, poprzez który żądania adaptera są kierowane do serwera FTP. Nie Nie Brak
SocksProxyUserName String Nazwa użytkownika używana do uwierzytelniania w przypadku serwera proxy. Tak Nie Brak
SocksProxyPassword String Hasło używane do uwierzytelniania w przypadku serwera proxy. Tak Nie Brak
FTPScriptFileExecuted
BeforeInbound
String Bezwzględna ścieżka do pliku skryptowego na lokalnym komputerze adaptera. Określony plik skryptowy jest uruchamiany przed każdym cyklem odpytywania danych przychodzących. Tak Nie Brak
FTPScriptFile
ExecutedAfterInbound
String Bezwzględna ścieżka do pliku skryptowego na lokalnym komputerze adaptera. Określony plik skryptowy jest uruchamiany po każdym cyklu odpytywania danych przychodzących. Tak Nie Brak
DefaultObjectName String Nazwa opakowującego obiektu biznesowego używanego przez strukturę transformacji danych przed dostarczeniem zdarzenia do punktu końcowego. Na przykład FTPFileBG lub CustomerWrapperBG. Nie Nie Brak
EventContentType String Typ treści lub typ MIME wejściowego pliku zdarzeń, który jest wysyłany do struktury transformacji danych w celu wywołania właściwej procedury obsługi danych podczas przekształcania łańcucha obiektu biznesowego w obiekt biznesowy. Ta właściwość podczas operacji tranzytu ma wartość NULL. Nie Nie Brak
Odsyłacze pokrewne
Właściwości adaptera zasobów
Właściwości specyfikacji połączenia
Właściwości fabryki połączeń zarządzanych (J2C)
Właściwości specyfikacji interakcji

Warunki używania |


(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)