Class CreateRecordAction

Generic action for creating new entity records in the database. This action provides a flexible way to create records for any entity type by accepting the entity name and field values as parameters.

Example

// Create a new customer record
const result = await runAction({
  ActionName: 'Create Record',
  Params: [
    {
      Name: 'EntityName',
      Value: 'Customers'
    },
    {
      Name: 'Fields',
      Value: {
        Name: 'John Doe',
        Email: 'john@example.com',
        Status: 'Active'
      }
    }
  ]
});

// The PrimaryKey output parameter contains an object with the key field(s)
// For example: { CustomerID: '12345' }
const primaryKey = result.Params.find(p => p.Name === 'PrimaryKey')?.Value;

Hierarchy (View Summary)

BaseRecordMutationAction
- CreateRecordAction
  - CreateUserAction
  - CreateEmployeeAction

Index

Constructors

constructor

Methods

analyzeEntityError getEntityNameParam getEntityObject getFieldsParam getPrimaryKeyParam handleError InternalRunAction loadRecord Run setFieldValues

Constructors

constructor

new CreateRecordAction(): CreateRecordAction
Returns CreateRecordAction
Inherited from BaseRecordMutationAction.constructor

Methods

`Protected`analyzeEntityError

analyzeEntityError(
    entity: BaseEntity,
    operation: "delete" | "create" | "update",
    entityName: string,
): ActionResultSimple
Analyze error from entity save/delete operation and return appropriate result
Parameters
- entity: BaseEntity
- operation: "delete" | "create" | "update"
- entityName: string
Returns ActionResultSimple
Inherited from BaseRecordMutationAction.analyzeEntityError
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:175

`Protected`getEntityNameParam

getEntityNameParam(
params: RunActionParams,
): { error?: ActionResultSimple; value?: string }
Extract and validate the EntityName parameter
Parameters
- params: RunActionParams
Returns { error?: ActionResultSimple; value?: string }
Inherited from BaseRecordMutationAction.getEntityNameParam
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:16

`Protected`getEntityObject

getEntityObject(
    entityName: string,
    contextUser: any,
    provider?: IMetadataProvider,
): Promise<
    { entity?: BaseEntity; entityInfo?: any; error?: ActionResultSimple },
>
Get entity metadata and create entity object
Parameters
- entityName: string
- contextUser: any
- Optionalprovider: IMetadataProvider
Returns Promise<{ entity?: BaseEntity; entityInfo?: any; error?: ActionResultSimple }>
Inherited from BaseRecordMutationAction.getEntityObject
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:73

`Protected`getFieldsParam

getFieldsParam(
params: RunActionParams,
): { error?: ActionResultSimple; value?: Record<string, any> }
Extract and validate the Fields parameter
Parameters
- params: RunActionParams
Returns { error?: ActionResultSimple; value?: Record<string, any> }
Inherited from BaseRecordMutationAction.getFieldsParam
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:54

`Protected`getPrimaryKeyParam

getPrimaryKeyParam(
params: RunActionParams,
): { error?: ActionResultSimple; value?: Record<string, any> }
Extract and validate the PrimaryKey parameter
Parameters
- params: RunActionParams
Returns { error?: ActionResultSimple; value?: Record<string, any> }
Inherited from BaseRecordMutationAction.getPrimaryKeyParam
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:35

`Protected`handleError

handleError(e: any, operation: string): ActionResultSimple
Handle generic errors with consistent formatting
Parameters
- e: any
- operation: string
Returns ActionResultSimple
Inherited from BaseRecordMutationAction.handleError
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:222

InternalRunAction

InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>
Creates a new record for the specified entity type.
Parameters
- params: RunActionParams
  The action parameters containing:
  
  EntityName (required): The name of the entity to create
  
  Fields (required): Object containing field names and values to set
Returns Promise<ActionResultSimple>
ActionResultSimple with:
- Success: true if record was created successfully
- ResultCode: SUCCESS, FAILED, ENTITY_NOT_FOUND, VALIDATION_ERROR, PERMISSION_DENIED
- Message: Details about the operation
- Params: Output parameter 'PrimaryKey' contains an object with the primary key field(s) and value(s)
Overrides BaseRecordMutationAction.InternalRunAction
- Defined in Actions/CoreActions/src/custom/crud/create-record.action.ts:52

`Protected`loadRecord

loadRecord(
    entity: BaseEntity,
    entityInfo: any,
    primaryKey: Record<string, any>,
    entityName: string,
): Promise<{ error?: ActionResultSimple; success: boolean }>
Load an existing record using primary key
Parameters
- entity: BaseEntity
- entityInfo: any
- primaryKey: Record<string, any>
- entityName: string
Returns Promise<{ error?: ActionResultSimple; success: boolean }>
Inherited from BaseRecordMutationAction.loadRecord
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:108

Run

Run(params: RunActionParams): Promise<ActionResultSimple>
Executes the action with the provided parameters.
Parameters
- params: RunActionParams
  The action execution parameters including context
Returns Promise<ActionResultSimple>
Promise resolving to the action result
Inherited from BaseRecordMutationAction.Run
- Defined in Actions/Engine/dist/generic/BaseAction.d.ts:37

`Protected`setFieldValues

setFieldValues(
    entity: BaseEntity,
    fields: Record<string, any>,
    entityName: string,
): void
Set field values on an entity
Parameters
- entity: BaseEntity
- fields: Record<string, any>
- entityName: string
Returns void
Inherited from BaseRecordMutationAction.setFieldValues
- Defined in Actions/CoreActions/src/custom/crud/base-record-mutation.action.ts:162

Class CreateRecordAction

Example

Hierarchy (View Summary)

Index

Constructors

Methods

Constructors

constructor

Returns CreateRecordAction

Methods

ProtectedanalyzeEntityError

Parameters

Returns ActionResultSimple

ProtectedgetEntityNameParam

Parameters

Returns { error?: ActionResultSimple; value?: string }

ProtectedgetEntityObject

Parameters

Returns Promise<{ entity?: BaseEntity; entityInfo?: any; error?: ActionResultSimple }>

ProtectedgetFieldsParam

Parameters

Returns { error?: ActionResultSimple; value?: Record<string, any> }

ProtectedgetPrimaryKeyParam

Parameters

Returns { error?: ActionResultSimple; value?: Record<string, any> }

ProtectedhandleError

Parameters

Returns ActionResultSimple

InternalRunAction

Parameters

Returns Promise<ActionResultSimple>

ProtectedloadRecord

Parameters

Returns Promise<{ error?: ActionResultSimple; success: boolean }>

Run

Parameters

Returns Promise<ActionResultSimple>

ProtectedsetFieldValues

Parameters

Returns void

Settings

On This Page

`Protected`analyzeEntityError

`Protected`getEntityNameParam

`Protected`getEntityObject

`Protected`getFieldsParam

`Protected`getPrimaryKeyParam

`Protected`handleError

`Protected`loadRecord

`Protected`setFieldValues