M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions m365con.net

المدونة · Mirko Peters

Microsoft Fabric Apps: ما هي وكيفية استخدامها

By ·

تتيح ميزة Fabric Apps (المعاينة) للمطورين بناء تطبيقات مدعومة بالبيانات على Microsoft Fabric باستخدام TypeScript. يشرح هذا الدليل ماهية الميزة، ومفتاح التشغيل للمسؤول، وكيفية إنشاء التطبيق ونشره، والأذونات، والحدود الحالية.

Automatically translated with AI from the original post. Read the English original

Fabric Apps ميزة في Microsoft Fabric، وهي في مرحلة المعاينة حاليًا، لبناء تطبيقات مدعومة بالبيانات. يكتب المطورون نماذج البيانات بلغة TypeScript، فيولّد Fabric مخطط قاعدة البيانات وواجهات GraphQL وتسجيل الدخول والاستضافة. وهي موجهة إلى المطورين لا إلى مؤلفي التقارير، وهي منفصلة عن تطبيقات Power BI.

النقاط الرئيسية

  • Fabric Apps ميزة في مرحلة المعاينة مبنية على Rayfin SDK. يعرّف المطورون نماذج البيانات بلغة TypeScript، ويولّد Fabric قاعدة البيانات وواجهة GraphQL والمصادقة والاستضافة.
  • يجب على مسؤول المستأجر أولًا تفعيل Fabric Apps (المعاينة) ضمن Tenant settings في بوابة إدارة Fabric، سواء لكامل المؤسسة أو لمجموعات أمان محددة.
  • يجب تعيين سعة Fabric لمساحة العمل. وتستهلك خدمات Fabric Apps وحدات السعة منها.
  • بعد النشر، يكون تسجيل الدخول عبر Fabric SSO من خلال Microsoft Entra ID فقط. ولا يعمل البريد الإلكتروني وكلمة المرور إلا للتطوير المحلي.
  • تذكر Microsoft حدودًا مثل عدم دعم العلاقات متعددة إلى متعددة، ومفاتيح التجميع المركّبة، وعدم دعم ALM وPrivate Link، لذا تحقق منها قبل اعتماد أي تصميم.

ما الذي تفعله Fabric Apps

تصف Microsoft Learn Fabric Apps بأنها مبنية على Rayfin SDK. تزيّن فئات TypeScript بمُزخرفات مثل @entity() أو @text() أو @uuid(). ومن هذا النموذج ينتج Fabric ما يلي:

  • جداول قاعدة بيانات، مع قاعدة بيانات SQL في Fabric بوصفها مخزنًا مُدارًا
  • نقطة نهاية GraphQL على المسار /api/graphql ضمن عنوان URL للواجهة الخلفية للتطبيق
  • قواعد تفويض على مستوى الصف عبر مُزخرفات @role
  • طرق عميل آمنة الأنواع
  • استضافة ثابتة للواجهة الأمامية

عند النشر باستخدام rayfin up، ينشئ Fabric عناصر فرعية ضمن التطبيق: قاعدة بيانات SQL في Fabric، والمصادقة، والمحتوى الثابت. لكل تطبيق نقطة نهاية خلفية واحدة بالصيغة https://<your-app>-app.rayfin.windows.net/، مع المسارين /api/graphql للبيانات و/auth للمصادقة.

من الإمكانات الموثقة الأخرى موصلات مُعرّفة الأنواع إلى lakehouse أو warehouse أو قاعدة بيانات SQL في Fabric أو semantic model، إضافةً إلى تخزين ملفات مُعرّف الأنواع مع سياسات وصول.

أين تناسب هذه الميزة

تذكر Microsoft الحالات التالية بوصفها ملائمة: النماذج الأولية السريعة، والأدوات الداخلية ولوحات المعلومات، واستكشاف البيانات باستخدام موصلات Fabric، وتطبيقات الذكاء الاصطناعي أو الوكلاء التي تحتاج إلى حالة دائمة. وتذكر أيضًا الحالات التي قد لا تناسبها: التطبيقات التي تحتاج إلى معاملات معقدة متعددة الخطوات أو إجراءات مخزنة، والتطبيقات التي تحتاج إلى موفري مصادقة مخصصين.

الخطوة 1: تفعيل إعداد المستأجر

هذه مهمة للمسؤول، ويجب إنجازها قبل أن يتمكن المستخدمون من إنشاء العنصر.

  1. سجّل الدخول إلى بوابة إدارة Fabric.
  2. افتح Tenant settings.
  3. ضمن Fabric Apps (preview)، اضبط مفتاح التبديل على Enabled.
  4. اختر المؤسسة بأكملها أو مجموعات أمان محددة.
  5. حدّد Apply.

قد تستغرق التغييرات بضع دقائق حتى تسري.

الخطوة 2: تحضير مساحة العمل

يجب أن تحتوي مساحة العمل على سعة Fabric مخصّصة. اختر سعة عند إنشاء مساحة العمل. لإنشاء تطبيق، تحتاج إلى الأذونات الخاصة بدور المساهم (Contributor) أو المسؤول (Admin) فيها. للعمل محليًا، ثبّت Node.js 20 أو إصدارًا أحدث.

الخطوة 3: إنشاء عنصر التطبيق

  1. في شريط التنقل الأيسر، حدّد Workspaces وافتح مساحة العمل الخاصة بك.
  2. حدّد New item، وابحث عن App، ثم حدّده.
  3. أدخل اسمًا، ثم حدّد Create.

تعرض البوابة بعد ذلك أمرًا لتنزيل مشروع محليًا. يكون بالشكل التالي:

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

الخطوة 4: التطوير والنشر

عدّل المشروع، أو اعمل مع GitHub Copilot، ثم اختبره مقابل الواجهة الخلفية في Fabric باستخدام npm run dev. انشره باستخدام npx rayfin up. للنشر إلى مساحة عمل أخرى، أضف --workspace <workspacename>. تحقّق من الواجهة الخلفية باستخدام npx rayfin up status.

يذكر التعليق الوارد في مثال الأسئلة المتداولة أن النشر الذي يتضمّن محتوى ثابتًا فقط باستخدام npx rayfin up staticapp deploy يستغرق من 30 إلى 60 ثانية بعد النشر الأولي. لا تذكر الصفحات التي قرأتها أي مدة للنشر الأول. لا يمكن للنشر الثابت فقط إنشاء التطبيق البعيد الأولي، لذا شغّل npx rayfin up مرة واحدة أولًا. للتراجع، انتقل إلى الالتزام (commit) السابق في git، ثم شغّل npx rayfin up مرة أخرى.

ما تراه في بوابة Fabric

بعد تنفيذ rayfin up، يعرض عنصر التطبيق عناصر فرعية أنشأها Fabric من إعدادات rayfin.yml الخاصة بك:

  • قاعدة بيانات SQL في Fabric: قاعدة البيانات المُدارة مع المخطط الناتج عن المزخرِفات (decorators). وهي للقراءة فقط في البوابة، لذا غيّر المخطط عبر الشيفرة.
  • المصادقة: تسجيل دخول يُدار عبر Fabric ومن خلال Microsoft Entra ID. يمكنك عرض المستخدمين الذين تمت مصادقتهم في قاعدة بيانات SQL.
  • المحتوى الثابت: أصول الواجهة الأمامية المبنية، وتُقدَّم من عنوان URL للاستضافة وتُحدَّث مع كل نشر. تذكر النظرة العامة أن الاستضافة الثابتة قد تتطلب الوصول إلى عنصر في Fabric، أو قد تسمح بالوصول المجهول.

المصادقة والأذونات

تذكر Learn تسجيل الدخول الموحّد (SSO) في Fabric للتطبيقات المنشورة، وتسجيل الدخول بالبريد الإلكتروني وكلمة المرور للتطوير المحلي. لا يعمل تسجيل الدخول بالبريد الإلكتروني وكلمة المرور بعد النشر، ويتطلب النشر تفعيل مصادقة Fabric.

أذونات العناصر منفصلة عن أدوار مساحة العمل:

| الإذن | يسمح بـ | |---|---| | التشغيل والتفاعل | فتح التطبيق واستخدامه واستدعاء واجهات برمجة التطبيقات الخلفية الخاصة به. يحصل عليه جميع أعضاء مساحة العمل افتراضيًا. | | التحرير (Write) | النشر، وتغيير المخطط، وتحديث الإعدادات، وإدارة الخدمات الفرعية | | إعادة المشاركة | منح الآخرين حق الوصول. يتطلب دور المسؤول في مساحة العمل. |

يمكن لمسؤول Fabric أن يمنع مؤقتًا المستخدمين الآخرين من تحميل تطبيق، بينما يظل المالك قادرًا على فتحه.

يبقى جزء من الأمان على عاتقك. توصي Microsoft بإبقاء الأسرار خارج الشيفرة وأصول الواجهة الأمامية، وبأن شيفرتك هي التي تحدد ما يراه المستخدمون الذين سجّلوا الدخول وما يمكنهم فعله.

القيود التي يجب التحقق منها أولًا

تسرد الأسئلة المتداولة القيود الحالية التالية:

  • لا توجد علاقات متعدد إلى متعدد ولا مفاتيح أساسية مركّبة (يحتاج كل كيان إلى حقل UUID واحد باسم id)
  • لا توجد موفّرات مصادقة مخصّصة.
  • لا توجد إدارة متعددة البيئات جاهزة للاستخدام.
  • لا توجد حماية للوصول الصادر من مساحة العمل.
  • لا توجد روابط خاصة على مستوى المستأجر أو على مستوى مساحة العمل.
  • لا توجد إدارة لدورة حياة التطبيق (ALM).
  • count() غير متوفرة في عميل GraphQL الاصطلاحي (fluent).

تُكتب نماذج البيانات بلغة TypeScript باستخدام المزخرِفات (decorators).

المشكلات الشائعة

تذكر Microsoft أن نقص بناء الإنتاج هو السبب الأكثر شيوعًا لأخطاء البناء، لذا شغّل npm run build أولًا. بالنسبة إلى أخطاء السعة أو الأذونات، تأكّد من أن مساحة العمل تحتوي على سعة، وأنك تستطيع إنشاء العناصر أو تغييرها فيها. أما أخطاء المخطط، فراجع التغييرات منذ آخر نشر ناجح. تقول صفحة استكشاف الأخطاء وإصلاحها إن شيفرة التطبيق هي المصدر الموثوق. لا تغيّر المخطط البعيد من خلال بوابة Fabric أو أدوات SQL، لأن إزالة عمود موجود أو تعديله قد يعطّل التطبيق ونشره. أجرِ تغييرات المخطط في الشيفرة، ثم طبّقها باستخدام npx rayfin up db apply.

ذات صلة

المصادر

FAQ

هل Fabric Apps متاحة بشكل عام؟

لا. تصنّف Microsoft Learn ميزة Fabric Apps على أنها ميزة في مرحلة المعاينة، وتذكر أنها غير متاحة في جميع المناطق بعد. لا تحدد الصفحات التي اطّلعنا عليها لهذه المقالة تاريخًا للإتاحة العامة.

من يمكنه إنشاء تطبيق Fabric؟

وفقًا لـ Microsoft Learn، يلزمك امتلاك أذونات Contributor أو Admin في مساحة عمل Fabric مرتبطة بسعة Fabric، ويجب أن يكون مسؤول المستأجر قد فعّل إعداد المستأجر Fabric Apps (المعاينة). كما يلزم تثبيت Node.js 20 أو إصدار أحدث للتطوير المحلي.

ما طرق تسجيل الدخول التي تدعمها تطبيقات Fabric المنشورة؟

تذكر Microsoft Learn أن التطبيقات المنشورة تستخدم Fabric SSO، وهو تسجيل الدخول الأحادي إلى Microsoft Entra، حصريًا. أما تسجيل الدخول بالبريد الإلكتروني وكلمة المرور فهو متاح للتطوير المحلي فقط، ولا يمكنك النشر دون تفعيل المصادقة.

هل يمكن لتطبيق Fabric الاستفادة من قاعدة بيانات موجودة؟

لا. تذكر الأسئلة المتداولة في Microsoft Learn أن Fabric Apps تدير المخطط انطلاقًا من نماذج TypeScript الخاصة بك، ولا يمكنها الإشارة إلى قاعدة بيانات ذات مخطط محدد مسبقًا. للوصول إلى lakehouse أو warehouse أو قاعدة بيانات SQL موجودة في Fabric، تضيف موصلًا.

هل تشرح صفحات Microsoft تسعير Fabric Apps؟

لا، فالصفحات التي اطّلعنا عليها لا تتضمن أي تسعير. تذكر النظرة العامة فقط أن مساحة العمل تحتاج إلى سعة Fabric، وأن خدمات Fabric Apps تستهلك وحدات السعة منها، كما تنص الأسئلة المتداولة على أن الأداء يعتمد على سعة Fabric الخاصة بك.

Entities in this article

مواضيع هذا المقال:

Microsoft Fabric Apps – أداة تحليلات وذكاء أعمال من Microsoft Microsoft Fabric – أداة تحليلات وذكاء أعمال من Microsoft Fabric capacity – مفهوم Fabric tenant settings – مفهوم

Related articles

مقالات أخرى عن Microsoft Fabric:

RSS