السابق

التالي

تحسين تجربة التضمين

مكتمل

يمكنك استخدام تقنيتين لتحسين تجربة التضمين: Bootstrap و Phased embedding.

استخدام نظام تمهيد تشغيل الكمبيوتر

حقق أداء تضمين أسرع باستخدام powerbi.bootstrap(embedContainer, config) الوظيفة. تقوم هذه الوظيفة بإعداد العنصر وتهيئته iframe قبل تعيين كافة معلمات التكوين المطلوبة. powerbi.embed(embedContainer, config) يجب استدعاء الوظيفة بمجرد تعيين جميع معلمات التكوين.

توضح التعليمة البرمجية التالية كيفية إعداد العنصر الخاص بتقرير iframe Power BI وتهيئته.

powerbi.bootstrap(embedContainer, { type: 'report' });

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

ملاحظة

لا يمكن استخدام وظيفة التمهيد عند تضمين التقارير التي تم ترقيمها.

لمزيد من المعلومات، راجع استخدام التمهيد للحصول على أداء أفضل.

استخدام التضمين المرحلي

عندما يكون محتوى Power BI المراد تضمينه في صفحة مختلفة من تطبيقك، فهناك تقنية بديلة لتسريع التضمين وتحسين تجربة المستخدم.

ملاحظة

عند التضمين في نفس الصفحة، نوصي باستخدام تقنية bootstrap (الموضحة سابقاً) لأنها أسرع.

استخدم powerbi.preload(config)الوظيفة للتمرير في كائن تكوين بسيط يتكون فقط من type و embedUrl الخصائص. embedUrl يجب أن تكون القيمة عنوان URL أساسياً، مما يعني أنها لا تحتاج إلى معرف أداة محدد. يساعد التحميل المسبق على تسريع التضمين عن طريق تنزيل البرامج النصية المطلوبة لتضمين محتوى Power BI قبل انتقال المستخدم إلى الصفحة.

// Building the configuration object
let config = {
    type: 'report',
    embedUrl: 'https://app.powerbi.com/reportEmbed',
};

let element = powerbi.preload(config);

يتم preloaded تشغيل الحدث عند اكتمال التحميل المسبق

element.on('preloaded', function () {
    ...
});

powerbi.load(embedContainer, config) استخدم الوظيفة لتغيير الإعدادات في div العنصر ديناميكياً قبل عرض المحتوى. على سبيل المثال، يمكنك استخدام هذه الوظيفة للحصول على معلومات حول صفحات التقرير ثم تحديد الصفحة التي تريد عرضها للمستخدم. إذا كنت تستخدم هذه الدالة، فيجب عليك أيضاً استدعاء powerbi.render() الدالة لإظهار المحتوى المضمن.

معاً، تحقق load و render الوظائف نفس النتيجة مثل الوظيفة embed.

على الرغم من أنه يجب عليك استخدام loadو render الوظائف معاً، preload إلا أنها مستقلة عنها. يمكنك استخدام الدالة لإظهار الكائن embed المضمن بعد التحميل المسبق. يمكنك أيضاً استخدام الإجراء الكامل عن طريق الاتصال preload و load و renderبهذا الترتيب.

لمزيد من المعلومات، راجع استخدام التضمين المرحلي.

للحصول على مواضيع التحسين الأخرى، راجع أفضل الممارسات للحصول على أداء أسرع في تحليلات Power BI المضمنة.

متابعة