8base फीचर्स का उपयोग करके एक स्लैक एप्लिकेशन बनाना

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

इस लेख में, हम एक स्लैक बॉट बनाएंगे जो हमारे द्वारा प्रबंधित ई-कॉमर्स प्लेटफॉर्म पर एक ऑर्डर बनाते समय अपडेट प्रकाशित करता है।

ई-कॉमर्स प्लेटफॉर्म 8base का उपयोग करके बनाया गया एक सर्वर रहित एप्लिकेशन है। इस लेख में, हम ट्रिगर्स का उपयोग करके डेटा मॉडल में ईवेंट बनाने के लिए 8base फ़ंक्शन का उपयोग करेंगे।

ट्रिगर एक प्रकार का फ़ंक्शन है जो डेटा म्यूटेशन ईवेंट के जवाब में ट्रिगर किया जाता है: किसी ऑब्जेक्ट को बनाना , अपडेट करना या हटाना। 8base दो प्रकार के ट्रिगर्स प्रदान करता है, यह इस बात पर निर्भर करता है कि डेवलपर डेटा को बदलने से पहले या बाद में फ़ंक्शन को निष्पादित करना चाहता है: ट्रिगर।

आपको आवश्यकता होगी

• प्रतिक्रिया और Node.js. की बुनियादी समझ शुरू करने से पहले, सुनिश्चित करें कि आपके पास नोड और एनपीएम / यार्न स्थापित है ।
• हम परियोजना में कुछ ग्राफ़कॉल प्रश्नों का उपयोग करेंगे, इसलिए ग्राफकॉल के साथ परिचित होना उपयोगी है ।
• उनकी वेबसाइट पर जाकर 8base अकाउंट बनाएं (यदि आपने पहले से ऐसा नहीं किया है)।

8base पर्यावरण तैयार करना

एक खाता बनाएँ या 8base में लॉग इन करें। नए खातों के लिए, 8base 30 दिन की मुफ्त सुविधा प्रदान करता है।


2। लॉग इन करने के बाद, डेटा पेज पर जाएं और बैकएंड को कॉन्फ़िगर करना शुरू करने के लिए "नई तालिका" पर क्लिक करें।

3। नई तालिका लोड करने के बाद, आपको एक आरेख दिखाई देगा और आप खेतों को परिभाषित करना शुरू कर सकते हैं। अगला, आदेश नामक एक तालिका बनाएं, जिसमें निम्नलिखित फ़ील्ड शामिल हैं:
- उपयोगकर्ता : फ़ील्ड प्रकार तालिका है। सही अनुभाग में, उपयोगकर्ता तालिका का चयन करें और संबंध फ़ील्ड नाम फ़ील्ड में "आदेश" निर्दिष्ट करें। फिर " उपयोगकर्ता प्रति एकाधिक ऑर्डर की अनुमति दें" बॉक्स को चेक करें।

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

एक सुस्त अनुप्रयोग बनाएँ

अपने स्लैक में लॉग इन करके शुरू करें या इस गाइड के लिए एक नया बनाएं। एक नया स्लैक ऐप बनाने के लिए स्लैक एपीआई कंसोल पर जाएं।



शॉप क्विक नामक हमारे काल्पनिक ई-कॉमर्स प्लेटफॉर्म के बाद इस स्लैक ऐप को कॉल करें।

हमने अपनी कार्यशाला में एप्लिकेशन बनाने के बाद, हम अस्थायी रूप से स्लैक एप्लिकेशन को स्थगित कर सकते हैं और 8base फ़ंक्शन बनाने पर काम कर सकते हैं, जो शॉप क्विक प्लेटफॉर्म पर नए ऑर्डर के निर्माण की घटनाओं को सुनेंगे।

एक 8base फंक्शन बनाएं

8base प्लेटफ़ॉर्म उन सुविधाओं की पेशकश करता है जो सर्वर रहित अनुप्रयोगों के निर्माण की सुविधा प्रदान करती हैं। इस स्लैक एप्लिकेशन के लिए, हमें कस्टम तर्क और एकीकरण की आवश्यकता है जिसे केवल CRUD के साथ लागू नहीं किया जा सकता है। हमारे मामले में, हम एक नया ऑर्डर बनाते समय स्लैक को संदेश भेजना चाहते हैं। हम 8base फ़ंक्शन का उपयोग करके इसे प्राप्त कर सकते हैं, क्रिएट, अपडेट और डिलीट इवेंट्स को सुनकर हम ट्रिगर्स का उपयोग करेंगे।

ट्रिगर एक फ़ंक्शन है जो डेटा म्यूटेशन ईवेंट के जवाब में ट्रिगर होता है: जब कोई ऑब्जेक्ट बनाया जाता है, अपडेट किया जाता है, या हटाया जाता है। ट्रिगर के दो प्रकार हैं, यह इस बात पर निर्भर करता है कि उन्हें डेटा परिवर्तन से पहले या बाद में निष्पादित किया गया है: ट्रिगर। एबी और ट्रिगर।

हमारे मामले में, हम ऑर्डर बनाने के बाद अपने फ़ंक्शन को कॉल करेंगे। इसलिए, हमें Orders.create को निर्दिष्ट करना होगा। डेटा ईवेंट के संभावित मान बनाएं, अपडेट और हटाएं हैं।

8base सीएलआई

CLI 8base आपको बायलरप्लेट कोड से परहेज करते हुए केवल तर्क को जोड़ने के लिए प्रभावी रूप से तर्क जोड़ने के लिए कस्टम जावास्क्रिप्ट या टाइपस्क्रिप्ट लिखने की अनुमति देता है।

8base कमांड लाइन इंटरफेस (CLI) टर्मिनल से सही आपके एप्लिकेशन में कस्टम सर्वर लॉजिक जोड़ना आसान बनाता है। एक टर्मिनल में निम्नलिखित कमांड चलाकर सीएलआई स्थापित करें:

npm install -g 8base 

विश्व स्तर पर CLI स्थापित करने के बाद, आपको अपने 8base खाते में CLI की सुविधा देने के लिए लॉग इन होना चाहिए। लॉग इन करने के लिए निम्नलिखित कमांड चलाएँ:

 8base login 

जब आप इस आदेश को चलाते हैं, तो CLI प्राधिकरण के लिए एक ब्राउज़र विंडो दिखाई देगी। लॉग इन करके आपके 8base खाते में CLI की सुविधा मिलती है। आप CLI द्वारा दी गई अन्य कमांड को हेल्प कमांड चलाकर पा सकते हैं:

 8base help 

अगला, हम आपके टर्मिनल में निम्नलिखित कमांड चलाकर सीएलआई का उपयोग करते हुए 8base प्रोजेक्ट को आरम्भ करते हैं:

 8base init shop-quick-functions 

कमांड निष्पादित होने के बाद, एक नया फ़ोल्डर बनाया जाएगा। फ़ोल्डर की संरचना इस तरह दिखनी चाहिए:

 ├── src/ | ├── function1.ts | └── function2.js ├── 8base.yml └── package.json 

सीएलआई एक नियमित नोड परियोजना को लोड करता है, जो आपको एनपीएम या यार्न का उपयोग करके निर्भरता स्थापित करने की अनुमति देता है। इसके अलावा, 8base CLI वेबपैक और टाइपस्क्रिप्ट बॉक्स से पहले से कॉन्फ़िगर किया हुआ आता है ताकि आप जावास्क्रिप्ट या टाइपस्क्रिप्ट कोड लिख सकें।

हम 8base.yml में कस्टम फीचर्स और अनुमतियां सेट करते हैं। हम अपनी आवश्यकताओं के अनुसार 8base.yml फ़ाइल की वर्तमान सेटिंग बदलते हैं। फ़ाइल खोलें और निम्नलिखित परिवर्तन करें:

 functions: notifySlack: handler: code: src/notifySlack.js type: trigger.after operation: Orders.create 

फ़ाइल संरचना किसी भी YAML फ़ाइल के समान है। पहला ब्लॉक जिसे हम देखेंगे वह एक फ़ंक्शन ब्लॉक है; हम इस ब्लॉक में बनाए जाने वाले सभी फंक्शन की परिभाषाएँ रखेंगे। उदाहरण के लिए, हमारे द्वारा बनाया गया InformSlack फ़ंक्शन; फ़ंक्शन में निम्न गुण हैं:

• हैंडलर : नोटिफिकेशन फ़ंक्शन हैंडलर के सापेक्ष फ़ाइल पथ।
• ऑपरेशन : पैरामीटर यह निर्धारित करता है कि किस डेटा प्रकार और घटना को ट्रिगर को सुनना चाहिए।
• प्रकार : चाहे वे डेटा परिवर्तन से पहले या बाद में शुरू किए गए हों। इसके दो प्रकार हैं: ट्रिगर.बेफ़र और ट्रिगर। आफ्टर।

अगला कदम ट्रिगर के बाद घटनाओं को प्राप्त करना शुरू करने के लिए एक हैंडलर फ़ाइल बनाना है। स्लैक को अपडेट भेजने के लिए हम chat.postMessage पद्धति का उपयोग करेंगे। HTTP पोस्ट विधि का उपयोग करके संदेश भेजे जाएंगे - चैट.पोस्टमैसेज पद्धति के प्रत्येक अनुरोध पर आपके बॉट के OAuth एक्सेस टोकन द्वारा हस्ताक्षर किए जाएंगे। अपने आवेदन के लिए विवरण पृष्ठ पर जाएं, साइडबार नेविगेशन में OAuth और अनुमतियां लिंक पर क्लिक करें।



‍ टोकन को कॉपी करें और 8base सेटिंग्स पेज पर पर्यावरण चर टैब पर जाएं। आपके फ़ंक्शंस में सभी निर्मित पर्यावरण चर तक पहुंच है। हमेशा अपने गोपनीय मूल्यों और प्रमाणों को यहां संग्रहीत करें, और उन्हें सीधे स्रोत कोड डेटाबेस में न रखें। SLACK_ACCESS_TOKEN नामक एक नया चर बनाएं, कॉपी किए गए टोकन को चिपकाएं और इसे सहेजें।



अब एडिटर में कोड जोड़ते हैं। एक फ़ाइल बनाएँ जिसे src निर्देशिका में utils.js कहा जाता है। अपने पसंदीदा संपादक में फ़ाइल खोलें और उसमें निम्नलिखित कॉपी करें:

 /* src/utils.js */export const sendMessage = (order) => { const message = `A new order was just created`; const messageBody = dataBuilder(order); const body = { channel: 'general', attachments: messageBody, text: message }; ‍ console.log('Message body', { body }); console.log('Sending message request'); return makeRequest(body); };‍ 

इस प्रकार, SendMessage फ़ंक्शन एक आदेश को एक तर्क के साथ स्वीकार करता है, जो कि एक ऑब्जेक्ट है जो हमने ऑर्डर मॉडल के लिए बनाया है। अब हमें ऑर्डर ऑब्जेक्ट का उपयोग करके एक नया संदेश बनाने की आवश्यकता है, इसलिए हम ऑब्जेक्ट को एक फ़ंक्शन से पास करते हैं जिसे dataBuilder कहा जाता है। DataBuilder फ़ंक्शन स्लैक अटैचमेंट के प्रारूप में एक ऑब्जेक्ट देता है।

फिर हम अनुरोध बॉडी बनाते हैं जिसमें कार्यक्षेत्र चैनल होता है जिसमें हम संदेश प्रकाशित करते हैं, अटैचमेंट डेटाबुर्टल से लौटते हैं, और अंत में टेक्स्ट। अगला, संदेश को प्रकाशित करने का अनुरोध मेकइरफेस्ट फ़ंक्शन द्वारा भेजा जाता है।

चलिए डेटाब्यूलर फंक्शन बनाते हैं, नीचे के टुकड़े को कॉपी करें और utils.js फ़ाइल को अपडेट करें:

 /* src/utils.js */ export const sendMessage = (order) => { ...}; const dataBuilder = (order) => { const { items } = order; const itemSections = items.map((item) => { return { type: 'section', text: item.name, color: '#3AA3E3', accessory: { type: 'image', image_url: item.image, alt_text: item.name, }, }; }); const data = [ { type: 'section', text: { type: 'mrkdwn', text: `*There are ${items.length} items in the order*`, }, }, ...itemSections, ]; return data; }; 

DataBuilder फ़ंक्शन एक ऑर्डर ऑब्जेक्ट को स्वीकार करता है और आइटम के नाम और छवि का उपयोग करके प्रत्येक आइटम के लिए एक अनुभाग बनाता है। आप वास्तविक समय में संदेशों और अनुलग्नकों के प्रारूपण का पूर्वावलोकन करने के लिए संदेश बिल्डर का उपयोग कर सकते हैं।

अगला, हम मेक रेयर फ़ंक्शन जोड़ते हैं, जो मैसेज बॉडी को स्लैक कार्यशाला में भेजता है।

निम्नलिखित स्निपेट को utils.js फ़ाइल में कॉपी करें:

 /* src/utils.js */ import fetch from 'node-fetch'; export const sendMessage = (order) => { ... }; const dataBuilder = (order) => { ... }; const makeRequest = (data) => { const url = 'https://slack.com/api/chat.postMessage'; const headers = { Authorization: `Bearer ${process.env.SLACK_ACCESS_TOKEN}`, 'Content-type': 'application/json', }; return fetch(url, { method: 'post', body: JSON.stringify(data), headers, }); }; 

निम्नलिखित कमांड को चलाकर पहले नोड-भ्रूण पैकेज स्थापित करें:

 npm install node-fetch 

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

अब हमारे पास एक बॉट का उपयोग करके स्लैक वारस्पेस को एक संदेश भेजने की आवश्यकता है। एक फ़ंक्शन हैंडलर बनाते हैं जिसे हमने ऊपर 8base.yml फ़ाइल में संदर्भित किया है।

एक फ़ाइल बनाएँ, जिसे एसएनएस डायरेक्टरी में InformSlack.js कहा जाता है, फ़ाइल खोलें और उसमें कोड कॉपी करें:

 /* src/notifySlack.js */ import { sendMessage } from './utils'; module.exports = async (event) => { try { console.log('Sending notification to slack'); const res = await sendMessage(event.data); console.log('Notification sent successfully'); } catch (error) { console.log(error); } return { data: event.data, }; }; 

फ़ाइल में, हम SendMessage उपयोगिता फ़ंक्शन का उपयोग करते हैं जो हमने बनाया था। 8base फ़ंक्शन हैंडलर दो तर्क पास करता है: एक घटना और एक संदर्भ। ईवेंट ऑब्जेक्ट की संरचना फ़ंक्शन के प्रकार पर निर्भर करती है, और संदर्भ ऑब्जेक्ट में उपयोगी गुण और विधियां शामिल हैं, जिन्हें आप यहां पढ़ सकते हैं।
हमारे मामले में, ईवेंट ऑब्जेक्ट में बनाए गए ऑर्डर होंगे, जिसमें दो उपयोगकर्ता और आइटम फ़ील्ड शामिल हैं। ऑर्डर ऑब्जेक्ट ईवेंट ऑब्जेक्ट डेटा की एक संपत्ति है, और हम इस ऑब्जेक्ट को स्लैक को सूचित करने के लिए sendMessage फ़ंक्शन में पास करते हैं।

फ़ंक्शन कॉल को कोशिश / पकड़ में लपेटा जाता है, क्योंकि हम नहीं चाहते हैं कि फ़ंक्शन समाप्त होने के लिए कोई भी त्रुटि हो। अंत में, हम फ़ंक्शन के अंत में ईवेंट डेटा वापस करते हैं।
इस डेटा के साथ, हम संदेश के विषय और शरीर को इंगित कर सकते हैं, और फिर हमारे द्वारा बनाए गए ट्रांसपोर्टर का उपयोग करके मेल भेज सकते हैं। निम्न कमांड को चलाकर फाइल को सेव करें और 8base CLI का उपयोग करके फंक्शन को तैनात करें:

 # deploy while in project root directory 8base deploy 

सफलतापूर्वक कार्य पूरा करने के बाद, आपको टर्मिनल से निम्न आउटपुट देखना चाहिए:

 ➜ 8base deploy deploy done. Time: 15,553 ms. 

डिबगिंग सुविधाएँ

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

8base डैशबोर्ड पर जाएं और साइड मेनू में लॉजिक क्लिक करें। तर्क पृष्ठ पर, आप सभी निर्धारित कार्यों को देख सकते हैं।


किसी विशिष्ट फ़ंक्शन के लिए, सभी लॉग देखने के लिए लॉग लॉग पर क्लिक करें। अगला, हम स्लैक एप्लिकेशन इंस्टॉल करते हैं और उसका परीक्षण करते हैं।

स्लैक ऐप इंस्टॉल करना और उसका परीक्षण करना

चलो अंतिम चरण समाप्त करते हैं और कार्यक्षेत्र में स्लैक एप्लिकेशन इंस्टॉल करते हैं। ऐसा करने के लिए, स्लैक ऐप कंसोल पर लौटें और साइड नेविगेशन बार पर ऐप इंस्टॉल करें पर क्लिक करें ।



पृष्ठ पर, आपको एप्लिकेशन इंस्टॉल करने के लिए फ़ंक्शन या प्राधिकरण जोड़ने के बारे में एक चेतावनी दिखाई देगी। उस पर क्लिक करें और अनुमति जोड़ें।

एप्लिकेशन को सफलतापूर्वक स्थापित करने के बाद, हम फ़ंक्शन और एप्लिकेशन का परीक्षण कर सकते हैं। 8base डेटा पृष्ठ पर जाएं, साइडबार में आदेश तालिका पर क्लिक करें। ऑर्डर टेबल व्यूअर में, डेटा टैब पर क्लिक करें, यहां हम टेबल में नई पंक्तियों को जोड़ सकते हैं।



डेटा तालिका में, {+} बटन दबाएं और एक नई पंक्ति बनाएं।



आप निम्न डेटा के साथ उत्पाद क्षेत्र को भर सकते हैं:

 [{ "name": "Food product", "image": "https://static.pexels.com/photos/368893/pexels-photo-368893.jpeg", "price": 4 }, { "name": "The real fruit", "image": "https://static.pexels.com/photos/368893/pexels-photo-368883.jpeg", "price": 20 }] 

नया ऑर्डर बनाने के लिए Add Row पर क्लिक करें। फिर कार्यशाला में जाएं जहां आपने स्लैक ऐप इंस्टॉल किया है, #general चैनल पर क्लिक करें और आपको बॉट से एक नया संदेश दिखाई देगा।

यह इस तरह दिखना चाहिए:



स्लैक चैनल पर 8base bot से नई अधिसूचना

अंतिम शब्द

स्लैक एप्लिकेशन बनाना एक अच्छा विचार है; सुस्त अधिकांश टीमों के लिए संचार का प्राथमिक साधन है, और आपको दैनिक कार्य के लिए आवश्यक सभी जानकारी प्राप्त करने की अनुमति दे सकता है।

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

पढ़ने के लिए धन्यवाद।