设置 Web 服务查找属性

本文包含以下主题：

作为管理员，您可以设置 Web 服务查找属性。您可以配置属性以从外部系统和故障单上检索信息。例如，您可以使用存储在 CMDB 工具上的硬件信息（如购买日期和保修数据）来填充故障单字段。

先决条件

在您配置 Web 服务查找属性之前，确保您已经完成以下先决条件任务：

启用 Web 服务调用
选择与 Web 服务查找属性关联的故障单类型。

注意事项

将配置两个 Web 服务操作：
- 一个返回多条记录。我们称之为“列表 Web 服务”操作。将列表 Web 服务操作与属性上的“列表 Web 服务”字段映射。配置此 Web 服务操作以接受其中一个输入参数作为搜索字符串。这些参数在稍后被映射到 Web 服务查找。
- 另一个返回单条记录。我们称之为“详细信息 Web 服务”操作。将详细信息 Web 服务操作与“详细信息 Web 服务”字段映射。此 Web 服务调用的输入参数可以映射到在列表 Web 服务中填充的一个或多个字段。
配置列表 Web 服务和详细信息 Web 服务操作，以便这两种操作互相关联。
注意：有关配置 Web 服务凭据和 Web 服务操作的详细信息，请参阅“配置出站 Web 服务”。
列表 Web 服务操作根据查找中提供的搜索字符串检索记录。
如果详细信息 Web 服务操作返回多条记录，则仅显示结果中的第一条记录。
当配置 Web 服务的入站映射时，您最多可以映射十个显示实体字段。显示字段提供供参考用的附加信息，但是不保存在故障单上。显示字段出现在 Web 服务查找自定义字段中。
映射“日期时间”类型属性时，在故障单上显示的值仅供参考。这些值不保存在故障单上。
您仅可以为 SOAP Web 服务调用（而不能为 RESTful Web 服务调用）配置“Web 服务查找”属性。
您可以在故障单的查找字段中最多输入 4000 个字符作为搜索字符串。
您在查找中输入的搜索字符串不会保留在故障单中。从搜索结果中选择一条记录后，相关信息将显示在故障单的映射字段中。
故障单中的映射字段可以最多显示从 Web 服务查找返回的值的 4000 个字符。

配置 Web 服务查找属性

可以像配置其他任何属性一样配置“Web 服务查找”属性类型。

有关创建属性的更多信息，请参阅“创建和管理属性”。

使用 Web 服务查找属性配置自定义字段

可以将“Web 服务查找”属性与自定义字段模板关联，并将其显示在故障单上。当在故障单的自定义字段中进行搜索时，从 Web 服务检索到的信息会显示在弹出窗口中。您可以配置以下两个字段用于 Web 服务查找自定义字段：

列表 Web 服务：该服务帮助检索记录并显示在弹出窗口上的网格中。可以用从“列表 Web 服务”映射的字段填充故障单。
详细信息 Web 服务（可选）：该服务帮助检索“列表 Web 服务”提取的每个记录的信息。故障单上不填充“详细信息 Web 服务”检索的信息。

注意：仅在自定义字段上显示从外部系统检索的前 25 条记录。

有关创建自定义字段模板的更多信息，请参阅“创建和管理自定义字段模板”。

将自定义字段与 Web 服务映射

在您创建自定义字段后，将它们与这两种 Web 服务映射。您可以按照此示例来映射自定义字段。

如果 Web 服务响应如以下示例所示：

则这两种 Web 服务的“显示字段”和“故障单字段”的字段映射将指向所需的属性。

显示字段 1：/result/record/attribute1
故障单/自定义字段：/result/record/attribute3
请参阅标准 XPath 表示法以了解更多信息。

注意：要将搜索字符串传递给列表 Web 服务，请将 Web 服务查找属性映射到所需的 Web 服务参数。

设置 Web 服务查找属性的最佳实践

要验证为列表 Web 服务创建的 Web 服务操作，请使用虚拟故障单。使用故障单来验证 Web 服务操作时，会使用映射信息更新该故障单。不要将有效故障单用于此目的。
在单节标头下添加映射的自定义故障单字段。当来自 Web 服务的映射值出现在单节下时，用户可以轻松发现他们。