{"id":7854,"date":"2024-01-19T09:49:10","date_gmt":"2024-01-19T08:49:10","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&p=7854"},"modified":"2024-01-19T09:49:17","modified_gmt":"2024-01-19T08:49:17","slug":"interfejs-uslug-sieciowych","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/interfejs-uslug-sieciowych\/","title":{"rendered":"Interfejs us\u0142ug sieciowych"},"content":{"rendered":"

Us\u0142ugi sieciowe to interfejsy do zdalnego wywo\u0142ywania funkcji. Nale\u017c\u0105 one do tej samej kategorii interfejs\u00f3w co CORBA.<\/p>\n

Comarch ERP Enterprise oferuje interfejs us\u0142ug sieciowych z \u0142\u0105czem do Business Integration Service (BIS) na potrzeby funkcji eksportu i importu danych. Dzi\u0119ki temu jednostki biznesowe (Business Entitys) mog\u0105 by\u0107 eksportowane do aplikacji klienckiej lub importowane z niej za pomoc\u0105 us\u0142ug sieciowych. Ponadto istnieje mo\u017cliwo\u015b\u0107 wywo\u0142ywania aplikacji w tle poprzez interfejs us\u0142ug sieciowych. Niniejszy dokument zawiera opis us\u0142ug sieciowych.<\/p>\n

U\u017cytkownik mo\u017ce programowa\u0107 w\u0142asne us\u0142ugi sieciowe, kt\u00f3re do zdalnych wywo\u0142a\u0144 funkcji wykorzystuj\u0105 protok\u00f3\u0142 SOAP lub realizuj\u0105 regu\u0142y REST. Szczeg\u00f3\u0142owe informacje znajduj\u0105 si\u0119 w dokumencie Interfejs dla programowalnych us\u0142ug sieciowych<\/em>.<\/p>\n

W przeciwie\u0144stwie do interfejsu CORBA, interfejs us\u0142ug sieciowych nie zosta\u0142 stworzony do przesy\u0142ania du\u017cych ilo\u015bci danych lub do kr\u00f3tkich czas\u00f3w reakcji, ale z my\u015bl\u0105 o mo\u017cliwie jak najprostszej obs\u0142udze dla klient\u00f3w, kt\u00f3rzy nie znaj\u0105 skomplikowanych logik lub protoko\u0142\u00f3w.<\/p>\n

Interfejs us\u0142ug sieciowych wykorzystuje og\u00f3lnie dost\u0119pn\u0105 bibliotek\u0119 us\u0142ug sieciowych Apache Axis dla us\u0142ug sieciowych, kt\u00f3re nie s\u0105 programowalne. Axis mo\u017cna r\u00f3wnie\u017c wykorzysta\u0107 do implementacji klient\u00f3w w Java. Szczeg\u00f3\u0142owe informacje o Axis dost\u0119pne s\u0105 na stronie:<\/p>\n

http:\/\/ws.apache.org\/axis\/<\/em><\/a><\/p>\n

Comarch ERP Enterprise posiada klient\u00f3w przyk\u0142adowych zar\u00f3wno dla Java, jak r\u00f3wnie\u017c dla \u201eMicrosoft.Net\u201d. Obs\u0142uga dla klient\u00f3w Java oparta jest na Axis, natomiast klienci \u201eMicrosoft.Net\u201d realizowani s\u0105 w formie arkusza Microsoft Excel z przynale\u017cnym kodem C#. Opis klient\u00f3w przyk\u0142adowych znajduje si\u0119 w rozdziale 6.<\/p>\n

Wskaz\u00f3wka<\/div>
Interfejs us\u0142ug sieciowych nie jest przeznaczony do przesy\u0142ania du\u017cych zbior\u00f3w danych. Otrzymane lub wys\u0142ane dane mog\u0105 wymaga\u0107 ca\u0142kowitego przetworzenia w pami\u0119ci g\u0142\u00f3wnej serwera aplikacji. Mo\u017ce to prowadzi\u0107 do znacznego obci\u0105\u017cenia serwera aplikacji i zmniejszenia wydajno\u015bci.<\/div><\/section>\n

Z uwagi na z\u0142o\u017cono\u015b\u0107 funkcjonalno\u015bci zaleca si\u0119 u\u017cywanie us\u0142ug sieciowych przez programist\u00f3w lub doradc\u00f3w technicznych.<\/p>\n

Definicje poj\u0119\u0107<\/h3>\n

WSDL<\/strong> – web Services Description Language, j\u0119zyk opisu dla interfejsu us\u0142ugi sieciowej.<\/p>\n

SOAP<\/strong> \u2013 simple Object Access Protocol. Protok\u00f3\u0142 oparty na XML przeznaczony do wymiany wiadomo\u015bci w systemach rozproszonych. SOAP jest wykorzystywana do komunikacji pomi\u0119dzy klientami a serwerami serwis\u00f3w sieciowych.<\/p>\n

Opis<\/h3>\n

Nieprogramowalne us\u0142ugi sieciowe<\/h4>\n

Comarch ERP Enterprise oferuje cztery us\u0142ugi sieciowe, kt\u00f3rych nie mo\u017cna programowa\u0107. Us\u0142ugi te wykorzystuj\u0105 do po\u0142\u0105cze\u0144 zdalnych protok\u00f3\u0142 SOAP. Z jednej strony s\u0105 to specjalistyczne us\u0142ugi sieciowe: eksport i import danych oraz zdalne wyszukiwanie. Z drugiej strony istnieje mo\u017cliwo\u015b\u0107 uruchomienia dowolnych aplikacji w tle.<\/p>\n

Wywo\u0142anie aplikacji w tle<\/h5>\n

Ka\u017cd\u0105 z aplikacji w tle mo\u017cna wywo\u0142a\u0107 za pomoc\u0105 tej us\u0142ugi sieciowej. Aplikacje mog\u0105 by\u0107 jednak wywo\u0142ane tylko bez statusu (CallApplication<\/em>). Inaczej ni\u017c w przypadku COBRA, gdzie mo\u017cliwe jest wywo\u0142anie aplikacji w konkretnym stanie (RunApplication<\/em>).<\/p>\n

Eksport danych<\/h5>\n

Ta us\u0142uga sieciowa mo\u017ce by\u0107 wykorzystywana do eksportu danych jednostki biznesowej (dost\u0119pna w aplikacji Eksport danych<\/em>). Filtr ustawiony w Comarch ERP Enterprise okre\u015bla liczb\u0119 eksportowanych atrybut\u00f3w i rekord\u00f3w danych. Klient zewn\u0119trzny mo\u017ce wtedy wywo\u0142a\u0107 ten eksport i jako odpowied\u017a otrzyma atrybuty ustawione w filtrze.<\/p>\n

Import danych<\/h5>\n

Ta us\u0142uga sieciowa mo\u017ce by\u0107 wykorzystywana do importu danych dla jednostki biznesowej (dost\u0119pna w aplikacji Import danych<\/em>). Filtr ustawiony w Comarch ERP Enterprise okre\u015bla liczb\u0119 importowanych atrybut\u00f3w. Klient zewn\u0119trzny mo\u017ce wywo\u0142a\u0107 ten import, po czym zwracany jest wynik procesu importu oraz wszelkie nieprawid\u0142owe rekordy danych.<\/p>\n

Zdalne wyszukiwanie<\/h5>\n

Ta us\u0142uga sieciowa mo\u017ce by\u0107 wykorzystywana do wyszukiwania poszczeg\u00f3lnych rekord\u00f3w danych jednostki biznesowej. W zale\u017cno\u015bci od wyszukiwania OQL zapisanego w Comarch ERP Enterprise parametry wysy\u0142ane s\u0105 do serwera, kt\u00f3ry nast\u0119pnie zwraca znalezione rekordy danych.<\/p>\n

Wywo\u0142anie us\u0142ugi sieciowej<\/h4>\n

Wywo\u0142anie us\u0142ugi sieciowej odbywa si\u0119 poprzez API, kt\u00f3re musi by\u0107 wygenerowane specjalnie dla wybranej us\u0142ugi sieciowej. Aby by\u0142a mo\u017cliwo\u015b\u0107 wygenerowania API, ka\u017cda us\u0142uga sieciowa udost\u0119pnia opis swoich parametr\u00f3w i warto\u015bci wynikowych w formie WSDL. WSDL musi nast\u0119pnie zosta\u0107 przekszta\u0142cone w odpowiednie API. S\u0142u\u017cy do tego narz\u0119dzie dost\u0119pne w Comarch ERP Enterprise. To API jest nast\u0119pnie wykorzystywane przez klienta do wywo\u0142anie us\u0142ugi sieciowej.<\/p>\n

Us\u0142ugi sieciowe mog\u0105 by\u0107 wywo\u0142ane przez dowolnego klienta w dowolnym j\u0119zyku programowania. Comarch ERP Enterprise wspiera tylko klient\u00f3w utworzonych w Java i .NET. Wszystkie inne formy klient\u00f3w mog\u0105 wymaga\u0107 dodatkowych instrument\u00f3w. Poni\u017cej jako przyk\u0142ad przedstawiono API klienta Axis 1 dla j\u0119zyka Java.<\/p>\n

API klienta<\/h4>\n

Ka\u017cda us\u0142uga sieciowa sk\u0142ada si\u0119 z dw\u00f3ch interfejs\u00f3w: interfejs lokalizatora (Locator<\/em>) i interfejs us\u0142ugi sieciowej (Web<\/em> Service<\/em>). Interfejs Locator<\/em> odpowiada Factory<\/em>, a interfejs us\u0142ugi sieciowej Proxy<\/em>.<\/p>\n

\"\"<\/a><\/p>\n

Interfejs Locator<\/em> jest wykorzystywany na kliencie w formie klasy implementuj\u0105cej. Klasa ta nosi nazw\u0119 us\u0142ugi sieciowej plus dodatek Locator<\/em>. Najwa\u017cniejsze metody interfejsu Locator<\/em> s\u0105 trzy metody GET, kt\u00f3re mo\u017cna wykorzysta\u0107 do uzyskania dost\u0119pu do adresu us\u0142ugi sieciowej i proxy dla us\u0142ugi sieciowej.<\/p>\n

Obiekt proxy zawiera jedn\u0105 metod\u0119 dla ka\u017cdej operacji us\u0142ugi sieciowej. Ka\u017cda metoda otrzymuje jako parametr obiekt typu Request. Jest on charakterystyczny dla wybranej us\u0142ugi sieciowej, wybranej operacji oraz ew. dla wybranej bazy danych OLTP i wybranego filtra. To samo dotyczy warto\u015bci wynikowej typu Response<\/em>. Obiekt typu Response<\/em>\u00a0otrzyma nast\u0119pnie dane wygenerowane przez aplikacj\u0119 w tle.<\/p>\n

W tabeli poni\u017cej znajduje si\u0119 zestawienie metod:<\/p>\n\n\n\n\n\n\n\n\n
Interfejs<\/strong><\/td>\nMetoda<\/strong><\/td>\nOpis<\/strong><\/td>\n<\/tr>\n<\/thead>\n
<service>Locator<\/td>\nget<Service>Address()<\/td>\nZwraca adres, pod kt\u00f3rym dost\u0119pna jest us\u0142uga sieciowa.<\/td>\n<\/tr>\n
<service>Locator<\/td>\nget<service>()<\/td>\nZwraca obiekt <service>Service<\/em> (proxy) z zastosowaniem URL zarejestrowanego w WSDL<\/td>\n<\/tr>\n
<service>Locator<\/td>\nget<service>(URL)<\/td>\nZwraca obiekt <service>Service<\/em> (proxy) z zastosowaniem podanego URL<\/td>\n<\/tr>\n
<service>Service<\/td>\n<operation>
\n(<service>Request)<\/td>\n		Zwraca obiekt <service>Response<\/em> obiekt w zale\u017cnosci od danych obiektu Request<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Obs\u0142uga b\u0142\u0119d\u00f3w przy wywo\u0142ywaniu us\u0142ugi sieciowej<\/h4>\n

W przypadku wywo\u0142ywania us\u0142ug sieciowych wymagana jest stopniowana obs\u0142uga b\u0142\u0119d\u00f3w. Typowe wywo\u0142anie us\u0142ugi sieciowej przebiega nast\u0119puj\u0105co:<\/p>\n

try {\r\n    Response response= service.process(request);\r\n    Result result = response.getResult();\r\n    if(result != null) {\r\n        \/\/ application specific interpretation of results.\r\n    }\r\n    MessageQueue mQueue = response.getMessageQueue();\r\n    \/\/ interpret or print messages from queue\r\n}\r\ncatch (RemoteException ex) {\r\n    \/\/ technical problem with the service\r\n}\r\n<\/pre>\n
Wyst\u0105pienie wyj\u0105tku podczas wywo\u0142ywania us\u0142ugi sieciowej ma przyczyn\u0119 techniczn\u0105. W\u015br\u00f3d mo\u017cliwych przyczyn s\u0105 b\u0142\u0119dy przesy\u0142u danych lub b\u0142\u0119dy w sk\u0142adni danych XML. Je\u015bli nie wyst\u0105pi\u0105 \u017cadne b\u0142\u0119dy techniczne, w\u00f3wczas zostanie zwr\u00f3cony obiekt Response<\/em>. W przypadku wyst\u0105pienia b\u0142\u0119d\u00f3w w wywo\u0142ywanej us\u0142udze sieciowej, obiekt Response nie b\u0119dzie zawiera\u0142 \u017cadnego obiektu Result<\/em>. Je\u015bli wi\u0119c response.getResult() zwraca warto\u015b\u0107 zero, oznacza to b\u0142\u0105d w wywo\u0142anej us\u0142udze sieciowej. Je\u015bli istnieje obiekt Result<\/em>, konieczna jest dalsza interpretacja wynik\u00f3w, w celu wykrycia ewentualnych b\u0142\u0119d\u00f3w podczas opracowywania danych. Na przyk\u0142ad wywo\u0142anie us\u0142ugi importu mo\u017ce zwr\u00f3ci\u0107 rekordy danych, kt\u00f3re nie spe\u0142niaj\u0105 wymog\u00f3w weryfikacji w\u0142a\u015bciwych dla jednostek biznesowych. W ka\u017cdym z przypadk\u00f3w obiekt Response<\/em> otrzyma obiekt MessageQueue<\/em>. Dlatego nie jest mo\u017cliwe, aby wywo\u0142anie metody response.getMessageQueue() zwr\u00f3ci\u0142o warto\u015b\u0107 zero. Samo MessageQueue<\/em> mo\u017ce by\u0107 jednak puste, to znaczy, mo\u017ce nie zawiera\u0107 \u017cadnych obiekt\u00f3w Message<\/em>. Je\u015bli obiekt Response<\/em> ma warto\u015b\u0107 zero, to obiekt MessageQueue<\/em> zawsze zawiera przynajmniej jeden obiekt Message<\/em>.<\/p>\n
Wskaz\u00f3wka<\/div>
WSDL dla us\u0142ug sieciowych Import i Eksport zale\u017cy od filtra okre\u015blonego podczas generowania WSDL. Dlatego klienci wygenerowani w ten spos\u00f3b nie mog\u0105 by\u0107 u\u017cywani dla innego filtra. Mo\u017ce to spowodowa\u0107 wy\u015bwietlenie komunikatu o b\u0142\u0119dzie lub nieoczekiwane dzia\u0142anie.<\/div><\/section>\n
Parametry API us\u0142ug sieciowych<\/h4>\n
Poni\u017cej opisane zosta\u0142y parametry us\u0142ug sieciowych okre\u015blanych za pomoc\u0105 API. Inne parametry s\u0105 okre\u015blane nie poprzez API, ale za pomoc\u0105 URI zapytania (patrz rozdzia\u0142 Zapytanie URI dla us\u0142ug sieciowych<\/em>)<\/p>\n
CallApplication<\/h5>\n
Us\u0142uga sieciowa CallApplication<\/em> wywo\u0142uje metod\u0119 RUN<\/em> dla aplikacji w tle. Mo\u017cliwe jest okre\u015blenie przez klienta parametr\u00f3w metody RUN<\/em> podczas wywo\u0142ywania us\u0142ugi sieciowej. Po stronie klienta przekazywana jest nazwa kwalifikowana aplikacji w tle, akcja do wywo\u0142ania oraz tablic\u0119 (Array<\/em>) obiekt\u00f3w ParameterListEntry<\/em>. Przy czym obiekty ParameterListEntry<\/em> odpowiadaj\u0105 parametrom aplikacjom w tle.<\/p>\n
Wynik wywo\u0142anej aplikacji w tle jest zwracany do us\u0142ugi sieciowej CallApplication<\/em>. R\u00f3wnie\u017c w formie tablicy obiekt\u00f3w ParameterListEntry<\/em>.<\/p>\n
Nale\u017cy pami\u0119ta\u0107, \u017ce us\u0142uga sieciowa CallApplication<\/em> obs\u0142uguje tylko typy danych, kt\u00f3re zosta\u0142y wymienione poni\u017cej. Dotyczy to parametr\u00f3w wywo\u0142ania u warto\u015bci wynikowych. Nie mo\u017cna poprawnie wywo\u0142a\u0107 aplikacji w tle, kt\u00f3re wykorzystuj\u0105 inne typy danych.<\/p>\n
Klasa ParameterListEntry<\/h6>\n
Ka\u017cdy ParameterListEntry <\/em>posiada nazw\u0119, typ i warto\u015b\u0107. Przy czym warto\u015b\u0107 musi odpowiada\u0107 typowi. Typ jest definiowany jako sta\u0142a z klasy ParameterListEntryType<\/em>.<\/p>\n
Podczas tworzenia obiektu ParameterListEntry<\/em> zawsze nale\u017cy poda\u0107 nazw\u0119, typ i warto\u015b\u0107. Mo\u017cna stosowa\u0107 jeden z dw\u00f3ch konstruktor\u00f3w. Najprostsze jest zastosowanie domy\u015blnego konstruktora (bez parametr\u00f3w), wtedy jednak nale\u017cy ustawi\u0107 nazw\u0119, typ i warto\u015b\u0107 za pomoc\u0105 odpowiedniej metody set<\/em>.<\/p>\n
Klassa ParameterListEntryType<\/h6>\n
Dla tego typu danych dost\u0119pne s\u0105 nast\u0119puj\u0105ce sta\u0142e:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
Sta\u0142a<\/strong><\/td>\nTyp danych Java (klient)<\/strong><\/td>\nTyp danych XML<\/strong><\/td>\n<\/tr>\n
STRING<\/td>\nString<\/td>\nxsd:string<\/td>\n<\/tr>\n
PARAMETER_LIST<\/td>\nParameterListEntry []<\/td>\nParameterList<\/td>\n<\/tr>\n
BOOLEAN<\/td>\nBoolean<\/td>\nS<\/td>\n<\/tr>\n
BYTE<\/td>\nByte<\/td>\nxsd:byte<\/td>\n<\/tr>\n
SHORT<\/td>\nShort<\/td>\nxsd:short<\/td>\n<\/tr>\n
INT<\/td>\nInt<\/td>\nxsd:int<\/td>\n<\/tr>\n
LONG<\/td>\nLong<\/td>\nxsd:long<\/td>\n<\/tr>\n
BYTE_ARRAY_STRING<\/td>\nString<\/td>\nxsd:string<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
BYTE_ARRAY_STRING mo\u017ce by\u0107 zastosowane dla parametr\u00f3w aplikacji w tle GUID i Binary. Jako warto\u015b\u0107 na kliencie us\u0142ugi sieciowej podawany jest szesnastkowy ci\u0105g numeru GUID lub byte[].<\/p>\n
W rozdziale CallApplication<\/u><\/em> znajduje si\u0119 przyk\u0142ad zastosowania r\u00f3\u017cnych typ\u00f3w danych.<\/p>\n
Import<\/h5>\n
Istniej\u0105 dwie specjalne klasy parametr\u00f3w dla importu. S\u0105 one generowane na podstawie WSDL. W celu uruchomienia procesu importu nale\u017cy wygenerowa\u0107 obiekt ImportRequest<\/em>, odpowied\u017a importu jest zawarta w obiekcie ImportResponse<\/em>.<\/p>\n
Filtr<\/h6>\n
Dla importu nale\u017cy zastosowa\u0107 filtr dodany w systemie Comarch ERP Enterprise. Jest on okre\u015blany w adresie URI dla \u017c\u0105dania us\u0142ugi.<\/p>\n
WSDL us\u0142ugi zale\u017cy od zastosowanego filtra. Dlatego filtr nale\u017cy wskaza\u0107 r\u00f3wnie\u017c podczas wywo\u0142ywania WSDL. Ka\u017cdorazowo po zmianie filtra nale\u017cy ponownie pobra\u0107 WSDL i ew. wygenerowa\u0107 nowe klasy po stronie klienta.<\/p>\n
Wskaz\u00f3wka<\/div>
\u00a0W filtrze nie mo\u017cna aktywowa\u0107 \u017cadnych atrybut\u00f3w ani relacji, gdzie part i relacja r\u00f3\u017cni\u0105 si\u0119 tylko pisowni\u0105 wielkich i ma\u0142ych liter oraz znajduj\u0105 si\u0119 w tym samym obiekcie modelu danych BIS. Dlatego w przypadku z\u0142o\u017conych jednostek biznesowych nie nale\u017cy stosowa\u0107 filtra opartego na ustawieniu „Wszystkie atrybuty\u201d.<\/p>\n
Przyk\u0142ad z importu artyku\u0142\u00f3w: warehouse jest artybutem w part storageArea, code jest atrybutem w relacji StorageArea.<\/p>\n
InventoryItems.ItemStorageData.storageArea.warehouse<\/p>\n
InventoryItems.ItemStorageData.StorageArea.code<\/p>\n
Nie mo\u017cna r\u00f3wnocze\u015bnie stosowa\u0107 tych obu atrybut\u00f3w. W przypadku wielu bibliotek klient\u00f3w us\u0142ug sieciowych spowodowa\u0142oby to utworzenie klas Java, kt\u00f3rych nazwy r\u00f3\u017cni\u0105 si\u0119 tylko pisowni\u0105 wielkimi\/ma\u0142ymi literami.<\/div><\/section>\n
Struktura wywo\u0142ywania dla importu<\/h6>\n
Podczas generowania obiektu Request<\/em> nale\u017cy okre\u015bli\u0107 wszystkie parametry importu.<\/p>\n
Konstruktor ImportRequest(…)<\/h5>\n
S\u0142u\u017cy do generowania obiektu ImportRequest z odpowiednimi parametrami:<\/p>\n
    \n
  • WarningsMode warningsMode<\/em> \u2013 okre\u015bla obs\u0142ug\u0119 ostrze\u017ce\u0144 pojawiaj\u0105cych si\u0119 podczas importu\n
      \n
    • Ostrze\u017cenia z warto\u015bci\u0105 CONFIRM_NONE powoduj\u0105 b\u0142\u0119dy importu i s\u0105 zapisywane do pliku b\u0142\u0119d\u00f3w<\/li>\n
    • Ostrze\u017cenia z warto\u015bci\u0105 CONFIRM_ALL s\u0105 ignorowane<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
        \n
      • CorrectionMode correctionMode<\/em> – okre\u015bla, czy w Comarch ERP Enterprise maj\u0105 zosta\u0107 poprawione nieprawid\u0142owe dane.<\/li>\n<\/ul>\n
        Warto\u015b\u0107 NONE oznacza brak korekty w Comarch ERP Enterprise. Nieprawid\u0142owe dane zostan\u0105 przekazane do klienta w obiekcie Reponse-Object.<\/p>\n
        Warto\u015b\u0107 WORKFLOW oznacza, \u017ce korekta ma zosta\u0107 wykonana w Comarch ERP Enterprise po powiadomieniu poprzez workflow. Nieprawid\u0142owe dane nie zostan\u0105 przekazane do klienta, ale zapisane w formie pliku b\u0142\u0119d\u00f3w w systemowym repozytorium wiedzy w folderze kstore:\/\/<Arbeitsbereich>\/Import\/ RemoteErrorFiles<\/em>. Jako obszar roboczy stosowany jest domy\u015blny obszar roboczy bazy danych, do kt\u00f3rej dane zosta\u0142y zaimportowane.<\/p>\n
        Uwaga<\/div>
        Nale\u017cy pami\u0119ta\u0107, \u017ce ten parametr nie wp\u0142ywa na powiadomienie poprzez workflow. <\/div><\/section>\n
          \n
        • EntityWrapper importData<\/em> \u2013 obiekt Wrapper zawiera dane do zaimportowania.<\/li>\n<\/ul>\n
          Konstruktor EntityWrapper( \u2026 )<\/h5>\n
            \n
          • Title[] title – tablica rekord\u00f3w danych do zaimportowania<\/li>\n
          • Message[] _message \u2013 nieu\u017cywane. Zaleca si\u0119 przeniesienie warto\u015bci null<\/em>.<\/li>\n<\/ul>\n
            Struktura warto\u015bci zwracanych dla importu<\/h6>\n
            Po skutecznym wywo\u0142aniu importu zwracany jest obiekt ImportResponse<\/em>, z kt\u00f3rego mo\u017cna odczyta\u0107 odpowiednie warto\u015bci za pomoc\u0105 metod get<\/em>.<\/p>\n
            Klasa ImportResponse<\/h6>\n
            Dost\u0119pne metody:<\/p>\n
              \n
            • ImportResult getResult() – zwraca obiekt Result<\/em>, mo\u017ce mie\u0107 warto\u015b\u0107 null<\/em><\/li>\n
            • MessageQueue getMessageQueue() – zwraca MessageQueue<\/em><\/li>\n<\/ul>\n
              Klasa ImportResult<\/h6>\n
              Dost\u0119pne metody:<\/p>\n
                \n
              • int getImportedObjectCount() – zwraca liczb\u0119 poprawnie zaimportowanych rekord\u00f3w danych<\/li>\n
              • int getInvalidObjectCount() – zwraca liczb\u0119 niezaimportowanych rekord\u00f3w danych, kt\u00f3re mog\u0105 by\u0107 poprawione<\/li>\n
              • int getNotCorrigibleObjectCount() – zwraca liczb\u0119 niezaimportowanych rekord\u00f3w danych, kt\u00f3rych nie mo\u017cna poprawi\u0107<\/li>\n
              • boolean isHasErrorFile() – je\u015bli metoda zwraca warto\u015b\u0107 true<\/em>, w\u00f3wczas zwracane s\u0105 b\u0142\u0119dne rekordy danych<\/li>\n
              • EntityWrapper getErrorData() – zwraca obiekt EntityWrapper<\/em><\/li>\n<\/ul>\n
                Klasa EntityWrapper<\/h6>\n
                  \n
                • Title[] getTitle() – zwraca nieprawid\u0142owe rekordy danych, kt\u00f3rych nie mo\u017cna zaimportowa\u0107. W przypadku braku nieprawid\u0142owych danych metoda zwraca warto\u015b\u0107 null<\/em>.<\/li>\n
                • MessageQueue getMessageQueue() – zwraca MessageQueue<\/em>, w kt\u00f3rej mog\u0105 znajdowa\u0107 si\u0119 komunikaty<\/li>\n<\/ul>\n
                  Eksport<\/h5>\n
                  Istniej\u0105 dwie specjalne klasy parametr\u00f3w dla importu. S\u0105 one generowane na podstawie WSDL. W celu uruchomienia procesu eksportu nale\u017cy wygenerowa\u0107 obiekt Request<\/em>, odpowied\u017a eksportu zawarta jest w obiekcie Response<\/em>.<\/p>\n
                  Filtr<\/h6>\n
                  Dla eksportu nale\u017cy zastosowa\u0107 filtr dodany w systemie Comarch ERP Enterprise. Jest on okre\u015blany w adresie URI dla \u017c\u0105dania us\u0142ugi.<\/p>\n
                  Wskaz\u00f3wki odnosz\u0105ce si\u0119 do filtr\u00f3w importu maj\u0105 r\u00f3wnie\u017c zastosowanie dla eksportu.<\/p>\n
                  Struktura wywo\u0142ywania dla eksportu<\/h6>\n
                  Podczas generowania obiektu ExportRequest<\/em> nale\u017cy okre\u015bli\u0107 wszystkie parametry eksportu.<\/p>\n
                  Konstruktor ExportRequest(\u2026)<\/h6>\n
                  Generuje obiekt ExportRequest<\/em> z odpowiednimi parametrami:<\/p>\n
                  Parametry-Opis<\/p>\n
                    \n
                  • String dynamicOQLSearch – instrukcja OQL pozwalaj\u0105ca ograniczy\u0107 eksportowane rekordy danych. Szczeg\u00f3\u0142owe informacje o strukturze aplikacji OQL znajduj\u0105 si\u0119 w dokumencie Eksport danych<\/em> Je\u015bli zamiast instrukcji OQL b\u0119dzie zastosowane wyszukiwanie OQL, nale\u017cy wprowadzi\u0107 w tym miejscu pusty ci\u0105g.<\/li>\n
                  • String searchName – pe\u0142na nazwa wyszukiwania OQL. Je\u015bli zamiast wyszukiwania OQL b\u0119dzie zastosowana instrukcja OQL, nale\u017cy wprowadzi\u0107 w tym miejscu pusty ci\u0105g.<\/li>\n
                  • ParameterListEntry[] searchParameters – parametry wyszukiwania do ograniczania wynik\u00f3w za pomoc\u0105 wyszukiwania OQL. Warto\u015b\u0107 to tablica z wpisami, kt\u00f3re zawieraj\u0105 po jednym parametrze wyszukiwania. Nazwa parametru odpowiada nazwie pola wyszukiwania z wyszukiwania OQL, warto\u015bci\u0105 parametru jest natomiast Selection String<\/em>. Nale\u017cy okre\u015bli\u0107 te parametry wyszukiwania, kt\u00f3re maj\u0105 by\u0107 zastosowane do ograniczania wynik\u00f3w wyszukiwania.<\/li>\n<\/ul>\n
                    W przypadku ograniczania za pomoc\u0105 instrukcji OQL ten parametr nie jest wykorzystywany.<\/p>\n
                      \n
                    • String searchSortOrder – sortowanie eksportowanych instancji dla ograniczenia za pomoc\u0105 wyszukiwania OQL. Warto\u015bci\u0105 domy\u015bln\u0105 jest sortowanie domy\u015blne wprowadzone dla wyszukiwania QOL. Sk\u0142adnia sortowania zosta\u0142a opisana w dokumencie Interfejsy programistyczne do wymiany danych<\/em>, w rozdziale Format funkcji sortowania<\/em>. W przypadku ograniczania za pomoc\u0105 instrukcji OQL ten parametr nie jest wykorzystywany.<\/li>\n<\/ul>\n
                      Struktura warto\u015bci zwracanych dla eksportu<\/h6>\n
                      Po skutecznym wywo\u0142aniu eksportu zwracany jest obiekt ExportResponse<\/em>, z kt\u00f3rego mo\u017cna odczyta\u0107 odpowiednie warto\u015bci za pomoc\u0105 metod get<\/em>.<\/p>\n
                      Klasa ExportResponse<\/h6>\n
                      Dost\u0119pne metody:<\/p>\n
                        \n
                      • int getExportedObjectCount() – zwraca liczb\u0119 wyeksportowanych rekord\u00f3w danych<\/li>\n
                      • Title[] getExportData() – zwraca tablic\u0119 wszystkich wyeksportowanych rekord\u00f3w danych<\/li>\n
                      • MessageQueue getMessageQueue() – zwraca MessageQueue<\/em>, w kt\u00f3rej mog\u0105 znajdowa\u0107 si\u0119 komunikaty<\/li>\n<\/ul>\n
                        Search<\/h5>\n
                        Us\u0142uga sieciowa Search<\/em> zawiera obie operacje Wyszukaj<\/em> i Sprawd\u017a wyst\u0119powanie<\/em>. O ile podczas wyszukiwania w zbiorze wynik\u00f3w mo\u017cna znale\u017a\u0107 szereg rekord\u00f3w danych, operacja Sprawd\u017a wyst\u0119powanie<\/em> b\u0119dzie zawiera\u0107 jedynie rekord danych, kt\u00f3ry ma zosta\u0107 sprawdzony. Je\u015bli parametry okre\u015blone w operacji Sprawd\u017a wyst\u0119powanie<\/em> odpowiadaj\u0105 wielu rekordom danych w bazie, to mimo to zwr\u00f3cony zostanie tylko jeden rekord danych.<\/p>\n
                        Dla us\u0142ugi sieciowej Search<\/em> dost\u0119pne s\u0105 trzy specjalne klasy parametr\u00f3w. S\u0105 one generowane na podstawie WSDL. W celu uruchomienia wyszukiwania nale\u017cy wygenerowa\u0107 obiekt SearchRequest<\/em> lub SearchExist<\/em>, odpowied\u017a us\u0142ugi jest zawarta w obiekcie SearchResponse<\/em>.<\/p>\n
                        Struktury wywo\u0142ywania dla wyszukiwania<\/h6>\n
                        Podczas generowania obiektu SearchRequest<\/em> lub SearchExistRequest<\/em> nale\u017cy okre\u015bli\u0107 wszystkie parametry wyszukiwania.<\/p>\n
                        Klasa SearchRequest(…)<\/h6>\n
                        Generuje obiekt SearchRequest<\/em> z odpowiednimi parametrami:<\/p>\n
                          \n
                        • String searchName – w pe\u0142ni kwalifikowana nazwa wyszukiwania OQL, kt\u00f3re ma by\u0107 wykonane na wskazanej bazie danych<\/li>\n
                        • ParameterListEntry[] searchParameters – warto\u015bci parametr\u00f3w dla wskazanego wyszukiwania OQL (opcjonalne)<\/li>\n
                        • String searchSortOrder – sortowanie eksportowanych instancji dla ograniczenia za pomoc\u0105 wyszukiwania OQL. Warto\u015bci\u0105 domy\u015bln\u0105 jest sortowanie domy\u015blne wprowadzone dla wyszukiwania QOL. Sk\u0142adnia sortowania zosta\u0142a opisana w dokumencie Interfejsy programistyczne do wymiany danych<\/em>, w rozdziale Format funkcji sortowania<\/em>.<\/li>\n
                        • String database – alias bazy danych Nale\u017cy zastosowa\u0107 dane z wygenerowanej klasy Database<\/em><\/li>\n
                        • pageSize – okre\u015bla maksymaln\u0105 liczb\u0119 rekord\u00f3w danych, kt\u00f3re maj\u0105 zosta\u0107 przekazane do klienta<\/li>\n
                        • SearchFormat searchParametersFormat – okre\u015bla format, w kt\u00f3rym maj\u0105 by\u0107 podawane parametry wyszukiwania. Nale\u017cy zastosowa\u0107 dane z wygenerowanej klasy SearchFormat<\/em>.<\/li>\n
                        • SearchFormat searchResultFormat – Okre\u015bla format atrybut\u00f3w zwracanych w wynikach wyszukiwania. Nale\u017cy zastosowa\u0107 dane z wygenerowanej klasy SearchFormat<\/em>.<\/li>\n<\/ul>\n
                          Klasa SearchExistRequest(…)<\/h6>\n
                          Dost\u0119pne parametry:<\/p>\n
                          Parametry-Opis<\/p>\n
                            \n
                          • String searchName – w pe\u0142ni kwalifikowana nazwa wyszukiwania OQL, kt\u00f3re ma by\u0107 wykonane na wskazanej bazie danych<\/li>\n
                          • ParameterListEntry[] searchParameters – warto\u015bci parametr\u00f3w dla wskazanego wyszukiwania OQL (opcjonalne)<\/li>\n
                          • String database – alias bazy danych Nale\u017cy zastosowa\u0107 dane z wygenerowanej klasy Database<\/em>.<\/li>\n
                          • SearchFormat searchParametersFormat – okre\u015bla format, w kt\u00f3rym maj\u0105 by\u0107 podawane parametry wyszukiwania. Nale\u017cy zastosowa\u0107 dane z wygenerowanej klasy SearchFormat<\/em>.<\/li>\n<\/ul>\n
                            Struktury zwracanych warto\u015bci dla wyszukiwania<\/h6>\n
                            Po skutecznym wywo\u0142aniu wyszukiwania zwracany jest obiekt SearchResponse<\/em>, z kt\u00f3rego mo\u017cna odczyta\u0107 odpowiednie warto\u015bci za pomoc\u0105 metod get<\/em>.<\/p>\n
                            Klasa SearchResponse<\/h6>\n
                            Dost\u0119pne metody:<\/p>\n
                              \n
                            • SearchResult getResult() – zwraca obiekt SearchResult<\/em> zawieraj\u0105cy wyniki wyszukiwania. Mo\u017ce mie\u0107 warto\u015b\u0107 null<\/em>.<\/li>\n
                            • MessageQueue getMessageQueue() – zwraca MessageQueue<\/em>, kt\u00f3re mo\u017ce zawiera\u0107 komunikaty<\/li>\n<\/ul>\n
                              Klasa SearchResult<\/h6>\n
                              Dost\u0119pne metody:<\/p>\n
                                \n
                              • int getCurrentObjectCount() – wskazuje liczb\u0119 zwracanych rekord\u00f3w danych.<\/li>\n
                              • String getContent() – zwraca rekordy danych w formie ci\u0105gu zawieraj\u0105cego plik XML zakodowany w UTF8<\/li>\n<\/ul>\n
                                Komunikaty dla zwracanych warto\u015bci<\/h4>\n
                                Klient us\u0142ugi sieciowej otrzymuje z serwera us\u0142ug sieciowych nie tylko wyniki wywo\u0142ywania, ale mo\u017ce r\u00f3wnie\u017c otrzymywa\u0107 szereg komunikat\u00f3w, np. o wyst\u0105pieniu b\u0142\u0119d\u00f3w. S\u0105 one dostarczane do klienta w formie specjalnej struktury danych sk\u0142adaj\u0105cej si\u0119 z klas MessageQueue<\/em> i Message<\/em>.<\/p>\n
                                Wszystkie obiekty Message<\/em> wysy\u0142ane przez serwer do klienta s\u0105 zestawione w obiekcie MessageQueue<\/em>. Ka\u017cdy obiekt Message<\/em> zawiera z kolei obiekt MessageSeverity<\/em> opisuj\u0105cy typ komunikatu (b\u0142\u0105d, ostrze\u017cenie, informacja itd.).<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
                                Klasa<\/strong><\/td>\nMetoda<\/strong><\/td>\nOpis<\/strong><\/td>\n<\/tr>\n<\/thead>\n
                                MessageQueue<\/em><\/td>\nisRequiresAttention()<\/td>\ntrue<\/em>, je\u015bli MessageQueue<\/em> zawiera komunikaty o b\u0142\u0119dach lub niezatwierdzone ostrze\u017cenia.<\/td>\n<\/tr>\n
                                getMessage()<\/td>\nZwraca tablic\u0119 obiekt\u00f3w Message<\/em>.<\/td>\n<\/tr>\n
                                Message<\/em><\/td>\ngetSeverityLevel()<\/td>\nZwraca obiekt MessageSeverity<\/em> opisuj\u0105cy typ komunikatu.<\/td>\n<\/tr>\n
                                getIdentifier()<\/td>\nZwraca identyfikator komunikatu stanowi\u0105cy kombinacj\u0119 klasy i numeru komunikatu.<\/td>\n<\/tr>\n
                                getMessageClass()<\/td>\nZwraca klas\u0119 komunikatu.<\/td>\n<\/tr>\n
                                getMessageNumber()<\/td>\nZwraca numer komunikatu.<\/td>\n<\/tr>\n
                                getMessageText()<\/td>\nZwraca tekst komunikatu.<\/td>\n<\/tr>\n
                                getMessageLongText()<\/td>\nZwraca d\u0142ugi tekst komunikatu.<\/td>\n<\/tr>\n
                                MessageSeverity<\/em><\/td>\ngetValue()<\/td>\nZwraca tekstow\u0105 prezentacj\u0119 typu komunikatu.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                Uwierzytelnienie<\/h4>\n
                                Zar\u00f3wno klient us\u0142ug sieciowych musi zosta\u0107 uwierzytelniony dla serwera us\u0142ug sieciowych, jak i serwer us\u0142ug sieciowych dla klienta us\u0142ug sieciowych.<\/p>\n
                                Axis wspiera tylko uwierzytelnianie BASIC<\/em> i uwierzytelnianie przy u\u017cyciu certyfikat\u00f3w. Comarch ERP Enterprise obs\u0142uguje tylko uwierzytelnianie DIGEST<\/em> oraz uwierzytelnianie przy u\u017cyciu certyfikat\u00f3w. Dlatego klient us\u0142ugi sieciowej mo\u017ce komunikowa\u0107 si\u0119 z serwerem Comarch ERP Enterprise dla us\u0142ug sieciowych tylko za pomoc\u0105 uwierzytelniania przez certyfikaty.<\/p>\n
                                Klient us\u0142ugi sieciowej potrzebuje certyfikatu serwera do weryfikacji serwera us\u0142ug internetowych oraz certyfikatu u\u017cytkownika na potrzeby w\u0142asnej identyfikacji. Certyfikat u\u017cytkownika musi zawiera\u0107 klucz prywatny i dlatego najcz\u0119\u015bciej jest zapisywany w postaci pliku „.pfx” lub „.jks”, chronionym has\u0142em (Java 1.5 obs\u0142uguje tylko pliki „.jks” bez dodatkowych bibliotek.)<\/p>\n
                                Przyk\u0142ady programowania klienta us\u0142ugi sieciowej znajduj\u0105 si\u0119 w rozdziale Programowanie klienta us\u0142ugi sieciowej.<\/em><\/p>\n
                                Obszary nazw XML<\/h4>\n
                                Klient us\u0142ugi sieciowej jest tworzony na podstawie WSDL danej us\u0142ugi sieciowej. To WSDL definiuje jeden lub wiele obszar\u00f3w nazw. Definiowany jest przynajmniej obszar nazw XML dla samego wywo\u0142ania us\u0142ugi sieciowej razem z domy\u015blnymi parametrami. Je\u015bli wymagane s\u0105 jeszcze dodatkowe dane, np. w przypadku zdalnej us\u0142ugi sieciowej, w\u00f3wczas definiowany jest jeszcze obszar nazw dla typ\u00f3w danych dodatkowych oraz obszar nazw XML danych.<\/p>\n
                                Te obszary nazw XML s\u0105 r\u00f3wnie\u017c odwzorowane w klasach Java wygenerowanych z WSDL. Zasadniczo obszary nazw XML j\u0119zyka WSDL skutkuj\u0105 powstaniem obszar\u00f3w nazw klasy Java, kt\u00f3re niekoniecznie s\u0105 oczekiwane. Dlatego istnieje te\u017c mo\u017cliwo\u015b\u0107 odwzorowania tych obszar\u00f3w nazw w dowolnych obszarach nazw Java podczas generowania klas Java. Szczeg\u00f3\u0142owe parametry tego odwzorowania mo\u017cna znale\u017a\u0107 w rozdziale Generowanie plik\u00f3w \u017ar\u00f3d\u0142owych Java z WSDL<\/em>.<\/p>\n
                                Obszarom nazw XML nadawane s\u0105 nast\u0119puj\u0105ce klasy:<\/p>\n
                                  \n
                                • obszar nazw XML common<\/em><\/li>\n<\/ul>\n
                                  Klasy nale\u017c\u0105ce do obszaru nazw XML common<\/em> s\u0105 stosowana przez us\u0142ug\u0119 sieciow\u0105 CallApplication<\/em> oraz wsp\u00f3lnie przez wszystkie us\u0142ugi sieciowe. Klasy wygenerowane dla tego obszaru nazw XML:<\/p>\n
                                  CallApplication\r\nCallApplicationLocator\r\nCallApplicationRequest\r\nCallApplicationResponse\r\nCallApplicationService\r\nCallApplicationSoapBindingStub\r\nMessage\r\nMessageQueue\r\nMessageSeverity\r\nParameterListEntry\r\nParameterListEntryType\r\n<\/pre>\n
                                    \n
                                  • obszary nazw XML Eksport\/Baza danych\/Filtry<\/em>, Import\/Baza danych\/<Filtry><\/em>, Search<\/em><\/li>\n<\/ul>\n
                                    Wszystkie opisy klas dla danych u\u017cytkowych us\u0142ugi sieciowej Export<\/em>, Import<\/em> i Search<\/em> znajduj\u0105 si\u0119 w ich odpowiednim oddzielnym obszarze nazw XML.<\/p>\n
                                      \n
                                    • obszary nazw XML Eksport\/<Baza danych>\/<Filtry>\/data<\/em> oraz Import\/<Baza danych>\/<Filtry>\/data<\/em>.<\/li>\n<\/ul>\n
                                      Wszystkie opisy klas dla danych u\u017cytkowych us\u0142ugi sieciowej Export<\/em> lub Import<\/em> znajduj\u0105 si\u0119 w oddzielnym obszarze nazw XML. To, jakie klasy b\u0119d\u0105 generowane, zale\u017cy m.in. od wybranej jednostki biznesowej (business entity), bazy danych OLTP oraz ustawie\u0144 filtra.<\/p>\n
                                      Instrukcje<\/h3>\n
                                      W tym rozdziale opisano spos\u00f3b tworzenie klienta us\u0142ug sieciowych w j\u0119zyku Java przy u\u017cyciu biblioteki klienta Axis 1. Zastosowano us\u0142ug\u0119 eksportu.<\/p>\n
                                      Generowanie WSDL<\/h4>\n
                                      Dla ka\u017cdej us\u0142ugi sieciowej mo\u017cna wykona\u0107 zapytanie o przynale\u017cne WSDL. Wystarczy wpisa\u0107 w przegl\u0105darce URI w nast\u0119puj\u0105cej formie:<\/p>\n
                                      https:\/\/<server>:<port>\/webservices\/<service>?wsdl;oltp=<oltp>;filter=<filter>;oltpMode=<oltpMode><\/pre>\n
                                      Wymagane parametry:<\/p>\n
                                      Parametry-Opis<\/p>\n
                                        \n
                                      • server – adres serwera aplikacji systemu ERP, do kt\u00f3rego jest wysy\u0142ane zapytanie<\/li>\n
                                      • port – port us\u0142ugi sieciowej zapytania. Warto\u015b\u0107 domy\u015blna to 443.<\/li>\n
                                      • service – identyfikator us\u0142ugi sieciowej zapytania. Dost\u0119pne warto\u015bci:\n
                                          \n
                                        • CallApplication<\/em><\/li>\n
                                        • Import<\/em><\/li>\n
                                        • Export<\/em><\/li>\n
                                        • Search<\/em><\/li>\n<\/ul>\n<\/li>\n
                                        • Oltp – identyfikator bazy danych OLPT, na kt\u00f3rej loguje si\u0119 klient (browser), aby wykona\u0107 zapytanie o WSDL<\/li>\n
                                        • Filter – identyfikator filtra, kt\u00f3ry ma by\u0107 zastosowany do okre\u015blenia WSDL<\/li>\n
                                        • oltpMode – tryb OLPT. Okre\u015bla, czy nazwa bazy danych OLTP powinna by\u0107 zawarta w obszarze nazw us\u0142ugi sieciowej. Dost\u0119pne warto\u015bci:\n
                                            \n
                                          • oltp – po wybraniu tej warto\u015bci w obszarze nazw pojawi si\u0119 nazwa bazy danych OLTP, a wygenerowane WSDL mo\u017ce zosta\u0107 zastosowane na aktualnym systemie i dla podanej bazy OLTP.<\/li>\n
                                          • extended – po wybraniu tej warto\u015bci WSDL mo\u017ce by\u0107 wykorzystywane na dowolnym systemie lub bazie danych OLTP. Nale\u017cy jednak upewni\u0107 si\u0119, \u017ce u\u017cywany filtr istnieje w odpowiednich bazach danych OLTP i ma te same ustawienia.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                                            Warto\u015b\u0107 domy\u015blna: oltp.<\/p>\n
                                            Przyk\u0142ad<\/div>
                                            <\/p>\n
                                            https:\/\/rXYZ.semiramis.com\/webservices\/Export?wsdl;oltp= OLTPDB00;filter=TITLE<\/pre>\n
                                            <\/div><\/section>\n
                                            Generowanie klas Java<\/h4>\n
                                            W kolejnym kroku nale\u017cy przet\u0142umaczy\u0107 WSDL na klasy Java. Mo\u017cna w tym celu u\u017cy\u0107 narz\u0119dzi z pakietu AXIS, ale \u0142atwiej jest to zrobi\u0107 za pomoc\u0105 polecenia CreateWSDLJavaSources<\/em>.<\/p>\n
                                            Ta komenda nie tylko t\u0142umaczy WSDL na klasy Java, ale mo\u017ce r\u00f3wnie\u017c automatycznie wykona\u0107 zapytanie o WSDL z serwera us\u0142ugi sieciowej. Szczeg\u00f3\u0142owy opis wszystkich parametr\u00f3w znajduje si\u0119 w rozdziale Generowanie plik\u00f3w \u017ar\u00f3d\u0142owych Java z WSDL<\/em><\/p>\n
                                            CreateWSDLJavaSources \t\r\n    -server:rXYZ.semiramis.com \t\r\n    -service:Export\t\r\n    -oltp:DATABASE00\t\r\n    -filter:TITLE \t\r\n    -userCertificateFileName:C:\\temp\\XYZ.jks \t\r\n    -userCertificateFilePassword:1234567  \t\r\n    -serverCertificateFileName:C:\\temp\\XYZ.jks \t\r\n    -outputDirectory:C:\\semiramis\\work\\job0xxxx\\usrXYZ\\source \t\r\n    -outputNameSpace:http:\/\/webservices.semiramis.com\/2006-01\/Export\/extended\/TITLE\r\n        =com.cisag.app.system.webservices.log.export.generated\r\n-outputNameSpace:http:\/\/cisag.com\/pgm\/external\/webservices\/2006-01\r\n    -outputNameSpace:http:\/\/webservices.semiramis.com\/2006-01\/common\r\n        =com.cisag.app.system.webservices.log.export.generated \t\r\n    -outputNameSpace:http:\/\/webservices.semiramis.com\/2006-01\/Export\/extended\/TITLE\/data\r\n        =com.cisag.app.system.webservices.log.export.generated\r\n<\/pre>\n
                                            Teraz nale\u017cy przet\u0142umaczy\u0107 utworzone klasy Java.<\/p>\n
                                            Programowanie klienta us\u0142ugi sieciowej<\/h4>\n
                                            Klient Java mo\u017ce zastosowa\u0107 wygenerowane klasy w celu wywo\u0142ania \u017c\u0105danej us\u0142ugi sieciowej. W tym celu nale\u017cy wykona\u0107 nast\u0119puj\u0105ce kroki:<\/p>\n
                                              \n
                                            1. Ustawi\u0107 \u015bcie\u017cki pliku zawieraj\u0105cego certyfikat u\u017cytkownika oraz has\u0142a do otwarcia tego pliku.<\/li>\n
                                            2. Ustawi\u0107 \u015bcie\u017cki pliku zawieraj\u0105cego certyfikat serwera. Mo\u017cna to zrobi\u0107 poprzez ustawienia odpowiednich w\u0142a\u015bciwo\u015bci (properties).<\/li>\n<\/ol>\n
                                              Przyk\u0142ad<\/div>
                                              <\/p>\n
                                              System.setProperty(\"javax.net.ssl.keyStore\", userCertificate);\r\nSystem.setProperty(\"javax.net.ssl.keyStorePassword\",password);\r\nSystem.setProperty(\"javax.net.ssl.trustStore\", serverCertificate); \r\n<\/pre>\n
                                              <\/div><\/section>\n
                                              3. Utworzy\u0107 obiekt locator i wykona\u0107 zapytania dla obiektu service.<\/p>\n
                                              ExportLocator loc= new ExportLocator();\r\nURL url= new URL(\u201chttps:\/\/<server>:<port>\/webservices\/<service>? oltp=<oltp>;filter=<filter>\u201c);\r\nservice = loc.getExport( url );<\/pre>\n
                                              4. Wygenerowa\u0107 obiekt request i ustawi\u0107 parametry.<\/p>\n
                                              ExportRequest request= new ExportRequest();\r\nrequest.setSearchName(\"com.cisag.app.general.obj.Title\");\r\n\/\/ ustawienie innych parametr\u00f3w \u2026\r\n<\/pre>\n
                                              5. Wywo\u0142a\u0107 us\u0142ug\u0119 sieciow\u0105:<\/p>\n
                                              ExportResponse response= service.export(request);<\/pre>\n
                                              6. Przeanalizowa\u0107 zwracane dane:<\/p>\n
                                              ExportResult result = response.getResult();\r\nif (result != null) {\r\nTitle[] instances = result.getExportData();\r\n}<\/pre>\n
                                              Wymagane biblioteki<\/h4>\n
                                              W celu uruchomienia klienta Java wymagane s\u0105 nast\u0119puj\u0105ce biblioteki:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
                                              Biblioteka<\/td>\nWersja (najni\u017csza mo\u017cliwa)<\/td>\n<\/tr>\n<\/thead>\n
                                              axis.jar<\/td>\n1.3<\/td>\n<\/tr>\n
                                              saaj.jar<\/td>\n1.2<\/td>\n<\/tr>\n
                                              jaxrpc.jar<\/td>\n1.1<\/td>\n<\/tr>\n
                                              commons-logging.jar<\/td>\n1.0.4<\/td>\n<\/tr>\n
                                              commons-discovery.jar<\/td>\n0.2-dev<\/td>\n<\/tr>\n
                                              wsdl4j.jar<\/td>\n1.5.1<\/td>\n<\/tr>\n
                                              log4j.jar
                                              \n(w Comarch ERP Enterprise: log4j-core.jar)<\/td>\n                                              		1.2.8<\/td>\n<\/tr>\n
                                              activation.jar<\/td>\n1.0.2<\/td>\n<\/tr>\n
                                              mail.jar<\/td>\n1.3<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                              Biblioteki mo\u017cna pobra\u0107 ze strony projektu Apache.<\/p>\n
                                              Zapytanie URI dla us\u0142ug sieciowych<\/h4>\n
                                              Aby uruchomi\u0107 us\u0142ugi sieciowe, nale\u017cy wywo\u0142a\u0107 odpowiedni identyfikator URI specyficzny dla danej us\u0142ugi sieciowej.<\/p>\n
                                                \n
                                              • CallApplication
                                                \nhttps:\/\/<server>:<port>\/webservices\/CallApplication?oltp=<oltp><\/li>\n
                                              • Export
                                                \nhttps:\/\/<server>:<port>\/webservices\/Export?oltp=<oltp>;filter=<filter>;oltpMode=<mode><\/li>\n
                                              • Import
                                                \nhttps:\/\/<server>:<port>\/webservices\/Import?oltp=<oltp>;filter=<filter>;oltpMode=<mode><\/li>\n
                                              • Search
                                                \nhttps:\/\/<server>:<port>\/webservices\/Search?oltp=<oltp><\/li>\n<\/ul>\n
                                                Dost\u0119pne parametry:<\/p>\n
                                                  \n
                                                • server – adres serwera aplikacji systemu ERP<\/li>\n
                                                • port – port serwera aplikacji systemu ERP<\/li>\n
                                                • oltp – identyfikator bazy danych OLPT, na kt\u00f3rej loguje si\u0119 us\u0142uga sieciowa, w celu uzyskania wyniku zapytania<\/li>\n
                                                • filter – identyfikator filtra dost\u0119pnego w podanej bazie danych OLTP, kt\u00f3ry okre\u015bla atrybuty jednostki biznesowej i inne ustawienia, np. format czasu\/ Ten parametr jest wymagany tylko dla us\u0142ug sieciowych Import<\/em> i Export<\/em>.<\/li>\n
                                                • oltpMode – tryb OLPT. Okre\u015bla, czy nazwa bazy danych OLTP powinna by\u0107 zawarta w obszarze nazw us\u0142ugi sieciowej. Dost\u0119pne warto\u015bci:\n