वेब एप्लिकेशन और मेंटिसबीटी के बीच संचार

ग्राहकों से एप्लिकेशन को ट्रैक करने के लिए मेंटिस का उपयोग करने से अक्सर निम्न कठिनाइयों का सामना करना पड़ता है:
1) एक नया एप्लिकेशन जोड़ते समय, आपको मंटिस में ग्राहक के कार्ड से जानकारी का एक हिस्सा दर्ज करना होगा या कॉपी करना होगा, जो कि, सबसे पहले, आलस्य और दूसरा, संभवतः सूचना के विरूपण को जन्म दे सकता है।
2) इस ग्राहक के लिए पिछले अनुप्रयोगों को जल्दी से पढ़ना संभव नहीं है, सबसे पहले, क्योंकि आलस्य, और दूसरी बात, विकृत जानकारी के बारे में पैराग्राफ एक देखें।

इस समस्या को हल करने के लिए, हम मंटिस एपीआई - mantisconnect.php का उपयोग करेंगे।

शुरुआत

इस एपीआई का जिक्र हैबर और मंटिसबेट फोरम दोनों पर फिसल गया, लेकिन समस्या यह थी कि सभी वार्तालापों ने इस तथ्य पर ध्यान केंद्रित किया कि "सब कुछ सरल है", लेकिन मेरे लिए एक गैर-प्रोग्रामर के रूप में, यह समझना बहुत आसान नहीं था क्या शुरू करना है। आगे देखते हुए, मैं कह सकता हूं कि वहां सब कुछ वास्तव में सरल है, मैं इसके बारे में बात करने की कोशिश करूंगा।

मंटिस एपीआई एपीआई प्रोटोकॉल का उपयोग करता है। इसके साथ काम करने के लिए, हमें या तो एक बाहरी नुसैप लाइब्रेरी की आवश्यकता है, या आप मानक एक्सटेंशन php_soap का उपयोग कर सकते हैं। आप देख सकते हैं कि इस API में यहाँ क्या है:
http://www.mantisbt.org/bugs/api/soap/mantisconnect.php
http://www.mantisbt.org/bugs/api/soap/mantisconnect.php?wsdl

अब आइए जानें कि इस सारी दौलत का क्या किया जाए।

हमें एक php स्क्रिप्ट लिखने की आवश्यकता है जिसमें:
1) एक SOAP क्लाइंट बनाएं

$client = new nusoap_client($WSDL_POINT, false); 

$WSDL_POINT आपके ट्रैकर में mantisconnect.php के स्थान का url है, http: // [साइट] / aapi/soap/mantisconnect.php?wsdl

2) हमारे स्वार्थी उद्देश्यों के लिए बनाए गए ग्राहक का उपयोग करें। एक उदाहरण के रूप में, हम सबसे सरल फ़ंक्शन का उपयोग करते हैं - दृश्य संस्करण ( mc_version )

 $result = $client->call('mc_version', 'http://localhost/mantis/api/soap/mantisconnect.php', 'http://soap.amazon.com'); 

परिणाम बगट्रैकर के संस्करण के साथ एक पंक्ति होगा।

यदि हम किसी विशेष घटना के बारे में जानकारी प्राप्त करने की कोशिश करते हैं, तो हमें निम्नलिखित स्क्रिप्ट मिलती है:

 <?php require_once('nusoap-0.9.5/lib/nusoap.php'); $WSDL_POINT = "http://localhost/mantis/api/soap/mantisconnect.php"; $username = 'administrator'; $password = 'root'; $issue_id = 1; $params = array( 'username' => $username, 'password' => $password, 'issue_id' => $issue_id ); $client = new nusoap_client($WSDL_POINT, false); $result = $client->call('mc_issue_get', $params, 'http://localhost/mantis/api/soap/mantisconnect.php', 'http://soap.amazon.com'); echo "<pre>"; print_r ($result); echo "</pre>"; ?> 

$params इनपुट चर की एक सरणी है। एक घटना प्राप्त करने के लिए, जैसा कि एपीआई में वर्णन से देखा जा सकता है, हमें एक उपयोगकर्ता नाम, पासवर्ड और घटना संख्या चाहिए।

परिणाम इस घटना से संबंधित सभी आंकड़ों के साथ एक सहयोगी सरणी होगा। आप इसे print_r() फ़ंक्शन के साथ देख सकते हैं। हम एक सरणी के तत्वों के रूप में आवश्यक फ़ील्ड उठा सकते हैं।

यहां हम संभवतः एक समस्या का सामना कर सकते हैं - एक घटना के साथ एक सरणी के बजाय, एक त्रुटि के साथ एक सरणी हमारे पास आ सकती है:

 Array ( [faultcode] => Server [faultactor] => [faultstring] => Error Type: SYSTEM NOTICE, Error Description: Use of undefined constant ERROR_DUPLICATE_FILE - assumed 'ERROR_DUPLICATE_FILE',) 

समस्या तब दिखाई देती है जब उपयोगकर्ता खाते की सेटिंग्स जिसका उपयोगकर्ता नाम / पासवर्ड मंटिस के साथ "संवाद" करने के लिए उपयोग किया जाता है, भाषा सेटिंग्स अंग्रेजी के अलावा किसी भी भाषा को इंगित करती हैं। यह इस तथ्य के कारण है कि मंटिस में कोड को बदल दिया गया था, और स्थानीयकरण फ़ाइलों को ठीक नहीं किया गया था।

स्थिति को निम्नलिखित तरीकों से ठीक किया जा सकता है:

1) सेटिंग्स में अंग्रेजी भाषा सेट करें;
2) संस्करण 1.2.11 की प्रतीक्षा करें, जहां वे इसे ठीक करने का वादा करते हैं, या रात के निर्माण के लिए अपग्रेड करते हैं;
3) स्थानीयकरण फ़ाइल को ठीक करें / /lang/strings_russian.txt अपने आप को - एकल उद्धरणों में /lang/strings_russian.txt संलग्न करें।

अनुरोध बनाएँ

किसी घटना के साथ एक व्यूह का गठन करने के बाद, हम एक घटना बनाने के लिए एक ही रचना कर सकते हैं। इसके अलावा, वे फ़ील्ड जिन्हें आप आने वाले एरे में निर्दिष्ट नहीं करते हैं, वे स्वतः डिफ़ॉल्ट रूप से अपडेट हो जाएंगे।

मान लें कि ग्राहक के कार्ड से हमें एक एप्लिकेशन बनाने की आवश्यकता है:

1) उसका नाम;
2) लॉगिन करें।

साथ ही अपील का कारण।

हम लॉगिन को विशेष रूप से बनाए गए लॉगिन फ़ील्ड में डालेंगे।
हमें निम्न सरणी मिलती है:

 $issue_data = array( 'project' => array ( 'id' => 1 ), 'category' => "general", 'reporter' => array ( 'id' => $reporter_id ), 'summary' => $summary, 'description' => $description, 'custom_fields' => array ($sequence_login_field => array ( 'field' => array ( 'id' => $login_field_id ), 'value' => $login ), ) ); 

project_id = 1 - उस प्रोजेक्ट का आईडी जिसमें हम घटना को जोड़ रहे हैं
$reporter_id - हां, हम इस स्थान पर किसी भी उपयोगकर्ता को आसानी से स्थानापन्न कर सकते हैं, क्योंकि हमें पासवर्ड जानने की आवश्यकता नहीं है
सभी कर्मचारी
$summary - एक पूर्ण नाम और संभवतः अधिक शामिल हैं। जानकारी के
$description - संपर्क का कारण
$sequence_login_field, $login_field_id - $sequence_login_field, $login_field_id से प्राप्त करें
$login - ग्राहक कार्ड से ग्राहक लॉगिन

अगला, हमने इस सरणी को $ params में रखा

 $params = array( 'username' => $username, 'password' => $password, 'issue' => $issue_data ); 

और जहाज करने के लिए स्वतंत्र महसूस हो रहा है। जवाब में, बनाई गई घटना की संख्या हमारे पास वापस आ जाएगी।

घटना की जानकारी

जब हमारे पास सभी सृजित अनुप्रयोगों में ग्राहक का लॉगिन है (लॉगिन अद्वितीय है), ग्राहक के कार्ड को खोलते समय, हम मंटिस को एक और साबुन-अनुरोध कर सकते हैं, अर्थात् इस ग्राहक से संबंधित सभी घटनाओं को दिखाने के लिए एक खोज अनुरोध।

दुर्भाग्य से, ऐसा कोई अनुरोध नहीं है, जिससे आप मंटिस डेटाबेस में खोज कर सकें, लेकिन आप पहले से तैयार किए गए फ़िल्टर का उपयोग कर सकते हैं। मेरे मामले में, मैंने "बंद" को छोड़कर सभी स्थितियों के साथ 1000 घटनाओं के लिए एक फ़िल्टर बनाया और अंतिम घटना परिवर्तन के समय के आरोही क्रम में सॉर्ट किया।

 $params = array( 'username' => $username, 'password' => $password, 'project_id' => 1, 'filter_id' => $filter_id, 'page_number' => 1, 'per_page' => 100 ); 

नतीजतन, मैं 100 घटनाओं की एक सरणी स्वीकार करता हूं, और मैं केवल उन स्क्रीन पर प्रदर्शित कर सकता हूं जिनके लॉगिन इस क्लाइंट कार्ड में निर्दिष्ट एक से मेल खाते हैं।