Apple School Manager में रिकॉर्ड इंपोर्ट करने के लिए टेम्पलेट जानकारी
आपके स्थान से डेटा जोड़ते समय Apple उपयोग करने के लिए छह टेम्पलेट प्रदान करता है:
विद्यार्थी : इसमें विद्यार्थी के खाते की जानकारी शामिल है।
स्टाफ़ : इसमें स्टाफ़ के खाते की जानकारी शामिल है, जैसे कि प्रशिक्षक।
पाठ्यक्रम : यह पाठ्यक्रम को निर्धारित करता है।
कक्षाएँ : इसमें पाठ्यक्रम, प्रशिक्षक (स्टाफ़) की जानकारी होती है।
रोस्टर : इसमें कक्षा, विद्यार्थी और स्थान की जानकारी शामिल है।
स्थान : इसमें स्थान की जानकारी शामिल है।
टेम्प्लेट और प्रबंधित Apple ID
अगर कोई विकल्प फ़ील्ड—जैसे कि person_number या sis_username—आपके प्रबंधित Apple ID प्रारूप का हिस्सा है, तो वह एक आवश्यक फ़ील्ड बन जाता है। अगर आप इसे खाली छोड़ देते हैं, तो SFTP अपलोड MANAGED_ID_GENERATION_FAILED त्रुटि के साथ विफल हो जाता है।
टेम्पलेट तैयार करें
टेम्पलेट तैयार करते समय निम्नलिखित मानदंड को पूरा किया जाना चाहिए :
students.csv और staff.csv टेम्पलेट लिए, person_id सभी स्थानों के लिए विशिष्ट होना चाहिए।
महत्वपूर्ण : अगर आप किसी नए यूज़र को अपलोड करने के लिए SFTP का उपयोग करते हैं और जो person_id आप असाइन करते हैं वह पहले से ही किसी और यूज़र को असाइन किया गया है, तो नया यूज़र Apple School Manager में मौजूदा यूज़र को ओवरराइट कर देता है। ओवरराइट पूरा होने के बाद, आप सिर्फ़ उसी यूज़र को SFTP के ज़रिए अपडेट कर सकते हैं।
यदि आप टेम्पलेट संपादित करते हैं, तो उदाहरण डेटा को अपने डेटा से बदल लें। प्रत्येक फ़ाइल में हेडर पंक्ति के कॉन्टेंट को न बदलें। किसी भी फ़ाइल में डुप्लिकेट स्तंभ न बनाएँ। आप विशिष्ट टेम्प्लेट में कॉलम जोड़ सकते हैं।
सभी टेम्पलेट में हर एक पंक्ति को एक विशिष्ट मान दर्शाना चाहिए। उदाहरण के तौर पर, students.csv file में हर एक पंक्ति को एक विशिष्ट विद्यार्थी होना चाहिए। उस विद्यार्थी के लिए कुछ निश्चित मान ख़ाली छोड़ सकते हैं। शाब्दिक मान—उदाहरण के तौर पर, नाम में पंक्ति विराम या उद्धरण चिह्न—बैकस्लैश के साथ रखा जाना चाहिए (\)। यह रहा उदाहरण : \"। सभी पहचानकर्ता अल्फ़ान्यूमैरिक दर्ज किए जाने चाहिए और हायफ़न (-) शामिल कर सकते हैं।
यदि आपके मान में कोई स्पेस ( ) या अल्पविराम (,) शामिल है, तो इसके दोनों तरफ़ उद्धरण चिह्न (") का उपयोग करें। यदि आपके मान में इनमें से कोई विशेष वर्ण नहीं है, तो उद्धरण चिह्न का उपयोग न करें। यदि आप जहाँ आवश्यक है वहाँ क्वोट्स का उपयोग नहीं करते हैं या घुमावदार क्वोट्स का उपयोग करते हैं, तो आप अपलोड प्रक्रिया में त्रुटि प्राप्त कर सकते हैं।
भले ही आपकी फ़ाइल कैसे भी बनी हो, आपकी फ़ाइल में मान अल्पविराम (,) या अर्द्धविराम (;) से विभाजित होने चाहिए। अल्पविराम या अर्द्धविराम और अगले मान के बीच स्पेस या टैब का उपयोग न करें। प्रत्येक फ़ाइल UTF-8 के रूप में एन्कोड होनी चाहिए। पंक्ति की समाप्ति दर्शाने के लिए, UNIX नई पंक्ति की एन्कोडिंग \n का उपयोग करें।
यदि पहले के अपलोड से प्रविष्टि गुम है, तो खाता निष्क्रिय हो जाएगा और 120 दिन बाद अपने आप डिलीट हो जाएगा जब तक कि खाते ने वॉल्यूम कॉन्टेंट न खरीदा हो।
.csv फ़ाइलों के नाम मूल फ़ाइल के नाम से पूरी तरह मेल खाने चाहिए।
अपलोड करने के लिए सभी फ़ाइलों को एक (.zip) आर्काइव फ़ाइल में कंप्रेस करना होगा।
ज़िप की गई आर्काइव फ़ाइल के फ़ोल्डर में कोई फ़ाइल नहीं रखी जा सकती है।
अन्य .csv फ़ाइलों में सभी विदेशी-कुंजी संदर्भ संदर्भित फ़ाइल में निर्धारित किए जाने चाहिए।
.csv टेम्पलेट में वर्ण सीमाएँ
.csv टेम्पलेट में कुछ फ़ील्ड में वर्णों की संख्या की सीमाओं की अनुमति होती है।
फ़ील्ड | टेम्पलेट | वर्ण सीमा |
---|---|---|
first_name | विद्यार्थी, स्टाफ़ | 32 |
middle_name | विद्यार्थी, स्टाफ़ | 32 |
last_name | विद्यार्थी, स्टाफ़ | 64 |
grade_level | विद्यार्थी | 64 |
email_address | विद्यार्थी | 256 |
person_number | विद्यार्थी, स्टाफ़ | 64 |
person_id | विद्यार्थी, स्टाफ़, कक्षाएँ, रोस्टर | 256 |
sis_username | विद्यार्थी, स्टाफ़ | 256 |
class_id | कक्षाएँ, रोस्टर | 256 |
class_number | कक्षाएँ | 64 |
course_id | पाठ्यक्रम, कक्षाएँ | 256 |
course_name | पाठ्यक्रम | 128 |
course_number | पाठ्यक्रम | 64 |
location_name | स्थान | 256 |
location_id | विद्यार्थी, स्टाफ़, पाठ्यक्रम, कक्षाएँ, स्थान | 256 |