获取 ServiceNow 记录

UiPath.ServiceNow.Activities.GetRecord

获取 ServiceNow 记录活动使用 ServiceNow表格 - GET{sys_id} API 来检索特定记录 ( sys_id )。

After retrieving the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

此活动还返回与sys_id关联的字段数据。例如，如果要检索 ServiceNow 事件 对象，可以通过在 对象向导 中添加字段（带有变量）来输出 short_description 和 contact_type 数据（请参阅下面的 示例 ）。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成设置步骤。
2. 将“ServiceNow 作用域”活动添加到您的项目中。
3. Add the Get ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Get ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to retrieve and enter, at a minimum, the sys_id of the record.
6. 为“输出”属性创建并输入ResponseStatus变量。

   • 您的输入属性值将发送到“表格”- GET{sys_id} API。

   • API 会将 ResponseStatus 值返回到您的输出属性变量。

     

在活动正文中

To enter your Get ServiceNow Record property values, you must use the Object Wizard by clicking the Configure button.

要了解有关对象向导的更多信息，请参阅业务活动框架页面。

• sys_id - The id of the ServiceNow record that you want to retrieve. Enter a String or String variable.
  • 要获取sys_id值，您可以采用 ServiceNow唯一记录标识符 (sys_id)文档中显示的其中一种方法，也可以在 ServiceNow 用户界面中右键单击该记录，然后在弹出菜单中选择“复制 sys_id”选项。

属性

备注：

如果您看不到所选对象的属性列表，即使选择了“添加多个字段”选项，您可能也没有足够的权限在 ServiceNow 中查看对象元数据和修改数据。有关更多详细信息，请参阅权限问题故障排除。

高级

• AdditionalFields - A DataRow that includes the columns and values that you want to retrieve. The column names must match the names as they appear in the ServiceNow database table for the selected object type.

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 或 String 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• ServiceNowStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅快速入门指南。