使用 Web 服务链接至 Ivanti Process Manager
可以使用两种方法来与 Ivanti Process Manager 通信:
- 使用 Web 服务
- 使用“事态生成器”行为
前一种是首选方法,将在本节中介绍。使用“事态生成器”行为的效率较低,但可以配合其他不提供 Web 服务接口的外部工具来使用。有关事态生成器方法的详细信息,请参阅不使用 Web 服务发送信息。
要设置这种集成,首先需要在 LPM 中创建 Web 服务监听程序,并且作为创建监听程序的一部分,需要提供 XML 文件来定义载荷。您的 Service Desk 或 Asset Manager 安装内容的 Console 文件夹中已经安装了一个示例载荷 XML 文件 (LPMWSSample.xml),如有必要,您可以对其进行修改。您可按下述方式在控制台的 Web 服务对话框中加载该相同的 XML 文件,并将 Service Desk 或 Asset Manager 属性映射到载荷属性。
要在 Service Desk 或 Asset Manager 与 LPM 之间设置集成,需要具有发起服务请求的相应对象。要将请求实现作为流程的一部分提供,该对象需要与模块的顶级对象相关联,并具有 Web 服务行为。无论何时创建、更新或删除具有 Web 服务行为的对象实例,都会进行由 LPM 读取的 Web 服务调用。
要将 Service Desk 或 Asset Manager 属性映射到 LPM 载荷参数:
- 使用 LPMWSSample.xml 创建 LPM Web 服务监听程序。
请参阅 LPM 文档了解如何进行的信息。
- 在对象设计器中打开要使用 Web 服务的对象。
- 创建需要映射到 Web 服务中的参数的字符串属性。
- 选择属性树顶部的对象,然后在属性网格中的行为旁边单击
。
出现“行为选择”对话框。 - 在可用项目列表中,选择 Web 服务,然后单击
。
“Web 服务”移动到“选中的项目”列表。 - 单击确定。
“行为选择”对话框关闭,而“属性”网格中则会出现一个新的项目“Web 服务”。 - 在属性网格中,在 Web 服务旁边单击
。
随即显示“Web 服务”对话框。 - 根据要在创建、更新还是删除业务对象实例时调用 Web 服务,相应地选择创建、更新或删除选项卡。
- 在身份验证类型列表中,选择托管 Web 服务的网站所要求的身份验证类型。无、Windows 或基本。
- 在 Web 服务说明地址框中,键入您要使用的 Web 服务的 URL,然后单击开始。
URL 的格式为 https://<lpmserver>/ServiceManagement/WebServiceListener.asmx?wsdl。
“方法”列表将更新以显示 WebServiceListener 中包含的方法。 - 在方法列表中,单击 WebServiceListener 下的 ProcessExternalMessage。
“参数”列表将更新以显示 ProcessExternalMessage 参数。 - 将 connectorName 参数映射到属性,该属性中包含您要在 LPM 中使用的 Web 服务监听程序的名称。
您可以使用默认值、计算或自动操作实例数据值在 Service Desk 或 Asset Manager 中自动填充该属性,否则您的用户将需要在相应的窗口上输入该值。 - 右键单击 fieldContext 参数,然后单击快捷方式菜单上的加载 LPM 模板。
出现“打开”对话框。 - 浏览到 Console 文件夹然后打开 LPMWSSample.xml。
将加载 LPM 参数的字段上下文。 - 根据需要,将 fieldContext 下名为 parameter## 的项目映射到属性,然后单击确定并将变更保存到对象。
您映射的参数值就是那些发送到 LPM 的参数值,并在之后作为 LPM 流程的一部分在 LPM 中进行使用。有关在 LPM 中设计流程的详细信息,请参阅 LPM 随附的文档。
您不能将参数列表中的 ModuleName、ModuleGuid、ClassName、ClassGuid、ObjectGuid 或 ProcessGuid 进行映射 – 它们仅供内部使用。
您可以将最高级别的 fieldContext 参数映射到属性。该参数包含您进行映射并在之后发送到 LPM 的所有字段上下文所生成的 xml 载荷。您可能发现这对调试而言很有作用。
ReturnParameter 会返回真或假,具体取决于与 LPM 的通信是否成功。