基於氚雲平台的應用開發學習(二)

在氚雲中要想實現表單某個功能，第一個方法可以通過平台自己本身就有的“控件屬性”與“表單屬性”，這個方法非常方便簡單高效，但也有它的局限性，較復雜的功能無法實現，適用於對代碼不了解或不熟悉人員。第二個方法可以通過代碼實現，較於前者可以實現復雜的邏輯或功能。第一個方法，可以實現的功能包括有篩選值范圍限定、自動填充其它控件(本身是關聯表單才可填充)、計算公式、表單提交檢驗、業務規則(對其它表單增刪改查等，有些需設置條件)等等。第二個方法，可以實現的功能有打開其它表單並傳入數據、后台定時服務、操作流程運轉、綁定控件變化事件、設置提交表單后事件(當一個表單提交后首先會觸發業務規則，比如新增其它表單，再執行提交后事件，比如修改其他表單數據或狀態)等等。

下面圍繞第二個方法記錄說明一下自己遇到的問題以及解決方法。

一、控件取值、賦值、變更綁定等

二、表單提交檢驗，彈出提示信息

三、打開其它表單並傳數據

四、前端操作子表

五、前端調用后台業務邏輯

 

var enviroment = $.SmartForm.ResponseContext; //獲取當前對象環境變量

enviroment.FormMode;  //表單模式，值為1表示生效狀態，值為0表示編輯狀態

enviroment.ActivityCode;  //流程環節,值是流程設計中流程對應的節點編碼

enviroment.BizObjectId;  //當前表單ID，可用於在后端sql中查詢數據

詳細了解可訪問：氚雲社區

 

一、控件取值、賦值、變更綁定等

this.BuyApply.GetValue(); 

//取值，這里BuyApply是圖形設計中對應控件的編碼（下同）

this.BuyApply.SetValue();   

//賦值

this.BuyApply.BindChange( "Test", function( data ) {   

　　//執行xxx事件

});

//變更綁定

this.BuyApply.SetVisible( false );

//隱藏，顯示反之參數為true

this.BuyApply.SetReadonly( true );

//只讀

var detailsList = this.D000399RhyjRuleDetails01.GetValue();
for( var i = 0;i < detailsList.length;i++ ) {
    var cell1 = this.D000399RhyjRuleDetails01.GetCellManager( detailsList[ i ].ObjectId, "D000399RhyjRuleDetails01.FormName" );
    cell1.SetReadonly( true );
}

//子表控件設置只讀

 

二、表單提交檢驗，彈出提示信息

// 提交校驗
OnValidate: function( actionControl ) {
　　var _this = this;
　　var flag = true;

　　//校驗訂單編號
　　var value = _this.No.GetValue();
　　if( value.length > 12 ) {
　　　　$.IShowWarn( "提示：訂單編號長度不得多於12位" );
　　　　flag = false;
　　} else if( value.length < 6 ) {
　　　　$.IShowWarn( "提示：訂單編號長度不得低於6位！" );
　　　　flag = false;
　　} else {
　　　　var lastSix = value.substr( value.length - 6 );
　　　　if( isNaN( lastSix ) ) {
　　　　　　$.IShowWarn( "提示：訂單編號后6位不是數字！" );
　　　　　　flag = false;
　　　　}
　　}
　　return flag;
},

 

彈出信息成功、提示、錯誤、警告方法分別對應：$.IShowSuccess();　　$.IShowTip();　　$.IShowError();　　$.IShowWarn();

 

三、打開其它表單並傳數據

 

var params = { BuyApply: $.SmartForm.ResponseContext.BizObjectId, ApplyDetail: outData.ReturnData };
$.IShowForm( "D000399SgPurchaseOrder", null, params );

這里params是傳遞的參數，里面是鍵值對，$.SmartForm.ResponseContext.BizObjectId是當前表單的ID，outData.ReturnData是通過ajax請求后端並查詢數據庫得到的返回值，可以根據自己需求定義傳遞的參數。D000399SgPurchaseOrder是打開表單的編碼，下面是這個表單怎么接收參數並填入對應控件中。

 

//接受采購申請數據
if( $.IGetParams( "BuyApply" ) != null ) {
    _this.BuyApply.SetValue( $.IGetParams( "BuyApply" ) );
    _this.BuyApply.SetReadonly( true );
    _this.State.SetReadonly( true );
    var controlManager = _this.D000399SgOrderDetails;
    //接受采購申請子表列表傳遞的參數
    if( $.IGetParams( "ApplyDetail" ).length != 0 ) {
        console.log( $.IGetParams( "ApplyDetail" ) );
        var length1 = Object.keys( $.IGetParams( "ApplyDetail" ).dicts1 ).length;
        var i = 0;
        if( length1 > 0 ) {
            controlManager.ClearRows();  
        }
        for( var key in $.IGetParams( "ApplyDetail" ).dicts1 ) {
            if( ++i > length1 ) {
                break;
            }
            var subObjectId = $.IGuid();
            var subObject = $.IGetParams( "ApplyDetail" ).dicts1[ key ];
            controlManager.AddRow( subObjectId, {
                "D000399SgOrderDetails.ControlCatalogue": subObject.ControlCatalogue,
                "D000399SgOrderDetails.No": subObject.No,
                "D000399SgOrderDetails.MaterialName": subObject.MaterialName,
                "D000399SgOrderDetails.Type": subObject.Type,
                "D000399SgOrderDetails.Unit1": subObject.Unit1,
                "D000399SgOrderDetails.Num1": subObject.Num3,
                "D000399SgOrderDetails.Node": subObject.Node1
            });
        }
    }
}

var controlManager = _this.D000399SgOrderDetails;  //獲取當前表單中子表對象

controlManager.ClearRows();  //清空子表行

var subObjectId = $.IGuid();  //子表每一行數據都有一個唯一的ID，這里是隨機生成一個ID

var subObject = $.IGetParams( "ApplyDetail" ).dicts1[ key ];  //獲取參數ApplyDetail中的所有鍵

controlManager.AddRow( subObjectId, {   //根據上方生成的ID，添加子表行

});

"D000399SgOrderDetails.ControlCatalogue": subObject.ControlCatalogue; //根據鍵取值，並賦值給子表對應控件

上述是在表單中打開另一個表單，下面是在列表中打開另一個表單，代碼是在列表設計中。

var objects = $.ListView.GetSelected();
if( objects == null || objects == undefined || objects == "" ) {
    $.IShowWarn( "提示：請選擇！" );
    return;
}
if( objects.length > 1 ) {
    $.IShowWarn( "提示：只能選擇一條記錄！" );
    return;
}
if( objects[ 0 ].Status != 1 ) {
    $.IShowWarn( "提示：當前開票通知流程未結束！" );
    return;
}


if( actionCode == "ToD000399SgContractInvoice" ) {
    var params = { ObjectId: objects[ 0 ].ObjectId };
    $.IShowForm( "D000399SgContractInvoice", null, params );
}

var objects = $.ListView.GetSelected();　　//獲取選中行

actionCode == "ToD000399SgContractInvoice"　　//列表中自定義的按鈕

objects[ 0 ].ObjectId;　//選中第一條行的ID


四、前端操作子表

常見的有子表綁定添加行、綁定某一列變化事件、數據寫入子表、更新子表、清空子表等。

var _this = this;
//采購訂單明細子表綁定添加行事件
this.D000399SgOrderDetails.BindChange( "JudgeLine", function( changeRow ) {
    if( changeRow[ 1 ] == "add" ) {
        //若對應采購申請不為空，則檢查子表行數
        if( _this.BuyApply.GetValue() != "" ) {
            var LineNum;
            var dataParas = { BuyApply: _this.BuyApply.GetValue() };
            $.SmartForm.PostForm(
                "GetLine",
                dataParas,
                function( outData ) {
                    LineNum = parseInt( outData.Message );
                },
                function( outData ) {
                    $.IShowWarn( outData );
                }, false )

            var detailsList = _this.D000399SgOrderDetails.GetValue();
            if( detailsList.length > LineNum ) {
                $.IShowWarn( "提示：當前明細數量不得多於采購申請明細數量！" );
            }
        }
    }
});

上述代碼是綁定添加行，當點擊添加子表按鈕時，會根據主表控件中對應的采購申請，去后端查詢它明細的條數，當采購訂單明細條數多於采購申請的明細條數，彈窗警告。

var _this = this;
//判斷倉庫物料目錄是否存在
this.D000399SgOrderDetails.BindChange( "SonTable1", function( data ) {
    var responseData = data[ 0 ];
    var currentRowId = data[ 0 ].ObjectId; //獲取行ID
    if( responseData != null && responseData.DataField == "D000399SgOrderDetails.ControlCatalogue" )   //觸發變更的列
    {
        if( responseData.GetValue() != "" && _this.BuyApply.GetValue() != "" ) {
            var dataParas = { ControlCatalogue: responseData.GetValue(), BuyApply: _this.BuyApply.GetValue() }; //傳遞的參數
            $.SmartForm.PostForm(
                "JudgeExit",
                dataParas,
                function( outData ) {
                    if( outData.Message != "" ) {
                        $.IShowWarn( "提示：對應采購申請不存在該倉庫物料目錄！" );
                        _this.D000399SgOrderDetails.UpdateRow( currentRowId, {
                            "D000399SgOrderDetails.ControlCatalogue": ""
                        });
                    }
                },
                function( outData ) {
                    $.IShowWarn( outData );
                }, false )
        }
    }
});

上述代碼是綁定某一列變化事件，當寫入倉庫物料目錄后，會根據主表控件中對應的采購申請，去后端查詢它明細中是否存在該倉庫物料目錄，若沒有則清空已填入的數據，並彈窗警告。其中responseData.GetValue();就是當前寫入的倉庫物料目錄值，這里也涉及到了更新子表操作。

數據寫入子表、更新子表、清空子表等功能，均在上面代碼中能找到，總之先需要生成或獲得每一條行數據的ID，然后再根據ID去填寫數據或更新數據，這里不贅述。

 

五、前端調用后台業務邏輯

調用后端代碼，還是通過常見的ajax請求的方式，后續這種方法可能會移除。這里通過一個簡單的功能說明一下。

var _this = this;
var dataParas = {};
$.SmartForm.PostForm(
    "ReadMax",
    dataParas,
    function( outData ) {
        _this.No.SetValue( outData.Message );
    },
    function( outData ) {
        $.IShowWarn( outData );
    }, false )

上述代碼，前端首先定義請求的名稱，以及傳入的參數，並將返回的數據填入對應控件。

public class D000399SgArMarginContract: H3.SmartForm.SmartFormController
{
    public D000399SgArMarginContract(H3.SmartForm.SmartFormRequest request): base(request)
    {

    }

    protected override void OnLoad(H3.SmartForm.LoadSmartFormResponse response)
    {
        base.OnLoad(response);
    }

    
    protected string ReadMax() {
        return "000001";    //這里也可以查詢數據庫，根據上一條記錄編號，來自定義返回的編號
    }

    protected override void OnSubmit(string actionName, H3.SmartForm.SmartFormPostValue postValue, H3.SmartForm.SubmitSmartFormResponse response)
    {
        if(actionName == "ReadMax")
        {
            string newString = ReadMax();
            response.Message = newString;
        }
        base.OnSubmit(actionName, postValue, response);
    }
}

上述代碼是后端代碼，根據前端請求的名稱與參數，自定義返回的值。

 

 

 

至此是對氚雲部分功能的一個簡單介紹，后續會繼續說明其它部分功能所遇到的問題以及解決方法。

如有疏漏錯誤之處，還請不吝賜教！