Opis adapterów usługi WWW

Sposób działania systemu został opisany szczegółowo w poniższych tematach.

Importowanie dokumentu WSDL

Pierwszą czynnością wykonywaną w ramach konfiguracji adaptera usługi WWW jest wybór dokumentu WDSL (Web Services Description Language) używanego do definiowania interfejsu. Dokumenty są udostępniane przez system zewnętrzny. Aby w produkcie podstawowym zaimportować dokument WSDL, należy wykonać następujące czynności.

  • Należy włączyć tryb wprowadzania, przejść do strony Adapter usługi WWW i wybrać właściwy podstawowy obiekt biznesowy.
  • Należy wprowadzić sensowną nazwę usługi WWW i właściwe opisy.
  • Należy podać adres URL żądanego dokumentu WSDL.
  • Należy nacisnąć przycisk Importowanie, aby pobrać szczegóły dokumentu WSDL. System przeprowadzi następnie analizę składniową szczegółów WSDL i wypełni wartościami zdefiniowanymi w dokumencie WSDL pola "Nazwa usługi WSDL", "Źródło WSDL", "Port WSDL", "Adres URL" oraz listę operacji (metod).
  • Na podstawie wymogów biznesowych dotyczących wywoływania tej usługi WWW należy określić, które operacje powinny być aktywne. Operacje aktywne to te operacje, które we wdrożeniu będą wywoływane z systemu. Dla tych operacji należy wygenerować odpowiednie obszary danych żądania i odpowiedzi. Więcej informacji na ten temat można znaleźć w następnej sekcji.
  • Należy określić właściwą wartość opcji "Typ zabezpieczeń", aby skonfigurować typ zabezpieczeń stosowanych podczas wywoływania tej usługi WWW.
  • Należy nacisnąć przycisk "Zapisz".

Zostanie utworzony rekord adaptera usługi WWW ze stanem oczekujące. Następnie należy wygenerować obszary danych żądania i odpowiedzi dla wszystkich operacji, które oznaczono jako aktywne.

Generowanie obszarów danych żądania i odpowiedzi

Do prawidłowego działania adaptera usługi WWW wymagane jest wygenerowanie dwóch obszarów danych dla każdej operacji oznaczonej jako aktywna. Są to obszary danych żądania i odpowiedzi, które odpowiadają komunikatom żądania i odpowiedzi XML.

Aby w produkcie podstawowym wygenerować te obszary danych, należy:

  • Zgodnie z procedurą w powyższej sekcji Importowanie dokumentu WSDL, w konfiguracji adaptera usługi WWW zostanie utworzona lista operacji wymienionych w dokumencie WSDL. Osoba wdrażająca powinna wskazać, które z tych operacji mają być aktywne.
  • Po zapisaniu rekordu adaptera usług WWW ze stanem oczekujące zostanie wyświetlona lista wszystkich aktywnych operacji. Obok każdej z nich będzie wyświetlany przycisk Generowanie.
  • Po naciśnięciu przycisku Generowanie danej operacji zostanie wyświetlone okno dialogowe, w którym można zdefiniować nazwy nowych obszarów danych żądania i odpowiedzi. Należy nacisnąć przycisk Zapisywanie, aby wygenerować obszary danych.

Wygenerowane obszary danych zapewniają interfejs API, którego osoba wdrażająca może użyć do wdrożenia wywołania usługi WWW w odpowiednim algorytmie lub usłudze systemu. W obszarach danych znajdują się używane przez osobę wdrażającą odwzorowania elementów na kod służący do wywoływania usług WWW oraz definicje języka WSDL.

Aby ułatwić generowanie obszarów danych żądania i odpowiedzi, podstawowy produkt jest wyposażony w specjalną usługę biznesową. Jest ona wywoływana w celu utworzenia odpowiednich odwzorowań. Usługa biznesowa jest zdefiniowana jako opcja obiektu biznesowego adaptera usługi WWW. Umożliwia to udostępnienie we wdrożeniu niestandardowej usługi biznesowej, która będzie używana do rozszerzenia odwzorowań żądania i odpowiedzi w razie potrzeby.

Uwaga:

Zostaną wygenerowane obszary danych. Po utworzeniu obszarów danych możliwe jest ich edytowanie i modyfikowanie. Osoba wdrażająca może zmieniać nazwy elementów lub usuwać zbędne elementy w razie potrzeby. Wygenerowane obszary danych należy zmieniać ręcznie tylko, jeśli jest to absolutnie konieczne. Wynika to z faktu, że system nie może sprawdzić poprawności ręcznie wprowadzonych zmian. Problemy w obszarach danych zostaną więc wykryte dopiero po uruchomieniu.

Aktywowanie adapterów usługi WWW

Obiekty biznesowe adapterów usługi WWW dostępne w pakiecie podstawowym mają uproszczony cykl życia składający się ze statusów oczekujące i aktywne. Adapter usługi WWW i jego obszary danych należy konfigurować, gdy obiekt biznesowy ma status oczekujące. Po zakończeniu konfiguracji można go aktywować, aby wdrożyć adapter we właściwej funkcji systemu.

Wywoływanie usług WWW

Do wywoływania usług WWW za pomocą adapterów usługi WWW służy usługa biznesowa Program wysyłania usługi WWW (F1-InvokeWebService). Przed wywołaniem usługi biznesowej program wywołujący musi pobrać wszystkie informacje niezbędne do poprawnego wypełnienia żądania wysyłanego w ramach wywołania usługi WWW.

Uwaga:

Więcej informacji można znaleźć w szczegółowym opisie tej usługi biznesowej.

Ograniczenia

Poniżej przedstawiono najważniejsze ograniczenia powiązane z typami usług WWW, które są obsługiwane przez system:

  • W jednym dokumencie WSDL mogą znajdować się definicje dotyczące kilku usług WWW. Obecnie system pozwala na opisanie tylko jednego portu lub usługi za pomocą danego dokumentu WSDL.
  • W dokumencie WSDL można zdefiniować wiele wzorców komunikatów. System obecnie obsługuje tylko żądania i odpowiedzi.