مشاركة عبر

الاتصال بـ Power BI من Power Apps

  • مقالة

Power BI.

إن Power BI عبارة عن مجموعة من الأدوات تحليلية لتحليل البيانات ومشاركة الرؤى. راقب عملك واحصل على الإجابات بسرعة من خلال لوحات المعلومات الغنية المتوفرة على كل جهاز. في تطبيقك، يمكنك التحقق من حالة تنبيهات البيانات التي قمت بإعدادها في خدمة Power BI. لمزيد من المعلومات حول تنبيهات البيانات في Power BI، انتقل إلى صفحة الوثائق.

يوضح لك هذا الموضوع كيفية إنشاء اتصال Power BI في تطبيق، ويذكر الدالات المتوفرة.

ملاحظة

اتصال Power BI غير قابل للتفويض.

المتطلبات الأساسية

استخدام اتصال Power BI في تطبيقك

سرد التنبيهات التي قمت بإعدادها في خدمة Power BI

  1. في قائمة إدراج، حدد المعرض، وأضف أيًا من معارض النص.

  2. لإظهار تنبيهات المستخدم الحالي، قم بتعيين خاصية العناصر الخاصة بالمعرض إلى الصيغة التالية:

    PowerBI.GetAlerts()

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

عرض حالة التنبيه

عرض حالة التنبيه، يمكنك استدعاء الدالة CheckAlertStatus مع معرف التنبيه الذي تم الحصول عليه من الخطوة السابقة.

يمكن تمرير معرف التنبيه اما كسلسلة حرفية (على سبيل المثال، "1234") أو كمرجع إلى قسم المعرض الذي تمت تعبئته باستخدام استدعاء GetAlerts(). (على سبيل المثال Gallery1.Selected.alertId)

للمتابعة، أضف تسمية، ثم عيّن خاصية النص إلى إحدى الصيغ التالية:

  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertTitle
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).currentTileValue
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertThreshold
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).isAlertTriggered

سيتم تحديث التسمية بواسطة الحالة الحالية للتنبيه.

عرض الدالات المتوفرة

يتضمن هذا الاتصال الدالات التالية:

اسم الدالة ‏‏الوصف
GetAlerts سرد التنبيهات التي قمت بإعدادها في خدمة Power BI
CheckAlertStatus التحقق من حالة تنبيه معين

GetAlerts

سرد التنبيهات التي قمت بإعدادها في خدمة Power BI.

خصائص الإدخال

بلا.

خصائص الإخراج

اسم الخاصية نوع البيانات مطلوب ‏‏الوصف
القيمة صفيف لا مجموعة من تنبيهات البيانات التي قمت بإعدادها في خدمة Power BI. سيتضمن كل عنصر في المجموعة:
  • alertTitle: عنوان التنبيه
  • alertId: معرف التنبيه
  • groupId: معرف المجموعة التي تم إنشاء التنبيه فيها

CheckAlertStatus

التحقق من حالة التنبيه.

ملاحظة

سيتم تقييد الطلبات الخاصة بنقطة النهاية هذه لكل تنبيه إذا تكررت الاستدعاءات.

خصائص الإدخال

اسم الخاصية نوع البيانات مطلوب ‏‏الوصف
alertId integer نعم معرف التنبيه، كما تم إرجاعه بواسطة GetAlerts

خصائص الإخراج

اسم الخاصية نوع البيانات مطلوب ‏‏الوصف
tileValue رقم لا قيمه اللوحة عند تشغيل التنبيه
tileUrl string لا عنوان URL للوحة حيث يوجد التنبيه
alertTitle string لا اسم التنبيه
isAlertTriggered boolean لا ما إذا تم تشغيل التنبيه في الوقت الحالي
alertThreshold رقم لا حد تشغيل الإنذار

اطلع على جميع الاتصالات المتوفرة.
تعرف على كيفية إضافة اتصالات إلى تطبيقاتك.