CreateActivitiesListRequest Class

Definition

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

Object

OrganizationRequest

CreateActivitiesListRequest

Attributes

DataContractAttribute

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

Properties

Applies to

See also

• CreateActivitiesListResponse