Data Manager customization: addRecordAction

The addRecordAction allows you to override the core action logic for adding a record when a form is submitted. The core will have already checked permissions for adding records, but all other logic will be up to you to implement (including audit trails, validation, etc.).

The method is not expected to return a value and is provided with args.objectName. The expectation is that the method will redirect the user after processing the request.

For example:

// /application/handlers/admin/datamanager/blog.cfc

component {

	property name="blogService" inject="blogService";

	private void function addRecordAction( event, rc, prc, args={} ) {
		var formName         = "my.custom.addrecord.form";
		var formData         = event.getDataForForm( formName );
		var validationResult = validateForm( formName, formData );

		if ( validationResult.validated ) {
			var newRecordId = blogService.addBlog( argumentCollection=formData );

			setNextEvent( url=event.buildAdminLink(
				  objectName = "blog"
				, recordId   = newRecordId
			) );
		}

		var persist = formData;
		persist.validationResult = validationResult;

		setNextEvent( url=event.buildAdminLink(
			  objectName = "blog"
			, operation  = "addRecord"
		), persistStruct=persist );

	}

}

Info

If you wish to still use core logic for adding records but need to add additional logic to the process, use preAddRecordAction or postAddRecordAction instead.