{"id":7608,"date":"2023-12-21T12:02:42","date_gmt":"2023-12-21T11:02:42","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&p=7608"},"modified":"2024-11-08T09:12:00","modified_gmt":"2024-11-08T08:12:00","slug":"zdalne-interfejsy-bis","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/zdalne-interfejsy-bis\/","title":{"rendered":"Zdalne interfejsy BIS"},"content":{"rendered":"

Us\u0142uga integracji biznesowej (BIS) jest mo\u017cliwa do uruchomienia zdalnie, obejmuje ona funkcje importu i eksportu danych BIS oraz funkcj\u0119 wyszukiwania, kt\u00f3re razem s\u0105 okre\u015blane jako zdalny BIS. Import i eksport danych s\u0105 funkcjonalnie podobne do BIS opartego na plikach. Funkcja wyszukiwania dzia\u0142a analogicznie jak pomoc wyszukiwania warto\u015bci oraz wyszukiwanie lokalizatora w graficznym interfejsie u\u017cytkownika systemu ERP. Dane u\u017cytkownika przesy\u0142ane s\u0105 bezpo\u015brednio przez sie\u0107, a nie, jak w przypadku plikowego BIS, przez Repozytorium Wiedzy (Knowledge Store).<\/p>\n

Od wersji 4 Comarch ERP Enterprise, zdalne interfejsy BIS s\u0105 dost\u0119pne za po\u015brednictwem COBRA jako interfejs komunikacyjny. Aby korzysta\u0107 ze zdalnych interfejs\u00f3w BIS za po\u015brednictwem CORBA wymagana jest r\u00f3wnie\u017c znajomo\u015b\u0107 interfejsu CORBA systemu Comarch ERP Enterprise.<\/p>\n

Od wersji 4.2 Comarch ERP Enterprise, zdalne interfejsy BIS dost\u0119pne s\u0105 r\u00f3wnie\u017c za po\u015brednictwem us\u0142ug sieciowych (web services) jako interfejs komunikacyjny. Aby korzysta\u0107 ze zdalnych interfejs\u00f3w BIS za po\u015brednictwem us\u0142ug sieciowych wymagana jest r\u00f3wnie\u017c znajomo\u015b\u0107 interfejsu us\u0142ug sieciowych systemu Comarch ERP Enterprise.<\/p>\n

Funkcjonalno\u015b\u0107 zdalnych interfejs\u00f3w BIS realizowana jest w systemie ERP za po\u015brednictwem aplikacji dzia\u0142aj\u0105cych w tle, kt\u00f3re s\u0105 wywo\u0142ywane zdalnie. Oznacza to, \u017ce s\u0105 niezale\u017cne od konkretnego interfejsu komunikacyjnego.<\/p>\n

Funkcjonalno\u015b\u0107 oraz formaty danych<\/h3>\n

Format danych importu, eksportu i wynik\u00f3w wyszukiwania to XML. Do kodowania wykorzystywane jest UTF-8. W zwi\u0105zku z tym, aby korzysta\u0107 z danych i generowa\u0107 dokumenty XML klient musi zwykle stosowa\u0107 parser XML.<\/p>\n

W przypadku CORBA, przesy\u0142anie danych odbywa si\u0119 w blokach, z kt\u00f3rych ka\u017cdy wymaga osobnego wywo\u0142ania aplikacji dzia\u0142aj\u0105cej w tle. W przypadku importu i eksportu bloki s\u0105 \u0142\u0105czone w celu utworzenia kompletnego dokumentu XML. Importowane i eksportowane dokumenty XML mog\u0105 by\u0107 bardzo obszerne.\u00a0 Poniewa\u017c dane przesy\u0142ane podczas wywo\u0142ania przez CORBA musz\u0105 by\u0107 tymczasowo przechowywane w pami\u0119ci g\u0142\u00f3wnej serwera (a tak\u017ce klienta), dokumenty XML nie s\u0105 przesy\u0142ane w ca\u0142o\u015bci, ale w blokach.<\/p>\n

Je\u015bli do importu lub eksportu wykorzystywane s\u0105 us\u0142ugi sieciowe, dane s\u0105 przesy\u0142ane w jednym bloku, poniewa\u017c us\u0142ugi sieciowe wykorzystuj\u0105 protok\u00f3\u0142 bezstanowy, co uniemo\u017cliwia ich przesy\u0142anie w kilku blokach. W przypadku du\u017cej ilo\u015bci danych mo\u017ce to spowodowa\u0107 du\u017ce obci\u0105\u017cenie serwera oraz znaczne spadki wydajno\u015bci. Interfejs us\u0142ug sieciowych nie nadaje si\u0119 zatem do przesy\u0142ania du\u017cych ilo\u015bci danych.<\/p>\n

Podczas importu i eksportu format dokumentu XML jest taki sam, jak w przypadku plikowego BIS i odpowiada schematowi XML, kt\u00f3ry zapewnia BIS. Inne formaty danych, np. CSV, nie s\u0105 dost\u0119pne za po\u015brednictwem zdalnego BIS. Zdalny BIS nie mo\u017cna przesy\u0142a\u0107 atrybut\u00f3w typu BLOB.<\/p>\n

W funkcji wyszukiwania z CORBA wyniki wyszukiwania przesy\u0142ane s\u0105 strona po stronie, tj. ka\u017cda strona jest oddzielnym blokiem, zawieraj\u0105cym okre\u015blon\u0105 liczb\u0119 kompletnych rekord\u00f3w danych. Ka\u017cda strona wyniku wyszukiwania jest oddzielnym dokumentem XML, st\u0105d te\u017c mo\u017ce by\u0107 parsowana indywidualnie, w przeciwie\u0144stwie do wyniku procesu eksportu. Dok\u0142adny format zwracanych wynik\u00f3w wyszukiwania zosta\u0142 opisany w rozdziale Format danych dla wynik\u00f3w wyszukiwania<\/em>.<\/p>\n

W przypadku us\u0142ug sieciowych, wyniki wyszukiwania nie s\u0105 przesy\u0142ane w blokach, poniewa\u017c u\u017cywany protok\u00f3\u0142 jest bezstanowy.<\/p>\n

Funkcja wyszukiwania oferuje r\u00f3wnie\u017c sprawdzanie istnienia, kt\u00f3ry zwraca tylko pojedynczy rekord danych. Interfejs ten ma umo\u017cliwi\u0107 wykonanie prostego zapytania, czy istnieje co najmniej jeden rekord danych pasuj\u0105cy do wyszukiwania. Je\u015bli rekord danych istnieje, jego atrybuty nie s\u0105 zwracane jako dokument XML, ale jako warto\u015bci na li\u015bcie parametr\u00f3w. U\u0142atwia to realizacj\u0119 zdalnych weryfikacji kluczy obcych.<\/p>\n

Cechy wsp\u00f3lne<\/h3>\n

Opis interfejs\u00f3w CORBA oraz us\u0142ug sieciowych dost\u0119pny jest w powi\u0105zanych artyku\u0142ach Interfejs CORBA<\/em> i Interfejs us\u0142ug sieciowych<\/em>. W niniejszym rozdziale opisano cz\u0119\u015bci interfejs\u00f3w, kt\u00f3re s\u0105 wsp\u00f3lne dla obu kana\u0142\u00f3w komunikacji.<\/p>\n

Format danych dla wynik\u00f3w wyszukiwania<\/h4>\n

Poni\u017cszy przyk\u0142ad opisuje format dokument\u00f3w XML reprezentuj\u0105cych strony wynik\u00f3w zdalnego interfejsu wyszukiwania:<\/p>\n

<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<semiramis>\n\n\u00a0 <SearchResultRow>\n\n\u00a0\u00a0\u00a0 <guid>004076BF35F71E1080568464962B0000<\/guid>\n\n\u00a0\u00a0\u00a0 <name>Dr.<\/name>\n\n\u00a0\u00a0\u00a0 <deleteTime>\n\n\u00a0\u00a0\u00a0\u00a0\u00a0 <date>16\/12\/2003<\/date>\n\n\u00a0\u00a0\u00a0\u00a0\u00a0 <timeOfDay>17:50:58.304<\/timeOfDay>\n\n\u00a0\u00a0\u00a0 <\/deleteTime>\n\n\u00a0 <\/SearchResultRow>\n\n<\/semiramis><\/pre>\n
Przyk\u0142ad zawiera stron\u0119 wynik\u00f3w z jednym wierszem. Wiersz ten jest elementem SearchResultRow.\u00a0 Kolejne wiersze wynik\u00f3w nast\u0119puj\u0105 bezpo\u015brednio po tym elemencie.<\/p>\n
Elementy poni\u017cej SearchResultRow to kolumny wynik\u00f3w. Nazwy element\u00f3w s\u0105 nazwami atrybut\u00f3w z wyszukiwania OQL (guid, name); warto\u015bci element\u00f3w s\u0105 warto\u015bciami atrybut\u00f3w. Format warto\u015bci atrybutu zale\u017cy od typu danych atrybutu i jest opisany w nast\u0119pnym rozdziale.<\/p>\n
Atrybuty niekt\u00f3rych typ\u00f3w danych prezentowane s\u0105 w spos\u00f3b z\u0142o\u017cony, to znaczy, ich element XML w dokumencie XML sk\u0142ada si\u0119 z jednego lub wi\u0119cej element\u00f3w podrz\u0119dnych.\u00a0 Ilustruje to opis w nast\u0119pnym rozdziale, gdzie warto\u015b\u0107 zwracana typu danych sk\u0142ada si\u0119 z kolumn.\u00a0 Przyk\u0142adem w powy\u017cszym dokumencie XML jest atrybut deleteTime.<\/p>\n
To, kt\u00f3re kolumny wynik\u00f3w wy\u015bwietlane s\u0105 w ka\u017cdym wierszu, zale\u017cy od u\u017cytego wyszukiwania OQL. Zaleca si\u0119 utworzenie okre\u015blonego wyszukiwania OQL dla wyszukiwania, kt\u00f3re ma by\u0107 wywo\u0142ywane zdalnie.<\/p>\n
Typy danych w wyszukiwaniu<\/h4>\n
Wymienione poni\u017cej typy danych s\u0105 obs\u0142ugiwane jako parametry ograniczaj\u0105ce i zwracaj\u0105ce. W obu przypadkach mo\u017cna okre\u015bli\u0107, czy dane powinny by\u0107 wprowadzane w formacie specyficznym dla u\u017cytkownika czy technicznym. Dla formatu specyficznego dla u\u017cytkownika podano przyk\u0142adowe ci\u0105gi znak\u00f3w. Konkretne ci\u0105gi znak\u00f3w zale\u017c\u0105 od ustawie\u0144 u\u017cytkownika. Format techniczny jest zawsze niezale\u017cny od ustawie\u0144 u\u017cytkownika.<\/p>\n
W przypadku z\u0142o\u017conych typ\u00f3w danych, kt\u00f3re s\u0105 wymienione jako „nieobs\u0142ugiwane”, zawsze istnieje mo\u017cliwo\u015b\u0107 zdefiniowania wyszukiwania w taki spos\u00f3b, aby poszczeg\u00f3lne atrybuty (np. kwota waluty obcej) mog\u0142y by\u0107 u\u017cyte jako parametry ograniczaj\u0105ce lub zwracaj\u0105ce. Jedynie bezpo\u015brednie u\u017cycie typu z\u0142o\u017conego mo\u017ce nie by\u0107 obs\u0142ugiwane.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Typ danych<\/strong><\/td>\nParametr ograniczaj\u0105cy<\/strong><\/td>\nParametr zwracaj\u0105cy<\/strong><\/td>\n<\/tr>\n
Specyficzny dla u\u017cytkownika<\/strong><\/td>\nTechniczny<\/strong><\/td>\nSpecyficzny dla u\u017cytkownika<\/strong><\/td>\nTechniczny<\/strong><\/td>\n<\/tr>\n<\/thead>\n
Boolean<\/strong><\/td>\n\u201cprawda\u201d, \u201cfa\u0142sz\u201d<\/td>\n\u201ctrue\u201d, \u201cfalse\u201d, \u201c\u201d<\/td>\n\u201cprawda\u201d, \u201cfa\u0142sz\u201d<\/td>\n\u201ctrue\u201d, \u201cfalse\u201d<\/td>\n<\/tr>\n
ValueSet<\/strong><\/td>\njak techniczny<\/td>\nposortowane \u201c1, 2, 3\u201d<\/td>\ndwie kolumny: \u201c1\u201d, \u201ctext\u201d<\/td>\nDwie kolumny: \u201c1\u201d, \u201cWarto\u015b\u0107 sta\u0142a\u201d<\/td>\n<\/tr>\n
Guid<\/strong><\/td>\nhexadecimal<\/td>\nhexadecimal<\/td>\nhexadecimal<\/td>\nhexadecimal<\/td>\n<\/tr>\n
byte<\/strong><\/td>\n\u201c100\u201d<\/td>\n\u201c100\u201d<\/td>\n\u201c100\u201d<\/td>\n\u201c100\u201d<\/td>\n<\/tr>\n
short<\/strong><\/td>\n\u201c1.000\u201d<\/td>\n1000<\/td>\n\u201c1.000\u201d<\/td>\n\u201c1000\u201d<\/td>\n<\/tr>\n
int<\/strong><\/td>\njak short<\/td>\njak short<\/td>\njak short<\/td>\njak short<\/td>\n<\/tr>\n
long<\/strong><\/td>\njak short<\/td>\njak short<\/td>\njak short<\/td>\njak short<\/td>\n<\/tr>\n
decimal<\/strong><\/td>\n\u201c1.000,1\u201d<\/td>\n\u201c1000,1\u201d<\/td>\n\u201c1.000,1\u201d<\/td>\n\u201c1000,1\u201d<\/td>\n<\/tr>\n
string<\/strong><\/td>\n\u201ctext\u201d<\/td>\n\u201ctext\u201d<\/td>\n\u201ctext\u201d<\/td>\n\u201ctext\u201d<\/td>\n<\/tr>\n
char<\/strong><\/td>\njak string<\/td>\njak string<\/td>\njak string<\/td>\njak string<\/td>\n<\/tr>\n
CisAttributeTimeStamp<\/strong><\/td>\n\u201cdzisiaj\u201d, \u201c+1\u201d, \u201c28\/12\/2003 17:15:23\u201d<\/td>\n\u201c[@today]\u201d, \u201c+1[D]\u201d, \u201c28#12#2003 17#15#23#000\u201d<\/td>\ntrzy kolumny:\u201c28\/12\/2003\u201d<\/p>\n
\u201c17:15:23\u201d<\/p>\n
\u201cGMT\u201d<\/td>\n
dwie kolumny: milisekundy od 01\/01\/1970 GMT oraz identyfikator strefy czasowej<\/td>\n<\/tr>\n
CisObjectTimeStamp<\/strong><\/td>\njak CisAttributeTimeStamp<\/td>\njak CisAttributeTimeStamp<\/td>\njak CisAttributeTimeStamp<\/td>\njak CisAttributeTimeStamp<\/td>\n<\/tr>\n
CisAttributeDate<\/strong><\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\n<\/tr>\n
CisObjectDate<\/strong><\/td>\njak CisAttributeDate bez informacji o czasie<\/td>\njak CisAttributeDate bez informacji o czasie<\/td>\njak CisAttributeDate<\/td>\njak CisAttributeDate<\/td>\n<\/tr>\n
TimeStamp<\/strong><\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\njak CisAttributeTimeStamp bez informacji o czasie<\/td>\n<\/tr>\n
Domestic <\/strong>
\nAmount<\/strong><\/td>\n		nie obs\u0142ugiwany<\/td>\nnie obs\u0142ugiwany<\/td>\ntrzy na dwie kolumny:
\n\u201c1.233,44\u201d \u201cEUR\u201d<\/td>\n		nie obs\u0142ugiwany<\/td>\n<\/tr>\n
Foreign <\/strong>
\nAmount<\/strong><\/td>\n		nie obs\u0142ugiwany<\/td>\nnie obs\u0142ugiwany<\/td>\ndwie kolumny: \u201c1.123,44\u201d \u201cEUR\u201d<\/td>\nnie obs\u0142ugiwany<\/td>\n<\/tr>\n
Quantity<\/strong><\/td>\nnie obs\u0142ugiwany<\/td>\nnie obs\u0142ugiwany<\/td>\ndwie kolumny: \u201c1.234,44\u201d \u201ccm\u201d<\/td>\nnie obs\u0142ugiwany<\/td>\n<\/tr>\n
Duration<\/strong><\/td>\njak Quantity<\/td>\njak Quantity<\/td>\njak Quantity<\/td>\njak Quantity<\/td>\n<\/tr>\n
PointInTime<\/strong><\/td>\njak TimeStamp<\/td>\njak TimeStamp<\/td>\njedna kolumna: zawarto\u015b\u0107 atrybutu warto\u015bciowego PointInTime, np. \u201c28\/12\/2003\u201d<\/td>\njedna kolumna: zawarto\u015b\u0107 atrybutu warto\u015bciowego PointInTime, np. \u201c28#12#2003\u201d<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Uwaga<\/div>
 W przypadku liczb i ci\u0105g\u00f3w znak\u00f3w mo\u017cliwe jest okre\u015blenie wielu warto\u015bci i u\u017cycie zakres\u00f3w. W tym celu u\u017cywana jest sk\u0142adnia ci\u0105gu wyboru opisana w artykule Programowanie interfejs\u00f3w do wymiany danych<\/em> w rozdziale Format ci\u0105g\u00f3w wyboru<\/em>. <\/div><\/section>\n","protected":false},"author":18,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-7608","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-zewnetrzne-interfejsy"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/7608","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=7608"}],"version-history":[{"count":4,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/7608\/revisions"}],"predecessor-version":[{"id":20090,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/7608\/revisions\/20090"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=7608"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}