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 त्रुटि के साथ विफल हो जाता है।
टेम्पलेट तैयार करें
टेम्पलेट तैयार करते समय नीचे बताए गए मानदंड को पूरा करना ज़रूरी है :
संरचना
यह ज़रूरी है कि .csv फ़ाइलों के नाम वहीं हों जो मूल फ़ाइलों के नाम हैं।
किसी भी फ़ाइल की हेडर पंक्ति का नाम न बदलें।
किसी कॉलम को न हटाएँ, भले ही वह कॉलम खाली हो।
आप विद्यार्थी, स्टाफ़ और कक्षाएँ टेम्प्लेट में कॉलम जोड़ सकते हैं।
हर टेम्प्लेट में, हर पंक्ति में एक विशिष्ट वैल्यू दिखनी चाहिए। उदाहरण के लिए, students.csv फ़ाइल में हर पंक्ति एक में एक विद्यार्थी होना चाहिए।
students.csv और staff.csv टेम्पलेट के लिए, person_id सभी स्थानों के लिए विशिष्ट होनी चाहिए।
महत्वपूर्ण : अगर आप किसी नए यूज़र को अपलोड करने के लिए SFTP का उपयोग करते हैं और जो person_id आप असाइन करते हैं वह पहले से ही किसी और यूज़र को असाइन किया गया है, तो नया यूज़र Apple School Manager में मौजूदा यूज़र को ओवरराइट कर देता है। ओवरराइट पूरा होने के बाद, आप उस यूज़र को केवल SFTP के ज़रिए ही अपडेट कर सकते हैं।
कुछ मान खाली हो सकते हैं। उदाहरण के लिए, students.csv फ़ाइल में, मध्य नाम खाली हो सकता है।
उदाहरण के डेटा को अपने खुद के डेटा से बदलें।
प्रारूपण
शाब्दिक मान—उदाहरण क लिए, किसी नाम में मौजूद कोई पंक्ति विराम या उद्धरण चिह्न— को बैकस्लैश (\) के साथ रखा जाना चाहिए। उदाहरण के लिए : \"। दर्ज किए गए सभी पहचानकर्ता में अक्षर और संख्या, दोनों को शामिल किया जाना चाहिए जिसमें हायफ़न (-) को भी शामिल किया जा सकता है।
यदि आपकी वैल्यू में कोई स्पेस ( ) या अल्पविराम (,) शामिल है, तो इसके दोनों तरफ़ सीधे उद्धरण चिह्न (") का उपयोग करें। यदि आपकी वैल्यू में इनमें से कोई विशेष वर्ण शामिल नहीं है, तो उद्धरण चिह्न का उपयोग न करें। यदि आप जहाँ आवश्यक है वहाँ उद्धरण चिह्न का उपयोग नहीं करते हैं या आप कर्ली उद्धरण चिह्न का उपयोग करते हैं, तो आपको अपलोड करने की प्रक्रिया में गड़बड़ी का सामना करना पड़ेगा।
आपके .csv में दर्ज की गई वैल्यू को अल्पविराम (,) या अर्द्धविराम (;) से अलग-अलग किया जाना ज़रूरी है। इस पर इस बात का कोई असर नहीं पड़ता कि आपने फ़ाइल कैसे बनाई है। अल्पविराम (,) या अर्द्धविराम (;) और अगली वैल्यू के बीच स्पेस या टैब का उपयोग न करें। प्रत्येक फ़ाइल UTF-8 के रूप में एन्कोड होनी चाहिए। पंक्ति की समाप्ति दिखाने के लिए, UNIX नई पंक्ति की एन्कोडिंग \n का उपयोग करें।
अन्य .csv फ़ाइलों में मौजूद बाहर की सभी-कुंजी के संदर्भ के बारे में संदर्भित फ़ाइल में बताया जाना चाहिए।
अपलोड हो रहा है
यदि किसी पहले अपलोड की गई एंट्री गायब है, तो यूज़र खाता निष्क्रिय कर दिया जाएगा और 120 दिनों के बाद ऑटोमैटिकली डिलीट कर दिया जाएगा, जब तक कि :
यूजर की भूमिका ऐसी है कि उसने बड़ी मात्रा में ऐप्स या किताबें ख़रीदी हैं।
यूज़र को 120-दिन की सीमा से पहले मैन्युअल रूप से डिलीट कर दिया जाता है
अपलोड करने के लिए सभी .csv फ़ाइलों को एक ज़िप की गई (.zip) आर्काइव फ़ाइल में कंप्रेस करना होगा।
ज़िप की गई आर्काइव फ़ाइल के फ़ोल्डर में कोई फ़ाइल नहीं रखी जा सकती है।
.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 |