插入记录

UiPath.MicrosoftDynamics.Activities.InsertRecord

“ 插入记录” 活动使用 Web API POST 操作插入新记录。

插入记录后，该活动会在 ResponseStatus 对象 (MicrosoftDynamicsStatus) 中输出请求的状态（成功/失败信息），您可以在后续活动（例如条件逻辑）中使用该对象。

如果请求成功，该活动将返回分配给新记录的 String 标识符。 例如，如果要插入 帐户 ，则可以通过使用 配置 按钮添加 String 变量来输出帐户ID值（请参见下面的 示例 ）。

工作方式

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

1. 完成 设置 步骤。
2. 将“ Microsoft Dynamics 应用程序作用域 ” 活动添加到您的项目中。
3. 在“ Microsoft Dynamics 应用程序作用域 ”活动中添加“插入记录”活动。
4. 单击“ 插入记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
5. 选择要插入的 对象 ，然后添加要填充的字段（包含值）。
6. 为“ 输出 ” 属性创建并输入 ResponseStatus 变量。
   • 您的输入属性值将在 POST 操作请求中发送。
   • 此操作会将 String 标识符和 ResponseStatus 值返回到输出属性变量。
     
     

     

     
     

配置

要输入“ 插入记录” 属性值，您必须使用“ 对象向导 ”，方法是单击“ 配置 ”按钮。

使用“ 对象向导 ” 选择 对象时，可以添加要包含在新记录中的字段。有关每个对象的可用字段的完整列表，请参阅 Microsoft 文档中的 Web API 实体类型参考 。

属性

高级

• “其他 字段” - DataRow ，其中包含要插入的列和值。 输入 DataRow 变量。
  • 要确定/验证 DataRow 列名称，请单击“ 配置 ” 按钮，选择“ 对象”，然后查看“ 字段 ” 列中显示的名称； DataRow 列名称必须与显示的值匹配。
  • 如果同时在“ 对象向导 ”和“ 附加 字段”属性中输入字段值，则在“ 对象向导 ”中输入的值优先（覆盖“ 附加 字段”值）。

常见

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

其他

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

输出

• “响应 状态” - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。

示例

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

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