বাল্ক ক্রেডেনশিয়াল

বাল্ক ক্রেডেনশিয়াল আপনাকে একটি CSV ফাইল আপলোড করে একসঙ্গে শত শত বা হাজার হাজার প্রাপককে ব্যাজ ইস্যু করতে দেয়। প্রক্রিয়াটির চারটি ধাপ রয়েছে, যার সঙ্গে বিল্ট-ইন অগ্রগতি ট্র্যাকিং, বিরতি/পুনরায় শুরু এবং ত্রুটি পরিচালনা আছে।

ওভারভিউ

বাল্ক ক্রেডেনশিয়াল প্রক্রিয়াটি চারটি ধাপে চলে:

1. কনফিগার — ব্যাজ ও অপশন নির্বাচন করুন
2. আপলোড — আপনার CSV ফাইল প্রস্তুত করে আপলোড করুন
3. প্রসেস — ক্রেডেনশিয়াল তৈরি হওয়ার সময় অগ্রগতি পর্যবেক্ষণ করুন
4. ফলাফল — ফলাফল পর্যালোচনা করুন এবং রিপোর্ট ডাউনলোড করুন

ধাপ ১: কনফিগার

1. সাইডবার থেকে বাল্ক ক্রেডেনশিয়াল পেজটি খুলুন (এটির নিজস্ব রুট আছে, ক্রেডেনশিয়াল পেজ থেকে আলাদা)।
2. ব্যাজ পিকার ব্যবহার করে যে ব্যাজটি ইস্যু করতে চান সেটি নির্বাচন করুন।
3. ইচ্ছা হলে নিচেরগুলো কনফিগার করুন:
   • ইস্যুর তারিখ — সব ক্রেডেনশিয়ালের জন্য ব্যবহৃত তারিখ (ডিফল্ট আজকের তারিখ)
   • মেয়াদ শেষ — সব ক্রেডেনশিয়ালের জন্য ঐচ্ছিক মেয়াদোত্তীর্ণের তারিখ
   • ইমেইল পাঠান — ক্রেডেনশিয়াল তৈরি হওয়ার পর প্রতিটি প্রাপককে স্বয়ংক্রিয়ভাবে ইমেইল পাঠানো হবে কি না
4. পরবর্তী ক্লিক করুন।

ধাপ ২: CSV আপলোড

CSV ফরম্যাট

CSV ফাইলে অবশ্যই একটি name কলাম এবং একটি email কলাম থাকতে হবে, সঙ্গে একটি হেডার সারি। হেডারের নাম কেস-ইনসেনসিটিভ, এবং recipient_name / recipient_email যথাক্রমে name / email-এর বিকল্প নাম হিসেবে গ্রহণযোগ্য।

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

টেমপ্লেট ডাউনলোড

সঠিক হেডারসহ একটি ফাঁকা CSV ফাইল পেতে টেমপ্লেট ডাউনলোড ক্লিক করুন। আপনার প্রাপকদের তথ্য দিয়ে এটি পূরণ করে আপলোড করুন।

আপলোড

1. CSV আপলোড ক্লিক করুন অথবা আপনার ফাইলটি টেনে এনে ছেড়ে দিন।
2. প্রসেসিং শুরুর আগে ফাইলটি যাচাই করা হয়।

যাচাইকরণের নিয়ম

ফাইল পার্স হওয়ামাত্র প্রতিটি সারি যাচাই করা হয়:

• নাম কমপক্ষে ৫ অক্ষরের হতে হবে
• ইমেইল একটি বৈধ ইমেইল ঠিকানা হতে হবে
• ফাঁকা সারি বাদ দেওয়া হয়

প্রিভিউ টেবিলে প্রতিটি সারি সবুজ টিক বা লাল কারণসহ দেখানো হয়। অবৈধ সারি কোনো বাধা নয় — সেগুলো কেবল বাদ দেওয়া হয়, এবং কাউন্টার দেখায় কতজন বৈধ প্রাপক প্রসেস হবে (যেমন "১৮ জন বৈধ প্রাপক, ২ জন অবৈধ (বাদ দেওয়া হবে)")। অন্তত একটি সারি বৈধ হলেই আপনি এগিয়ে যেতে পারবেন; আগে ঠিক করে আবার আপলোড করার প্রয়োজন নেই।

3. প্রসেসিং শুরু করতে পরবর্তী ক্লিক করুন।

ধাপ ৩: প্রসেসিং

প্রসেসিং শুরু হলে আপনি একটি প্রগ্রেস বার এবং লাইভ কাউন্টার দেখতে পাবেন:

• প্রগ্রেস বার — প্রসেস হওয়া সারির শতকরা হার
• তৈরি হয়েছে — কতগুলো ক্রেডেনশিয়াল তৈরি হয়েছে
• ব্যর্থ — কতগুলো সারি ব্যর্থ হয়েছে
• বাকি — কতগুলো সারি এখনও সারিতে অপেক্ষমাণ

ব্যাচ চলার সময় বারের নিচে লাইভ তৈরি হয়েছে, ব্যর্থ এবং অপেক্ষমাণ টেবিল ভরে ওঠে।

বিরতি ও পুনরায় শুরু

• প্রসেসিং সাময়িকভাবে থামাতে বিরতি ক্লিক করুন। বিরতির সময় নতুন কোনো ক্রেডেনশিয়াল তৈরি হয় না।
• যেখানে থেমেছিলেন সেখান থেকে চালিয়ে যেতে পুনরায় শুরু ক্লিক করুন।

বাতিল

• প্রসেসিং সম্পূর্ণ বন্ধ করতে বাতিল ক্লিক করুন। ইতিমধ্যে তৈরি হওয়া ক্রেডেনশিয়াল রেখে দেওয়া হয়।

ত্রুটি পরিচালনা

কোনো সারি সারি-নির্দিষ্ট কারণে ব্যর্থ হলে (যেমন ব্যাকএন্ড প্রত্যাখ্যান করে এমন একটি অবৈধ মান):

• ত্রুটিটি ওই সারির বিপরীতে রেকর্ড করা হয়
• প্রসেসিং স্বয়ংক্রিয়ভাবে পরবর্তী সারিতে চলে যায়
• ব্যর্থ সারিগুলো ফলাফল ধাপের জন্য সংগ্রহ করা হয়, এবং স্ক্রিনের ব্যর্থতার টেবিলে তাদের ত্রুটির বার্তা দেখানো হয়

রেট-লিমিটে আটকে যাওয়া সারি অল্প ব্যাক-অফের পর স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করা হয়। ক্রেডিট বা কোটা ত্রুটি আলাদা — সামনে এগিয়ে যাওয়ার পরিবর্তে ব্যাচটি বিরতি নেয়, যাতে ফাইলের বাকি অংশ নষ্ট না হয়। একটি লাল "ক্রেডিট অপর্যাপ্ত" বার্তা দেখা যায়; টপ আপ করুন বা আপগ্রেড করুন, তারপর যেখানে থেমেছিল সেখান থেকে চালিয়ে যেতে পুনরায় শুরু ক্লিক করুন।

পেজ রিফ্রেশের পর পুনরুদ্ধার

প্রসেসিং চলাকালীন ভুলবশত ব্রাউজার বন্ধ করলে বা পেজ রিফ্রেশ করলে, আপনি ফিরে এলে বাল্ক ক্রেডেনশিয়াল সেশনটি পুনরুদ্ধার হয়। অগ্রগতি যেখানে থেমেছিল সেখান থেকেই আবার শুরু হয়।

ধাপ ৪: ফলাফল

প্রসেসিং শেষ হওয়ার পর (বা বাতিল হলে), ফলাফল স্ক্রিনে চারটি সারসংক্ষেপ কার্ড দেখানো হয়:

• মোট — ব্যাচে প্রাপকের সংখ্যা
• তৈরি হয়েছে — তৈরি হওয়া ক্রেডেনশিয়ালের সংখ্যা
• ব্যর্থ — ব্যর্থ হওয়া সারির সংখ্যা
• বাদ — প্রসেস না হওয়া প্রাপক (যেমন বাতিলের পর অবশিষ্ট সারি)

কার্ডগুলোর নিচে, তৈরি হয়েছে টেবিলে প্রতিটি নতুন ক্রেডেনশিয়াল দেখার লিংকসহ তালিকাভুক্ত থাকে, এবং ব্যর্থ টেবিলে ব্যর্থতাগুলো তাদের ত্রুটির বার্তাসহ তালিকাভুক্ত থাকে।

রিপোর্ট ডাউনলোড

• ফলাফল CSV ডাউনলোড — ব্যাচের প্রতিটি সারি, row, name, email, status, award_url কলামসহ (তৈরি হওয়া সারিগুলোর জন্য ক্রেডেনশিয়াল URL পূরণ করা থাকে)।
• ব্যর্থতার CSV ডাউনলোড — শুধু ব্যর্থ সারিগুলো, name, email, error কলামসহ।

ব্যর্থতাগুলো পুনরায় চেষ্টা

কিছু সারি ব্যর্থ হলে ব্যর্থতাগুলো পুনরায় চেষ্টা করুন ক্লিক করুন। এটি শুধু ব্যর্থ প্রাপকদের ওপর নতুন করে একটি পাস শুরু করে — CSV আবার আপলোড করার প্রয়োজন নেই। বিরতিতে থাকা ব্যাচের পর ক্রেডিট টপ আপ করার মতো সাময়িক সমস্যা ঠিক করার পর এটি কাজে লাগে।