تكامل Ally API مع أداة إعداد تقارير خارجية

توفر أدوات إعداد التقارير الخارجية العديد من المزايا، بما في ذلك العرض المرئي المحسَّن للبيانات وخيارات التخصيص وعمليات إعداد التقارير التلقائية. يمكن للمؤسسات تحليل مجموعات البيانات المعقدة بسهولة باستخدام مجموعة متنوعة من أنواع المخططات والرسوم البيانية ولوحات المعلومات. من خلال تخصيص عناصر البيانات المعروضة، يمكن للمؤسسات تخصيص التقارير وفقًا لاحتياجاتها الخاصة. باستخدام التقارير التلقائية، يوفر المستخدمون وقتًا وموارد ثمينة، ما يبسِّط عملية إنشاء التقارير.

من خلال الجمع بين إمكانات استرداد البيانات لـ Ally API وميزات العرض المرئي والتحليل المتقدمة لأدوات إعداد التقارير الشائعة، يمكن للمؤسسات اكتشاف رؤى تسهِّل عليها اتخاذ قرارات مستندة إلى البيانات.

لا تتردد في الاطلاع على الوثائق الفنية لنقاط نهاية API الخاصة بإعداد التقارير لمعرفة كيفية إعداد نقاط النهاية وتخصيصها بشكل مناسب.

قبل البدء

لتحقيق تكامل Ally API مع أداة إعداد التقارير المفضلة لديك، ستحتاج إلى ما يلي:

• أداة إعداد تقارير خارجية، مثل Power BI أو Tableau أو Microsoft Excel أو SAP Analytics وغيرها
• الوصول إلى التقرير المؤسسي في Ally (من صلاحيات المسؤول فحسب)
• رمز API المميز المعني بالتخويل (متاح في التقرير المؤسسي)
• عنوان URL لنقطة النهاية (متوفر في صفحة المساعدة هذه)
• معرِّف عميل Ally الخاص بك (اتصل بفريق الدعم لدينا إذا لم يكن لديك هذا المعرِّف)

ضع في اعتبارك أنه سيتعين عليك التبديل بين صفحة المساعدة هذه والتقرير المؤسسي وأداة إعداد التقارير الخارجية لإعداد كل شيء بنجاح. 

كيفية تكامل Ally API مع أداة إعداد التقارير الخارجية

• قم بالوصول إلى التقرير المؤسسي الخاص بك. تعرَّف على كيفية الوصول إلى التقرير المؤسسي.
• في علامة التبويب نظرة عامة، حدد الزر تصدير على اليسار.
• حدد "Connect external tool" (أداة Connect خارجية).  
  

• ستظهر نافذة مشروطة تحوي رمزًا مميزًا تم إنشاؤه تلقائيًا. حدد نسخ الرمز المميز.

تنتهي صلاحية رموز API المميزة بعد عام واحد. للحصول على رمز مميز جديد، اتبع هذا الدليل لإعداد أداة إعداد التقارير الخارجية مرة أخرى.    

• انتقل إلى أداة إعداد التقارير الخارجية المفضلة لديك. لغرض هذا المثال، سنوضح كيفية إعداد API الخاصة بـ Ally مع Power BI.
   

أدوات إعداد التقارير الخارجية الأخرى لها واجهات مختلفة، ومع ذلك، فإنها جميعًا تتبع خطوات مماثلة كما هو موضح أدناه. يُرجى الرجوع إلى وثائق أداة إعداد التقارير الخاصة بك إذا كنت بحاجة إلى مساعدة في إعداد مصدر بياناتك.  
 

• افتح برنامج Power BI Desktop
• حدد "Get Data" (الحصول على البيانات) من خيارات علامة التبويب "Home" (الصفحة الرئيسية). 
• حدد "ًWeb" (الويب) من القائمة المعروضة.
    

• حدد الخيار "Advanced" (متقدم) في النافذة المشروطة "From web (من الويب). 
• اكتب التخويل في حقل معلمة رأس طلب HTTP.
• في مربع النص الموجود على اليسار، اكتب حامل التخويل، وأضف مسافة، ثم ألصق الرمز المميز الوارد في التقرير المؤسسي.
• انسخ أحد عنوانَي URL التاليين لنقطة النهاية:
  • https://[Region]/api/v2/clients/[Ally Client ID]/reports/overall
  • https://[Region]/api/v2/clients/[Ally Client ID]/reports/issues 

يمكن تقسيم بيانات "تقرير Ally" إلى "نظرة عامة" و"المشكلات". وكلاهما ينطبق على جميع مقرراتك الدراسية في مؤسستك. حدد عنوان URL لنقطة النهاية حسب تفضيلك.  

• ألصق عنوان URL لنقطة النهاية في حقل مسارات عناوين URL في النافذة المشروطة "From Web" (من الويب) في برنامج Power BI.
• استبدل [معرّف عميل Ally]بمعرّف Ally الفريد الخاص بك.

إذا لم يكن لديك هذا المعرِّف، يُرجى الاتصال بفريق الدعم لدينا. تذكر أن المعرّف هو معرّف عميل Ally وليس معرّف LMS.

• استبدل [Region] استنادًا إلى المنطقة المستضاف فيها بيئة Ally الخاصة بمؤسستك:
  • مركز بيانات الولايات المتحدة: prod.ally.ac
  • مركز البيانات الكندي: prod-ca-central-1.ally.ac
  • مركز البيانات الأوروبي: prod-eu-central-1.ally.ac
  • مركز البيانات السنغافوري: prod-ap-southeast-1.ally.ac
  • مركز البيانات الأسترالي: prod-ap-southeast-2.ally.ac
• بمجرد اكتمال هذه الخطوات، يجب أن تبدو النافذة المشروطة "From WEB" (من الويب) في Power BI على هذا النحو: 

• حدد موافق لبدء الاستعلام استنادًا إلى المعلومات المقدمة.

بناءً على عدد السجلات، قد تحتاج مجموعة البيانات إلى بعض الوقت اللازم للإعداد. يستجيب Ally بـ "حالة" لإعلام المستخدم إذا ما زالت البيانات قيد المعالجة أم لا. في Power BI، يمكنك رؤية هذا عن طريق تحديد "Expanded metadata" ("بيانات التعريف الموسعة) والبحث في عمود metadata.status:

بينما تكون الحالة هي "Processing" (جارٍ المعالجة)، ستحتاج إلى الانتظار حتى تصبح البيانات جاهزة. حدد زر "Refresh preview" (تحديث المعاينة) على الشريط العلوي لاستدعاء API مرة أخرى ومعرفة ما إذا كانت البيانات جاهزة أم لا. إذا كانت مجموعة البيانات جاهزة، فستُعرَض كل السجلات وسيعرض عمود metadata.status الحالة "Successful" (نجاح).

• وفي النهاية، حدد "Close & Apply" (إغلاق وتطبيق) في أعلى الجانب الأيمن.

وقت تحديث البيانات 
يتم تحديث بيانات المصدر داخليًا كل 15 دقيقة لأي من نقاط النهاية. ضع هذا في اعتبارك عند استدعاء نقطة النهاية لاسترداد البيانات من أجل إعداد تقاريرك. 

حد الاستجابة
ضع في اعتبارك أن حد الاستجابة لكل استدعاء لنقطة النهاية هو 10000 سجل. إذا لم تُعرَض بعض السجلات ضمن أول 10000 سجل، فستحتاج إلى استخدام خيارات التصفية أو الفرز.