将对象链接到 SOAP Web 服务

您可以在系统中使用外部 Web 服务所提供的功能，方法是使用对象设计器将 Web 服务行为添加到对象。 您可以将 Web 服务方法所使用的输入和输出参数映射到相应的属性。

将 SOAP Web 服务行为添加到对象：

1. 在对象设计器中打开要使用 SOAP Web 服务的对象。
2. 创建需要映射到 Web 服务中的参数的字符串属性。
3. 选择属性树顶部的对象，然后在属性网格中的行为旁边单击 。
   出现“行为选择”对话框。
4. 在可用项目列表中选择 SOAP Web 服务，然后点击 。
   SOAP Web 服务移动到“选中的项目”列表。
5. 单击确定。
   “行为选择”对话框关闭，而“属性”网格中会出现一个新的项目“SOAP Web 服务”。
6. 在属性网格中，点击 SOAP Web 服务旁边的 。
   随即显示“SOAP Web 服务”对话框。
   
7. 根据要在创建、更新还是删除业务对象实例时调用 Web 服务，相应地选择创建、更新或删除选项卡。
8. 在身份验证类型列表中，选择托管 Web 服务的网站所要求的身份验证类型。无、Windows 或基本。
9. 在 SOAP Web 服务说明地址框中，输入要使用的 Web 服务的 URL，然后点击开始。
   “方法”列表将更新以显示所选 Web 服务中包含的方法。

您必须选择正确的身份验证类型，然后再单击开始。如果要使用的 Web 服务的 URL 包含 ?wsdl 等查询字符串，则必须将其纳入 SOAP Web 服务说明地址。

10. 在方法列表中，选择要使用的方法。
    “参数”列表将更新，以显示方法所使用的参数。您现在需要将这些参数映射到相应的属性。
11. 将您要使用的每个参数拖放到相应的 Service Desk 或 Asset Manager 业务属性，然后单击确定。
12. 将更改保存到业务对象。
    会自动向对象添加三个新的属性以存储 Web 服务的创建、更新和删除状态。这些属性记录了 Web 服务的返回值，对于捕捉所返回的任何错误消息很有用处。

使用 Web 服务链接至 Ivanti Process Manager

您可以使用上述 Web 服务行为来调用 Ivanti Process Manager (LPM) Web 服务监听程序。 这提供了一种更为有效的 Service Desk 或 Asset Manager 与 LPM 进行通信的方式。

示例 LPM Web 服务 XML 文件（LPMWSSample.xml）已安装在 Service Desk 或 Asset Manager 安装的控制台文件夹中。 可使用该 XML 文件来将 Service Desk 或 Asset Manager 属性映射到 LPM 载荷参数，然后该参数将用于控制 LPM 进程。

在开始之前，您需要使用 LPMWSSample.xml 创建 LPM Web 服务监听程序。 有关如何进行此操作的信息，请参阅 LPM 文档。

要将属性映射到 LPM 载荷参数：

1. 将 SOAP Web 服务行为添加到所需的对象，然后使用适当的身份验证类型，将 SOAP Web 服务说明地址设置为系统的 LPM Web 服务。

LPM Web 服务的 SOAP Web 服务说明地址通常以 webservicelistener.asmx?wsdl 结尾。

2. 单击开始。
   “方法”列表将更新以显示 WebServiceListener 中包含的方法。
3. 在方法列表中，单击 WebServiceListener 下的 ProcessExternalMessage。
   “参数”列表将更新以显示 ProcessExternalMessage 参数。
4. 将 connectorName 参数映射到属性，该属性中包含您要在 LPM 中使用的 Web 服务监听程序的名称。
   您可以使用默认值、计算或自动操作实例数据值自动填充该属性，否则您的用户将需要在相应的 Service Desk 或 Asset Manager 窗口上输入该值。
5. 右键单击 fieldContext 参数，然后单击快捷方式菜单上的加载 LPM 模板。
   出现“打开”对话框。
6. 浏览到 Console 文件夹然后打开 LPMWSSample.xml。
   将加载 LPM 参数的字段上下文。
   
7. 根据需要，将 fieldContext 下名为 parameter## 的项目映射到 Service Desk 或 Asset Manager 属性，然后单击确定并将变更保存到对象。
   您映射的参数值就是那些发送到 LPM 的参数值，并在之后作为 LPM 流程的一部分在 LPM 中进行使用。有关在 LPM 中设计流程的详细信息，请参阅 LPM 随附的文档。

您不能将参数列表中的 ModuleName、ModuleGuid、ClassName、ClassGuid、ObjectGuid 或 ProcessGuid 进行映射 – 它们仅供内部使用。

您可以将最高级别的 fieldContext 参数映射到 Service Desk 或 Asset Manager 属性。该参数包含您进行映射并在之后发送到 LPM 的所有字段上下文所生成的 xml 载荷。您可能发现这对调试而言很有作用。

ReturnParameter 会返回真或假，具体取决于与 LPM 的通信是否成功。

您可以使用 Framework 中的 Web Service 诊断日志类别以及配置中心里的 Web Access 应用程序来记录关于何时使用过 Web 服务行为的信息。 该类别会记录调用的 Web 服务 URL、传递到 Web 服务的参数、从 Web 服务发来的返回值以及返回状态、执行 Web 服务的时间以及传递到 Web 服务的身份验证参数。有关配置诊断日志记录的详细信息，请参阅诊断记录。