في إصدار أبريل 2022، أجرينا بعض التغييرات على المجموعات لمعالجة المشكلات المتعلقة بالمهلات أثناء إنشاء المجموعات داخل Brightspace. تعني التغييرات التي أجريناها أن إنشاء فئات المجموعة ومجموعاتها الفرعية وأي تسجيلات تتم معالجتها الآن من خلال مهمة خلفية تضمن إنشاء المجموعات دائما بنجاح ، وتتم معالجة تسجيلاتها كما هو متوقع في كل مرة. في السابق ، ربما تكون قد رأيت إخفاقات أثناء إنشاء فئات المجموعة مما يجعل الطريقة القديمة للإنشاء غير موثوقة. في الوقت الحالي، يتم تطبيق هذه التغييرات فقط على إنشاء المجموعة داخل واجهة Brightspace - في أداة المجموعات.
في إصدار يونيو 2022، أو 20.22.06، سنقوم بإجراء نفس التغيير على واجهات برمجة تطبيقات إنشاء المجموعة الخاصة بنا لتوفير نفس المزايا لوسيلة إنشاء المجموعة هذه. اعتبارا من يونيو ، عند استخدام مسار واجهة برمجة التطبيقات "POST /d2l/api/lp/(version)/(orgUnitId)/groupcategories/" لإنشاء فئة مجموعة جديدة في وحدة تنظيمية ، ستتلقى استجابة مختلفة لرمز الحالة - 202 مقبول - من شأنها أن تشير إلى أن طلبك قد تم قبوله ولكن لم يكتمل بعد. ستتمكن بعد ذلك من استخدام مسار واجهة برمجة تطبيقات جديد للتحقق من حالة طلب إنشاء فئة المجموعة للتأكد من اكتماله بنجاح. عادة ما يرى المستخدمون الذين ينشرون على واجهة برمجة التطبيقات هذه رسالة حالة 200 موافق إذا نجح الإجراء.
ستفشل أي مسارات لواجهة برمجة التطبيقات مثل استدعاءات PUT أو POST أو DELETE مقابل إنشاء فئة المجموعة التي تتم معالجتها حاليا مع استجابة رمز الحالة الجديدة - تعارض 409 - مما يشير إلى أن إنشاء فئة المجموعة لم يكتمل بعد، ولا يمكن إجراء أي تغييرات على فئة المجموعة في الوقت الحالي.
لماذا نجري هذا التغيير؟
لكي ننتقل إلى وسيلة أكثر قوة لإنشاء المجموعات وتوفير الفوائد التي توفرها لنا طريقة إنشاء الخلفية الجديدة ، نحتاج إلى التأكد من تطبيق هذا التغيير على جميع طرق إنشاء المجموعات ، سواء داخل واجهة المستخدم أو عبر واجهات برمجة التطبيقات الخاصة بنا في هذا الوقت.
ماذا يعني هذا بالنسبة لي؟
إذا كنت تستخدم واجهة برمجة تطبيقات فئة المجموعة كجزء من عمليتك لإنشاء مجموعات داخل الوحدات التنظيمية، فستحتاج إلى توقع استجابة مختلفة لرمز الحالة وتكون قادرا على التعامل معها بنجاح.