活动
最新
False
- 概述
- Adobe Sign - 传统
- Alteryx - 传统
- Amazon Comprehend - 传统
- Amazon Connect - 传统
- Amazon Rekognition - 传统
- Amazon Textract - 传统
- Box - 传统
- 认知 - 传统
- DocuSign - 传统
- Google Vision - 传统
- Jira - Classic
- Marketo - 传统版
- Microsoft Dynamics - 传统
- Microsoft Dynamics Finance and Operations - 传统
- Microsoft Translator - 传统
- Microsoft Vision - Classic
- Oracle Integration Cloud - 传统
- Oracle NetSuite - 传统
- Salesforce - 传统
- SAP BAPI - 传统
- ServiceNow - 传统
- Slack - 传统
- Smartsheet - 传统
- SuccessFactors - 传统
- Tableau - 传统
- Twilio - 传统
- Workato - 传统
- Workday - 传统
传统集成活动
上次更新日期 2024年4月22日
更新或插入记录
UiPath.ServiceNow.Activities.UpsertRecords
“更新插入记录”活动使用 ServiceNow批处理 - POST API 更新或插入一个或多个记录。
完成操作后,该活动会在
DataTable
对象 (Result) 中输出插入结果,并在 ResponseStatus
对象 (ServiceNowStatus) 中输出操作状态(成功/失败信息),您可以在后续活动(例如,条件逻辑)。
提示:
此活动包提供四种不同的方法来更新和/或插入记录: 更新 ServiceNow 记录、 插入 ServiceNow 记录 、更新插入记录或 插入导入集记录。
“ 更新 ServiceNow 记录”、“ 插入 ServiceNow 记录”和“更新插入 记录” 活动使用 REST API 直接写入生产表。 “ 插入导入集记录” 活动使用 REST 导入集 API 写入导入集表,数据将从该表转换为目标生产表。
为避免直接写入生产表,建议您使用“ 插入导入集记录” 活动更新或插入新记录。
有关详细信息,包括对导入集性能进行故障排除,请参阅 ServiceNow 文档中的导入集。
以下步骤和消息序列图是活动从设计时(即活动依赖项和输入/输出属性)到运行时如何工作的示例。
- 完成 设置 步骤。
- 将“ ServiceNow 作用域 ”活动添加到项目中。
- 在“ ServiceNow 作用域 ”活动中添加“更新插入记录”活动。
- 单击“更新插入 记录” 活动中的“配置”按钮(这将打开“ 对象向导”)。
- 选择要用于导入集的 对象 ,然后输入 输入 属性。
-
- 您的输入属性值将发送到Batch - POST API。
-
API 将
DataTable
和ResponseStatus
值返回到您的输出属性变量。
要选择对象,您必须通过单击“ 配置 ”按钮使用“对象向导”。
要了解有关对象向导的更多信息,请参阅业务活动框架页面。
- “对象 ” - 要插入或更新的记录类型。 这将设置并显示在设计时画布中,但不会显示在属性面板中。 使用“ 对象向导 ”选择对象。
注意:如果您看不到所选对象的属性列表,即使查看了“添加多个字段”选项,您在 ServiceNow 中可能没有足够的权限来查看对象元数据和修改数据。 有关更多详细信息,请参阅权限问题故障排除。
常见
- “显示名称”- 活动的显示名称。此字段仅支持
Strings
和String
变量。
输入
-
“数据表 ” - 要插入或更新的记录数据。 输入
DataTable
变量。- 要更新现有记录,请将 sys_Id 值添加到包含要进行更新的数据行中。
- 不包含 sys_id 值的数据行将作为新记录插入(新记录的 sys_id 将在 结果
DataTable
对象中返回)。 - 每个活动运行可以更新或插入的最大记录数为 200。 如要插入/更新 200 条以上的记录,可以添加 for 循环,或为每个包含 200 条记录的
DataTable
添加一个更新插入活动(例如,如果总共有 4,000 条记录,则可以将这些记录拆分为 20 个单独的部分),活动)。 有关更多信息,请参阅 ServiceNow 文档中的 “批处理 API ”。
其他
- “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
输出
-
“状态” - 请求的状态(成功/失败信息)。 输入
ResponseStatus
变量 (UiPath.BAF.Models.ResponseStatus)。ResponseStatus
对象包含三个可在其他活动中使用的属性。- “成功” -
Boolean
- 指定 API 请求是否成功。 - 错误代码 -
String
- API 请求不成功 (Success=False) 时的响应错误。 - 消息 -
String
- 错误消息。
- “成功” -
-
“结果 ” - 插入或更新记录的结果。 结果
DataTable
与输入 数据表具有相同的结构,但以下情况除外:- 成功插入的新记录现在包含 sys_id 值。
- 系统将附加一个新的“操作类型”列,其中包含“ 添加 ”或 “更新 ”值,以指示记录是已更新还是已添加到表中。
- 如果操作失败,则会附加一个新的“错误”列,并包含错误信息。