الاتصال بـ 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	رقم	لا	حد تشغيل الإنذار

ارتباطات مفيدة

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