🔌 API و یکپارچه‌سازی

اتصال Moodle به رایان‌استریم

فعالیت دوره مودل را به اتاق رایان‌استریم متصل کنید و نقش، زمان‌بندی و گزارش حضور را سازگار نگه دارید.

نویسنده: تیم محتوای رایان‌استریمبازبینی فنی: تیم محصول رایان‌استریم5 دقیقه
فعالیت دوره مودل را به اتاق رایان‌استریم متصل کنید و نقش، زمان‌بندی و گزارش حضور را سازگار نگه دارید. در این راهنما مسیر تنظیم، آزمون و سنجش نتیجه را بر اساس امکانات واقعی رایان‌استریم مرور می‌کنیم.

گام‌به‌گام

  1. کانکتور محلی را در محیط staging نصب کنید.
  2. شناسه دوره و فعالیت را به اتاق متناظر نگاشت کنید.
  3. نقش teacher و student را جدا آزمایش کنید.
  4. گزارش بازگشت حضور و رفتار حذف دوره را کنترل کنید.

مسیر اتصال Moodle در چهار گام

گام اول، تعیین منبع حقیقت است: کاربر در Moodle ساخته می‌شود یا در پلتفرم کلاس؟ بدون این تصمیم، همگام‌سازی دوطرفه به تناقض می‌رسد. پیشنهاد رایج: Moodle منبع کاربر و ثبت‌نام، پلتفرم منبع جلسه.

گام دوم، احراز هویت یکپارچه است تا دانشجو با همان حساب وارد کلاس شود. گام سوم، ساخت خودکار جلسه از روی تقویم دوره. گام چهارم، برگرداندن گزارش حضور و ضبط به Moodle.

ترتیب اجرا را عوض نکنید. بیشتر اتصال‌های نیمه‌کاره از شروع با گزارش و پایان با هویت کاربر به وجود آمده‌اند.

  • منبع حقیقت کاربر را مشخص کنید
  • SSO را قبل از ساخت خودکار جلسه بگذارید
  • گزارش را آخرین گام بگذارید

نگهداری پس از اتصال

بعد از راه‌اندازی، سه چیز نیاز به مراقبت دارد: توکن دسترسی (تاریخ انقضا و جای نگهداری)، رفتار در خطای شبکه (تکرار درخواست با شناسهٔ یکتا)، و لاگ تطبیق کاربران برای پیدا کردن حساب‌های تکراری.

یک آزمون ماهانهٔ کوچک بگذارید: ساخت یک جلسهٔ آزمایشی و بررسی اینکه در Moodle دیده می‌شود. این آزمون ساده، خرابی خاموش را زودتر از کاربر نشان می‌دهد.

  • انقضای توکن را تقویم کنید
  • شناسهٔ یکتا برای ساخت جلسه
  • آزمون ماهانهٔ ساخت جلسه

چه چیزی را قبل از اتصال آماده کنیم

قبل از شروع، چهار چیز را آماده کنید: دسترسی مدیر به هر دو سیستم، فهرست دوره‌های فعال، قاعدهٔ نام‌گذاری جلسات، و تصمیم دربارهٔ نقش‌ها (مدرس، دستیار، دانشجو).

قاعدهٔ نام‌گذاری جلسه مهم است چون تکراری‌شدن جلسات معمولاً از نام‌های متفاوت برای یک جلسه می‌آید. یک الگوی ثابت بگذارید: نام دوره، شمارهٔ جلسه، تاریخ.

همچنین مشخص کنید چه کسی مسئول پاسخ به خطاهای همگام‌سازی است. بدون مالک مشخص، لاگ خطاها خوانده نمی‌شود و مشکل تا شکایت کاربر پنهان می‌ماند.

هزینهٔ نگهداری اتصال

هر اتصال یک هزینهٔ نگهداری ماهانه دارد: بررسی توکن، بررسی لاگ، آزمون ساخت جلسه، و به‌روزرسانی در صورت تغییر نسخه. این هزینه را از قبل در برنامهٔ تیم بگذارید.

اگر تیم فنی کوچک است، اتصال را ساده نگه دارید: یک جهت همگام‌سازی، یک منبع حقیقت، و حداقل داده. هر قابلیت اضافه، یک نقطهٔ شکست اضافه است.

برای تغییر نسخه‌ها، یک محیط آزمایشی کوچک داشته باشید. آزمایش اتصال روی محیط واقعی، ریسک قطعی کلاس را بالا می‌برد.

رفع خطاهای رایج اتصال

خطای احراز هویت معمولاً از انقضای توکن یا تفاوت دامنه می‌آید؛ اول تاریخ توکن را بررسی کنید. خطای ساخت جلسه بیشتر از نبود مدرس یا دوره در سیستم مقصد است.

برای هر خطا یک پیام روشن در لاگ بنویسید که شامل شناسهٔ کاربر، شناسهٔ جلسه و علت باشد. لاگ مبهم، عیب‌یابی را به حدس تبدیل می‌کند.

یک قاعدهٔ ساده بگذارید: هر خطای همگام‌سازی که دو بار تکرار شود، باید در همان هفته بررسی شود. خطاهای تکرارشوندهٔ نادیده‌گرفته‌شده، به خرابی انبوه تبدیل می‌شوند.

مستندسازی اتصال

یک صفحه مستند کوتاه بنویسید: اجزای سیستم، جهت همگام‌سازی، محل نگهداری توکن، و مراحل عیب‌یابی. این صفحه در روز خرابی، ارزشش را نشان می‌دهد.

مستند را کنار کد نگه دارید، نه در فایل شخصی. اگر فرد مسئول تغییر کند، مستند تنها چیزی است که می‌ماند.

خطاهای رایج

  • استفاده از credential تولید در staging
  • عدم تطبیق منطقه زمانی
  • حذف نگاشت پیش از نگهداری گزارش لازم

چک‌لیست بررسی

  • تنظیمات در اتاق آزمایشی ذخیره و بازبینی شده است
  • دسترسی نقش مدرس و شرکت‌کننده جداگانه آزموده شده است
  • یک مسیر جایگزین برای اینترنت یا دستگاه ضعیف تعریف شده است
  • نتیجه جلسه برای بهبود اجرای بعد ثبت می‌شود

پرسش‌های متداول

آیا همگام‌سازی دوطرفه لازم است؟

در بیشتر موسسات نه. یک منبع حقیقت و همگام‌سازی یک‌طرفه، خطا و تناقض کمتری می‌سازد.

اگر ایمیل دانشجو در دو سیستم یکی نباشد؟

از شناسهٔ داخلی به‌عنوان کلید نگاشت استفاده کنید و ایمیل را فقط برای اطلاع‌رسانی نگه دارید.

این مقاله مفید بود؟

0 بازخورد مفید · 0 بازخورد نیازمند بهبود
گزارش مقاله ناقص یا قدیمی
این محتوا بر پایه قابلیت‌های واقعی رایان‌استریم نوشته و توسط تیم محصول بازبینی شده است. اگر رابط کاربری حساب شما متفاوت است، از گزینه «گزارش مقاله ناقص» استفاده کنید.