> For the complete documentation index, see [llms.txt](https://docs.solarvis.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solarvis.co/documentation/ar/configuration/materials-page/my-items.md).

# عناصري

## هدف هذه الصفحة <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

استخدم العناصر الخاصة بي لإضافة مكونات مخصصة غير متوفرة في قاعدة بيانات مواد solarVis أو المطلوبة لمحاكاة الأنظمة. يمكن أن تمثل هذه المواد عناصر مثل وحدات إدارة البطاريات (BMS)، الغلايات، خزانات المياه، ملحقات التركيب، أو أجهزة المراقبة، وغيرها.

## ما يمكنك القيام به هنا <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

* إنشاء مواد خاصة بالشركة
* تعيين العناصر إلى فئة
* إضافة أوصاف، صور، ومستندات PDF
* تحديد العملة، السعر، نوع التسعير، والكمية الافتراضية
* ضبط ظهور العنصر في العروض
* تضمين العناصر في حسابات العائد على الاستثمار (ROI)
* تطبيق خصومات مخصصة، هوامش ربح، ونسب ضريبة القيمة المضافة
* تفعيل أو إلغاء تفعيل العناصر
* البحث عن عناصر محددة أو تصفية العناصر حسب الفئة
* مراجعة تفاصيل العنصر أو تحديث العناصر الحالية

## كيف تعمل <a href="#how-it-works" id="how-it-works"></a>

{% embed url="<https://app.arcade.software/share/P4AHpgRkPMzs26CZaybj?language=ar>" %}

صفحة **العناصر الخاصة بي**، والتي تمثل مكتبة المواد المخصصة الخاصة بك، مقسمة إلى قسمين مختلفين: جميع المواد والمواد النشطة.

يستخدم قسم جميع المواد مفتاح الحالة لتفعيل أو إلغاء تفعيل العنصر. العناصر النشطة متاحة في حوارات اختيار المواد ذات الصلة.

يوفر قسم المواد النشطة طريقة لإدارة معلومات تسعير العناصر المتوفرة حالياً في حوارات اختيار المواد.

{% hint style="info" %}
العناصر الخاصة بي متاحة فقط ضمن الشركة التي أنشأتها. يمكن لحسابات الإدارة الرئيسية إنشاء وتحديث العناصر، بينما يمكن لحسابات الشركاء والفريق عرضها فقط.
{% endhint %}

### البحث وتصفية العناصر <a href="#search-and-filter-items" id="search-and-filter-items"></a>

يمكن استخدام حقل البحث للعثور على العناصر حسب الاسم أو الفئة. كما أن مرشح الفئة يعرض العناصر المعينة إلى فئات المشاريع المحددة. يمكنك تصفية القائمة حسب فئات العناصر.

{% hint style="info" %}
يمكن استخدام حقل البحث ومرشح الفئة معاً لتضييق قائمة المواد.
{% endhint %}

### إضافة عنصر <a href="#add-an-item" id="add-an-item"></a>

انقر على زر "إضافة عنصر" لإنشاء مادة مخصصة.

ضمن المعلومات العامة، أدخل اسم العنصر، اختر فئة، وأضف وصفاً اختيارياً. الفئات المتاحة هي:

* نظام الطاقة الشمسية (PV System)
* البطارية
* مضخة حرارية (Heat Pump)
* شاحن مركبات كهربائية (EV Charger)

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

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

ضمن تفاصيل العنصر، اختر العملة، نوع التسعير، سعر الوحدة، والكمية الافتراضية. أنواع التسعير المتاحة تشمل:

* ثابت (Set)
* حسب الكمية (Quantity)
* لكل متر (Per Meter)
* لكل كيلوغرام (Per Kilogram)
* نسبة مئوية (Percentage)
* لكل لوح (Per Panel)
* لكل واط (Per Watt)
* لكل واط-ساعة للبطاريات (Per Watt-Hour for batteries)

ضمن الإعدادات التفصيلية، قم بتكوين ما إذا كان العنصر يظهر في العروض، وما إذا كان سعر الوحدة أو العلامة التجارية أو الطراز أو الخصم يظهر، وما إذا كان العنصر مشمولاً في حسابات العائد على الاستثمار (ROI). يمكنك أيضاً ضبط خصم خاص بالعنصر، هوامش الربح، ضريبة القيمة المضافة، وإعدادات المخزون.

انقر على زر "إنشاء" لحفظ العنصر. سيظهر العنصر الجديد ضمن علامة تبويب جميع المواد.

### تحديث عنصر <a href="#update-an-item" id="update-an-item"></a>

حدد عنصراً من قسم جميع المواد أو المواد النشطة لفتح نافذة تفاصيل العنصر.

تعرض اللوحة:

* المعلومات العامة
* سعر الوحدة ونوع التسعير
* إعدادات العرض
* الإعدادات المالية
* حالة المخزون

حدد "تحديث" لفتح إعدادات العنصر. قم بتحرير معلومات العنصر، الفئة، الوصف، الملفات، تفاصيل التسعير، إعدادات العرض، أو الإعدادات المالية، ثم احفظ التغييرات.

## المخرجات الرئيسية <a href="#key-outputs" id="key-outputs"></a>

العناصر الخاصة بي متاحة عبر سير عمل solarVis ذات الصلة بناءً على الفئة المعينة لها.

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

***

## الصفحات ذات الصلة <a href="#related-pages" id="related-pages"></a>

* [صفحة قائمة المواد (BoM)](/documentation/ar/project-design/create-a-project/bill-of-materials-bom.md)
* [صفحة إعدادات تكلفة الإعدادات المسبقة](/documentation/ar/configuration/settings-page/project-settings/preset-cost-settings.md)
* [صفحة إعدادات الحزم](/documentation/ar/configuration/settings-page/project-settings/package-settings.md)

لمزيد من المساعدة، لا تتردد في [التواصل معنا.](https://solarvis.co/en/company/contact)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solarvis.co/documentation/ar/configuration/materials-page/my-items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.