CreateEntityRequest Class

Definition

public ref class CreateEntityRequest sealed : Microsoft::Xrm::Sdk::OrganizationRequest

[System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/xrm/2011/Contracts")]
public sealed class CreateEntityRequest : Microsoft.Xrm.Sdk.OrganizationRequest

[<System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/xrm/2011/Contracts")>]
type CreateEntityRequest = class
    inherit OrganizationRequest

Public NotInheritable Class CreateEntityRequest
Inherits OrganizationRequest

Inheritance

Object

OrganizationRequest

CreateEntityRequest

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.

/// <summary>
/// Demonstrates creating a table
/// </summary>
/// <param name="service">Authenticated IOrganizationService instance</param>
static void CreateTable(IOrganizationService service) {

   string prefix = "sample";
   int languagecode = 1033; //English
   string tableSchemaName = $"{prefix}_BankAccount";
   string primaryNameColumnName = $"{prefix}_AccountName";
   string solutionUniqueName = "SolutionName";

   CreateEntityRequest request = new()
   {

      //Define the table
      Entity = new EntityMetadata
      {
            SchemaName = tableSchemaName,
            DisplayName = new Label("Bank Account", languagecode),
            DisplayCollectionName = new Label("Bank Accounts", languagecode),
            Description = new Label("An table to store information about customer bank accounts", languagecode),
            OwnershipType = OwnershipTypes.UserOwned,
            IsActivity = false,

      },

      // Define the primary name column for the table
      PrimaryAttribute = new StringAttributeMetadata
      {
            SchemaName = primaryNameColumnName,
            RequiredLevel = new AttributeRequiredLevelManagedProperty(AttributeRequiredLevel.None),
            MaxLength = 100,
            FormatName = StringFormatName.Text,
            DisplayName = new Label("Account Name", languagecode),
            Description = new Label("The primary column for the Bank Account table.", languagecode)
      },
      SolutionUniqueName = solutionUniqueName

   };
   var response = (CreateEntityResponse)service.Execute(request);

   Console.WriteLine($"Table ID:{response.EntityId}");
   Console.WriteLine($"Primary name column ID:{response.AttributeId}");
}

Output:

Table ID:ab84f688-a56f-ee11-8df0-000d3a993550
Primary name column ID:ac84f688-a56f-ee11-8df0-000d3a993550

Sample code on GitHub

Create and update table definitions

Remarks

Usage

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

Privileges and Access Rights

To perform this action, the caller must have the following privileges that are assigned to the System Administrator and System Customizer roles:

prvCreateEntity, prvCreateQuery, prvCreateSdkMessage, prvCreateSdkMessageProcessingStep, prvCreateSystemForm, prvReadCustomization, prvReadPluginType, prvReadQuery, prvReadSdkMessage, prvReadSystemForm, prvWriteQuery, prvWriteSystemForm

Constructors

Properties

Applies to

See also

• CreateEntityResponse