Wdrażanie przychodzących usług internetowych SOAP

Po zdefiniowaniu przychodzącej usługi internetowej SOAP nie jest ona automatycznie dostępna dla klientów usług WWW w celu dostępu do systemu. Dostępność usługi WWW jest określana przez status wdrożenia i znacznik aktywności (o ustawionej wartości "Prawda"). Ostatnim krokiem jest wdrożenie przychodzących usług internetowych SOAP na serwerze aplikacji WWW Java EE. Ta faza wdrażania składa się z poniższych kroków, które są automatycznie wykonywane po zainicjowaniu wdrażania.

  • Generowanie plików usługi WWW i załączanie zasad.

  • Generowanie pliku WSDL z odpowiednimi adnotacjami i wartościami.

  • Generowanie i kompilowanie wymaganych fragmentów kodu Java do wdrożenia w usłudze WWW na serwerze aplikacji WWW Java EE.

  • Utworzenie usług WWW w prawidłowym pliku archiwum aplikacji WWW (WAR).

  • Opcjonalne wdrożenie nowo utworzonego pliku WAR usług WWW na serwerze aplikacji WWW Java EE. W przypadku grupowych wdrożeń ten krok można również w razie potrzeby wykonać ręcznie.

Istnieją dwie metody wdrażania przychodzących usług internetowych SOAP:

  • Wdrożenie z poziomu wiersza poleceń przy użyciu polecenia iwsdeploy[.sh], wskazanego w publikacji Server Administration Guide. Ta metoda jest zalecana w przypadku natywnych instalacji i wdrożeń w środowisku produkcyjnym.

  • Wdrożenie z poziomu portalu "Wdrożenie przychodzącej usługi WWW". Ta metoda jest obsługiwana tylko w środowiskach rozwojowych (innych niż produkcyjne).

Przychodząca usługa WWW - portal wdrażania

Aby użyć portalu online "Wdrożenie przychodzącej usługi internetowej", należy wybrać opcje Administrator > Integracja > Wdrożenie przychodzącej usługi internetowej.

W poniższych sekcjach opisano bazowe strefy dostępne w tym portalu.

Wdrażanie przychodzących usług internetowych SOAP

Strefa wdrażania przychodzącej usługi internetowych SOAP zawiera informacje o ostatnim wdrożeniu. Jeśli region jest rozwojowy (inny niż produkcyjny), można użyć przycisku Wdrażanie, aby wdrożyć lub ponownie wdrożyć przychodzące usługi WWW. Zostaną wdrożone wszystkie przychodzące usługi WWW, dla których przełącznik aktywności ma wartość "Tak". Wdrożenie wszystkich usług, dla których przełącznik aktywności ma wartość "Nie", zostanie wycofane.

Uwaga: Podczas wdrażania przychodzącej usługi internetowej SOAP jest rejestrowana wartość jej pola wersji usługi. Zastosowanie niektórych zmian konfiguracji wymaga ponownego wdrożenia. W przypadku wystąpienia jednej z poniższych zmian, wartość wersji usługi przychodzącej usługi WWW zostanie zwiększona. Spowoduje to, że status wdrożenia będzie miał wartość Wymagane wdrożenie.

  • Zmiana wartości przełącznika aktywności

  • Dodanie lub usunięcie adnotacji

  • Dodanie lub usunięcie operacji

  • Zmiana nazwy operacji, typu schematu/nazwy schematu, schematu żądania lub odpowiedzi, XSL żądania lub odpowiedzi na potrzeby operacji

Uwaga: Dodatkowo, jeśli wdrożenie obsługuje usługi XAI wdrażane za pośrednictwem przychodzącej usługi WWW, w razie potrzeby zostaną wdrożone odpowiednie przychodzące usługi XAI lub zostanie cofnięte ich wdrożenie.

Status wdrożenia

W strefie "Status wdrożenia" jest wyświetlana lista przychodzących usług internetowych SOAP w produkcie wraz z ich statusem wdrożenia.

Status wdrożenia jest określany przez porównanie wartości wewnętrznego pola wersji usługi każdej przychodzącej usługi WWW z wartością zarejestrowaną podczas wdrożenia.

  • Wdrożono. Służy do określania, że przychodząca usługa WWW została wdrożona i nie wykryto zmian w jej konfiguracji.

  • Wymagane wdrożenie. Służy do określania, że przychodząca usługa WWW nigdy została wdrożona albo została wdrożona, ale od tego czasu wykryto zmiany konfiguracji wymagające ponownego wdrożenia.

  • Cofnięto wdrożenie. Służy do określania, że przychodząca usługa WWW jest oznaczona jako nieaktywna i nie jest obecnie wdrożona.

  • Wymagane cofnięcie wdrożenia. Służy do określania, że przychodząca usługa WWW jest oznaczona jako nieaktywna, ale jest obecnie wdrożona.

Jeśli przychodzące usługi WWW zostały wdrożone, w kolumnie Widok będzie dostępne łącze WSDL umożliwiające otwarcie osobnego okna pozwalającego na przeglądanie definicji WSDL.

Uwaga: W przypadku instalacji w chmurze obsługiwane jest definiowanie identyfikatora URI WSDL za pośrednictwem wartości zastąpienia zdefiniowanej dla identyfikatora URI tokenu: @F1_​BASE_​IWS_​URI@. Wartość ta będzie wykorzystywana zgodnie z funkcją opisaną w sekcji Zastąpienie identyfikatora URI. Gdy nie zdefiniowano żadnej wartości, używany jest domyślny adres URL, czyli adres URL odpowiedni dla instalacji lokalnej.

Przycisk rozsyłania widniejący obok każdej z przychodzących usług WWW widocznych w tej strefie umożliwia wyświetlanie szczegółów rekordu przychodzącej usługi WWW. Powoduje to wyświetlenie strefy Przychodząca usługa WWW. Jest to ta sama strefa, która pojawia się w portalu obsługi Przychodząca usługa WWW.

Status wdrożenia usługi przychodzącej XAI

Strefa Status wdrożenia przychodzącej usługi XAI jest widoczna tylko, jeśli opcja konfiguracji cechy Obsługa usług XAI za pośrednictwem przychodzącej usługi WWW jest ustawiona na typ cechy Komunikaty zewnętrzne lub jeśli system wykryje, że zostały wdrożone przychodzące usługi XAI. (Drugi warunek jest sprawdzany w przypadku, gdy we wdrożeniu są wdrożone przychodzące usługi XAI, a mimo to zostaje podjęta decyzja o zaprzestaniu korzystania z tej funkcji. Po zmianie opcji konfiguracji cechy na fałsz wymagane jest jeszcze jedno wdrożenie, aby "cofnąć wdrożenie" usług XAI). W tej strefie wyświetlana jest lista przychodzących usług XAI w produkcie, które są powiązane z usługami strony. Więcej informacji zawiera sekcja Wdrażanie przychodzących usług XAI za pośrednictwem przychodzącej usługi WWW.

Status wdrożenia jest określany przez porównanie wartości pola wersji rekordu z wartością zarejestrowaną podczas wdrożenia.

  • Wdrożono. Służy do określania, że przychodząca usługa XAI została wdrożona i nie wykryto zmian w konfiguracji.

  • Wymagane wdrożenie. Służy do określania, że przychodząca usługa XAI nie została wdrożona albo została wdrożona, ale od tego czasu wykryto zmiany konfiguracji.

  • Cofnięto wdrożenie. Służy do określania, że przychodząca usługa XAI jest oznaczona jako nieaktywna lub opcja Obsługa usług XAI za pośrednictwem przychodzącej usługi WWW nie jest ustawiona na wartość prawda i w danym momencie nie znaleziono przychodzącej usługi XAI do wdrożenia.

  • Wymagane cofnięcie wdrożenia. Służy do określania, że przychodząca usługa XAI jest oznaczona jako nieaktywna lub opcja Obsługa usług XAI za pośrednictwem przychodzącej usługi WWW nie jest ustawiona na wartość prawda, ale w danym momencie znaleziono przychodzącą usługę XAI do wdrożenia.

Przychodząca usługa XAI nie ma odpowiednika pola Wersja usługi przychodzącej usługi WWW, którego wartość jest zwiększana tylko wtedy, gdy wprowadzone zostaną zmiany rekordu wpływające na wdrożenie. W przypadku przychodzącej usługi XAI używany jest numer wersji w rekordzie. To pole jest zwiększane tylko po wprowadzeniu zmian, nawet takich które nie wpływają na wdrożenie. W związku z tym niektóre przychodzące usługi XAI mogą mieć status "Wymagane wdrożenie" w przypadkach, gdy ponowne wdrożenie może nie być wymagane. W takim przypadku zaleca się po prostu ponowne wykonanie wdrożenia.

Jeśli przychodzące usługi WWW zostały wdrożone, w kolumnie Widok będzie dostępne łącze WSDL umożliwiające otwarcie osobnego okna pozwalającego na przeglądanie definicji WSDL.