أنشئ لوحات معلوماتك الخاصة في Power BI

Power BI هي أداة التقارير من Microsoft. يمنح Kaam360 مؤسستك موجز بيانات خاصًا بها يقرؤه Power BI، لتنشئ أي لوحة معلومات تريدها من مشاريعك ومهامك ووقتك وبيانات المال والمبيعات والدعم. الموجز للقراءة فقط: لا يمكنه أبدًا تغيير أي شيء في Kaam360. هذه الميزة جزء من باقة الأعمال.

كيف يبقى آمنًا

• لا يتصل Power BI أبدًا بقاعدة بيانات Kaam360. بل يطلب البيانات من Kaam360 عبر عنوان https آمن، ويجيب Kaam360 ببيانات مؤسستك فقط.
• يقرأ كل مفتاح موجز الأجزاء التي تحددها فقط، ويمكن إلغاؤه في أي وقت. يحتفظ Kaam360 بنسخة مشفّرة فقط من المفتاح، فلا يستطيع أحد قراءته مرة أخرى.
• لا تُضمَّن عناوين البريد الإلكتروني وأرقام الهواتف إلا إذا سمحت بها لذلك المفتاح.

الخطوة 1: أنشئ مفتاح موجز (للمسؤولين)

يستطيع ذلك من لديهم صلاحية إدارة التكاملات.

1. افتح الإعدادات واختر Power BI.
2. تحت إنشاء مفتاح موجز، اكتب الاسم للمفتاح، مثل «لوحة الإدارة».
3. تحت ما يمكنه قراءته، حدّد البيانات التي يحتاجها التقرير. اضغط تحديد الكل لتحديد كل شيء، أو مسح الكل للبدء من جديد.
4. حدّد تضمين عناوين البريد الإلكتروني وأرقام الهواتف فقط إذا احتاجها التقرير.
5. اضغط إنشاء المفتاح.
6. اضغط نسخ بجانب المفتاح الجديد واحفظه في مكان آمن. يُعرض مرة واحدة فقط. إذا فقدته، أنشئ مفتاحًا جديدًا وألغِ القديم.

الخطوة 2: اربط Power BI Desktop

1. في صفحة Power BI، اضغط نسخ بجانب عنوان الموجز. يبدو هكذا: https://your-kaam360-address/odata/.
2. افتح Power BI Desktop. في علامة التبويب Home اختر Get data ثم OData feed. إذا لم تجده، اختر More... ثم Other ثم OData feed.
3. اترك Basic محددًا أعلى النافذة، والصق عنوان الموجز في URL واضغط OK.
4. يسأل Power BI عن طريقة تسجيل الدخول. اختر Basic على اليسار. اكتب powerbi في User name والصق مفتاح الموجز في Password. في مستوى تطبيق هذه الإعدادات، اختر عنوان الموجز. اضغط Connect.
5. يعرض Navigator الجداول التي يمكن لمفتاحك قراءتها، مثل Projects وTasks وInvoices. حدّد الجداول التي تريدها. انقر على جدول لترى معاينة.
6. اضغط Load. يقرأ Power BI كل الصفوف. تصل الجداول الكبيرة في صفحات من 1,000 صف، ويجلب Power BI الصفحات التالية بنفسه.

الخطوة 3: أنشئ تقريرًا

1. افتح عرض Model. ربما ربط Power BI بعض الجداول بالفعل. تحقق من الروابط المذكورة تحت تقرير نموذجي أدناه، واسحب عمودًا فوق آخر لإضافة أي رابط ناقص.
2. ارجع إلى عرض Report. اختر مرئيًا، مثل مخطط شريطي، واسحب الحقول إليه: مثل Projects › Name وTasks › LoggedHours.
3. استخدم Health أو Status أو CompanyId كأدوات تقسيم لتصفية الصفحة كلها.
4. احفظ الملف.

الخطوة 4: انشر وحدّث وفق جدول

1. في Power BI Desktop، في علامة التبويب Home، اختر Publish ثم مساحة عمل في خدمة Power BI.
2. افتح خدمة Power BI (app.powerbi.com)، وانتقل إلى مساحة العمل وابحث عن النموذج الدلالي (مجموعة البيانات) الذي يحمل اسم التقرير.
3. افتح Settings الخاصة به. تحت Data source credentials، اختر Edit credentials بجانب عنوان OData.
4. اختر Basic في Authentication method. اكتب powerbi في User name والصق مفتاح الموجز في Password. اختر Privacy level (مثل Organizational) واضغط Sign in.
5. افتح Scheduled refresh، وشغّله، واختر عدد المرات والأوقات، ثم اضغط Apply.

لا حاجة إلى بوابة: تقرأ خدمة Power BI الموجز مباشرة عبر الإنترنت.

تقرير نموذجي

تستخدم لوحة مشاريع بسيطة هذه الجداول والروابط (كل رابط يصل عمود المعرّف على اليمين بـ Id الجدول المذكور بعده):

• Tasks: ProjectId مع Projects، وOwnerId مع Users، وPhaseId مع Phases.
• TimeLogs: ProjectId مع Projects، وTaskId مع Tasks، وUserId مع Users.
• Projects: CustomerId مع Customers، وCompanyId مع Companies.
• Invoices: CustomerId مع Customers، وProjectId مع Projects. InvoiceLines: InvoiceId مع Invoices.
• Payments: ProjectId مع Projects. Deals: CustomerId مع Customers. Contacts: CustomerId مع Customers. Tickets: CustomerId مع Customers.

مرئيات أولى جيدة: جدول لـ Projects مع Health وPercentDone وTasksOverdue وEndDate؛ ومخطط شريطي لـ TimeLogs › Hours حسب Users › Team؛ ومخطط أعمدة لـ Invoices › Total حسب شهر IssueDate؛ ومخطط قمعي لـ Deals › Amount حسب Stage.

من المفيد معرفته

• التواريخ تواريخ بسيطة (مثل 2026-10-31). الأوقات بتوقيت UTC.
• المبالغ تأتي دائمًا مع Currency الخاصة بها. وللفواتير وعروض الأسعار والمصروفات أيضًا ExchangeRate: كم وحدة من عملتك الرئيسية كانت تساوي وحدة واحدة من عملة المستند في تاريخه. اضرب فيه لجمع المبالغ بعملات مختلفة.
• يحدد CompanyId إلى أي من شركاتك الخاصة ينتمي المشروع أو المستند، إذا كان لديك أكثر من شركة (راجع الإعدادات › الشركات).
• تُحسب Projects › Health تمامًا كما في لوحات المعلومات: On track أو At risk أو Off track أو Not planned. وتكون فارغة للمشاريع المؤرشفة والمكتملة والملغاة.
• لكل جدول ModifiedAt. لتحديث التغييرات الأخيرة فقط في مؤسسة كبيرة، أعدّ التحديث التزايدي على ModifiedAt في Power BI Desktop.
• يمكن لكل مفتاح إرسال حتى 300 طلب في الدقيقة. إذا احتاج التحديث إلى أكثر، ينتظر Power BI ويعيد المحاولة بنفسه.
• لتغيير ما يمكن للمفتاح قراءته، اضغط تغيير بجانبه. يبقى المفتاح نفسه، فيستمر Power BI في العمل ويقرأ الاختيار الجديد عند التحديث التالي.
• اضغط إلغاء (مرتين) لإيقاف مفتاح. تتوقف التقارير التي تستخدمه عن التحديث.
• يعرض سجل النشاط (الإعدادات › سجل النشاط) متى أُنشئ كل مفتاح وتغيّر وأُلغي، وسطرًا لكل يوم استُخدم فيه.
• تعمل أدوات التقارير الأخرى التي تقرأ موجزات OData، مثل Excel (Data › Get Data › From Other Sources › From OData Feed)، بالعنوان والمفتاح نفسيهما.

إذا حدث خطأ

• «We couldn't authenticate with the credentials provided»: تأكد أنك اخترت Basic ولصقت المفتاح كاملًا ككلمة المرور، وأن المفتاح لم يُلغَ. لإدخال المفتاح من جديد في Power BI Desktop، اختر File › Options and settings › Data source settings، ثم اختر العنوان واضغط Edit Permissions.
• «Access to the resource is forbidden»: لا يمكن للمفتاح قراءة ذلك الجدول. حدّده تحت تغيير في صفحة Power BI.
• لا يظهر Power BI في الإعدادات: ربما لا تشمله باقتك (فهو جزء من الأعمال)، أو لا يملك دورك صلاحية إدارة التكاملات.