> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> RocketBI هي منصة ذكاء الأعمال ذاتية الخدمة، تساعدك على تحليل البيانات بسرعة، وإنشاء مرئيات بالسحب والإفلات، والتعاون مع الزملاء مباشرةً من متصفح الويب.

# الهدف: أنشئ أول لوحة معلومات لك باستخدام Rocket.BI

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            تتم صيانته من قِبل المجتمع
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

في هذا الدليل، ستثبّت Rocket.BI وتنشئ لوحة معلومات بسيطة باستخدامه.
هذه هي لوحة المعلومات:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_01.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=0f19f8e06f35a17beb149749f6d832fe" alt="لوحة معلومات Rocket BI تعرض مقاييس المبيعات مع مخططات ومؤشرات أداء رئيسية" border width="1200" height="651" data-path="images/integrations/data-visualization/rocketbi_01.webp" />

<br />

يمكنك الاطلاع على [لوحة المعلومات من خلال هذا الرابط.](https://demo.rocket.bi/dashboard/sales-dashboard-7?token=7eecf750-cbde-4c53-8fa8-8b905fec667e)

<div id="install">
  ## التثبيت
</div>

ابدأ تشغيل RocketBI باستخدام صور Docker الجاهزة.

احصل على docker-compose.yml وملف التهيئة:

```bash theme={null}
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/docker-compose.yml
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/.clickhouse.env
```

عدّل ملف `.clickhouse.env`، وأضف معلومات خادم ClickHouse.

ابدأ RocketBI بتشغيل الأمر: `docker-compose up -d .`

افتح المتصفح، ثم انتقل إلى `localhost:5050`، وسجّل الدخول باستخدام هذا الحساب: `hello@gmail.com/123456`

للبناء من الشيفرة المصدرية أو لإعدادات متقدمة، يمكنك الاطلاع على التفاصيل هنا [ملف README الخاص بـ Rocket.BI](https://github.com/datainsider-co/rocket-bi/blob/main/README.md)

<div id="lets-build-the-dashboard">
  ## لننشئ لوحة المعلومات
</div>

في لوحة المعلومات، ستجد تقاريرك، ويمكنك بدء إنشاء تصوّر بالنقر على **+New**

يمكنك إنشاء **عدد غير محدود من لوحات المعلومات** ورسم **عدد غير محدود من المخططات** في لوحة معلومات واحدة.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_02.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=02d400152e014cdde3e8a0ca5cfd5681" alt="رسم متحرك يوضح عملية إنشاء مخطط جديد في Rocket BI" border width="800" height="434" data-path="images/integrations/data-visualization/rocketbi_02.webp" />

<br />

شاهد الشرح عالي الدقة على YouTube: [https://www.youtube.com/watch?v=TMkdMHHfvqY](https://www.youtube.com/watch?v=TMkdMHHfvqY)

<div id="build-the-chart-controls">
  ### أنشئ عناصر التحكّم في المخطط
</div>

<div id="create-a-metrics-control">
  #### أنشئ عنصر تحكم للمقاييس
</div>

في عامل تصفية Tab، حدِّد حقول المقاييس التي تريد استخدامها. تأكّد من إبقاء إعداد التجميع محددًا.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_03.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=24fdce1bc7f1034937059f230e0c88fb" alt="لوحة إعداد عنصر تحكم المقاييس في Rocket BI تعرض الحقول المحددة وإعدادات التجميع" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_03.webp" />

<br />

أعِد تسمية عوامل التصفية واحفظ عنصر التحكم في لوحة المعلومات

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_04.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=e170c39ae950d98f405b633f1ff3d94f" alt="عنصر تحكم المقاييس مع عوامل تصفية أُعيدت تسميتها وجاهز للحفظ في لوحة المعلومات" border width="1156" height="138" data-path="images/integrations/data-visualization/rocketbi_04.webp" />

<div id="create-a-date-type-control">
  #### أنشئ عنصر تحكم من نوع التاريخ
</div>

اختر حقلاً من نوع Date كعمود التاريخ الرئيسي:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_05.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=cc4f57f23973a5518edd736bdd8e7d97" alt="واجهة اختيار حقل Date في Rocket BI تعرض أعمدة التاريخ المتاحة" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_05.webp" />

<br />

أضف نُسخًا مكررة بنطاقات lookup مختلفة. على سبيل المثال: سنوي أو شهري أو يومي أو يوم من أيام الأسبوع.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_06.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=fca999525071ef4c80282613562c4f84" alt="تهيئة نطاق التاريخ التي تعرض خيارات مختلفة لفترة زمنية مثل السنة والشهر واليوم" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_06.webp" />

<br />

أعِد تسمية عوامل التصفية واحفظ عنصر التحكم في لوحة المعلومات

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_07.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=d0d1057d1590c6aacf77199a8dd850b6" alt="عنصر تحكم في نطاق التاريخ مع عوامل تصفية أُعيدت تسميتها وجاهز للحفظ في لوحة المعلومات" border width="346" height="444" data-path="images/integrations/data-visualization/rocketbi_07.webp" />

<div id="now-let-build-the-charts">
  ### الآن، لننشئ الرسوم البيانية
</div>

<div id="pie-chart-sales-metrics-by-regions">
  #### المخطط الدائري: مقاييس المبيعات حسب المناطق
</div>

اختر Adding new chart، ثم اختر Pie Chart

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_08.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=c707b778f148f7f05538d2fabbd46071" alt="لوحة اختيار نوع المخطط مع تمييز خيار المخطط الدائري" border width="1860" height="1312" data-path="images/integrations/data-visualization/rocketbi_08.webp" />

<br />

أولاً، اسحب العمود "Region" وأفلِته من Dataset إلى Legend Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_09.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=7a6535f7cd8cba1f1d8a1f499baa5f98" alt="واجهة سحب وإفلات تُظهر إضافة عمود Region إلى حقل وسيلة الإيضاح" border width="2562" height="1486" data-path="images/integrations/data-visualization/rocketbi_09.webp" />

<br />

ثم انتقل إلى تبويب Chart Control

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_10.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=9d06fdac03dd910d1240af631034bdf3" alt="واجهة تبويب Chart Control تعرض خيارات تهيئة التصور" border width="1420" height="918" data-path="images/integrations/data-visualization/rocketbi_10.webp" />

<br />

اسحب Metrics Control وأفلِته في Value Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_11.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=c0f917fbe040b7d3527cb0f3235b9648" alt="إضافة Metrics Control إلى حقل القيمة في المخطط الدائري" border width="2532" height="1484" data-path="images/integrations/data-visualization/rocketbi_11.webp" />

<br />

(يمكنك أيضًا استخدام Metrics Control للفرز)

انتقل إلى Chart Setting لمزيد من التخصيص

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_12.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=dc1186376096c9a8fe7a0fd4e49a00c4" alt="لوحة إعدادات المخطط تعرض خيارات تخصيص المخطط الدائري" border width="1130" height="806" data-path="images/integrations/data-visualization/rocketbi_12.webp" />

<br />

على سبيل المثال، غيّر Data label إلى Percentage

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_13.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=01625fea3c631c9cdfdf6fd798d9e71c" alt="تغيير إعدادات تسمية البيانات لعرض النسب المئوية على المخطط الدائري" border width="2534" height="1468" data-path="images/integrations/data-visualization/rocketbi_13.webp" />

<br />

احفظ المخطط وأضِفه إلى لوحة معلومات

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_14.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=9472889a564042bc688aee76af40ef64" alt="عرض لوحة معلومات ويُظهر المخطط الدائري المُضاف حديثًا مع عناصر تحكم أخرى" border width="1566" height="1056" data-path="images/integrations/data-visualization/rocketbi_14.webp" />

<div id="use-date-control-in-a-time-series-chart">
  #### استخدم عنصر التحكم بالتاريخ في مخطط زمني
</div>

لنستخدم مخطط أعمدة متراصًا

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_15.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=c48caf7a47a3b46cf405e2d570ecfb25" alt="واجهة إنشاء مخطط أعمدة متراص مع بيانات زمنية" border width="1836" height="1332" data-path="images/integrations/data-visualization/rocketbi_15.webp" />

<br />

في Chart Control، استخدم عنصر تحكم بالمقاييس للمحور Y وDate Range للمحور X

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_16.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=8308cec48163775a04abe9d8a4cfb077" alt="إعداد Chart Control يوضح المقاييس على المحور Y وDate Range على المحور X" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_16.webp" />

<br />

أضف عمود Region إلى Breakdown

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_17.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=8a5c4a795d6998929eee0e755218edb2" alt="إضافة عمود Region كبُعد تفصيلي في مخطط الأعمدة المتراص" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_17.webp" />

<br />

أضف Number Chart كمؤشرات أداء رئيسية وأضف لمسة جمالية إلى لوحة المعلومات

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/8ewN4mllkqWURabs/images/integrations/data-visualization/rocketbi_18.webp?fit=max&auto=format&n=8ewN4mllkqWURabs&q=85&s=66f3e0b3f19d76dbfe7a4d152782422e" alt="لوحة معلومات مكتملة تتضمن مخططات أرقام لمؤشرات الأداء الرئيسية ومخططًا دائريًا وتمثيلًا مرئيًا زمنيًا" border width="2788" height="1506" data-path="images/integrations/data-visualization/rocketbi_18.webp" />

<br />

الآن، تكون قد نجحت في إنشاء أول لوحة معلومات لك باستخدام rocket.BI
