बल्क क्रेडेंशियल

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

अवलोकन

बल्क क्रेडेंशियल प्रक्रिया चार चरणों में होती है:

1. कॉन्फ़िगर — बैज और विकल्प चुनें
2. अपलोड — अपनी CSV फ़ाइल तैयार करें और अपलोड करें
3. प्रोसेस — क्रेडेंशियल बनते समय प्रगति पर नज़र रखें
4. परिणाम — नतीजों की समीक्षा करें और रिपोर्ट डाउनलोड करें

चरण 1: कॉन्फ़िगर करें

1. साइडबार से Bulk Credentials पेज खोलें (इसका अपना अलग रूट है, जो Credentials पेज से भिन्न है)।
2. बैज पिकर का उपयोग करके वह बैज चुनें जिसे आप जारी करना चाहते हैं।
3. वैकल्पिक रूप से ये विकल्प सेट करें:
   • Issued On — सभी क्रेडेंशियल के लिए उपयोग की जाने वाली तारीख (डिफ़ॉल्ट रूप से आज की तारीख)
   • Expires — सभी क्रेडेंशियल के लिए वैकल्पिक समाप्ति तिथि
   • Send Email — क्रेडेंशियल बनने के बाद प्रत्येक प्राप्तकर्ता को स्वचालित रूप से ईमेल भेजना है या नहीं
4. Next पर क्लिक करें।

चरण 2: CSV अपलोड करें

CSV प्रारूप

CSV फ़ाइल में हेडर पंक्ति के साथ एक name कॉलम और एक email कॉलम होना चाहिए। हेडर नाम केस-इनसेंसिटिव होते हैं, और recipient_name / recipient_email को name / email के विकल्प (alias) के रूप में स्वीकार किया जाता है।

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

टेम्पलेट डाउनलोड करें

सही हेडर वाली खाली CSV फ़ाइल पाने के लिए Download Template पर क्लिक करें। उसमें अपने प्राप्तकर्ताओं की जानकारी भरें और अपलोड करें।

अपलोड

1. Upload CSV पर क्लिक करें या अपनी फ़ाइल को ड्रैग और ड्रॉप करें।
2. प्रोसेसिंग शुरू होने से पहले फ़ाइल का सत्यापन किया जाता है।

सत्यापन नियम

फ़ाइल पार्स होते ही प्रत्येक पंक्ति का सत्यापन किया जाता है:

• Name कम से कम 5 अक्षरों का होना चाहिए
• Email एक मान्य ईमेल पता होना चाहिए
• खाली पंक्तियाँ छोड़ दी जाती हैं

प्रीव्यू तालिका हर पंक्ति को हरे टिक या लाल कारण के साथ दिखाती है। अमान्य पंक्तियाँ कोई रुकावट नहीं हैं — उन्हें बस छोड़ दिया जाता है, और काउंटर बताता है कि कितने मान्य प्राप्तकर्ताओं को प्रोसेस किया जाएगा (जैसे "18 valid recipients, 2 invalid (will be skipped)")। जब तक कम से कम एक पंक्ति मान्य है, आप आगे बढ़ सकते हैं; पहले ठीक करके दोबारा अपलोड करने की ज़रूरत नहीं है।

3. प्रोसेसिंग शुरू करने के लिए Next पर क्लिक करें।

चरण 3: प्रोसेसिंग

प्रोसेसिंग शुरू होने के बाद आपको एक प्रोग्रेस बार और लाइव काउंटर दिखते हैं:

• प्रोग्रेस बार — प्रोसेस की गई पंक्तियों का प्रतिशत
• Created — कितने क्रेडेंशियल बनाए जा चुके हैं
• Failed — कितनी पंक्तियाँ विफल रही हैं
• Remaining — कितनी पंक्तियाँ अभी कतार में हैं

बैच चलने के दौरान बार के नीचे लाइव Created, Failed और Pending तालिकाएँ भरती जाती हैं।

पॉज़ और रिज़्यूम

• प्रोसेसिंग को अस्थायी रूप से रोकने के लिए Pause पर क्लिक करें। रुके रहने के दौरान कोई नया क्रेडेंशियल नहीं बनता।
• जहाँ से रुके थे वहीं से जारी रखने के लिए Resume पर क्लिक करें।

रद्द करें

• प्रोसेसिंग को पूरी तरह रोकने के लिए Cancel पर क्लिक करें। जो क्रेडेंशियल पहले ही बन चुके हैं, वे सुरक्षित रहते हैं।

त्रुटि प्रबंधन

जब कोई पंक्ति पंक्ति-विशिष्ट कारण से विफल होती है (जैसे बैकएंड द्वारा अस्वीकृत कोई अमान्य मान):

• त्रुटि उसी पंक्ति के सामने दर्ज की जाती है
• प्रोसेसिंग अपने आप अगली पंक्ति पर जारी रहती है
• विफल पंक्तियाँ परिणाम चरण के लिए एकत्र की जाती हैं, और उनका त्रुटि पाठ स्क्रीन पर विफलता तालिका में दिखाया जाता है

रेट-लिमिट वाली पंक्तियों को थोड़े बैक-ऑफ के साथ अपने आप दोबारा आज़माया जाता है। क्रेडिट या कोटा संबंधी त्रुटि अलग तरह से संभाली जाती है — आगे बढ़ने के बजाय बैच पॉज़ हो जाता है ताकि बाकी फ़ाइल व्यर्थ न जाए। एक लाल "Insufficient credits" सूचना दिखती है; क्रेडिट टॉप अप करें या प्लान अपग्रेड करें, फिर जहाँ से रुका था वहीं से जारी रखने के लिए Resume पर क्लिक करें।

पेज रिफ़्रेश के बाद पुनर्प्राप्ति

यदि आप प्रोसेसिंग के दौरान गलती से ब्राउज़र बंद कर देते हैं या पेज रिफ़्रेश कर देते हैं, तो आपके लौटने पर बल्क क्रेडेंशियल सत्र पुनर्प्राप्त हो जाता है। प्रगति वहीं से फिर शुरू होती है जहाँ रुकी थी।

चरण 4: परिणाम

प्रोसेसिंग पूरी होने (या रद्द होने) के बाद, परिणाम स्क्रीन चार सारांश कार्ड दिखाती है:

• Total — बैच में प्राप्तकर्ताओं की संख्या
• Created — बनाए गए क्रेडेंशियल की संख्या
• Failed — विफल पंक्तियों की संख्या
• Skipped — जिन प्राप्तकर्ताओं को प्रोसेस नहीं किया गया (जैसे रद्द करने के बाद बची हुई पंक्तियाँ)

कार्ड के नीचे, Created तालिका हर नए क्रेडेंशियल को उसे देखने के लिंक के साथ सूचीबद्ध करती है, और Failed तालिका विफलताओं को उनके त्रुटि पाठ के साथ सूचीबद्ध करती है।

रिपोर्ट डाउनलोड करें

• Download Results CSV — बैच की हर पंक्ति, row, name, email, status, award_url कॉलम के साथ (बनाई गई पंक्तियों के लिए क्रेडेंशियल URL भरा होता है)।
• Download Failures CSV — केवल विफल पंक्तियाँ, name, email, error कॉलम के साथ।

विफलताओं को दोबारा आज़माएँ

यदि कुछ पंक्तियाँ विफल रहीं, तो Retry Failures पर क्लिक करें। यह केवल विफल प्राप्तकर्ताओं पर एक नया पास शुरू करता है — CSV दोबारा अपलोड करने की ज़रूरत नहीं। पॉज़ हुए बैच के बाद क्रेडिट टॉप अप करने जैसी किसी अस्थायी समस्या को ठीक करने के बाद यह काफ़ी काम आता है।