Apple School Manager में डेटा इंपोर्ट करने के लिए टेम्पलेट जानकारी
Apple¬School¬Manager में डेटा जोड़ने के लिए, आप Apple या OneRoster द्वारा फ़ॉर्मेट की गई .csv टेम्प्लेट फ़ाइलों का उपयोग कर सकते हैं।
Apple .csv टेम्पलेट नाम : विद्यार्थी, स्टाफ़, पाठ्यक्रम, कक्षाएँ, रोस्टर, स्थान
OneRoster .csv टेम्पलेट नाम : यूज़र, पाठ्यक्रम, कक्षाएँ, नामांकन, संगठन
Apple फ़ाइल नाम | OneRoster फ़ाइल नाम | कॉन्टेंट | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple : इसमें विद्यार्थी के खाते की जानकारी शामिल है। OneRoster : इसमें विद्यार्थी, प्रशिक्षक और स्टाफ के खाते की जानकारी शामिल है। | |||||||||||
N/A | इसमें स्टाफ़ के खाते की जानकारी शामिल है, जैसे कि प्रशिक्षक। | ||||||||||
पाठ्यक्रम की जानकारी शामिल है। | |||||||||||
इसमें कक्षाएं और प्रशिक्षक (कर्मचारी) की जानकारी शामिल है। | |||||||||||
इसमें कक्षा, विद्यार्थी और स्थान (रोस्टर) की जानकारी शामिल है। | |||||||||||
इसमें स्थान (विद्यालय या विभाग) की जानकारी शामिल है। | |||||||||||
टेम्प्लेट और प्रबंधित Apple खाते
अगर कोई विकल्प फ़ील्ड—जैसे कि person_number या sis_username—आपके प्रबंधित Apple खाता प्रारूप का हिस्सा है, तो वह एक आवश्यक फ़ील्ड बन जाता है। अगर आप इसे खाली छोड़ देते हैं, तो 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 दिनों के बाद ऑटोमैटिकली डिलीट कर दिया जाएगा, जब तक कि :
यूजर की भूमिका ऐसी है कि उसने बड़ी मात्रा में ऐप्स या किताबें ख़रीदी हैं।
यूज़र को 120-दिन की सीमा से पहले मैन्युअल रूप से डिलीट कर दिया जाता है
.csv फ़ाइलों के नाम मूल फ़ाइल के नाम से पूरी तरह मेल खाने चाहिए।
अपलोड करने के लिए सभी फ़ाइलों को एक (.zip) आर्काइव फ़ाइल में कंप्रेस करना होगा।
ज़िप की गई आर्काइव फ़ाइल के फ़ोल्डर में कोई फ़ाइल नहीं रखी जा सकती है।
अन्य .csv फ़ाइलों में सभी विदेशी-कुंजी संदर्भ संदर्भित फ़ाइल में निर्धारित किए जाने चाहिए।
.csv टेम्पलेट में वर्ण सीमाएँ
.csv टेम्पलेट में कुछ फ़ील्ड में वर्णों की संख्या की सीमाओं की अनुमति होती है।
विशेषता का नाम | टेम्पलेट | वर्ण सीमा |
|---|---|---|
Apple : first_name OneRoster : givenName | Apple : विद्यार्थी, स्टाफ़ OneRoster : यूज़र | 32 |
Apple : middle_name OneRoster : middleName | Apple : विद्यार्थी, स्टाफ़ OneRoster : यूज़र | 32 |
Apple : last_name OneRoster : familyName | Apple : विद्यार्थी, स्टाफ़ OneRoster : यूज़र | 64 |
Apple : grade_level OneRoster : ग्रेड | Apple : विद्यार्थी OneRoster : यूज़र | 64 |
Apple : email_address OneRoster : ईमेल | Apple : विद्यार्थी OneRoster : यूज़र | 256 |
Apple : person_number OneRoster : पहचानकर्ता | Apple : विद्यार्थी, स्टाफ़ OneRoster : यूज़र | 64 |
Apple : person_id OneRoster : sourcedId | Apple : विद्यार्थी, स्टाफ़, कक्षाएँ, रोस्टर OneRoster : यूज़र, कक्षाएँ, नामांकन | 256 |
Apple : sis_username OneRoster : यूज़रनेम | Apple : विद्यार्थी, स्टाफ़ OneRoster : यूज़र | 256 |
Apple : class_id OneRoster : sourcedID | Apple : कक्षाएँ, रोस्टर OneRoster : कक्षाएँ, नामांकन | 256 |
Apple : class_number OneRoster : classCode | Apple : विद्यार्थी, कक्षाएँ OneRoster : कक्षाएँ | 64 |
Apple : course_id OneRoster : sourcedID | Apple : विद्यार्थी, कक्षाएँ OneRoster : विद्यार्थी, कक्षाएँ | 256 |
Apple : course_name OneRoster : शीर्षक | Apple : पाठ्यक्रम OneRoster : पाठ्यक्रम | 128 |
Apple : course_number OneRoster : courseCode | Apple : पाठ्यक्रम OneRoster : पाठ्यक्रम | 64 |
Apple : location_name OneRoster : नाम | Apple : स्थान OneRoster : संगठन | 256 |
Apple : location_id OneRoster : sourcedID | Apple : विद्यार्थी, स्टाफ़, पाठ्यक्रम, कक्षाएँ, स्थान OneRoster : यूज़र, पाठ्यक्रम, कक्षाएँ, संगठन | 256 |