Narrative

Miranda configured a FLEV widget to manage a Contacts entity. The widget obtains data from a RPC service and uses it to create a client-side recordset. The widget's DataForm component raises an insertEvent, updateEvent, or deleteEvent whenever the recordset is changed. But, the widget cannot update the original datasource without additional configuration.

To complete the DataForm configuration, Miranda updates the FLEV subclass constructor (MY.Contacts) to replace the onInsert, onUpdate, and onDelete methods with new functions that make RPC calls to update the database. Each function references a "onChangeReturn" method that displays a confirmation message and changes from the edit screen to the view screen.

If the RPC method fails, an internal handler automatically displays the failure message instead.

Goal

(Why does the component exist? What problem does it solve?)

Main Success Scenario (MSS)

Sample Code

MY.Contact = function() {
    MY.Contact.superclass.constructor.call(this);
    this.oColumnHeaders = [ // ...    
    this.oConfigs = { // ...
    this.oResponseSchema = { // ...
    this.sItemName = "last_name";

    this.onUpdate = function (oData,oSelf) {
        oValues = oData.oRecord;
        Facilities.rpc.update(oValues,oSelf.onChangeReturn).call(ANVIL.channel);
    };

    this.onChangeReturn = function(oData) {
        my.message(oData.result);
        _Self.exitEdit(); // Set by Contacts.html 
    };