The following macros are not currently supported in the header:
  • style

通过 Web 服务执行工作流操作

本文包含以下主题:

可以使用基于 SOAP 的 Web 服务调用从外部应用程序对 ServiceAide Cloud Service Management 中的故障单执行工作流操作。 例如,您可以将故障单状态设置为“已取消”。

概述

该应用程序为您提供了 Web 服务描述语言 (WSDL) 文件。 WSDL 文件包含的脚本可通过外部应用程序对您的故障单执行各类工作流操作。 要创建 Web 服务调用,需要以下信息:

  • 该应用程序的 Web 服务用户 ID 和密码。
  • 适用于您的故障单类型的 WSDL 文件。
  • 您想要编辑的故障单的唯一 Web ID (MDR 元素 ID)。
  • 您想要执行的工作流操作的唯一 ID。

此外,确定完成您的 Web 调用所需的其他信息。 例如:

  • 如果您想要将某个故障单分配给特定个人或组,请确定他们的 ID。
  • 如果您想要将状态分配给某个故障单,请确定状态 ID。

您可以在应用程序内查找所有工作流操作、状态、个人、组等等的 ID。

MDR 元素 ID

确定您想要对其执行工作流操作的故障单。 应用程序中的每个故障单都被分配了唯一 ID,即 MDR 元素 ID。

MDR 元素 ID 不同于应用程序中分配给故障单的故障单编号。

当您在新窗口中打开某个故障单时,该故障单的 MDR 元素 ID 显示在 URL 字段中。 在下列图像中,您可以看到以红框标记的故障单的 MdrElementID:

您的 SOAP 应用程序使用 MDR 元素 ID 来识别应用程序中的故障单。

您还可以在 SOAP 请求中将 MdrElementID 称为 row_id。 在使用这些脚本时,您可以使用 row_id 字段来传递 MdrElementID。

还可以使用使用故障单或案例 ID 代替 MdrElementID 的脚本。 在此类情况下,将在 row_id 字段中传递固定值作为“-999”。 接下来,在 ticket_identifier 字段中传递实际故障单 ID。

WSDL 文件

应用程序中的每个故障单类型都有单独的 WSDL 文件。 要访问与您的故障单类型对应的 WSDL 文件,请使用下列任一 URL:

WSDL 文件包含用于对故障单执行各种操作的 XML 脚本。 要替换脚本中的 MdrElement ID 和工作流操作 ID,请在 SOAP 编辑器中打开该文件。

如果无法访问以上任一 URL,请使用 WSDL 的直接 URL,格式如下:

https://direct-sm1s.saas.ca.com/NimsoftServiceDesk/servicedesk/webservices/Incident?wsdl

替换 URL 中的故障单类型。

创建 Web 服务请求

执行 SOAP 请求的过程可能因不同的应用程序而有所不同。 下列过程显示如何使用 SOAP UI 对故障单执行工作流操作。

请执行以下步骤:

  1. 在 SOAP UI 中创建项目,并将 WSDL 文件的路径添加到该项目中。
    您可以在项目下看到在 WSDL 文件中可用的操作的列表。
  2. 选择想要执行的操作。
    该操作的脚本显示在右侧窗格中。
  3. 在脚本中,输入 Web 服务凭据、 MDR 元素 ID 和工作流操作 ID。 同时输入完成 Web 服务调用所需的其他 ID。
  4. 运行脚本。
    SOAP UI 显示执行的状态。

如果脚本成功运行,您可以查看应用程序中对您的故障单所做的变更。

请参阅下图了解在 row_id 字段中使用 MdrElementID 的示例脚本。


在此图中,用户正在对故障单(MDR 元素 ID 为 999)执行工作流操作 (ID 12)。 工作流操作将指定故障单分配给特定组 (ID 2)。 请注意,last_used_action_id 表示您将要执行的工作流操作。

请参阅下图了解在 ticket_identifier 字段中使用故障单或案例 ID 的示例脚本。


在此示例中,用户正在对故障单(案例 ID 100-157)执行工作流操作 (ID 12)。

切片可以同时处理最多 100 个 Web 服务请求。

© 2017 ServiceAide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com