www.tres.pl - Baza wiedzy Trawers ERP - Spis treści
SOA Przykłady i ćwiczenia 1. Opis ogólny 2. Polecenia pobrania i wpisania 2.1 Pobranie z bazy danych (OutBound) 2.2 Wpisanie do bazy danych (OutBound) 3. Programy zewnętrzne Przeglądarka Firefox z dodatkiem SOA Client Programy w Python i PHP 4. Jak testować programy zewnętrzne via SOA ? 5. Tematy powiązane 1. Opis ogólny Wbudowane przykłady wywołań funkcji SOA: [AD_PSOA3] Funkcje SOA najłatwiej można poznać na przykładach. Przykłady zapytań i odpowiedzi (pliki XML) znajdują się w programie: AD > Trawers > Usługi SOA > SOA Przykłady usług (ćwiczenia) [AD_PSOA3] Przykłady wywołań przygotowano dla danych branżowych: [MT] Meble Tapicerowane Sugerujemy utworzyć firmę przykładową, wgrać dane branżowe [MT] i wykonywać funkcje SOA wbudowane do programu. Dane branżowe Profile firm Wywołania funkcji można zmieniać, dostosowywać do własnych potrzeb. Przykład zapytania Ekran zawiera treść zapytania (polecenia), tj. plik xml: o-- Polecenie SOA ----------------------------------------------------------[X]o |<?xml version="1.0" encoding="UTF-8"?> | |<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" xmlns:fn="| | <soap:Header/> | | <soap:Body> | | <productGroups/> | | </soap:Body> | |</soap:Envelope> | o------------------------------------------------------------------------------o | F8-wykonaj | o------------------------ ----o----- ------------------------------------------o | Polecenie: Wykonaj Zapytanie (polecenie) wysyła się klawiszem F8-wykonaj | W odpowiedzi otrzymuje sie plik xml | | v Odpowiedź SOA o-- Odpowiedź SOA ----------------------------------------------------------[X]o | <?xml version="1.0" encoding="UTF-8"?> | | <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | | <soap:Header/> | | <soap:Body> | | <productGroups> | | <productGroup> | | <key>01</key> | | <name>Części do montażu</name> | | <type>REGULAR</type> | | <parent/> | | .... | o------------------------------------------------------------------------------o Przed wykonaniem: F8-wykonaj, program sprawdza poprawność składni tekstu XML Błąd sygnalizuje komunikatem, np. o--------------------------------------------------------[X]o | Błąd składni XML: [E11] Niedomknięty węzeł | | <soap:Body> | | | o-----------------------------------------------------------o OutBound (Out) InBound (In) Wśród przykładów są funkcje: * OutBound: pobieranie danych z programu Trawers * InBound: Wpisywanie danych do programu Trawers (tylko w demo) Funkcje wpisujące (InBound) można wywoływać tylko w wersji Demo programu Trawers. Dlatego tylko w wersji demo, aby program nie zapisał, przykładowych, ćwiczeniowych danych do bazy danych użytkowych (produkcyjnych). o---------------------------------------------------o | 1 Polecenia pobrania z bazy danych Out > | | 2 Polecenia zapisania do bazy danych (1) In > | | 2 Polecenia zapisania do bazy danych (2) In > | o------------------------------------------F10-info-o o----------------------------------------------o | 1 Grupy indeksów Out | | 2 Logowanie klienta (uwierzytelnienie) Out | | 3 Zamówienia sprzedaży Out | | 4 Zamówienie sprzedaży wg numeru Out | | 5 Odbiorca wg symbolu Out | | 6 Indeks wg symbolu Out | | 7 Szukanie indeksu KIM Out | | 9 ... Out | | d Odczyt z bazy danych Out | o----------------------------------------------o Program wykonujący polecenia emuluje (udaje) pracę serwera SOA. Ułatwia zapoznanie się z mechanizmem usług SOA. Przykłady poleceń przygotowane zostały dla danych branżowych: [MT] Meble Tapicerowane Np. program pyta o kartę odbiorcy o symbolu [000001] i materiały GRANULAT, KARTON01 i SRUBY-X01 TableGet Prosimy zwrócić uwagę na funkcję: Odczyt z bazy danych (TableGet), która pobiera wskazane, dowolne informacje z bazy danych Trawersa wg definicji opisanych w słowniku danych. Baza danych. Słownik. Opis 2. Polecenia pobrania i wpisania 2.1 Pobranie z bazy danych (OutBound) Grupy indeksów Zamówienie sprzedaży wg numeru Odbiorca wg symbolu Indeks wg symbolu Stany indeksu w magazynach Przykłady wywołań funkcji SOA: * Pobranie (export) danych z kartoteki odbiorców programu Trawers [Customers] Wymiana danych SOA * Generowanie plików raportów wymaganych przez system Asseco EBI [EBI_MAG] [EBI_KLT] [...] Raportowanie do Asseco EBI 2.2 Wpisanie do bazy danych (InBound) Wykonanie operacji produkcyjnej Rozchód z magazynu Zamówienie sprzedaży Zamówienie zakupu Faktura sprzedaży Zamówienie sprzedaży EDI Nowy indeks KIM Nowy KID Faktura zakupu EDI Wpisanie faktury zakupu w formacie EDI [Document-Invoice] Potrzeba: Program zewnętrzny (skrypt) wywołuje proces AD_PSOA1 w Autorun i zapisuje kolejne faktury do zbioru dokumentów ZO Kroki: 1. Wywołać Trawers SOA w trybie Autorun (Command-Line): tr5w.exe --firma=HA --operator=AA --proces=AD_PSOA1 --input=plik_faktury_NNNNNN.xml --output=wynik_NNNNNN.xml 2. Jeżeli nie ma pliku: wynik_NNNNN.xml lub plik nie zawiera: <result>OK</result> i <erpKey>numer faktury Trawers</erpKey> to przerwać / przejść do następnego dokumentu 3. Przenieść plik do katalogu np. zozal mv plik_faktury_NNNNNN.xml ścieżka do trawers\...\zotres\zozal\faktury Jeżeli dostępna jest także faktura w formacie PDF, to także przenieść: mv plik_faktury_NNNNNN.pdf ścieżka do trawers\...\zotres\zozal\faktury Obraz faktury w PDF można przeglądać w powiązaniu z fakturą zakupu w ZO (przeglądanie pliku powiązanego z dokumentem - ale bez użycia tabeli załączników) Plik: wynik_NNNNNN.xml można usunąć lub zostawić. Jeżeli zostanie, to program nie pozwoli powtórnie zapisać tej faktury. Jak przeglądać fakturę PDF bez użycia tabeli załączników ? Wyświetlić odpowiednio przygotowany wzorzec faktury zakupu (znak: t85) przy pomocy urządzenie wydruku: Polecenie Opis jest tu: Wzorce Przykłady 3. Programy zewnętrzne Funkcje SOA programu Trawers można testować w programach zewnętrznych, np. dodatkach do przeglądarek internetowych. Przeglądarka Firefox z dodatkiem SOA Client * Uruchomić serwer Trawers SOA SOA Serwer internetowy * W przeglądarce Firefox zainstalować dodatek: SOA Client SOA Client, to jest program (client) do testowania usług sieciowych (Web Services). Pozwala zapoznać się z podstawowymi procesami usług sieciowych * Z menu podręcznego przeglądarki wybrać: SOA Client > Advanced Access i podać następuje wartości: URL: http://127.0.0.1:7000 <-- podać właściwy adres IP HTTP Request Method: POST HTTP Request Header: Content-Type: application/soap+xml Communication: async Raw Request Body: <?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> <soap:Header/> <soap:Body> <about/> </soap:Body> </soap:Envelope> * Wykonać polecenie przyciskiem: Submit * Program wykona funkcje SOA: About informacje o programie Programy w Python i PHP Opisane są proste aplikacje (programy) internetowe wykorzystujące funkcje SOA SOA Programy w Python i PHP 4. Jak testować programy zewnętrzne via SOA ? 1. Zainstalować program Trawers (Wersja Demo) Instalowanie programu Trawers 2. (opcja) Wgrać spersonalizowany plik: licencja.txt na miejsce pliku licencja.txt z wersją demonstracyjną Spersonalizowany plik: licencja.txt można otrzymać z firmy Tres 3. Podczas pierwszego uruchmienia wybrać dane przykładowe firmy: [MT] Meble Tapicerowane (dane demo) Hasło dla operatora AA: aa Dane branżowe. Profile firm 4. Sprawdzić (poznać) możliwości funkcjonalne SOA Wykonać funkcję: Trawers > Usługi SOA > SOA Przykłady usług (ćwiczenia) SOA Przykłady i ćwiczenia 5. Uruchomić Trawers jako serwer SOA HTTP Wykonać funkcję: Trawers > Usługi SOA > SOA Serwer internetowy (podać pusty adres IP i port 7000) W przeglądarce internetowej pod adresem 127.0.0.1:7000 zgłosi się strona powitalna SOA Serwer internetowy Więcej informacji: SOA Opis ogólny 5. Tematy powiązane SOA Architektura wymiany danych SOA Funkcje OutBound i InBound SOA SOA Serwer internetowy SOA Przykłady rozwiązań SOA Przykłady i ćwiczenia SOA Programy w Python i PHP Baza danych. Słownik. Opis Dane branżowe. Profile firm Słowa kluczowe #Admin-WymianaDanych #TrawersERP-Komponenty #TrawersERP-Środowisko #TrawersERP-Chmura #TrawersERP-SOA/API
www.tres.pl - Baza wiedzy Trawers ERP - Spis treści