<पी>
<पी> एक्सेल की कार्यक्षमता को बढ़ाने के लिए कस्टम ऐड-इन्स शक्तिशाली उपकरण हैं। आप दोहराए जाने वाले कार्यों को स्वचालित करने, कस्टम फ़ंक्शन बनाने या उपयोगकर्ताओं को अद्वितीय टूल प्रदान करने के लिए अपना ऐड-इन्स बना सकते हैं। इस लेख में, हम उन्नत कार्यक्षमता के लिए कस्टम ऐड-इन्स बनाएंगे। <पी> यह ट्यूटोरियल आपको जावास्क्रिप्ट और ऑफिस ऐड-इन्स फ्रेमवर्क का उपयोग करके एक कस्टम एक्सेल ऐड-इन बनाने में मार्गदर्शन करेगा। ExchangeRates API का उपयोग करके हम एक मुद्रा परिवर्तक ऐड-इन बनाएंगे। चरण 1. अपना विकास परिवेश सेट करें
<पी> आवश्यक शर्तें इंस्टॉल करें और डाउनलोड करें: - Node.js इंस्टॉल करें :
- Node.js डाउनलोड और इंस्टॉल करें।
- वीएस कोड इंस्टॉल करें :
- विजुअल स्टूडियो कोड डाउनलोड और इंस्टॉल करें।
- ऑफिस ऐड-इन सीएलआई स्थापित करें :
- पावरशेल या टर्मिनल खोलें और चलाएं:
npm install -g yo generator-office
<पी>
- एक्सेल इंस्टॉल करें :
- सुनिश्चित करें कि आपके पास Excel 2016 या उसके बाद का संस्करण (Office 365 अनुशंसित) है।
- हम MS Office 365 का उपयोग कर रहे हैं।
चरण 2:एक नया ऐड-इन प्रोजेक्ट बनाएं
- पावरशेल खोलें या कमांड प्रॉम्प्ट और प्रशासक के रूप में चलाएँ .
- अपना Office ऐड-इन प्रोजेक्ट बनाने के लिए निम्न कमांड चलाएँ:
- यह आदेश जारी रखें या बाहर निकलें का संकेत देगा।
- चुनेंजारी रखें अपने Office ऐड-इन प्रोजेक्ट के सेटअप के साथ आगे बढ़ने के लिए।
- जारी रखें का चयन करने के लिए तीर कुंजियों का उपयोग करें और Enter दबाएँ .
- इसके बाद, यह आपके द्वारा बनाए जाने वाले ऐड-इन के प्रकार के बारे में प्रश्नों की एक श्रृंखला पूछेगा।
- प्रोजेक्ट प्रकार चुनें:
- कार्य फलक ऐड-इन चुनें (तीर कुंजियों का उपयोग करें और Enter दबाएँ)।
- एक स्क्रिप्ट प्रकार चुनें:
- जावास्क्रिप्ट चुनें या टाइपस्क्रिप्ट आपकी पसंद के आधार पर.
- आप अपने ऐड-इन को क्या नाम देना चाहते हैं?
- अपने प्रोजेक्ट के लिए नाम टाइप करें (उदाहरण के लिए, CustomAddin).
- आप किस Office क्लाइंट एप्लिकेशन का समर्थन करना चाहेंगे?
<पी>
- जनरेटर के पूरा होने तक प्रतीक्षा करें। जनरेटर सभी आवश्यक फ़ाइलों के साथ एक प्रोजेक्ट फ़ोल्डर स्थापित करेगा। प्रोजेक्ट में निम्नलिखित फ़ाइलें होंगी:
- taskpane.html :कार्य फलक का यूआई.
- taskpane.js :आपके कार्य फलक के लिए जावास्क्रिप्ट कोड शामिल है।
- manifest.xml :Office में आपके ऐड-इन का वर्णन करता है।
चरण 3:प्रोजेक्ट को विज़ुअल स्टूडियो कोड में खोलें
<पी> सेटअप पूरा करने के बाद, आप टर्मिनल का उपयोग करके प्रोजेक्ट फ़ोल्डर खोल सकते हैं या आप इसे सीधे वीएस कोड में खोल सकते हैं। प्रोजेक्ट बनाते समय, येओमन वर्तमान निर्देशिका में एक फ़ोल्डर बनाता है जहां आपने यो ऑफिस कमांड चलाया था। फ़ोल्डर में आपके द्वारा पहले निर्दिष्ट ऐड-इन प्रोजेक्ट का नाम होगा (उदाहरण के लिए, CustomAddin)। <पी> टर्मिनल में प्रोजेक्ट फ़ोल्डर पर नेविगेट करें: पी> - अपने पावरशेल या कमांड प्रॉम्प्ट में, प्रोजेक्ट फ़ोल्डर में जाने के लिए सीडी (निर्देशिका बदलें) कमांड का उपयोग करें।
- प्रोजेक्ट फ़ोल्डर में जाने के लिए निम्न कमांड डालें
<पी> फ़ोल्डर को विज़ुअल स्टूडियो कोड में खोलें: पी> - एक बार जब आप प्रोजेक्ट फ़ोल्डर में हों, तो आप इसे सीधे टर्मिनल से विज़ुअल स्टूडियो कोड में खोल सकते हैं।
- वीएस कोड में फ़ोल्डर खोलने के लिए निम्न कमांड चलाएँ:
<पी>
- यह पूरे प्रोजेक्ट को विज़ुअल स्टूडियो कोड में खोल देगा।
<पी>
<पी> आप प्रोजेक्ट फ़ोल्डर को सीधे विज़ुअल स्टूडियो में खोल सकते हैं: पी> - फ़ाइल एक्सप्लोरर खोलें (विंडोज) या फाइंडर (मैक) और उस फ़ोल्डर पर नेविगेट करें जहां येओमन ने आपका ऐड-इन प्रोजेक्ट बनाया था।
- राइट-क्लिक करें प्रोजेक्ट फ़ोल्डर (उदाहरण के लिए, CustomAddin)>> कोड के साथ खोलें चुनें यदि आपके पास विज़ुअल स्टूडियो कोड है स्थापित.
- वैकल्पिक रूप से, आप विज़ुअल स्टूडियो कोड खोल सकते हैं, फ़ाइल पर जा सकते हैं टैब>> फ़ोल्डर खोलें चुनें , और अपना प्रोजेक्ट फ़ोल्डर चुनें।
चरण 3. रीयल-टाइम मुद्रा परिवर्तक बनाना
<पी> एक बार जब प्रोजेक्ट वीएस कोड में खुल जाए, तो आप अपने ऐड-इन का संपादन और निर्माण शुरू कर सकते हैं: <पी> निर्भरताएं स्थापित करें: पी> <पी> यदि आपने पहले से ही आवश्यक निर्भरताएँ (जैसे Office.js) स्थापित नहीं की हैं, तो VS कोड में एक टर्मिनल खोलें और निम्नलिखित कमांड चलाएँ। VS कोड में Taskpane.html और Taskpane.js को अपडेट करें
<पी> अब, आप ऐड-इन की कार्यक्षमता और उपस्थिति को परिभाषित करने के लिए src/ फ़ोल्डर में HTML, JavaScript और CSS फ़ाइलों को संपादित कर सकते हैं। <पी> आइए आपके ऐड-इन के उपयोगकर्ता इंटरफ़ेस को डिज़ाइन करने के लिए Taskpane.html को संशोधित करें, और इंटरैक्टिविटी (उदाहरण के लिए, एक्सेल के साथ इंटरैक्ट करने वाले फ़ंक्शन) जोड़ने के लिए Taskpane.js को अपडेट करें। <पी> taskpane.html को संशोधित करें: पी> <पी> Taskpane.html खोलें और मौजूदा सामग्री को निम्नलिखित से बदलें: <!DOCTYPE html>
<html>
<head>
<title>Currency Converter</title>
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>
<script src="./taskpane.js"></script>
</head>
<body>
<h2>Currency Converter</h2>
<label for="fromCurrency">From:</label>
<input id="fromCurrency" type="text" placeholder="e.g., USD" />
<br>
<label for="toCurrency">To:</label>
<input id="toCurrency" type="text" placeholder="e.g., EUR" />
<br>
<button id="convertButton">Convert</button>
<p id="status"></p>
</body>
</html>
<पी> स्पष्टीकरण: पी> - अनुभाग:
- :पृष्ठ का शीर्षक "मुद्रा परिवर्तक" के रूप में सेट करता है
- :
- Office ऐड-इन एकीकरण के लिए office.js शामिल है।
- कस्टम JavaScript कार्यक्षमता के लिए Taskpane.js को लिंक करता है।
<पी> यह लेआउट आपके Excel ऐड-इन के लिए उपयोगकर्ता इंटरफ़ेस बनाता है। <पी> टास्कपेन.जेएस में तर्क जोड़ना: पी> <पी> Taskpane.js खोलें और मौजूदा सामग्री को इस कोड से बदलें: Office.onReady(() => {
document.getElementById('convertButton').addEventListener('click', convertCurrency);
});
async function convertCurrency() {
const fromCurrency = document.getElementById('fromCurrency').value.toUpperCase();
const toCurrency = document.getElementById('toCurrency').value.toUpperCase();
if (!fromCurrency || !toCurrency) {
document.getElementById('status').innerText = "Please enter valid currencies.";
return;
}
try {
const apiKey = "Your_Api_Key"; // Replace with your ExchangeRates API key
const url = `https://api.exchangerate-api.com/v4/latest/${fromCurrency}`;
const response = await fetch(url);
const data = await response.json();
const rate = data.rates[toCurrency];
if (!rate) {
document.getElementById('status').innerText = `Invalid conversion rate for ${toCurrency}.`;
return;
}
await Excel.run(async (context) => {
const range = context.workbook.getSelectedRange();
range.load("values");
await context.sync();
const convertedValues = range.values.map(row =>
row.map(cell => cell * rate)
);
range.values = convertedValues;
document.getElementById('status').innerText = `Converted to ${toCurrency} successfully.`;
await context.sync();
});
} catch (error) {
console.error(error);
document.getElementById('status').innerText = "Error fetching conversion rate.";
}
}
<पी> स्पष्टीकरण: पी> - Office.onReady: Office परिवेश तैयार होने पर ऐड-इन आरंभ करता है।
- कन्वर्टमुद्रा फ़ंक्शन:
- इनपुट मुद्राएं पढ़ता है (मुद्रा से और मुद्रा तक)।
- इनपुट को सत्यापित करता है और एपीआई के माध्यम से विनिमय दर प्राप्त करता है।
- चयनित एक्सेल सेल में रूपांतरण लागू करने के लिए Excel.run का उपयोग करता है।
- कार्य फलक में सफलता या त्रुटि संदेश प्रदर्शित करता है।
- त्रुटि प्रबंधन: एपीआई या एक्सेल रनटाइम त्रुटियों को पकड़ता है और लॉग करता है, उपयोगकर्ता प्रतिक्रिया प्रदान करता है।
चरण 4. अपने ऐड-इन का परीक्षण करें
<पी> आइए ऐड-इन का परीक्षण करके देखें कि यह एक्सेल में कैसे काम करता है। - यदि आप प्रोजेक्ट फ़ोल्डर में नहीं हैं, तो टर्मिनल में अपने प्रोजेक्ट फ़ोल्डर पर जाएँ:
- वीएस कोड टर्मिनल में निम्न कमांड चलाएँ।
- विकास सर्वर शुरू करने के लिए, निम्नलिखित कमांड चलाएँ।
- यह एक प्रश्न पूछेगा:“? Microsoft Edge WebView के लिए लोकलहोस्ट लूपबैक की अनुमति दें?”
- प्रकार:हां
<पी>
<पी> यह कमांड एक्सेल फ़ाइल लॉन्च करेगा। - एक्सेल खुल जाएगा, और ऐड-इन कार्य फलक में स्वचालित रूप से लोड हो जाएगा।
- स्रोत मुद्रा में मान वाले कक्षों की एक श्रृंखला का चयन करें।
- हमने सेल A2:A10 चुना।
- में से बॉक्स:USD डालें औरकों बॉक्स:EUR डालें .
- रूपांतरित करें पर क्लिक करें .
<पी>
चरण 5:ऐड-इन तैनात करें
<पी> आप इसे Office 365 पर परिनियोजित कर सकते हैं या अपने संगठन में उपयोग करने के लिए साझा कर सकते हैं। आप ऐड-इन की पैकेजिंग करके और उसे Office स्टोर पर अपलोड करके ऐसा कर सकते हैं। <पी> ऐड-इन को पैकेज करने का तरीका यहां बताया गया है:
- यह आपके ऐड-इन का एक प्रोडक्शन बिल्ड तैयार करेगा, जिसे आप वेब सर्वर पर होस्ट कर सकते हैं या Azure जैसी क्लाउड सेवा पर अपलोड कर सकते हैं।
सामान्य पर्यावरण सेटअप मुद्दे और समाधान
- स्क्रिप्ट निष्पादन नीति त्रुटि (npm.ps1 लोड नहीं किया जा सकता)
- समाधान: निम्न चलाकर निष्पादन नीति सेट करें:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
- यो कमांड पहचाना नहीं गया
- समाधान: यह सुनिश्चित करें कि येओमन को चलाकर सही ढंग से स्थापित किया गया है:
- इंस्टॉलेशन रन को सत्यापित करने के लिए:
- पैकेज स्थापित करते समय अनुमति संबंधी समस्याएं
- समाधान: व्यवस्थापक के रूप में PowerShell या कमांड प्रॉम्प्ट चलाएँ, या –force का उपयोग करें स्थापना के दौरान ध्वज.
निष्कर्ष
<पी> उपरोक्त चरण का पालन करके, आप एक्सेल में करेंसी कन्वर्टर ऐड-इन बना सकते हैं। हमने विकास परिवेश को कैसे स्थापित किया जाए, ऐड-इन कैसे बनाया जाए और जावास्क्रिप्ट के साथ कार्यक्षमता को कैसे लागू किया जाए, इसके विस्तृत चरणों को कवर किया। आप अधिक उन्नत सुविधाएँ जोड़कर इस ऐड-इन कार्यक्षमता को और बढ़ा सकते हैं। समाधान के साथ निःशुल्क उन्नत एक्सेल अभ्यास प्राप्त करें!