Share via


CreateActivitiesListRequest Class

Definition

Contains the data that is needed to create a quick campaign to distribute an activity to members of a list (marketing list).

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

Examples

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface instance. For the complete sample, see the link later in this topic.

/// <summary>
/// This method creates Quick Campaign for a given Marketing List and returns the 
/// ID of the Quick Campaign which is modelled as bulk operation in Dataverse
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance.</param>
/// <param name="activityEntity">
/// An object that indicates activity type for the quick campaign and 
/// contains values for each activity that will be created
/// </param>
/// <param name="marketingListId">
/// The ID of the marketing list to which quick campaign is distributed
/// </param>
/// <param name="ownershipOption">
/// Specifies who will own the activities created by the Quick Campaign
/// The PropagationOwnershipOptions enum is used to specify value for this parameter
/// </param>
/// <param name="isPropagate">
/// Specifies whether the operation is to be executed. 
/// This input is often 'true' for Quick Campaign
/// </param> 
/// <param name="ownerId">
/// Specifies the user to make the owner
/// </param>  
public static Guid CreateAndRetrieveQuickCampaignForMarketingList(
      IOrganizationService service,
      Entity letterActivityEntity,
      Guid marketingListId,
      PropagationOwnershipOptions ownershipOption,
      bool isPropagate,
      Guid ownerId)
{
      //Create the request object from input parameters
      CreateActivitiesListRequest request = new()
      {
         Activity = letterActivityEntity,
         ListId = marketingListId,
         OwnershipOptions = ownershipOption,
         Propagate = isPropagate,
         TemplateId = Guid.Empty,
         FriendlyName = "Quick Campaign for My List",
         Owner = new EntityReference("systemuser", ownerId),
         PostWorkflowEvent = true
      };

      //Execute the request
      CreateActivitiesListResponse response =
         (CreateActivitiesListResponse)service.Execute(request);

      // On executing the request a BulkOperation record would be created in Dataverse. 
      // If isPropagate is true, a corresponding Async job is also created which runs and creates the required activities 
      // The response has BulkOperationId. This is the Id of the bulkoperation that mimics QuickCampaign in Dataverse
      return response.BulkOperationId;
}

Remarks

This message requires Dynamics 365 Sales.

For the Web API use the CreateActivitiesList action.

Usage

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

Privileges and Access Rights

To perform this action, the caller must have privileges on the List, Queue, and Template tables and on the specified entity in the Activity property. The caller must also have access rights on the specified records in the ListId, QueueId, and TemplateId properties. The following privileges are required: prvAppendActivity, prvAppendToList, prvCreateActivity, and prvReadList.

Notes for Callers

This operation distributes activities that specify a recipient: a phone call, appointment, letter, fax, or email.

Constructors

CreateActivitiesListRequest()

Initializes a new instance of the CreateActivitiesListRequest class.

Properties

Activity

Gets or sets the activity to be distributed. Required.

ExtensionData

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

(Inherited from OrganizationRequest)
FriendlyName

Gets or sets a display name for the campaign. Required.

Item[String]

Gets or sets the indexer for the Parameters collection.

(Inherited from OrganizationRequest)
ListId

Gets or sets the ID of the list. Required.

Owner

Gets or sets the owner for the activity. Required.

OwnershipOptions

Gets or sets the propagation ownership options. Required.

Parameters

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

(Inherited from OrganizationRequest)
PostWorkflowEvent

Gets or sets a value that indicates whether an asynchronous job is used to distribute an activity, such as an email, fax, or letter, to the members of a list. Required.

Propagate

Gets or sets a value that indicates whether the activity is both created and executed. Required.

QueueId

Gets or sets the ID of the queue to which the created activities are added. Required.

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)
sendEmail

Gets or sets a value that indicates whether to send an email about the new activity. Required.

TemplateId

Gets or sets the ID of the email template. Required.

Applies to

See also