Łączenie obiektów z usługami sieci Web SOAP

Funkcje dostarczane przez zewnętrzne usługi sieci Web można wykorzystać w systemie poprzez dodanie do obiektu zachowania Usługa sieci Web SOAP za pomocą Projektanta obiektów. Następnie można odwzorować parametry wejściowe i wyjściowe używane przez metodę usługi sieci web na odpowiednie atrybuty.

Aby dodać zachowanie Usługa sieci Web SOAP do obiektu:

1. Otwórz w Projektancie obiektów obiekt, który ma być używany z usługą sieci Web SOAP.
2. Utwórz atrybuty typu ciąg, które chcesz odwzorować na parametry w usłudze sieci web.
3. Wybierz obiekt u góry drzewa Atrybuty, a następnie w siatce Właściwości kliknij przycisk obok właściwości Zachowania.
   Zostanie wyświetlone okno dialogowe Wybór zachowania.
4. Z listy Dostępne elementy wybierz pozycję Usługa sieci Web SOAP, a następnie kliknij .
   Pozycja Usługa sieci Web SOAP zostanie przeniesiona na listę Wybrane elementy.
5. Kliknij przycisk OK.
   Okno dialogowe Wybór zachowania zostanie zamknięte, a na siatce Właściwości pojawi się nowy element, tj. Usługi sieci Web SOAP.
6. Na siatce Właściwości kliknij obok pozycji Usługi sieci Web SOAP.
   Zostanie wyświetlone okno dialogowe Usługi sieci Web SOAP.
   
7. Wybierz kartę Tworzenie, Aktualizacja lub Usuwanie w zależności od tego, czy usługa sieci web ma być wywoływana podczas tworzenia, aktualizowania czy usuwania instancji obiektu biznesowego.
8. Z listy Typ uwierzytelniania wybierz typ uwierzytelniania wymagany przez witrynę sieci Web, która udostępnia usługę sieci web: Brak, Windows lub Podstawowe.
9. W polu Adres opisu usługi sieci Web SOAP wpisz adres URL usługi sieci Web, która ma być używana, a następnie kliknij przycisk Przejdź.
   Lista Metody zostanie zaktualizowana i pojawią się na niej metody zawarte w wybranej usłudze sieci web.

Przed kliknięciem przycisku Przejdź należy wybrać poprawny Typ uwierzytelniania. Jeśli adres URL usługi sieci Web, która ma być używana, zwiera ciąg znaków zapytania, taki jak ?wsdl, należy go umieścić w polu Adres opisu usługi sieci Web SOAP.

10. Z listy Metody wybierz metodę, która ma być używana.
    Lista Parametry zostanie zaktualizowana i pojawią się na niej parametry używane przez daną metodę. Parametry te trzeba teraz odwzorować na odpowiednie atrybuty.
11. Przeciągnij każdy parametr, którego chcesz użyć, z listy Parametry na odpowiedni atrybut systemu Service Desk lub Asset Manager na liście Atrybuty biznesowe, a następnie kliknij przycisk OK.
12. Zapisz zmiany obiektu biznesowego.
    Do obiektu zostaną automatycznie dodane trzy nowe atrybuty, w których zapisywane będą stany tworzenia, aktualizowania i usuwania usługi sieci web. W tych atrybutach rejestrowane są wartości zwracane z usługi sieci web. Przydają się one do przechwytywania wszystkich zwracanych komunikatów o błędach.

Łączenie z komponentem Ivanti Process Manager za pomocą usługi sieci web

Opisanego powyżej zachowania Usługa sieci Web SOAP można użyć w celu wywołania programu nasłuchującego usługi sieci web komponentu Ivanti Process Manager (LPM). Jest to bardziej wydajny sposób komunikacji systemu Service Desk lub Asset Manager z komponentem LPM.

Przykładowy pliki XML usługi sieci web komponentu LPM (LPMWSSample.xml) jest zainstalowany w folderze Console instalacji systemu Service Desk lub Asset Manager. Za pomocą tego pliku XML można odwzorować atrybuty systemu Service Desk lub Asset Manager na parametry ładunku komponentu LPM, które następnie służą do sterowania procesem LPM.

Przed rozpoczęciem należy utworzyć program nasłuchujący usługi sieci web komponentu LPM za pomocą pliku LPMWSSample.xml. Informacje o tym, jak to zrobić, można znaleźć w dokumentacji komponentu LPM.

Aby odwzorować atrybuty na parametry ładunku komponentu LPM:

1. Dodaj zachowanie Usługa sieci Web SOAP do wymaganego obiektu, a następnie ustaw właściwość Adres opisu usługi sieci Web SOAP na usługę sieci Web komponentu LPM w systemie, stosując odpowiedni Typ uwierzytelniania.

Adres opisu usługi sieci Web SOAP związanej z komponentem LPM zwykle kończy się ciągiem znaków webservicelistener.asmx?wsdl.

2. Kliknij przycisk Przejdź.
   Lista Metody zostanie zaktualizowana i pojawi się na niej metoda zawarta w usłudze WebServiceListener.
3. Na liście Metody kliknij pozycję ProcessExternalMessage w sekcji WebServiceListener.
   Lista Parametry zostanie zaktualizowana i pojawią się na niej parametry metody ProcessExternalMessage.
4. Odwzoruj parametr connectorName na atrybut zawierający nazwę programu nasłuchującego usługi sieci web, który ma być używany w komponencie LPM.
   Ten atrybut można zapełnić automatycznie przy użyciu wartości domyślnej, obliczenia lub wartości danych instancji działania automatycznego. Mogą to także robić użytkownicy, wprowadzając tę wartość w odpowiednim oknie systemu Service Desk lub Asset Manager.
5. Kliknij prawym przyciskiem myszy parametr fieldContext, a następnie kliknij opcję Ładuj szablon LPM w menu skrótów.
   Zostanie wyświetlone okno dialogowe Otwórz.
6. Odszukaj, a następnie otwórz plik LPMWSSample.xml znajdujący się w folderze Console.
   Zostaną załadowane konteksty pól odpowiadające parametrom LPM.
   
7. Odwzoruj wszystkie potrzebne elementy związane z pozycją fieldContext o nazwach postaci parameter## na atrybuty systemu Service Desk lub Asset Manager, a następnie kliknij przycisk OK i zapisz zmiany wprowadzone do obiektu.
   Odwzorowane wartości parametrów są wartościami wysyłanymi do komponentu LPM, które są następnie używane w komponencie LPM w ramach procesu LPM. Więcej informacji na temat projektowania procesów w komponencie LPM zawiera dokumentacja komponentu LPM.

Nie można odwzorować parametrów ModuleName, ModuleGuid, ClassName, ClassGuid, ObjectGuid ani ProcessGuid z listy Parametry, gdyż są one używane wewnętrznie.

Możliwe jest odwzorowanie parametru najwyższego poziomu fieldContext na atrybut systemu Service Desk lub Asset Manager. Ten parametr zawiera ładunek XML, który jest generowany ze wszystkich kontekstów odwzorowanych pól, a następnie jest wysyłany do komponentu LPM. Może być przydatny podczas debugowania.

Parametr ReturnParameter zwraca wartość True lub False w zależności od tego, czy komunikacja z komponentem została nawiązana pomyślnie czy nie.

Informacje o tym, kiedy jest używane zachowanie usługi sieci Web SOAP, można rejestrować za pomocą kategorii rejestrowania diagnostycznego Usługa sieci Web w aplikacjach Środowisko i Web Access w Centrum konfiguracji. W tej kategorii rejestrowane są: wywołany adres URL usługi sieci web, parametry przekazane do usługi sieci web, zwrócone wartości i stan zwrotu z usługi sieci web, czas wykonania usługi sieci web oraz parametry uwierzytelniania przekazane do usługi sieci web. Więcej informacji na temat konfigurowania rejestrowania diagnostycznego można znaleźć w sekcji Rejestrowanie diagnostyczne.