تضمين أنواع محتويات Power BI أخرى

  • 5 دقائق

يمكنك تضمين أي نوع من محتوى Power BI في تطبيقاتك، بما في ذلك تقارير Power BI ومرئيات التقارير والتقارير المرقمة ولوحات المعلومات وتجانب لوحات المعلومات وتجربة Q&A. على عكس تقارير Power BI، لا يمكن تحرير أنواع المحتويات الأخرى هذه أو إنشائها.

تضمين مرئيات تقرير Power BI

يمكنك تضمين مرئيات تقرير واحد تم الحصول عليها من تقرير Power BI. استخدم كائن تكوين من النوع IVisualLoadConfiguration. بالإضافة إلى الخصائص المطلوبة (الموضحة في الوحدة 1؛ type يتم تعيين الخاصية إلى visual)، يجب عليك أيضاً تعيين الخصائص التالية.

  • pageName - مطلوب اسم الصفحة التي تحتوي على الصورة المرئية التي تقوم بتضمينها. يمكنك استخدام الدالة Report getPages للحصول على الصفحات الموجودة في التقرير.
  • visualName - مطلوب. اسم المرئي الذي تقوم بتضمينه. يمكنك استخدام الدالة Page getVisuals للحصول على المرئيات في صفحة.

يمكن لتطبيقك تطبيق عوامل التصفية على المرئي باستخدام وظيفة updateFilters.

تلميح

لا تقم بتضمين الكثير من المرئيات التي يتم الحصول عليها من صفحة واحدة لأنها قد لا تعمل بشكل جيد. أيضاً، إذا كنت بحاجة إلى مزيد من التحكم عند تضمين العديد من المرئيات من نفس التقرير، فيمكنك تحقيق ذلك بشكل أكثر كفاءة باستخدام custom layouts. لمزيد من المعلومات حول التخطيطات المخصصة، راجع Personalize a report layout.

للحصول على وصف كامل لتضمين مرئيات تقرير Power BI، راجع Embed a report visual.

تضمين تقارير مرقمة

يمكنك تضمين التقارير المرقمة باستخدام كائن تكوين من النوع IEmbedConfigurationBase. بالإضافة إلى الخصائص المطلوبة (الموضحة في الوحدة 1؛ type يتم تعيين الخاصية إلى report)، يجب عليك أيضاً تعيين الخصائص التالية.

  • id - مطلوب. معرف مساحة العمل (GroupID) الذي يحتوي على التقرير المرقم بالصفحات.
  • uniqueId - مطلوب. معرف التقرير للتقرير المرقم بالصفحات.

هناك أيضاً settings خاصية، وهي اختيارية. يمكنك تمرير كائن من النوع IPaginatedReportSettings لتحديد معلومات حول مظهر لوحة معلمات التقرير. يمكن لتطبيقك تمكين فتح اللوحة وتوسيعها.

لتعيين معلمات التقارير المرقمة إلى صفحات، قم بتمريرها في عنوان URL المضمن. ومع ذلك، لا يمكن تعيين قيم متعددة المعلمات. لمزيد من المعلومات، راجع تمرير معلمة تقرير في عنوان URL لتقرير مرقم في Power BI.

للحصول على وصف كامل لتضمين التقارير المرقمة حسب الصفحات، راجع تضمين تقرير مرصوف رقمياً.

تضمين لوحات المعلومات

يمكنك تضمين لوحات المعلومات باستخدام كائن تكوين من النوع IDashboardLoadConfiguration. بالإضافة إلى الخصائص المطلوبة (الموضحة في الوحدة 1؛ type يتم تعيين الخاصية إلى dashboard)، يجب عليك أيضاً تعيين pageViewالخاصية. وتشمل الخيارات ما يلي:

  • fitToWidth - يتطابق عرض لوحة المعلومات المضمنة مع عرض العنصر الذي div يحتوي على لوحة المعلومات.
  • oneColumn - تظهر لوحة المعلومات المضمنة في عمود واحد. هذا الخيار مناسب للأجهزة الصغيرة ذات الشكل، مثل الهاتف المحمول.
  • actualSize - تظهر لوحة المعلومات المضمنة بالحجم الكامل.

للحصول على وصف كامل لتضمين لوحات المعلومات، راجع Embed a dashboard.

تضمين تجانب لوحة المعلومات

يمكنك تضمين تجانب لوحات المعلومات باستخدام كائن تكوين من النوع ITileLoadConfiguration. بالإضافة إلى الخصائص المطلوبة (الموضحة في الوحدة 1؛ type يتم تعيين الخاصية إلى tile)، يجب عليك أيضاً تعيين الخصائص التالية.

  • dashboardId - مطلوب. معرف لوحة المعلومات الخاص بلوحة المعلومات التي تحتوي على اللوحة.
  • id - مطلوب. معرف تجانب لوحة المعلومات. يمكنك استخدام واجهة برمجة تطبيقات Power BI REST للحصول على تجانبات لوحة المعلومات وخصائصها.

للحصول على وصف كامل لتضمين لوحات المعلومات، راجع Embed a dashboard tile.

تضمين تجربة Q&A

يمكنك تضمين تجربة Q&A باستخدام كائن تكوين من النوع ILoadQnaConfiguration. بالإضافة إلى الخصائص المطلوبة (الموضحة في الوحدة 1؛ type يتم تعيين الخاصية إلى qna)، يجب عليك أيضاً تعيين الخصائص التالية.

  • datasetIds - مطلوب. مجموعة من معرفات مجموعة البيانات. ومع ذلك، يتم حالياً دعم DatasetID واحد فقط.
  • viewMode - اختياري. إما QnaMode.Interactive، مما يسمح للمستخدم بإدخال الأسئلة، أو QnaMode.ResultOnly، والذي يتطلب سؤالاً مقدماً.
  • question - اختياري. السؤال الذي يوفره تطبيقك. viewModeيجب تعيين الخاصية إلى QnaMode.ResultOnly.

تلميح

يمكن أن يساعد التشجيع على استخدام الأسئلة والأجوبة في تقليل عدد التقارير ولوحات المعلومات التي تحتاج إلى تطويرها. يمكنك تضمين Q&A مرئية من تقرير Power BI. يوفر هذا النهج القدرة على تنسيق المرئي، ويمكن للتطبيق تطبيق الفلاتر عليه.

للحصول على وصف كامل لتضمين تجربة Q&A، راجع Embed a standalone Q&A visual.