हम Bitrix24 में व्यावसायिक प्रक्रियाओं के लिए माइग्रेशन कैसे सेट करते हैं

अपने कार्यों को स्वचालित करने के लिए, व्यवसाय अक्सर Bitrix24 का उपयोग करता है। इस लेख में, हम व्यापार प्रक्रियाओं को बदलते समय कुछ संभावित समस्याओं के बारे में बात करते हैं और हमने उन्हें कैसे हल किया।



Bitrix24 आम सीआरएम सिस्टम में से एक है। इसमें व्यवसाय प्रक्रिया आरेख के निर्माण के लिए एक दृश्य डिजाइनर (डिजाइनर) शामिल है। यह याद रखना महत्वपूर्ण है कि इन प्रक्रियाओं को संपादित करते समय, कठिनाइयां संभव हैं - विशेष रूप से बड़ी मौजूदा परियोजनाओं पर, जहां किसी भी परिवर्तन को पहले स्थानीय और परीक्षण सर्वर पर जांचा जाता है। ऐसे मामलों में, जब उत्पादन में स्थानांतरित किया जाता है, तो हम व्यवसाय प्रक्रिया माइग्रेशन तंत्र (इसके बाद - बीपी) का उपयोग करते हैं।

छोटी कंपनियां, एक नियम के रूप में, प्रवास के बिना कर सकती हैं और बस 2-3 दिनों के लिए एक विशेष व्यवसाय प्रक्रिया को निलंबित कर सकती हैं। एक बड़ा व्यवसाय आमतौर पर इसे बर्दाश्त नहीं कर सकता है, इसलिए यह परीक्षण सर्वर और तैनाती का उपयोग करता है।



एक व्यापार प्रक्रिया टेम्पलेट कैसे काम करता है, इस पर Bitrix24

प्रवास के साथ काम करने की अपनी विशेषताएं हैं। विशेष रूप से, यह बड़ी संख्या में शामिल वस्तुओं और आईडी से जटिल है। इसके अलावा, Bitrix24 व्यवसाय प्रक्रियाओं के प्रवास के लिए भी प्रदान नहीं करता है जैसे - अक्सर यह समस्या आयात और निर्यात के माध्यम से हल की जाती है, और विभिन्न विसंगतियां हो सकती हैं। आइए विचार करें कि विकास के दृष्टिकोण से एक ही समय में क्या समस्याएं संभव हैं।

व्यावसायिक प्रक्रिया टेम्पलेट खोजने में समस्या

व्यवसाय प्रक्रिया बनाते समय, आप केवल टेम्पलेट को एक नाम निर्दिष्ट कर सकते हैं, एक अद्वितीय कोड नहीं। इस मामले में, किसी व्यावसायिक प्रक्रिया को अपडेट करते समय, इसे डेटाबेस से नाम से प्राप्त करना होगा। नाम कभी-कभी बदल जाते हैं क्योंकि सिस्टम उन्हें स्टार्टअप पर प्रक्रियाओं की सूची में प्रदर्शित करने के लिए उपयोग करता है। तदनुसार, ऐसी स्थितियां हो सकती हैं जब उन्नयन के दौरान एक टेम्पलेट ढूंढना असंभव होगा। और सामान्य तौर पर, नाम से खोज करना इतना अच्छा विचार नहीं है।

समाधान:

सिस्टम में बनाए गए सभी व्यवसाय प्रक्रिया टेम्पलेट b_bp_workflow_template तालिका में संग्रहीत किए जाते हैं। हमने उन क्षेत्रों के बीच तालिका खोली है, जिन्हें हम SYSTEM_CODE देखते हैं: कोड के लिए एक फ़ील्ड है, यह बस इंटरफ़ेस के लिए आउटपुट नहीं है। हम स्वयं टेम्प्लेट आईडी का उपयोग करके कोड सेट कर सकते हैं - इसे प्रक्रिया संपादन पृष्ठ पर url में देखा जा सकता है:



हमें टेम्प्लेट और कोड की आईडी प्राप्त करने के लिए एक फ़ंक्शन बनाने की आवश्यकता है, डुप्लिकेट के लिए एक चेक का संचालन करें और टेम्प्लेट को बदलने के लिए फ़ील्ड की पूर्णता, और इसके कोड को भी सेट करें।

use Bitrix\Main\Loader; Loader::includeModule("bizproc"); $BPloader = CBPWorkflowTemplateLoader::GetLoader(); // set template CODE field setTemplateCode ($BPloader, 'TEST', '94' ); function setTemplateCode($BPloader, $code, $tempalteId) { if (isCodeExists($BPloader, $code)) { die('   '); } if (!isCodeEmpty($BPloader, $tempalteId)) { die('     ') } $BPloader->UpdateTemplate($tempalteId, ['SYSTEM_CODE' => $code]); } // check if $code exists in DB function isCodeExists($BPloader, string $code) { $dbRes = $BPloader->GetTemplatesList( $arOrder = ['ID' => 'DESC'], $arFilter = ['CODE' => $code], $arGroupBy = false, $arNavStartParams = false, $arSelectFields = ['ID'] ); if (intval($dbRes->SelectedRowsCount()) > 0) { return true; } return false; } // check if the template code is not empty function isCodeEmpty($BPloader, $tempalteId) { $dbRes = $BPloader->GetTemplatesList( $arOrder = ['ID' => 'DESC'], $arFilter = ['CODE' => '', 'ID' => $tempalteId], $arGroupBy = false, $arNavStartParams = false, $arSelectFields = ['ID'] ); if (intval($dbRes->SelectedRowsCount()) > 0) { return false; } return true; } return true; } 

आगे बढ़ो। उदाहरण के लिए, सूचियों पर एक परीक्षण व्यवसाय प्रक्रिया बनाएं:



परीक्षण सर्वर (और फिर उत्पादन) के लिए स्थानीय रूप से विकसित प्रक्रिया को स्थानांतरित करने के लिए, हम माइग्रेशन तंत्र का उपयोग करते हैं।

Bitrix24 आपको एक व्यावसायिक प्रक्रिया का निर्यात करने की अनुमति देता है। हम इस अवसर का उपयोग करेंगे।



स्थानांतरण योजना इस प्रकार है:

• एक व्यापार प्रक्रिया का निर्यात करना
• हम माइग्रेशन लिखते हैं, फ़ाइल संलग्न करते हैं
• नए स्टैंड पर, हम पुरानी प्रक्रिया का बैकअप लेते हैं
• माइग्रेशन लागू करें

अगला, विचार करें कि यह प्रक्रिया कैसे होती है।

प्रवास बनाएँ

हम बाजार से माइग्रेशन मॉड्यूल का उपयोग करेंगे: https://marketplace.1c-bitrix.ru/solutions/ws.migrations/ ।

हमारी परियोजना में माइग्रेशन फ़ाइलें स्थानीय / माइग्रेशन / परिदृश्यों पर स्थित हैं




प्रक्रिया टेम्पलेट पृष्ठ खोलें और निर्यात करें। माइग्रेशन डायरेक्टरी के अंदर, फाइल्स डायरेक्टरी बनाएं और एक्सपोर्ट की हुई फाइल को वहां रखें। यह इस तरह से निकला:

स्थानीय / माइग्रेशन / परिदृश्य / फाइलें / bp-94.bpt

माइग्रेशन परिदृश्य बनाएँ:

 class ws_m_1565783124_approve_task extends \WS\Migrations\ScriptScenario { 

व्यापार प्रक्रिया टेम्पलेट के मापदंडों को परिभाषित करें:

 class ws_m_1565783124_approve_task extends \WS\Migrations\ScriptScenario { private $arBPFields = [ 'DOCUMENT_TYPE' => [ 'lists', 'BizprocDocument', 'iblock_' ], 'AUTO_EXECUTE' => 0, 'NAME' => ' ', 'CODE' => 'TEST', ]; 

हम व्यापार प्रक्रिया के आयात समारोह को लागू करते हैं:

 private function importBP($path) { CModule::IncludeModule('bizproc'); CModule::IncludeModule('iblock'); //Get iBlock id for which BP is created $this->arBPFields['DOCUMENT_TYPE'][2] .= $this->getIblockId(); // Get BP id by the CODE $result = \CBPWorkflowTemplateLoader::GetList( [], [ 'CODE' => $this->arBPFields['CODE'], 'MODULE_ID' => 'lists' ] ); if ($arFields = $result->GetNext()) { $id = $arFields['ID']; } else { $id = 0; } //read file to a variable $f = fopen($path, 'rb'); $datum = fread($f, filesize($path)); fclose($f); //Update BP if id>0, otherwise add BP \CBPWorkflowTemplateLoader::ImportTemplate( $id, $this->arBPFields['DOCUMENT_TYPE'], $this->arBPFields['AUTO_EXECUTE'], $this->arBPFields['NAME'], '', $datum, $this->arBPFields['CODE'] ); return $arFields['ID']; } 

यहां, हम पहले उस सूचना ब्लॉक की आईडी निर्धारित करते हैं जिसके लिए हम प्रक्रिया को लागू कर रहे हैं, और दिए गए कोड के साथ प्रक्रिया टेम्पलेट की आईडी प्राप्त करते हैं।

यदि टेम्पलेट पाया जाता है, तो हम इसे अपडेट करते हैं। अगर नहीं मिला - जोड़ें।
फ़ंक्शन निर्मित या अद्यतन प्रक्रिया की आईडी लौटाता है, और इसके लिए क्या आवश्यक है - हम आगे बताएंगे।

हम एक प्रतिबद्ध फ़ंक्शन को परिभाषित करते हैं जो हमारी व्यावसायिक प्रक्रिया को जोड़ेगा / अपडेट करेगा:

 public function commit() { $pathBPElement = __DIR__ . '/files/bp-94-approve-task.bpt'; $id = $this->importBP($pathBPElement); } 

इसलिए, इस कदम पर हम पहले से ही माइग्रेशन मॉड्यूल के माध्यम से एक विशिष्ट व्यवसाय प्रक्रिया बनाने और अपडेट करने में सक्षम हैं।

टेम्प्लेट डेटा अपडेट करने में समस्या

आइए अपनी व्यावसायिक प्रक्रिया पर वापस जाएं और वहां एक क्रिया जोड़ें - उपयोगकर्ता अधिसूचना।



प्रेषक के रूप में हम लेखक का चयन करते हैं। प्राप्तकर्ता करेंगे:

• एचआर उपयोगकर्ता समूह
• उपयोगकर्ता स्वेतलाना कुज़नेत्सोवा

अब देखते हैं कि डेटाबेस में व्यावसायिक प्रक्रिया कैसे दर्ज की जाती है। ऐसा करने के लिए, हम व्यवस्थापक पैनल में PHP कंसोल में टेम्पलेट प्राप्त करते हैं और प्रिंट करते हैं:

 $arFieldsTemplate = \CBPWorkflowTemplateLoader::GetList([], ['ID' => 94])->GetNext(); echo '<pre>'; var_dump($arFieldsTemplate); 

प्रक्रिया मापदंडों के सरणी में, हम इन घटनाओं को देखते हैं:



हम लाइन group_g15 को देखते हैं। यहां 15 एचआर ग्रुप आईडी है।
हम लाइन user_579 को देखते हैं। यहां 579 यूजर आईडी है।

इसका मतलब है कि यदि हम किसी अन्य साइट पर प्रक्रिया आयात करते हैं, तो हमारे पास निरंतर असंगतताएं होंगी।

इस प्रकार हमें इन आईडी को माइग्रेट करने के बाद एक प्रतिस्थापन करने की आवश्यकता है जो उस साइट के लिए प्रासंगिक हैं जहां हम प्रक्रिया आयात कर रहे हैं।

समूहों को प्रतीकात्मक कोड, उपयोगकर्ताओं द्वारा लॉगिन द्वारा पहचाना जाता है।

शुरू करने के लिए, उस साइट पर जहां प्रक्रिया बनाई गई थी, हम समूह का प्रतीकात्मक कोड और उपयोगकर्ता लॉगिन प्राप्त करते हैं। इस घटना में कि आपके पास प्रतीकात्मक समूह कोड सेट नहीं हैं, माइग्रेशन लिखना और उन्हें पहले स्थापित करना बेहतर है।

हमारे उदाहरण में:

• समूह कोड - एचआर
• उपयोगकर्ता लॉगिन - svetlana.kuznetsova

अगला, हम माइग्रेशन फ़ंक्शंस में लिखते हैं जो कोड और लॉगिन द्वारा, हमें समूह और उपयोगकर्ता की आईडी देगा:

• getUserId ($ लॉगिन)
• getGroupId ($ कोड);

अंत में, टेम्पलेट में उपयुक्त मानों को अपडेट करें:

 /** * Write action by apply scenario. Use method `setData` for save need rollback data **/ public function commit() { 

एक व्यापार प्रक्रिया आयात करें:

 $pathBPElement = __DIR__ . '/files/bp-94-approve-task.bpt'; $id = $this->importBP($pathBPElement); 

हमें टेम्पलेट डेटा मिलता है:

 $arFieldsTemplate = \CBPWorkflowTemplateLoader::GetList([], ['ID' => $id])->GetNext(); $template = $arFieldsTemplate["TEMPLATE"]; 

व्यवसाय प्रक्रिया के अंदर उपयोगकर्ता आईडी बदलें:

 $template[0]['Children'][0]['Properties']["MessageUserTo"][0] = 'group_g' . $this->getGroupId('HR'); $template[0]['Children'][0]['Properties']["MessageUserTo"][1] = 'user_' . $this->getUserId('svetlana.kuznetsova'); $arNewFields = [ “TEMPLATE” => $template, “VARIABLES” => $arFieldsTemplate["VARIABLES"] ]; $arNewFields["MODIFIER_USER"] = new \CBPWorkflowTemplateUser(CBPWorkflowTemplateUser::CurrentUser); \CBPWorkflowTemplateLoader::Update($id, $arNewFields); } 

यहां, माइग्रेशन शुरू करते समय, हम फ़ाइल अपलोड करते हैं और आयातबीपी फ़ंक्शन के साथ प्रक्रिया बनाते / अपडेट करते हैं। इसके बाद, हम एक सरणी में व्यापार प्रक्रिया टेम्पलेट की संरचना प्राप्त करते हैं, आईडी को बदलते हैं और टेम्पलेट को अपडेट करते हैं।

संक्षेप में देना

इस लेख में, हमने केवल कुछ मामलों को छुआ है जहां साइटों के बीच स्थानांतरण के दौरान असंगतताएं हो सकती हैं, और हमने संकेत दिया कि क्या देखना है। सामान्य तौर पर, हमारे व्यवहार में, हम निम्नलिखित आईडी बाइंडिंग में आते हैं:

• user_ (उपयोगकर्ता के लिए बाध्यकारी)
• group_ (उपयोगकर्ता समूह के लिए बाध्यकारी)
• iblock_ (अड़चन बंधन)
• SequentialWorkflowActivity (टेम्पलेट से व्यावसायिक प्रक्रिया शुरू करना)
• PROPERTY_ (अपरिभाषित वर्ण कोड के साथ दस्तावेज़ फ़ील्ड पर बाध्यकारी)

यदि सब कुछ सही ढंग से किया जाता है, तो उत्पादन के लिए डिबगड व्यवसाय प्रक्रिया का हस्तांतरण त्वरित और सुचारू है

हम आशा करते हैं कि हमारा अनुभव आपके लिए उपयोगी था!