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

Istnieją dwie metody komunikacji z komponentem Ivanti Process Manager:

• za pomocą usługi sieci web,
• z użyciem zachowanie Generator zdarzeń.

Pierwsza z tych metod jest preferowana i została opisana w tej sekcji. Użycie Generatora zdarzeń jest mniej wydajne, ale możliwe do zastosowania z innymi narzędziami zewnętrznymi, które nie dysponują interfejsem usług sieci Web. Informacje na temat metody Generatora zdarzeń można znaleźć w sekcji Wysyłanie informacji bez użycia usług sieci Web.

Pierwszym etapem konfigurowania tej integracji jest utworzenie w komponencie LPM programu nasłuchującego usługi sieci web, a podczas tworzenia tego programu nasłuchującego należy określić plik XML definiujący ładunek. Przykładowy plik XML ładunku (LPMWSSample.xml) jest zainstalowany w folderze Console instalacji systemu Service Desk lub Asset Manager. W razie potrzeby plik ten można modyfikować. Ten sam plik XML ładuje się w oknie dialogowym Usługi sieci Web w Konsoli, a następnie w sposób opisany poniżej odwzorowuje się atrybuty systemu Service Desk lub Asset Manager na atrybuty ładunku.

Aby skonfigurować integrację między systemem Service Desk lub Asset Manager i komponentem LPM, należy utworzyć odpowiedni obiekt, który będzie inicjować wniosek o usługę. Aby zapewnić realizację wniosków w ramach procesu, obiekt ten musi być powiązany z obiektem najwyższego poziomu w module i musi mieć ustawione zachowanie Usługa sieci Web. Za każdym razem, gdy instancja obiektu o zachowaniu Usługa sieci Web jest tworzona, aktualizowana lub usuwana, wykonywane jest wywołanie usługi sieci Web, które może zostać odczytane przez komponent LPM.

Aby odwzorować atrybuty systemu Service Desk lub Asset Manager na parametry ładunku komponentu LPM:

1. Utwórz program nasłuchujący usługi sieci web komponentu LPM, korzystając z pliku LPMWSSample.xml.

Informacje o tym, jak to zrobić, można znaleźć w dokumentacji komponentu LPM.

2. Otwórz w Projektancie obiektów obiekt, który ma być używany z usługą sieci web.
3. Utwórz atrybuty typu ciąg, które chcesz odwzorować na parametry w usłudze sieci web.
4. 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.
   
   
5. Wybierz pozycję Usługa sieci Web z listy Dostępne elementy, a następnie kliknij przycisk .
   
   Pozycja Usługa sieci Web zostanie przeniesiona na listę Wybrane elementy.
6. Kliknij przycisk OK.
   Okno dialogowe Wybór zachowania zostanie zamknięte, a w siatce Właściwości pojawi się nowy element — Usługa sieci Web.
7. W siatce Właściwości kliknij przycisk obok właściwości Usługi sieci Web.
   Zostanie wyświetlone okno dialogowe Usługi sieci Web.
   
8. 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.
9. Z listy Typ uwierzytelniania wybierz typ uwierzytelniania wymagany przez witrynę sieci Web, która udostępnia usługę sieci web: Brak, Windows lub Podstawowe.
10. Wpisz w polu Adres opisu usługi sieci Web adres URL usługi sieci web, która ma być używana, a następnie kliknij przycisk Przejdź.
    Adres URL ma format https://<serwer_lpm>/ServiceManagement/WebServiceListener.asmx?wsdl.
    Lista Metody zostanie zaktualizowana i pojawi się na niej metoda zawarta w usłudze WebServiceListener.
11. Na liście Metody kliknij pozycję ProcessExternalMessage w sekcji WebServiceListener.
    Lista Parametry zostanie zaktualizowana i pojawią się na niej parametry metody ProcessExternalMessage.
12. 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 w systemie Service Desk lub Asset Manager 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.
13. 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.

14. 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.
    
    
15. Odwzoruj wszystkie potrzebne elementy związane z pozycją fieldContext o nazwach postaci parameter## na atrybuty, 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. 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.