Связь с Ivanti Process Manager с помощью web-службы

Существует два метода, которые можно использовать для взаимодействия ПО Ivanti Process Manager:

• С помощью web-службы
• С помощью действия генератора событий

Ранее использовавшийся метод является предпочтительным и представлен далее в этом разделе. Использование действия генератора событий не является достаточно эффективным, но может использоваться с другими внешними программами, которые не имеют интерфейса web-службы. Для получения дополнительной информации о методе генератора событий см. раздел Отправка информации без использования web-службы.

Первым действием для настройки этой интеграции является создание приемника web-службы в LPM, и затем в качестве части создания приемника необходимо указать файл XML для определения нагрузки. Пример файла XML нагрузки (LPMWSSample.xml) устанавливается в папке Console во время установки приложения Service Desk или Asset Manager, которую вы можете изменить, если это необходимо. Вы будете загружать этот файл XML в диалоге web-служб на консоли и назначите атрибуты Service Desk для атрибутов нагрузки, как это будет представлено далее.

Для настройки интеграции между ПО Service Desk или Asset Manager и приложением LPM является создание соответствующего объекта, который будет инициировать запрос на обслуживание. Для обеспечения заполнения запроса, как части процесса, данный объект должен иметь родственный объект верхнего уровня для модуля и иметь возможность действовать как web-служба. Независимо от того, был ли экземпляр объекта с действием веб-службы создан, обновлен или удален запись добавляется в таблицу очереди, которая считывается приложением LPM.

Для назначения атрибутов Service Desk или Asset Manager для параметров нагрузки LPM:

1. Создайте приемник web-служб LPM, используя файл LPMWSSample.xml.

Для получения информации об этом см. документацию к LPM.

2. Откройте объект, который нужно использовать web-службе в Дизайнере объектов.
3. Создайте строковые атрибуты, которые нужно назначить для параметров в web-службе.
4. Выберите объект вверху дерева Атрибуты и затем на панели Свойства нажмите рядом с элементом Действия.
   
   Появится диалог выбора действия.
   
   
5. Выберите Web-служба в списке Доступные элементы, а затем нажмите .
   
   Элемент web-службы переместится в список "Выбранные элементы".
6. Нажмите OK.
   Диалог выбора действия будет закрыт, и новый элемент "Web-служба" отобразится на панели "Свойства".
7. На панели Свойства нажмите рядом с элементом Web-службы.
   Отобразится диалог "Web-службы".
   
8. Выберите вкладку Создание, Обновление или Удаление в зависимости от того, для чего нужно вызвать web-службу после создания, обновления или удаления экземпляра бизнес-объекта.
9. В списке Тип аутентификации выберите тип аутентификации, используемый web-сайтом, на котором находится web-служба: Нет, Windows или Общая.
10. Введите URL-адрес web-службы, которую нужно использовать, в Адрес описания web-службы, а затем нажмите Перейти.
    URL-адрес имеет форму https://<lpmserver>/ServiceManagement/WebServiceListener.asmx?wsdl.
    В списке "Методы" будет отображен метод, содержащийся в приемнике WebServiceListener.
11. В списке Методы выберите ProcessExternalMessage в области приемника WebServiceListener.
    Список "Параметры" будет обновлен для отображения параметров ProcessExternalMessage.
12. Назначьте параметр connectorName для атрибута, который содержит имя приемника web-службы, который вы хотите использовать в LPM.
    Вы можете заполнить этот атрибут автоматически, используя значение по умолчанию, вычисление или значение данных экземпляра автоматического действия, или вашим пользователям потребуется ввести это значение в соответствующем окне.
13. Нажмите правой кнопкой мыши параметр fieldContext, а затем нажмите Загрузить шаблон LPM в меню ярлыков.
    Появится диалог "Открыть".

14. Выберите и откройте файл LPMWSSample.xml в папке Console.
    
    Будут загружены контексты полей для параметров LPM.
    
    
15. Назначьте любые элементы в поле fieldContext с именем parameter## для атрибутов, а затем нажмите OK и сохраните изменения объекта.
    Назначенные значения параметров представляют собой значения, отправляемые в LPM, а затем используются в качестве части процессов LPM. Для получения дополнительной информации о создании процессов в LPM см. в документацию, поставляемую с LPM.

Вы не можете назначать параметры ModuleName, ModuleGuid, ClassName, ClassGuid, ObjectGuid или ProcessGuid из списка Параметры, так как они используются внутренне.

Вы можете назначить параметр верхнего уровня fieldContext для атрибута. Этот параметр содержит данные нагрузки xml, которая создается из всех назначаемых контекстов полей, которые затем отправляются в LPM. Это может быть полезным для отладки.

Параметр ReturnParameter возвращает значения True или False в зависимости от успеха взаимодействия с LPM.