Yii: वैधानिक रूप से सत्यापन नियम (स्क्रिप्ट) बदलें

इस छोटे से विषय में, मैं वाईआईआई ढांचे के संदर्भ में एक बहुत ही सरल नुस्खा (जो आप में से बहुत से लोग शायद जानते हैं) के बारे में बात करना चाहते हैं। यह फॉर्म वैलिडेशन नियमों को गतिशील रूप से बदलने की बात है - जब सत्यापन के नियम आपके आवेदन के उपयोगकर्ता की पसंद के आधार पर बदलते हैं, उदाहरण के लिए, किसी सूची या इंस्टॉल किए गए चेकबॉक्स से मूल्य चुनकर।

व्यावहारिक आवश्यकता ने मुझे एक वेब इंटरफेस के साथ एक सरल संपर्क केंद्र लिखते समय इस समाधान को लागू करने के लिए प्रेरित किया। उदाहरणों के साथ नहीं आने के लिए, मैं संक्षेप में उसी सीसी के उदाहरण का उपयोग करके इस नुस्खा के उपयोग की व्याख्या करूंगा। जैसा कि आप जानते हैं, केसी ऑपरेटरों की मुख्य गतिविधि ग्राहकों से कॉल प्राप्त करना और ग्राहकों को आउटगोइंग कॉल करना है। कॉल के परिणामों के आधार पर, ऑपरेटर को सिस्टम में कुछ डेटा दर्ज करना होगा - क्लाइंट के साथ बातचीत का परिणाम, जिसके आधार पर टिकट की स्थिति और इसके साथ काम करने के आगे के तर्क निर्धारित किए जाते हैं (बार-बार कॉल की नियुक्ति, किसी अन्य प्रक्रिया, टिकट बंद करना, आदि)। समस्या यह है कि कुछ प्रपत्र फ़ील्ड (पढ़ें - मॉडल विशेषताएँ) को "मूल" स्थिति के आधार पर भरा जाना चाहिए या रिक्त होना चाहिए। उदाहरण के लिए, यह स्पष्ट है कि "क्लाइंट के साथ बातचीत का परिणाम" फ़ील्ड को भरने का कोई मतलब नहीं है अगर कॉल की तकनीकी स्थिति "रीडियल / अमान्य नंबर" है (तकनीकी स्थिति ऑपरेटर द्वारा निर्धारित की जानी चाहिए, सिस्टम नहीं, क्योंकि कॉल हो सकती है, लेकिन कॉल प्राप्त करने वाला अचानक हो सकता है ग्राहक नहीं - संख्या में त्रुटि, आदि)। उसी समय, यदि तकनीकी स्थिति "सफल डायलिंग" सेट की जाती है, तो फ़ील्ड "क्लाइंट के साथ बातचीत का परिणाम" में भरना होगा। फिर से: बातचीत के परिणाम के आधार पर, अतिरिक्त फ़ील्ड भरना आवश्यक हो सकता है - उदाहरण के लिए, "कॉलबैक दिनांक" फ़ील्ड "कॉलबैक" स्थिति के साथ।

स्वाभाविक रूप से, मैं चाहूंगा कि फॉर्म के एक निश्चित क्षेत्र के मूल्य के आधार पर, पूरे फॉर्म के सत्यापन नियम भी बदल जाएं। व्यवहार में, यह कार्य उपयोग करना बहुत आसान है, लेकिन खदान जैसे मामलों में बहुत उपयोगी है।

तो:
1. हम कॉल फॉर्म के सत्यापन के लिए कई परिदृश्य बनाते हैं।
सबसे पहले, उन क्षेत्रों के लिए नियम बनाएं जो सभी परिदृश्यों में आवश्यक हैं:

public function rules(){ //... array('call_status', 'required', 'on'=>'callSubmit, invalidNumberSubmit, validCallSubmit, successCallSubmit...' //... 'message'=>' "{attribute}"    .'), } 

मुझे लगता है कि पहला नियम सवाल नहीं उठाता है - कॉल की तकनीकी स्थिति फॉर्म में शीर्ष स्तर का मूल्य है - यह किसी भी परिदृश्य में आवश्यक है।
हम सामान्य से विशेष तक जाना जारी रखते हैं:

 //.. Inside rules() method array('talk_status', 'required', 'on'=>'successCallSubmit, secondCall,...') /*   ,        */ 

अगला, हम अधिक विशेष मामलों के लिए नियमों को परिभाषित करते हैं:

 //.. Inside rules() method array('new_call_date', 'required', 'on'=>'secondCall') /*     " "*/ 

इस प्रकार, हम सभी आवश्यक सत्यापन नियमों से गुजर सकते हैं - सामान्य मामलों में और प्रत्येक विशेष मामले में। यह मामला छोटा है: सुनिश्चित करें कि सत्यापन नियम फार्म में चयनित मूल्यों के आधार पर बदलते हैं। जैसा कि आप शायद पहले से ही अनुमान लगा चुके हैं, हम इसके लिए CActiveForm का उपयोग करेंगे, क्योंकि बॉक्स से बाहर यह विजेट सरल और स्पष्ट अजाक्स सत्यापन की अनुमति देता है।
आइए उदाहरण के लिए एक सरल फ़ॉर्म बनाएँ:

  <?php $form=$this->beginWidget('CActiveForm', array( 'id'=>'call-submit-form', 'enableAjaxValidation'=>true, 'clientOptions'=>array( 'validateOnChange'=>true, 'validateOnSubmit'=>true ), //   )); ?> 

जिन विकल्पों में हम रुचि रखते हैं, उनमें से हमें निम्नलिखित पर ध्यान देना चाहिए: 'enableAjaxValidation', 'validateOnChange', 'validateOnSubmit'। मेरा मानना ​​है कि इन विकल्पों का उद्देश्य सवाल नहीं उठाता है और उनके नामों से स्पष्ट है। हम करने के लिए जारी:

 <div class='control-group'> <?php echo $form->labelEx($model,'call_status'); ?> <?php echo $form->dropDownList($model,'call_status', CHtml::listData( CallStatuses::model()->findAll(),'id','title' ) ); ?> <?php echo $form->labelEx($model,'talk_status'); ?> <?php echo $form->dropDownList($model,'talk_status', CHtml::listData(TalkStatuses::model()->findAll(),'id','title' ), )); ?> <?php echo $form->error($model,'call_status'); ?> <?php echo $form->error($model,'talk_status'); ?> </div> <div class='control-group'> <?php echo $form->label($model,'new_call_date'); ?> <?php //     $this->widget('zii.widgets.jui.CJuiDatePicker', array( 'attribute'=>'new_call_date', 'model'=>$model, //... ), )); ?> </div> 

मैं आपको बड़ी संख्या में फ़ील्ड्स से बोर नहीं करूंगा, मुझे लगता है कि तीन उदाहरण के लिए पर्याप्त हैं। हमारे लिए यह सब करने के लिए वास्तव में गतिशील रूप से बदलते सत्यापन नियमों (पढ़ें - स्क्रिप्ट) के लिए कार्यक्षमता को लागू करना है।

वास्तव में, यह कार्यक्षमता सबसे सरल तर्क पर आधारित है: आपको प्रत्येक फ़ील्ड मान को एक स्क्रिप्ट असाइन करने की आवश्यकता होती है जो इस मान को चुनने के बाद फ़ॉर्म को मान्य करेगा (इस मामले में, जब CActiveForm :: dropDadList () विधि) द्वारा बनाई गई सूची से एक मान का चयन करना होगा। यह एक बहुत ही सरल समाधान है, और मैं विवरणों पर ध्यान केंद्रित नहीं करूंगा और ओओपी तरीके से कार्यान्वयन बनाऊंगा, क्योंकि मुख्य बात यह है कि विचार व्यक्त करना है।

इसके बजाय, सादगी के लिए, मैंने उचित कोड को सीधे नियंत्रक वर्ग के performAjaxValidation () विधि में डाल दिया। नीचे मानक PerformAjaxValidation () विधि और विधि के लिए थोड़ा संशोधित कोड दिया गया है:

 //Inside controller public function actionSaveCall(){ /*     'callSubmit',       - 'call_status' -   . */ $model=new Calls('callSubmit'); $this->performCallAjaxValidation($model); if( isset($_POST['Calls']) ) { $model->attributes = $_POST['Calls']; if( $model->save() ) $this->redirect( Yii::app()->user->returnUrl ); } } protected function performAjaxValidation($model) { if(isset($_POST['ajax']) && $_POST['ajax']==='calls-form') { $callStatusesScenarios = array( Calls::CALL_FAIL=>'validCallSubmit', Calls::SUCCESS_CALL=>'successCallSubmit', Calls::WRONG_NUMBER=>'invalidNumberSubmit'); if( !empty($_POST['Calls']['call_status']) && !empty( $callStatusesScenarios[ $_POST['Calls']['call_status'] ] ) ){ $model->setScenario ( $callStatusesScenarios[ $_POST['Calls']['call_status'] ] ); } echo CActiveForm::validate($model); Yii::app()->end(); } } 

जैसा कि आप कोड से देख सकते हैं, मैं जो कुछ भी करता हूं वह केवल 'call_status' फ़ील्ड के मान के आधार पर स्क्रिप्ट को बदलना है। अब, यदि ऑपरेटर प्रपत्र में "सफल डायलर" डायलर स्थिति का चयन करता है, तो सत्यापन के दौरान मॉडल परिदृश्य 'सक्सेसकॉलसुबमिट' में बदल जाता है, जो अब फॉर्म से बातचीत की स्थिति की उम्मीद करता है - परिणामस्वरूप, "सफल डायलर" का चयन करके, ऑपरेटर अब फॉर्म सबमिट नहीं कर पाएगा। जब तक यह वार्तालाप परिणाम फ़ील्ड को पूरा नहीं करता है। उसी समय, यदि डायलर की स्थिति "गलत संख्या" है, तो फॉर्म बिना किसी अतिरिक्त फ़ील्ड के सबमिट किया जाएगा। एक ही सिद्धांत को आगे भी लागू किया जा सकता है - बातचीत की स्थिति और उनके अतिरिक्त क्षेत्र इत्यादि के साथ।

इस दृष्टिकोण का अनुप्रयोग उन स्थितियों में उपयोगी होगा जहां भरने के लिए आवश्यक फ़ील्ड की संख्या और प्रकार उपयोगकर्ता की पसंद के आधार पर भिन्न होंगे। मैं छोटी सज़ा के लिए माफी माँगता हूँ, और मैं आपको अद्भुत Yii ढांचे के विकास में सफलता की कामना करता हूँ।