Handling Form Data Submission

The most demanding usage of forms is to display data from the database and to post data in the database. This section explains about how to save form data in the database.

The following diagram illustrates the form data submission flow:

Creating JS listener class for the Form

When a form or form item action is triggered by the handlers, Canvas executes its corresponding actions registered with the global form listener key CFLR. This provides the freedom to the developer to write their action logic anywhere within their application.

It is best practice to keep the listener class files separated from the other action files. The structure of the JS listener class should be as follows:

canvas.ns("namespace ID");

<namespace ID>.sampleListener = Class(canvas.Observable, 
{
    constructor: function(config) 
	{
        this.fm = config.fm;
    },
    
	registerHandlers: function() 
	{
		this.fm.registerHandler(CFEC.PRE_INITIALIZE, function(fm) 
		{
		
		});
		
		this.fm.registerHandler(CFEC.POST_FORM_RENDERER, function(fm) 
		{
		
	    });
		
		this.fm.registerHandler(CFEC.PRE_MODEL_LOAD, function(fm, record) 
		{
        
      	});
	}
});

CFLR.registerListener("<FORM_ID>", <namespace ID>.sampleListener);

// Form Container Action button listener
CABR.registerHandler('ACTION_BUTTON_ID','CONTAINER_ID', function (config)
{  });

Create a listener payments.intertransfer.js as follows:

canvas.ns("payments");

payments.paymentForm = Class(canvas.Observable,
{ 
	constructor: function (config)
	{
		this.fm = config.fm;
	}, 

	registerHandlers: function()
	{ }
});

CFLR.registerListener("PAYMENT_FORM", payments.paymentForm); 

CABR.registerHandler('SUBMIT','PAYMENTS_CONTAINER', function (config)
{
	//Form submit action goes here
}); 

CABR.registerHandler('CLOSE','PAYMENTS_CONTAINER', function (config)
{
	CBXFORMCONTAINER.getActiveFormContainer().close();
});

View the following pages