插入记录

用于在 Microsoft Dynamics 365 中插入新记录的活动

UiPath.MicrosoftDynamics.Activities.InsertRecord

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

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

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

工作方式

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

1. 完成设置步骤。
2. 将“Microsoft Dynamics 应用程序作用域”活动添加到您的项目中。
3. Add the Insert Record activity inside the Microsoft Dynamics Application Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) that you want to populate.
6. 为“输出”属性创建并输入ResponseStatus变量。

   • 您的输入属性值将在POST操作请求中发送。

   • 此操作会将 String 标识符和 ResponseStatus 值返回到输出属性变量。

     

配置

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

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

属性

高级

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. Enter a DataRow variable.
  • To determine/validate your DataRow column names, click the Configure button, select your Object, and review the names shown in the Field column; your DataRow column names must match the shown value.
  • If you enter a value for a field in both the Object Wizard and the AdditionalFields property, the value entered in the Object Wizard takes precedent (overwriting the AdditionalFields value).

常见

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

其他

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

输出

• ResponseStatus - 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.

示例

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

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