Share via


ApplyRecordCreationAndUpdateRuleRequest Class

Definition

Contains data to apply record creation and update rules to activities in Dynamics 365 Customer Service created as a result of the integration with external applications.

public ref class ApplyRecordCreationAndUpdateRuleRequest sealed : Microsoft::Xrm::Sdk::OrganizationRequest
[System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/crm/2011/Contracts")]
public sealed class ApplyRecordCreationAndUpdateRuleRequest : Microsoft.Xrm.Sdk.OrganizationRequest
[<System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/crm/2011/Contracts")>]
type ApplyRecordCreationAndUpdateRuleRequest = class
    inherit OrganizationRequest
Public NotInheritable Class ApplyRecordCreationAndUpdateRuleRequest
Inherits OrganizationRequest
Inheritance
ApplyRecordCreationAndUpdateRuleRequest
Attributes

Remarks

This message requires Dynamics 365 Customer Service.

For the Web API use the ApplyRecordCreationAndUpdateRule action.

Usage

Pass an instance of this class to the Execute(OrganizationRequest) method, which returns an instance of the ApplyRecordCreationAndUpdateRuleResponse class.

Privileges and Access Rights

To perform this action, the caller must have privileges on the activity, QueueItem and Workflow tables, and access rights on the specified record in the Target property.

They must also have the privileges in the following table:

Primary tablePrivilege
activity

prvReadActivity

prvWriteActivity

queueitem

prvReadQueue

workflow

prvReadWorkflow

prvWorkflowExecution

Notes to Callers

The record creation and update rules in Dynamics 365 Customer Service enable you to automatically convert incoming activities, such as emails, custom activities, and posts, from external integrated applications (mobile applications, portals or social channels) to system or custom records in Dynamics 365 Customer Service. These rules can be created or edited using the web client only; rule creation and update is not supported through SDK. Learn to automatically create or update records with Dynamics 365 Customer Service.

Use the ApplyRecordCreationAndUpdateRuleRequest class message to retroactively apply a record creation and update rule to the activity that got created in Dynamics 365 Customer Service while the rule was inactive. To edit a rule, you need to deactivate the rule, edit the rule definition, and then reactivate the rule. While the rule is in inactive stage because its being edited, the activities from the external applications will continue to come into Dynamics 365 Customer Service (if you have configured an external application to integrate with Dynamics 365 Customer Service), but will not be acted upon as the rule is not active.

Constructors

ApplyRecordCreationAndUpdateRuleRequest()

Initializes a new instance of the ApplyRecordCreationAndUpdateRuleRequest class.

Properties

ExtensionData

Gets or sets the structure that contains extra data. Optional.

(Inherited from OrganizationRequest)
Item[String]

Gets or sets the indexer for the Parameters collection.

(Inherited from OrganizationRequest)
Parameters

Gets or sets the collection of parameters for the request. Required, but is supplied by derived classes.

(Inherited from OrganizationRequest)
RequestId

Gets or sets the ID of the request. Optional.

(Inherited from OrganizationRequest)
RequestName

Gets or sets the name of the request. Required, but is supplied by derived classes.

(Inherited from OrganizationRequest)
Target

Gets or sets the target for applying the rule.

Applies to