Motimate: كيفية دمج واجهة برمجة تطبيقات Motimate العامة مع PowerBI؟

هل تتمنى أن يكون لديك دائمًا لوحات معلومات وتحليلات مباشرة ومحدثة لبيانات Motimate الخاصة بك؟ لا مزيد من البحث، فباستخدام واجهة برمجة التطبيقات العامة الخاصة بنا، يمكنك الحصول على جميع بيانات واجهة برمجة التطبيقات مباشرةً في أدوات مثل PowerBI من Microsoft. نوضح لك هنا كيفية إعداد ذلك! ✨

قبل أن تذهب إلى أبعد من ذلك، تأكد من تمكين واجهة برمجة التطبيقات العامة في MotiSpace. إذا لم يكن الأمر كذلك، اكتشف المزيد هنا.

إنشاء رمز وصول مميز في ساعي البريد

• افتح Postman وقم بإجراء مكالمة POST API إلى نقطة نهاية المصادقة للحصول على رمز مميز.
   
• انسخ الرمز المميز الذي تم إنشاؤه للاستخدام المؤقت في PowerBI.

استخدم الآن رمز الوصول المميز لاسترداد البيانات في PowerBI

• افتح Power BI وانقر فوق الحصول على البيانات -> حدد الويب -> انقر فوق اتصال.
  
  
   
• في نافذة اتصال الويب، حدد متقدم.
   
• الصق عنوان URL الخاص بواجهة برمجة التطبيقات لمصدر البيانات
  أي. https://motimateapp.com/public_api/my_organization
   
• في قسم العناوين، أضف:
  • المفتاح التفويض
  • القيمة: "Bearer <<Token تم إنشاؤه من Postman>>"
    
    
     
• انقر فوق موافق للمتابعة.

سيُفتح محرر استعلام الطاقة Power Query Editor، ويعرض البيانات المسترجعة.

إنشاء استعلام لتوليد الرموز بشكل ديناميكي

نظرًا لانتهاء صلاحية رموز واجهة برمجة التطبيقات العامة ل Motimate Public API بعد 24 ساعة، يجب على PowerBI إنشاء رمز مميز جديد ديناميكيًا قبل كل استدعاء لواجهة برمجة التطبيقات لضمان صلاحية الرمز المميز دائمًا. يمكن إعداد ذلك باتباع الخطوات التالية:

• في محرر استعلام الطاقة، انقر فوق مصدر جديد -> استعلام فارغ.
  
  
  
  
• بمجرد فتح الاستعلام الفارغ، انتقل إلى المحرر المتقدم .
  
  
  
  
• أدخل استعلام Power Query M التالي، واستبدل النص الغامق ببيانات الاعتماد الخاصة بك:
  
  

  دع
  url ="https://motimateapp.com/public_api/oauth/token"،
  headers = [#"Content-Type" = "application/json"]،
  postData = Json.FromValue([
  
  client_id="<<معرف العميل الخاص بك>>"، 
  client_secret="<<سر العميل الخاص بك>>"، 
  grant_type=" client_credentials"
  
  ])،
  response = Web.Contents(
  url,
  [
  Headers = headers,
  Content = postData
  ]
  ),
  Data = Json.Document(response),
  access_token = Data[access_token]
  في
  access_token
  
  

• انقر فوق تم.
  
   
• تحقق من الخطوات المطبقة لتأكيد إنشاء رمز مميز:
  
  

تحويل الاستعلام إلى دالة

• الآن أعد تسمية الاستعلام إلى "GetToken".
  
  
   
• انقر بزر الماوس الأيمن على GetToken وافتح المحرر المتقدم
  
  
  
   
• قم بتعديل الاستعلام بإضافة "() =>" في البداية (قبل كلمة "دع"). سيؤدي ذلك إلى تحويل الاستعلام إلى دالة.
  
  
   
• انقر فوق تم.

استبدل رمز الوصول المرمّز بالوظيفة

• افتح استعلام مجموعة البيانات الرئيسية في المحرر المتقدم.
  
  
   
• ابحث عن الرمز المميز المشفر في قسم "الرؤوس"، واستبدل الرمز المميز نفسه بدالة GetToken(). يجب أن يبدو الآن على النحو التالي:
  
  تخويل = "حامل"&GetToken ()
  (تأكد من ترك مسافة بين كلمة حامل وعلامة الاقتباس اللاحقة، كما هو موضح أعلاه)
  
  
   
• انقر فوق تم.
• وأخيراً، انقر فوق إغلاق & تطبيق.
  
  

تهانينا! لقد قمت بإعداد تقرير في PowerBI بمنطق الرمز المميز الديناميكي 🎉

والآن، سينشئ PowerBI رمزًا مميزًا بشكل ديناميكي قبل كل مكالمة لواجهة برمجة التطبيقات، مما يضمن تحديثات سلسة للبيانات دون تدخل يدوي. يعمل هذا النهج على تبسيط استرجاع البيانات وتحسين الأتمتة.