# دليل مستخدم RAPTIX — النص الكامل المصدر: https://raptix.app/user-guide/ar/ · تاريخ الإنشاء: 2026-08-21 يجمع هذا الملف كل صفحات الدليل المنشورة بصيغة Markdown، ويفصل بينها خط وعنوان URL الأساسي لكل صفحة. --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-20-create-workspace-signup/ # إنشاء مساحة عمل جديدة في RAPTIX > **المنطقة:** البدء > > **الجمهور:** الشخص الذي ينشئ مساحة عمل جديدة لمؤسسة > > **الوصول المطلوب:** لا يلزم حساب RAPTIX موجود > > **ما ستتعلمه:** كيفية إنشاء الحساب ومساحة العمل، واختيار عنوانها، وتأكيد البريد، وإعادة إرسال رمز التحقق، وتصحيح البريد، وحل أخطاء التسجيل الشائعة. ## قبل أن تبدأ - افتح موقع التسجيل الرئيسي لـRAPTIX لا عنوان مساحة عمل مؤسسة موجودة. التسجيل من عنوان مساحة عمل قائمة يطلب عضوية فيها بدل إنشاء مساحة جديدة. - استخدم بريد عمل يمكنك فتحه فورًا. - اختر عنوانًا قصيرًا تتعرف إليه فرقك. سيبدو العنوان النهائي مثل `https://operations.raptix.app`. - جهّز رقم هاتف؛ إذ يتطلب النموذج دولة ورقمًا. - يجب ألا تقل كلمة المرور عن ثمانية أحرف. ## فتح صفحة التسجيل 1. افتح صفحة تسجيل الدخول إلى RAPTIX. 2. اختر **إنشاء حساب (`Sign up`)**. 3. تأكد أن العنوان هو **أنشئ مساحة عملك (`Create your workspace`)**. توضح الصفحة أنه يمكنك البدء مجانًا ومن دون بطاقة ائتمان. ## إكمال بيانات الحساب 1. أدخل **الاسم الكامل (`Full name`)**. 2. أدخل **بريد العمل (`Work email`)**. 3. أدخل الاسم المطلوب في **عنوان مساحة العمل (`Workspace URL`)**. 4. اختر الدولة وأدخل رقم الهاتف. 5. اكتب كلمة مرور في **كلمة المرور (`Password`)**. 6. اكتبها مرة أخرى في **تأكيد كلمة المرور (`Confirm password`)**. لا يصبح زر **إنشاء الحساب (`Create account`)** متاحًا إلا عندما تكون المعلومات المطلوبة صحيحة. ## اختيار عنوان مساحة العمل يتحكم حقل عنوان مساحة العمل في العنوان الذي سيستخدمه فريقك للدخول. - استخدم ثلاثة أحرف على الأقل. - استخدم الحروف الإنجليزية الصغيرة والأرقام والشرطات فقط. - ابدأ وانتهِ بحرف أو رقم. - لا تستخدم مسافات أو شرطات سفلية أو النهاية `.raptix.app`. يتحقق RAPTIX من العنوان أثناء الكتابة: | الرسالة | المعنى | ما ينبغي فعله | |---|---|---| | **متاح (`is available`)** | يمكن تسجيل العنوان حاليًا. | تابع التسجيل. | | **هذا العنوان مستخدم (`That address is taken`)** | تستخدمه مساحة عمل أخرى. | اختر اقتراحًا أو اسمًا مختلفًا. | | **هذا العنوان محجوز (`That address is reserved`)** | لا يسمح RAPTIX بتسجيله. | اختر اسمًا آخر. | | **ثلاثة أحرف على الأقل (`At least 3 characters`)** | العنوان قصير جدًا. | أضف أحرفًا. | | **حروف صغيرة وأرقام وشرطات فقط (`Only lowercase letters, numbers, and hyphens`)** | يحتوي رمزًا غير مدعوم. | أزل المسافات أو الرموز الخاصة. | | **تعذر التحقق من العنوان الآن (`We couldn't check this address just now`)** | تعذر الوصول إلى خدمة التحقق. | يمكنك المتابعة؛ سيفحصه الخادم مجددًا عند الإنشاء. | إذا لم تغيّر حقل عنوان مساحة العمل، فقد يقترح RAPTIX قيمة من الجزء السابق لـ`@` في بريدك. ويمكنك استبدالها قبل الإرسال. ## تعيين كلمة المرور وتأكيدها يتغير مؤشر القوة أثناء الكتابة. يجب ألا تقل الكلمة عن ثمانية أحرف، وأن يتطابق حقلاها. استخدم زر العين لإظهار الكلمة أو إخفائها. وإذا ظهرت **كلمتا المرور غير متطابقتين (`Passwords don't match`)**، فصحح حقل التأكيد قبل المتابعة. ## إنشاء الحساب 1. راجع رابط الشروط وسياسة الخصوصية. 2. أكمل فحص الأمان إن ظهر. 3. اختر **إنشاء الحساب (`Create account`)**. إذا منع امتداد متصفح فحص أمان مطلوبًا، فاسمح بالصفحة في الامتداد أو استخدم متصفحًا آخر، ثم حدّث وحاول مجددًا. ## التحقق من بريدك الإلكتروني بعد نجاح طلب الحساب، تتغير الصفحة إلى **تحقق من بريدك (`Check your email`)**. 1. افتح صندوق البريد للعنوان المعروض. 2. ابحث عن رسالة التحقق من RAPTIX. قد يستغرق وصولها دقيقة؛ وافحص البريد العشوائي أيضًا. 3. أدخل الرمز المكون من ستة أرقام. 4. اختر **تحقق من البريد (`Verify email`)** إن لم يبدأ التحقق تلقائيًا بعد الرقم السادس. بعد التحقق، يعرض RAPTIX رسالة ترحيب ويجهز مساحة العمل ثم ينقلك إلى عنوانها أو إلى الرئيسية. ## إعادة إرسال رمز التحقق تعرض الصفحة عدًا تنازليًا قصيرًا قبل السماح برمز جديد. 1. انتظر حتى يتاح **إعادة إرسال الرمز (`Resend code`)**. 2. اختره مرة واحدة. 3. استخدم أحدث رمز يصلك. إذا أفاد RAPTIX بتعذر إرسال البريد، فانتظر قليلًا ثم حاول. لا تكرر الطلب أثناء العد التنازلي. ## تغيير عنوان بريد غير صحيح 1. في صفحة التحقق، اختر **البريد خطأ؟ غيّره (`Wrong email? Change it`)**. 2. صحح حقل **بريد العمل**. 3. راجع عنوان مساحة العمل وبقية المعلومات. 4. اختر **إنشاء الحساب** مجددًا. 5. أدخل الرمز الجديد المرسل إلى العنوان المصحح. يربط RAPTIX الطلب الجديد بمحاولة التسجيل، فلا يعلقك البريد السابق أو حجز مساحة العمل. ## استكشاف المشكلات وحلها | المشكلة | ما ينبغي التحقق منه | |---|---| | **إنشاء الحساب** معطل | أكمل الاسم، وبريد عمل صحيحًا، وعنوان مساحة متاحًا أو لم يمكن التحقق منه مؤقتًا، وكلمتي مرور متطابقتين من ثمانية أحرف، ورقم الهاتف المطلوب. | | عنوان المساحة غير متاح | اختر اقتراحًا أو اكتب اسمًا آخر بحروف صغيرة. | | رُفض رقم الهاتف | اختر الدولة الصحيحة وأدخل رقمًا وطنيًا بين 4 و15 رقمًا. | | رُفض الرمز | أدخل أحدث رمز من ستة أرقام. تمسح المحاولة الفاشلة الحقول لتعيد الإدخال. | | لم تصل الرسالة | انتظر دقيقة وافحص البريد العشوائي، ثم استخدم **إعادة إرسال الرمز** بعد التأكد من البريد المعروض. | | تعذر إنشاء مساحة العمل | تحقق من الاتصال وأعد الإرسال. وإذا أصبح العنوان غير متاح، فاختر عنوانًا جديدًا. | | فحص الأمان محظور | عطّل الحاجب لهذه الصفحة أو استخدم متصفحًا آخر ثم حدّث. | ## أدلة ذات صلة - [تسجيل الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) - [استخدام الرئيسية: المهام وسير العمل والعناصر الحديثة في التطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [البقاء مسجلًا وتسجيل الخروج بأمان](https://raptix.app/user-guide/ar/00-getting-started/00-16-sessions-and-logout/) - [الحصول على المساعدة من الدعم](https://raptix.app/user-guide/ar/00-getting-started/00-19-getting-help-support/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/ # كيفية تسجيل الدخول باسم المستخدم وكلمة المرور > **الوحدة:** المنصة — البدء  |  **الجمهور:** جميع المستخدمين > **ما ستتعلمه:** كيفية الوصول إلى صفحة تسجيل الدخول، وإدخال بيانات الاعتماد، والوصول إلى الشاشة الرئيسية وأنت جاهز للعمل. ## ما هذه الميزة؟ شاشة تسجيل الدخول إلى RAPTIX هي بوابتك إلى المنصة كلها. أدخل اسم المستخدم (أو عنوان البريد الإلكتروني) وكلمة المرور، ثم اختر **تسجيل الدخول (`Sign In`)**؛ وستنقلك المنصة مباشرة إلى الصفحة التي كنت تحاول فتحها، أو إلى الشاشة الرئيسية إذا بدأت جلسة جديدة. يعمل النموذج في الوضعين الفاتح والداكن ويتكيف مع جميع أحجام الشاشات، بما فيها الهاتف. ## لماذا تفيدك؟ - **نموذج واحد مألوف يدخلك خلال ثوانٍ** — من دون تطبيق منفصل أو خطوات إضافية. - **سجّل الدخول باسم المستخدم أو بعنوان البريد الإلكتروني** — استخدم ما يسهل عليك تذكره. - **تصل مباشرة إلى الصفحة التي طلبتها** — إذا نقلك رابط مشارك إلى صفحة تسجيل الدخول، فستصل إلى وجهتك الصحيحة بعد الدخول بدلًا من الانتقال إلى شاشة رئيسية عامة. - **حسابك محمي تلقائيًا من محاولات التخمين المتكررة** — تُبطّأ المحاولات الخاطئة المتتابعة وتُحظر مؤقتًا من دون أي إجراء منك. - **رسائل خطأ فورية وواضحة** تبيّن ما حدث كي تصلحه من دون تخمين. - **تبقى الجلسة نشطة أثناء عملك** — يُجدَّد تسجيل دخولك بهدوء في الخلفية حتى لا تُقاطع في منتصف المهمة. ## قبل أن تبدأ - تحتاج إلى حساب RAPTIX نشط. إذا لم يكن لديك حساب، فاطلب من المسؤول إنشاءه لك. - يجب إسناد دور واحد على الأقل إلى حسابك. إذا ظهرت رسالة تفيد بعدم وجود أدوار، فتواصل مع المسؤول. - افتح متصفحًا مدعومًا (Chrome أو Edge أو Firefox أو Safari)، وانتقل إلى عنوان RAPTIX الخاص بمؤسستك، مثل `https://.raptix.app`. ## طريقة الاستخدام خطوة بخطوة 1. افتح عنوان RAPTIX الخاص بمؤسستك في المتصفح. ستظهر صفحة تسجيل الدخول تلقائيًا. 2. في حقل **اسم المستخدم أو البريد الإلكتروني (`Username or Email`)**، اكتب اسم المستخدم أو عنوان بريدك الإلكتروني؛ كلاهما مقبول. 3. في حقل **كلمة المرور (`Password`)**، اكتب كلمة المرور. - إذا لم تتذكرها أثناء الكتابة، فاختر **هل نسيت كلمة المرور؟ (`Forgot Password?`)**، وهو الرابط الموجود إلى جوار تسمية كلمة المرور، ثم راجع الدليل المرتبط بإعادة تعيين كلمة المرور. 4. اضغط **Enter** في لوحة المفاتيح أو اختر زر **تسجيل الدخول (`Sign In`)**. 5. أثناء التحقق من بياناتك، تتغير تسمية الزر إلى **جارٍ تسجيل الدخول… (`Signing in…`)** ويظهر مؤشر تحميل. انتظر لحظة. 6. عند النجاح، تُنقل إلى الشاشة الرئيسية أو إلى الصفحة التي حاولت فتحها في الأصل. > **إذا ظهرت رسالة خطأ:** يظهر شريط أحمر أسفل العنوان يوضح السبب. ستجد أكثر الرسائل شيوعًا في قسم «شرح الخيارات والإعدادات» أدناه. ## شرح الخيارات والإعدادات | العنصر | وظيفته | |---|---| | حقل **اسم المستخدم أو البريد الإلكتروني (`Username or Email`)** | يقبل اسم المستخدم المخصص لك أو بريدك الإلكتروني المسجل؛ كلاهما يعمل. | | حقل **كلمة المرور (`Password`)** | يخفي الأحرف حفاظًا على الأمان. اضغط **Enter** من هذا الحقل للإرسال من دون النقر على الزر. | | رابط **هل نسيت كلمة المرور؟ (`Forgot Password?`)** | يفتح مسار إعادة تعيين كلمة المرور. راجع دليل «ماذا تفعل إذا نسيت كلمة المرور؟». | | زر **تسجيل الدخول (`Sign In`)** | يرسل بيانات الاعتماد. يصبح معطلًا ويظهر باهتًا مع مؤشر تحميل أثناء تنفيذ الطلب. | | الفاصل **أو المتابعة باستخدام (`Or continue with`)** | يفصل نموذج اسم المستخدم وكلمة المرور عن خيار الدخول الموحد عبر Microsoft. | | زر **المتابعة باستخدام Microsoft (`Continue with Microsoft`)** | طريقة بديلة للدخول بحساب Microsoft الخاص بالعمل. راجع دليل «كيفية تسجيل الدخول بحساب Microsoft (SSO)». | ### رسائل الخطأ التي قد تراها | الرسالة | معناها | ما ينبغي فعله | |---|---|---| | «يرجى تعبئة جميع الحقول (`Please fill in all fields`)» | تركت حقل اسم المستخدم أو كلمة المرور فارغًا. | املأ الحقلين وحاول مرة أخرى. | | «بيانات الاعتماد أو كلمة المرور غير صحيحة (`Invalid credentials or password`)» | اسم المستخدم أو البريد الإلكتروني أو كلمة المرور غير صحيح. | تحقق من الأخطاء الإملائية، وتأكد من إيقاف `Caps Lock`، ثم أعد المحاولة. | | «طلبات كثيرة جدًا. يرجى الانتظار قليلًا (`Too many requests. Please wait a moment.`)» | حدثت محاولات فاشلة كثيرة من موقعك أو لحسابك خلال مدة قصيرة. | انتظر بضع دقائق ثم حاول مجددًا. إذا استمرت المشكلة، فتواصل مع المسؤول. | | «لم تُسند أدوار إلى حسابك. تواصل مع المسؤول لمنحك صلاحيات الوصول (`Your account has no roles assigned...`)» | الحساب موجود، لكن لم يُمنح أي دور وصول بعد. | اطلب من المسؤول إسناد دور إلى حسابك. | | «انتهت الجلسة. يرجى تسجيل الدخول مجددًا (`Session expired. Please log in again.`)» | انتهت مهلة جلستك السابقة. | سجّل الدخول مرة أخرى بالطريقة المعتادة. | ## نصائح وأفضل الممارسات - **استخدم عنوان بريدك الإلكتروني إذا نسيت اسم المستخدم.** تقبل المنصة كليهما. - **احفظ صفحة تسجيل الدخول في المفضلة** أو ثبّت المنصة كتطبيق على جهازك، كما يوضح دليل تثبيت PWA، للوصول الأسرع. - **اضغط Enter** بدلًا من اختيار زر تسجيل الدخول؛ فهذا أسرع ويعمل من حقل اسم المستخدم أو كلمة المرور. - **لا تشارك كلمة المرور.** ينبغي أن يكون لكل شخص حسابه؛ إذ تُنسب إجراءات المنصة إلى الحساب الذي نفذها. - **غيّر كلمة المرور المؤقتة فورًا** إذا أعطاك المسؤول كلمة أنشأها النظام. انتقل إلى إعدادات ملفك الشخصي بعد الدخول. - إذا كنت تستخدم جهازًا مشتركًا، فسجّل الخروج عند الانتهاء بدلًا من الاكتفاء بإغلاق علامة تبويب المتصفح. ## الأسئلة الشائعة **س: هل يمكنني استخدام بريدي الإلكتروني بدلًا من اسم المستخدم؟** نعم. يقبل حقل اسم المستخدم أو البريد الإلكتروني كليهما. أدخل ما تعرفه وستعثر المنصة على حسابك. **س: كتبت كلمة المرور الصحيحة، لكن تظهر رسالة «بيانات الاعتماد غير صحيحة». ما المشكلة؟** تحقق من أن: (1) مفتاح `Caps Lock` متوقف، و(2) لا توجد مسافات منسوخة قبل القيمة أو بعدها، و(3) تستخدم اسم المستخدم أو البريد الصحيح لهذه المنصة لا لنظام آخر. إذا استمرت المشكلة، فاستخدم «هل نسيت كلمة المرور؟» لإعادة تعيينها. **س: كم مرة يمكنني إدخال كلمة مرور خاطئة قبل حظر الحساب؟** تطبق المنصة إبطاءً تدريجيًا بعد تكرار المحاولات الفاشلة من الموقع نفسه. لن يُحظر حسابك نهائيًا؛ انتظر بضع دقائق ثم أعد المحاولة. إذا تعذر عليك الدخول باستمرار، فاطلب من المسؤول مراجعة حالة الحساب. **س: كنت في صفحة محددة عندما انتهت الجلسة ونُقلت إلى تسجيل الدخول. هل سأعود إليها بعد الدخول؟** نعم. تتذكر المنصة الصفحة التي حاولت فتحها، وبعد نجاح تسجيل الدخول ستُنقل إليها مباشرة. **س: ماذا يحدث إذا ابتعدت ثم عدت إلى المنصة لاحقًا؟** تُجدَّد جلستك بهدوء في الخلفية ما دمت نشطًا. إذا طال الخمول حتى انتهت الجلسة تمامًا، فستعود إلى صفحة الدخول مع رسالة تفيد بانتهاء الجلسة. سجّل الدخول مجددًا للمتابعة. **س: تعرض صفحة الدخول لوحة «مطلوب تنشيط الترخيص (`License Activation Required`)» بدلًا من النموذج المعتاد. ماذا يعني ذلك؟** لا تظهر هذه اللوحة إلا في تثبيت جديد تمامًا لم يُفعّل من قبل، ويتولى المسؤول التعامل معها؛ راجع دليل «الإعداد لأول مرة: تنشيط مفتاح الترخيص». إذا كنت مستخدمًا عاديًا ورأيت هذه الشاشة، فأبلغ قسم تقنية المعلومات. ## أدلة ذات صلة - [إنشاء حسابك ومساحة العمل](https://raptix.app/user-guide/ar/00-getting-started/00-20-create-workspace-signup/) - [كيفية تسجيل الدخول بحساب Microsoft ‏(SSO)](https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/) - [البقاء مسجلًا وتسجيل الخروج بأمان](https://raptix.app/user-guide/ar/00-getting-started/00-16-sessions-and-logout/) - [ماذا تفعل عندما تظهر «الوصول مقيّد»](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/ # كيفية تسجيل الدخول بحساب Microsoft ‏(SSO) > **الوحدة:** المنصة — البدء  |  **الجمهور:** جميع المستخدمين > **ما ستتعلمه:** كيفية الدخول إلى RAPTIX باستخدام حساب Microsoft الخاص بمؤسستك من دون الحاجة إلى كلمة مرور منفصلة. ## ما هذه الميزة؟ يدعم RAPTIX تسجيل الدخول بحساب Microsoft الحالي للعمل أو الدراسة، وهو الحساب نفسه الذي تستخدمه مع Outlook وTeams وخدمات Microsoft 365 الأخرى. عندما تختار **المتابعة باستخدام Microsoft (`Continue with Microsoft`)**، تنقلك المنصة إلى صفحة تسجيل الدخول التابعة لـ Microsoft؛ وبعد توثيق هويتك هناك، تعيدك Microsoft إلى RAPTIX وأنت مسجل الدخول. ويُسمى ذلك تسجيل الدخول الموحد (SSO). إذا فعّلت مؤسستك SSO وكان بريد Microsoft يطابق حسابًا في RAPTIX، أو فعّل المسؤول إنشاء الحساب تلقائيًا، فلن تستغرق العملية كلها سوى ثوانٍ ولن تحتاج إلى كلمة مرور مستقلة لـ RAPTIX. ## لماذا تفيدك؟ - **لا توجد كلمة مرور إضافية لتتذكرها** — بيانات Microsoft هي كل ما تحتاج إليه. - **دخول بنقرة واحدة** — اختر **المتابعة باستخدام Microsoft**، ووثّق هويتك مرة واحدة لدى Microsoft إن لم تكن مسجلًا لديها، وينتهي الأمر. - **تعمل مع سياسات الأمان الحالية في مؤسستك** — يُطبق تلقائيًا التحقق متعدد العوامل (MFA) والوصول المشروط وقواعد Microsoft الأمنية الأخرى. - **يمكن تجهيز المستخدمين الجدد تلقائيًا** — إذا فعّل المسؤول التجهيز التلقائي، ينشئ أول دخول حسابك في RAPTIX فورًا من دون انتظار قسم تقنية المعلومات. - **آمنة بطبيعتها** — لا ترى المنصة كلمة مرور Microsoft ولا تخزنها؛ تتولى Microsoft التحقق من بيانات الاعتماد مباشرة. - **حماية من اختطاف الروابط** — يتحقق فحص أمني تلقائي من مسار الدخول من بدايته إلى نهايته، ويرفض أي محاولة عُدلت أو أُعيد تشغيلها. ## قبل أن تبدأ - يجب تمكين Microsoft SSO لمؤسستك. إذا لم يظهر زر **المتابعة باستخدام Microsoft** في صفحة الدخول، فلم تُضبط الخدمة؛ تواصل مع المسؤول. - تحتاج إلى حساب Microsoft للعمل أو الدراسة، مثل `yourname@yourcompany.com`. وقد لا تُدعم الحسابات الشخصية مثل Outlook.com وHotmail.com بحسب إعداد مؤسستك. - يجب أن يطابق بريد حساب Microsoft حسابًا موجودًا في RAPTIX، أو أن يكون المسؤول قد فعّل إنشاء الحسابات تلقائيًا. - بعد إنشاء حسابك أو مطابقته، يجب إسناد دور إليه قبل الوصول إلى المنصة. إذا نجح الدخول عبر Microsoft لكن ظهرت رسالة بعدم وجود أدوار، فتواصل مع المسؤول. ## طريقة الاستخدام خطوة بخطوة 1. افتح عنوان RAPTIX الخاص بمؤسستك، مثل `https://.raptix.app`. ستظهر صفحة تسجيل الدخول. 2. اختر زر **المتابعة باستخدام Microsoft (`Continue with Microsoft`)** قرب أسفل النموذج. 3. تتغير تسمية الزر إلى **جارٍ الاتصال بـ Microsoft… (`Connecting to Microsoft…`)** ويظهر مؤشر تحميل بينما تجهز المنصة إعادة التوجيه. انتظر لحظة ولا تغلق علامة التبويب. 4. يعيد المتصفح توجيهك تلقائيًا إلى صفحة تسجيل الدخول التابعة لـ Microsoft. - إذا كنت مسجلًا لدى Microsoft بالفعل في هذا المتصفح، فقد تُكمل Microsoft الخطوة من دون تدخل وتعيدك فورًا، أو تطلب منك تأكيد الحساب باختيار اسمك. - إذا لم تكن مسجلًا، فأدخل بريد Microsoft وكلمة المرور وأكمل أي تحقق متعدد العوامل تطلبه مؤسستك. > **ملاحظة:** أنت الآن في صفحة Microsoft نفسها لا في RAPTIX. ولا يرى RAPTIX كلمة مرور Microsoft في أي مرحلة. 5. بعد أن تؤكد Microsoft هويتك، يعيدك المتصفح تلقائيًا إلى منصة RAPTIX. 6. يتحقق RAPTIX من هوية Microsoft ويطابقها بحسابك الموجود، أو ينشئ حسابًا جديدًا إذا كان التجهيز التلقائي مفعّلًا. 7. تصل إلى شاشة RAPTIX الرئيسية وأنت مسجل الدخول بالكامل. ## شرح الخيارات والإعدادات | العنصر | وظيفته | |---|---| | زر **المتابعة باستخدام Microsoft (`Continue with Microsoft`)** | يبدأ مسار Microsoft SSO وينقل المتصفح إلى صفحة Microsoft. لا يظهر الزر إذا لم تُضبط الخدمة. | | صفحة تسجيل الدخول إلى Microsoft | تديرها Microsoft بالكامل. أدخل فيها بريد العمل أو الدراسة وكلمة المرور. لا يرى RAPTIX الصفحة أو بيانات اعتمادك. | | مطالبات التحقق متعدد العوامل (MFA) | تأتي من Microsoft لا من RAPTIX. أكملها كما تفعل مع خدمات Microsoft الأخرى. | | العودة التلقائية | بعد أن تؤكد Microsoft هويتك، يعود المتصفح تلقائيًا إلى RAPTIX من دون خطوات إضافية. | ### رسائل الخطأ التي قد تراها | الرسالة | معناها | ما ينبغي فعله | |---|---|---| | «تعذر بدء تسجيل الدخول عبر Microsoft (`Failed to initiate Microsoft login`)» | لم تتمكن المنصة من بدء مسار SSO، وغالبًا لأن الخدمة غير مضبوطة. | تواصل مع المسؤول. | | «فشل توثيق Microsoft (`Microsoft authentication failed: …`)» | رفضت Microsoft محاولة الدخول، مثلًا لأن الحساب معطل لديها. | راجع قسم تقنية المعلومات بشأن حالة حساب Microsoft. | | «حالة OAuth غير صالحة أو منتهية (`Invalid or expired OAuth state...`)» | انتهت مهلة جلسة SSO أو غادر المتصفح الصفحة ثم عاد إليها. | ارجع إلى صفحة دخول RAPTIX واختر **المتابعة باستخدام Microsoft** مرة أخرى. | | «أُنشئ حسابك لكن لم تُسند إليه أدوار بعد (`Your account has been created but no roles...`)» | نجح الدخول عبر Microsoft وأُنشئ حسابك تلقائيًا، لكن لم تُمنح له أدوار وصول. | اطلب من المسؤول إسناد دور إلى الحساب الجديد. | | «عولج رمز التفويض هذا من قبل (`This authorization code has already been processed...`)» | أرسل المتصفح استجابة التوثيق نفسها مرتين، مثلًا بسبب تحديث صفحة العودة. | ارجع إلى صفحة الدخول وابدأ مسار SSO من جديد. | ## نصائح وأفضل الممارسات - **أبقِ حساب Microsoft مسجلًا** في المتصفح الذي تستخدمه مع RAPTIX؛ فهذا يجعل SSO شبه فوري. - **لا تحدّث صفحة العودة.** بعد أن تعيدك Microsoft إلى RAPTIX، دع الصفحة تُحمّل بالكامل؛ فقد يسبب التحديث خطأ «عولج من قبل». - **إذا تعطل SSO، فاستخدم اسم المستخدم وكلمة المرور كخيار بديل** إن كان المسؤول قد عيّن كلمة مرور لحسابك. يفيد ذلك عند وجود انقطاع مؤقت في خدمة Microsoft. - **على الأجهزة المشتركة،** سجّل الخروج من RAPTIX ومن Microsoft عند الانتهاء؛ فتسجيل الخروج من RAPTIX وحده قد يترك جلسة Microsoft نشطة في المتصفح. - **إذا كنت مستخدمًا جديدًا،** انتظر دقيقة بعد أول دخول حتى يكتمل تجهيز الحساب، ثم اطلب من المسؤول تأكيد إسناد دور قبل محاولة فتح وحدات محددة. ## الأسئلة الشائعة **س: هل أحتاج إلى كلمة مرور منفصلة لـ RAPTIX إذا استخدمت Microsoft SSO؟** لا. إذا كنت تدخل دائمًا عبر Microsoft، فلست بحاجة إلى كلمة مرور مستقلة. ومع ذلك، ربما يكون المسؤول قد أعد واحدة كخيار احتياطي، وعندها يمكنك استخدام نموذج اسم المستخدم وكلمة المرور أيضًا. **س: ماذا يحدث إذا تعطلت Microsoft أو لم تكن متاحة؟** سيفشل مسار SSO إذا تعذر الوصول مؤقتًا إلى خدمة دخول Microsoft. إن كان لحسابك اسم مستخدم وكلمة مرور على المنصة، فاستخدمهما بدلًا منها؛ وإلا فتواصل مع المسؤول. **س: تطلب صفحة Microsoft تحققًا متعدد العوامل. هل هذا طبيعي؟** نعم. تتحكم سياسات Microsoft في مؤسستك في MFA لا RAPTIX. أكمل الخطوة بالطريقة المعتادة مع خدمات Microsoft 365. **س: دخلت عبر Microsoft وظهرت رسالة بأن حسابي بلا أدوار. ماذا أفعل؟** تعرّفت المنصة إلى هويتك، لكن لم تُسند صلاحيات إلى حساب RAPTIX بعد. اطلب من المسؤول إسناد دور، ثم سجّل الدخول مجددًا. **س: تستخدم مؤسستي عناوين Outlook.com. هل يمكنني استخدامها؟** يتوقف ذلك على إعداد المسؤول لـ SSO مع حسابات Microsoft الشخصية. تضبط معظم المؤسسات الخدمة لحسابات العمل والدراسة فقط؛ راجع قسم تقنية المعلومات. **س: عدت إلى RAPTIX لكن الصفحة فارغة أو تعرض خطأ. ماذا أفعل؟** ارجع إلى صفحة الدخول بفتح عنوان RAPTIX مباشرة ثم حاول مجددًا. إذا تكررت المشكلة، امسح ملفات تعريف الارتباط للموقع وحاول مرة أخرى أو استخدم متصفحًا آخر. **س: هل تستطيع المنصة رؤية كلمة مرور Microsoft؟** لا. يتواصل متصفحك مباشرة مع Microsoft للتوثيق. ولا يتلقى RAPTIX سوى تأكيد بأن Microsoft تحققت من هويتك؛ فلا يرى كلمة المرور أو يخزنها. ## أدلة ذات صلة - [كيفية تسجيل الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) - [البقاء مسجلًا وتسجيل الخروج بأمان](https://raptix.app/user-guide/ar/00-getting-started/00-16-sessions-and-logout/) - [ماذا تفعل عندما تظهر «الوصول مقيّد»](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/ # ماذا تفعل إذا نسيت كلمة المرور؟ > **الوحدة:** أساسيات المنصة   |   **الجمهور:** المستخدم النهائي > **ما ستتعلمه:** كيفية طلب رابط لإعادة تعيين كلمة المرور حتى تستعيد الوصول إلى حسابك من دون التواصل مع قسم تقنية المعلومات. --- ## ما هذه الميزة؟ تتيح لك صفحة «نسيت كلمة المرور» طلب رابط آمن لإعادة التعيين يُرسل إلى بريدك الإلكتروني المسجل. أدخل بريدك واختر زرًا واحدًا، وسترسل إليك المنصة رابطًا خاصًا. ينقلك الرابط إلى صفحة تختار فيها كلمة مرور جديدة. تستغرق العملية كلها أقل من دقيقتين. --- ## لماذا تفيدك؟ - **استعادة ذاتية للحساب** — استعد الوصول بنفسك في أي وقت من دون انتظار تدخل المسؤول. - **حماية الخصوصية بطبيعتها** — تعرض المنصة الاستجابة نفسها سواء كان البريد مسجلًا أم لا، فلا تكشف لأي مراقب عن الحسابات الموجودة. - **مقاومة إساءة الاستخدام** — يحد النظام تلقائيًا عدد طلبات إعادة التعيين في الساعة للبريد نفسه ومن اتصال الشبكة نفسه، كي لا يغرق شخص آخر حسابك برسائل إعادة التعيين. - **روابط قصيرة الصلاحية** — ينتهي الرابط بعد 30 دقيقة، لذلك سرعان ما يصبح عديم الفائدة حتى لو اعترضه أحد. - **استخدام لمرة واحدة** — يعمل الرابط مرة واحدة فقط. حالما تحفظ كلمة المرور الجديدة، يُعطّل نهائيًا وتُلغى في الوقت نفسه أي روابط معلقة أخرى للحساب، فلا يمكن إساءة استخدام رسائل أقدم. - **عدم كشف المعلومات الحساسة** — لا تسجل المنصة بريدك الإلكتروني أو أي جزء من رابط إعادة التعيين ولا تعرضهما في سجلات النظام. --- ## قبل أن تبدأ - يجب أن تعرف البريد الإلكتروني المرتبط بحساب RAPTIX. - تحتاج إلى فتح صندوق ذلك البريد لتلقي الرابط. - لا يلزم دور أو صلاحية خاصة؛ فالصفحة متاحة لأي شخص لديه حساب. - **مكانها:** انتقل إلى صفحة الدخول `https://.raptix.app/login` ثم اختر **هل نسيت كلمة المرور؟ (`Forgot Password?`)**. ويمكنك أيضًا فتح `https://.raptix.app/forgot-password` مباشرة. --- ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — افتح صفحة «نسيت كلمة المرور» اختر رابط **هل نسيت كلمة المرور؟** من صفحة الدخول. تُفتح الصفحة وفيها رمز بريد وعنوان **هل نسيت كلمة المرور؟ (`Forgot Password?`)** ورسالة تطلب إدخال البريد لإرسال رابط إعادة التعيين. ### الخطوة 2 — أدخل عنوان بريدك الإلكتروني اختر حقل **عنوان البريد الإلكتروني (`Email Address`)** واكتب البريد الذي استُخدم لإنشاء حسابك. يقبل الحقل أي صيغة بريد صحيحة، ويمكنك الضغط على **Enter** بعد الكتابة لإرسال النموذج من دون الفأرة. > **نصيحة:** راجع تهجئة العنوان بدقة؛ فالمنصة تبحث عن حسابك باستخدامه. سيظل الخطأ الإملائي يعرض رسالة نجاح لحماية خصوصية الحساب، لكن لن تصلك رسالة. ### الخطوة 3 — أرسل رابط إعادة التعيين اختر زر **إرسال رابط إعادة التعيين (`Send Reset Link`)**. أثناء المعالجة يتغير إلى **جارٍ الإرسال... (`Sending...`)** مع مؤشر تحميل ويُعطل مؤقتًا. لا يستغرق ذلك عادة سوى لحظة. ### الخطوة 4 — راجع رسالة التأكيد بعد إرسال الطلب، تتحول الصفحة إلى شاشة تأكيد خضراء بعنوان **تحقق من بريدك (`Check Your Email`)** ورسالتها: > «إذا كان هناك حساب مرتبط بـ [بريدك]، فقد أرسلنا رابطًا لإعادة تعيين كلمة المرور.» > «ينتهي الرابط خلال 30 دقيقة. تحقق من مجلد البريد العشوائي إذا لم تجده.» > **ما معنى ذلك؟** تعرض المنصة رسالة التأكيد هذه دائمًا بصرف النظر عن تسجيل البريد، لحماية خصوصية الحسابات. إذا لم تصلك رسالة خلال دقائق، فتحقق من مجلد البريد العشوائي وتأكد من كتابة العنوان الصحيح. ### الخطوة 5 — افتح رسالة البريد ابحث في صندوق الوارد عن رسالة موضوعها **إعادة تعيين كلمة المرور — RAPTIX (`Password Reset — RAPTIX`)**. تحتوي الرسالة زر **إعادة تعيين كلمة المرور (`Reset Password`)** ورابطًا نصيًا بديلًا، وتنبه إلى انتهاء صلاحية الرابط بعد 30 دقيقة. > **ما ستراه في الرسالة:** رسالة تحمل هوية RAPTIX، بترويسة متدرجة من الأزرق إلى البنفسجي، وعنوان «طلب إعادة تعيين كلمة المرور»، وشرح موجز، وزر بارز لإعادة التعيين، وعنوان بديل يمكن نسخه إذا لم يعمل الزر، وتنبيه أصفر إلى انتهاء الصلاحية خلال 30 دقيقة. ### الخطوة 6 — اختر «إعادة تعيين كلمة المرور» من الرسالة اختر زر **إعادة تعيين كلمة المرور** في البريد، أو انسخ الرابط البديل والصقه في المتصفح. تفتح المنصة صفحة اختيار كلمة مرور جديدة. راجع دليل **[كيفية تعيين كلمة مرور جديدة باستخدام رابط إعادة التعيين](https://raptix.app/user-guide/ar/00-getting-started/00-4-reset-password/)** للخطوة التالية. ### الخطوة 7 — ارجع إلى تسجيل الدخول، إن أردت إذا تذكرت كلمة المرور أو أردت الرجوع، فاختر **العودة إلى تسجيل الدخول (`Back to Login`)** أسفل صفحة «نسيت كلمة المرور» أو شاشة التأكيد في أي وقت. --- ## شرح الخيارات والإعدادات | العنصر | وظيفته | |---|---| | حقل **عنوان البريد الإلكتروني (`Email Address`)** | يقبل البريد المرتبط بحساب RAPTIX، وهو مطلوب قبل الإرسال، ويدعم زر Enter للإرسال. | | زر **إرسال رابط إعادة التعيين (`Send Reset Link`)** | يرسل عنوان البريد ويبدأ إرسال رسالة إعادة التعيين. يتعطل ويعرض مؤشر تحميل أثناء المعالجة. | | رابط **العودة إلى تسجيل الدخول (`Back to Login`)** | يعيدك إلى صفحة الدخول من دون إرسال شيء، وهو متاح قبل الإرسال وبعده. | | شاشة **تحقق من بريدك (`Check Your Email`)** | تحل محل النموذج بعد نجاح الإرسال، وتعرض علامة خضراء وتوضح أن الرسالة أُرسلت إن كان البريد مسجلًا، وتذكّر بمهلة 30 دقيقة. | | مربع رسالة الخطأ، إن ظهر | شريط أحمر يظهر إذا كان الحقل فارغًا عند الإرسال أو وقع خلل تقني غير متوقع، ويشرح ما حدث. | --- ## نصائح وأفضل الممارسات - **تحرك بسرعة.** الرابط صالح لمدة 30 دقيقة فقط. إذا انتهت صلاحيته، فارجع واطلب رابطًا جديدًا. - **تحقق من مجلد البريد العشوائي.** قد تنقل بعض برامج البريد الرسائل الآلية إلى مجلد الرسائل غير المرغوب فيها. - **اطلب الرابط مرة واحدة.** لا يسبب تكرار النقر ضررًا، لكن الرابط الأحدث هو الذي ينبغي استخدامه، وتُلغى الروابط السابقة عند نجاح استخدام رابط جديد. - **يمكن لكل عنوان استقبال ثلاث رسائل إعادة تعيين كحد أقصى في الساعة** كإجراء حماية. إذا كررت الطلب ولم تصلك الرسائل، فانتظر ساعة ثم حاول أو تواصل مع المسؤول. - **لا تشارك الرابط.** رابط إعادة التعيين شخصي ويعمل مرة واحدة؛ لا تعِد توجيهه إلى أحد. --- ## الأسئلة الشائعة **أرسلت بريدي ولم تصل رسالة. ماذا أفعل؟** تحقق أولًا من مجلد البريد العشوائي، وتأكد أن العنوان المكتوب يطابق المسجل في حسابك. إذا لم تكن متأكدًا، فاسأل المسؤول عن البريد المسجل. وتذكّر أن المنصة تحد الرسائل إلى ثلاث في الساعة لكل عنوان؛ فإذا أرسلت عدة طلبات متقاربة، فانتظر ساعة قبل المحاولة. **لماذا تقول الصفحة دائمًا «إذا كان هناك حساب»؟ وكيف أعرف أن الطلب نجح؟** هذه الصياغة مقصودة؛ فالمنصة لا تؤكد تسجيل البريد ولا تنفيه، كي تمنع الآخرين من اكتشاف الحسابات. إذا كان البريد مسجلًا ولم تبلغ الحد الساعي، فستصل الرسالة. وإن لم تصل، فافحص البريد العشوائي ثم حاول مجددًا. **انتهت صلاحية الرابط في الرسالة. ماذا أفعل؟** ارجع إلى `https://.raptix.app/forgot-password` واطلب رابطًا جديدًا صالحًا لـ30 دقيقة أخرى. **وصلت الرسالة لكن زر إعادة تعيين كلمة المرور لا يعمل.** انسخ عنوان URL النصي أسفل الزر والصقه مباشرة في شريط عنوان المتصفح. إذا لم يعمل، فاطلب رابطًا جديدًا؛ لعل القديم انتهت صلاحيته. **اخترت الرابط لكنه يقول إنه غير صالح أو منتهي.** إما أن الرابط استُخدم، أو مرّت عليه 30 دقيقة، أو أُلغيت الروابط المعلقة للحساب. اطلب رابطًا جديدًا من صفحة «نسيت كلمة المرور». **هل أستخدم هذه الطريقة إذا كنت أسجل الدخول بحساب Microsoft؟** لا. إذا كانت مؤسستك تستخدم تسجيل دخول Microsoft، فتدير Microsoft كلمة مرورك لا RAPTIX. استخدم عملية استرداد حساب Microsoft المعتمدة في شركتك. --- ## أدلة ذات صلة - [كيفية تعيين كلمة مرور جديدة باستخدام رابط إعادة التعيين](https://raptix.app/user-guide/ar/00-getting-started/00-4-reset-password/) - [تسجيل الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) - [تسجيل الدخول باستخدام Microsoft ‏(SSO)](https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-4-reset-password/ # كيفية تعيين كلمة مرور جديدة باستخدام رابط إعادة التعيين > **الوحدة:** أساسيات المنصة   |   **الجمهور:** المستخدم النهائي > **ما ستتعلمه:** كيفية فتح رسالة إعادة تعيين كلمة المرور، واستخدام الرابط للوصول إلى الصفحة، وإنشاء كلمة مرور جديدة قوية بنجاح. --- ## ما هذه الميزة؟ صفحة إعادة تعيين كلمة المرور هي المكان الذي تختار فيه كلمة المرور الجديدة بعد فتح الرابط المرسل إلى بريدك. تعرض حقلين لكلمة المرور، ومؤشر قوة مباشرًا، وقائمة بأي متطلبات لم تتحقق؛ لذلك تعرف دائمًا ما تحتاج إليه قبل الإرسال. وبعد تأكيد كلمة المرور، تحدّث المنصة حسابك وتنقلك تلقائيًا إلى صفحة الدخول. --- ## لماذا تفيدك؟ - **استعادة فورية ذاتية للحساب** — لا تحتاج إلى الاتصال بالدعم أو انتظار المسؤول؛ ويمكنك العودة إلى حسابك خلال دقائق. - **تقييم مباشر للقوة** — يوضح شريط ملون وقائمة متطلبات بلغة واضحة، وفي الوقت الفعلي، إن كانت كلمة المرور ضعيفة (`Weak`) أو متوسطة (`Medium`) أو قوية (`Strong`). - **تنبيه واضح عند عدم التطابق** — إذا اختلف الحقلان، يتحول الثاني إلى الأحمر وتظهر رسالة فورًا قبل محاولة الإرسال. - **حماية قوية لحظة الإرسال** — رابط إعادة التعيين صالح لمرة واحدة ويُبطل نهائيًا فور حفظ كلمة المرور الجديدة. كما تُلغى أي روابط معلقة أخرى للحساب في اللحظة نفسها. - **عودة تلقائية** — بعد النجاح تعد الصفحة ثلاث ثوانٍ ثم تنقلك مباشرة إلى تسجيل الدخول. - **أمان مدمج** — لا تُخزن كلمة المرور الجديدة أو تُنقل كنص مكشوف. وتتحقق الصفحة والخادم من قواعد القوة كلٌ على حدة، فلا يمكن تجاوزها. --- ## قبل أن تبدأ - يجب أن تكون قد تلقيت رسالة إعادة التعيين واخترت رابط **إعادة تعيين كلمة المرور (`Reset Password`)**، أو نسخت عنوانه، خلال **مدة الصلاحية البالغة 30 دقيقة**. راجع **[ماذا تفعل إذا نسيت كلمة المرور؟](https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/)** إذا لم تطلب رابطًا بعد. - يجب أن يدعم متصفحك JavaScript، وهذا متاح في جميع المتصفحات الحديثة. - لا يلزم تسجيل الدخول للوصول إلى هذه الصفحة؛ فهي متاحة عمدًا من دون جلسة. - **مكانها:** تُفتح تلقائيًا عند اختيار زر إعادة التعيين من الرسالة. يبدو عنوانها مثل `https://.raptix.app/reset-password?token=...`. --- ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — افتح رابط إعادة التعيين من بريدك اختر زر **إعادة تعيين كلمة المرور** في الرسالة. يفتح المتصفح الصفحة التي تحمل العنوان نفسه وتعليمة «أدخل كلمة المرور الجديدة وأكّدها أدناه». ويظهر رمز قفل بحركة هادئة في ترويسة الصفحة. > **إذا ظهر خطأ فورًا:** إذا قالت الصفحة «رابط إعادة تعيين غير صالح؛ لم يُعثر على رمز في عنوان URL (`Invalid reset link. No token found in the URL`)»، فقد يكون الرابط ناقصًا أو تضرر أثناء النقل. ارجع إلى البريد واختر الزر أو انسخ الرابط البديل كاملًا. وإذا قالت «رمز إعادة التعيين غير صالح أو منتهي»، فقد انتهت مهلة 30 دقيقة أو استُخدم الرابط؛ اطلب رابطًا جديدًا من صفحة [نسيت كلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/). ### الخطوة 2 — أدخل كلمة المرور الجديدة اختر حقل **كلمة المرور الجديدة (`New Password`)** واكتب اختيارك. أثناء الكتابة يظهر أسفله فورًا شريط **قوة كلمة المرور (`Password strength`)** مع تصنيف: - **ضعيفة (`Weak`)** بشريط أحمر — لم تستوف جميع المتطلبات بعد. - **متوسطة (`Medium`)** بشريط أصفر — استوفت بعض المتطلبات، لكن يمكن تقويتها. - **قوية (`Strong`)** بشريط أخضر — استوفت المتطلبات وصيغت جيدًا. تُحسب القوة من أربعة عوامل: الطول، إذ تحصل 8 أحرف فأكثر على نقاط و12 فأكثر على نقاط إضافية، ووجود حرف إنجليزي كبير واحد على الأقل، وحرف صغير واحد، ورقم واحد. تضيف الرموز الخاصة مثل `!` و`@` و`#` قوة أخرى، لكنها ليست إلزامية. ### الخطوة 3 — أكّد كلمة المرور الجديدة اختر حقل **تأكيد كلمة المرور (`Confirm Password`)** واكتب الكلمة نفسها مرة ثانية. إذا لم يتطابق الحقلان، تتحول حافة الحقل الثاني إلى الأحمر وتظهر فورًا رسالة **«كلمتا المرور غير متطابقتين (`Passwords do not match.`)»**. يتحدث التنبيه مع الكتابة ويختفي حال تطابق القيمتين. ### الخطوة 4 — اختر إعادة تعيين كلمة المرور اختر زر **إعادة تعيين كلمة المرور (`Reset Password`)**. أثناء المعالجة تتغير تسميته إلى **جارٍ إعادة التعيين… (`Resetting…`)** مع مؤشر تحميل، وتكتمل العملية عادة خلال أقل من ثانية. **إذا وُجدت مشكلات تحقق،** تظهر لوحة صفراء فوق النموذج تسرد كل قاعدة لم تتحقق، مثل «يجب ألا تقل كلمة المرور عن 8 أحرف» أو «يجب أن تحتوي حرفًا كبيرًا واحدًا على الأقل». أصلح كل بند ثم اختر الزر مجددًا. تختفي اللوحة حال تحقق القواعد وتطابق الكلمتين. **إذا وقع خطأ في الخادم،** مثل انتهاء الرمز أو استخدامه سابقًا، يظهر مربع أحمر بالشرح. اتبع تعليماته، وغالبًا ستحتاج إلى طلب رابط جديد. ### الخطوة 5 — راجع تأكيد النجاح عندما تُقبل كلمة المرور، تحل شاشة خضراء محل النموذج بعنوان **أُعيد تعيين كلمة المرور! (`Password Reset!`)** ورسالة: > «أُعيد تعيين كلمة مرورك بنجاح.» > «ستنتقل إلى تسجيل الدخول خلال 3 ثوانٍ…» > **ما ستراه:** دائرة خضراء كبيرة بعلامة صح بيضاء، وعنوان النجاح، والعد التنازلي. ويتاح رابط **الانتقال إلى تسجيل الدخول (`Go to Login`)** إن أردت الانتقال فورًا. ### الخطوة 6 — سجّل الدخول بكلمة المرور الجديدة بعد ثلاث ثوانٍ، أو فور اختيار **الانتقال إلى تسجيل الدخول**، تصل إلى صفحة الدخول. أدخل اسم المستخدم أو البريد وكلمة المرور الجديدة. --- ## شرح الخيارات والإعدادات | العنصر | وظيفته | |---|---| | حقل **كلمة المرور الجديدة (`New Password`)** | مكان كتابة الكلمة الجديدة، وتظهر أحرفه كنقاط. يشغّل شريط القوة أثناء الكتابة، ويتعطل إذا كان الرابط غير صالح. | | **شريط قوة كلمة المرور** | يظهر تحت الحقل عند بدء الكتابة. يمتد شريط أحمر أو أصفر أو أخضر مع التصنيف ضعيفة أو متوسطة أو قوية. | | حقل **تأكيد كلمة المرور (`Confirm Password`)** | تكتب فيه الكلمة نفسها مرة أخرى. يتحول إلى الأحمر وتظهر ملاحظة عدم التطابق عند اختلاف الحقلين. ويمكن الضغط على **Enter** منه للإرسال. | | **لوحة متطلبات التحقق** الصفراء | تظهر بعد الإرسال إذا لم تستوف الكلمة القواعد، وتسرد المتطلبات الناقصة كنقاط، ثم تختفي عند تحققها. | | **مربع رسالة الخطأ** الأحمر | يظهر إذا كان الرمز مفقودًا أو منتهيًا أو مستخدمًا، أو وقعت مشكلة في الخادم، ويشرح السبب. | | زر **إعادة تعيين كلمة المرور** | يرسل الكلمة الجديدة. يتعطل ويعرض مؤشر تحميل أثناء المعالجة، ويظهر باهتًا إذا كان الرابط غير صالح. | | رابط **العودة إلى تسجيل الدخول (`Back to Login`)** | ينقلك إلى صفحة الدخول في أي وقت من دون إكمال العملية، ويتاح أسفل النموذج وعلى شاشة النجاح باسم **الانتقال إلى تسجيل الدخول**. | | **شاشة النجاح** | تحل محل النموذج، وتعرض علامة خضراء ونص التأكيد وعدًا تنازليًا لثلاث ثوانٍ ورابط الانتقال إلى الدخول. | --- ## متطلبات كلمة المرور يجب أن تحقق كلمة المرور الجديدة القواعد الأربع الآتية. تتحقق الصفحة منها أثناء الكتابة ومرة أخرى عند اختيار **إعادة تعيين كلمة المرور**: | المتطلب | التفاصيل | |---|---| | الحد الأدنى للطول | **8 أحرف** على الأقل | | حرف كبير | **حرف إنجليزي كبير واحد** على الأقل (A–Z) | | حرف صغير | **حرف إنجليزي صغير واحد** على الأقل (a–z) | | رقم | **رقم واحد** على الأقل (0–9) | الرموز الخاصة مثل `!` و`@` و`#` و`$` و`%` و`-` و`_` مسموحة وترفع تقييم القوة، لكنها غير مطلوبة. --- ## نصائح وأفضل الممارسات - **اجعل شريط القوة دليلك.** استهدف تصنيف **قوية** باللون الأخضر قبل الإرسال؛ فهي أصعب تخمينًا وتحمي الحساب أكثر. - **استخدم عبارة مرور.** سلسلة من ثلاث أو أربع كلمات عشوائية، مثل `BlueMountain77!`، سهلة التذكر وتحصل على تصنيف قوي لطولها وتنوعها. - **استخدم الرابط خلال 30 دقيقة.** تنتهي صلاحيته بعد 30 دقيقة من إرسال البريد. وإن لم تكن جاهزًا، فاطلب رابطًا جديدًا من صفحة [نسيت كلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/). - **لا تعِد استخدام الرابط.** فهو يعمل مرة واحدة فقط. إذا احتجت إلى إعادة التعيين مرة أخرى، فاطلب رابطًا جديدًا. - **اكتب بعناية في الحقلين.** لأن الأحرف مخفية، يُعد عدم التطابق سببًا شائعًا للالتباس؛ وسينبهك المؤشر الأحمر قبل الإرسال. - **فكّر في استخدام مدير كلمات مرور.** يمكنه إنشاء كلمة قوية وفريدة وتذكرها كي لا تضطر إلى إعادة تعيينها مجددًا. --- ## الأسئلة الشائعة **اخترت زر إعادة التعيين وظهرت رسالة «رمز غير صالح أو منتهي». ماذا تعني؟** إما أن أكثر من 30 دقيقة مرّت منذ إرسال البريد، أو أن الرابط استُخدم بنجاح. انتقل إلى صفحة [نسيت كلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/) واطلب رابطًا جديدًا صالحًا لـ30 دقيقة أخرى. **فُتحت الصفحة لكن حقلي كلمة المرور باهتان ولا أستطيع الكتابة.** اكتشفت الصفحة عدم وجود رمز صالح في عنوان URL؛ وربما كان الرابط ناقصًا أو تالفًا. ارجع إلى البريد واختر الزر أو انسخ الرابط كاملًا بعناية. وإذا استمرت المشكلة، فاطلب رابطًا جديدًا. **أدخلت كلمة المرور لكن ظهرت قائمة متطلبات لم أحققها. ماذا أفعل؟** اقرأ البنود في اللوحة الصفراء وحدّث كلمتك. أكثر الأسباب شيوعًا: أقل من 8 أحرف، أو لا يوجد حرف كبير، أو لا يوجد رقم، أو لا يتطابق الحقلان. أصلح كل بند وأعد الإرسال. **ظهرت شاشة النجاح لكن لم أنتقل إلى الدخول بعد ثلاث ثوانٍ.** اختر رابط **الانتقال إلى تسجيل الدخول** في شاشة النجاح لتنتقل فورًا من دون انتظار. **أعدت تعيين كلمة المرور لكن ما زلت لا أستطيع الدخول.** تأكد من كتابة الكلمة الجديدة كما عيّنتها تمامًا؛ فهي حساسة لحالة الأحرف. إذا استمرت المشكلة، فاطلب رابطًا آخر وحاول مجددًا. **هل يمكنني استخدام كلمة المرور السابقة نفسها؟** لا تمنع المنصة ذلك، لكن يُنصح باختيار كلمة جديدة وفريدة لأمان أفضل. **أغلقت علامة التبويب بالخطأ. هل يمكنني إعادة فتحها؟** نعم، ما دامت مهلة 30 دقيقة لم تنته والرابط لم يُستخدم. افتح رسالة إعادة التعيين واختر الزر مجددًا. وإذا مرّت 30 دقيقة، فاطلب رابطًا جديدًا. --- ## أدلة ذات صلة - [ماذا تفعل إذا نسيت كلمة المرور؟](https://raptix.app/user-guide/ar/00-getting-started/00-3-forgot-password/) - [تسجيل الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) - [تسجيل الدخول باستخدام Microsoft ‏(SSO)](https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-16-sessions-and-logout/ # البقاء مسجلًا وتسجيل الخروج بأمان > **الوحدة:** المنصة — البدء  |  **الجمهور:** جميع المستخدمين > **ما ستتعلمه:** كيف تعمل جلسة RAPTIX، وما الذي يبقيك مسجلًا خلال اليوم، وما الذي ينهيها، وكيف تسجل الخروج بأمان بعد الانتهاء. ## ما هذه الميزة؟ الجلسة هي المدة التي تكون فيها موثقًا ونشطًا في RAPTIX، من لحظة تسجيل الدخول حتى تسجل أنت أو النظام خروجك. يدير RAPTIX الجلسات بذكاء: يُجدَّد دخولك بهدوء في الخلفية أثناء العمل فلا تُقاطع، وتنتهي الجلسة بصورة حاسمة عند تسجيل الخروج أو انتهاء صلاحيتها، بحيث يتعذر على أي شخص إعادة استخدام بيانات جلستك بعد ذلك. يوضح هذا الدليل ما يحدث في كل حالة، وما ستراه، وكيف تنهي الجلسة بالطريقة الصحيحة. ## لماذا تفيدك؟ - **ابقَ مسجلًا طوال يوم العمل بلا مقاطعة** — تُجدَّد الجلسة تلقائيًا في الخلفية أثناء نشاطك، فلا تُخرج من منتصف مهمة. - **تسجيل الخروج فوري وكامل** — فور اختيار `Logout` تُبطل الجلسة في الخادم. ولا يستطيع من حصل بطريقة ما على رابط جلستك استخدامه بعد ذلك. - **خروج تلقائي عند انتهاء الجلسة فعلًا** — إذا تركت المنصة مدة كافية وانتهت الجلسة، تعود بأمان إلى صفحة الدخول برسالة واضحة، بدل شاشة معطلة أو ناقصة التحميل. - **هويتك وحالة حسابك ظاهرتان دائمًا** — يعرض الشريط العلوي اسمك وبريدك وشارات دورك طوال الجلسة، فتعرف الحساب الذي تعمل به. - **تعمل عبر علامات التبويب والنوافذ** — تشترك جميع علامات RAPTIX في المتصفح في الجلسة نفسها؛ وتسجيل الخروج من واحدة ينهيها في الجميع. ## قبل أن تبدأ - يجب أن تكون مسجلًا كي تكون لك جلسة. إن لم تكن كذلك، فراجع [الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) أو [الدخول بحساب Microsoft ‏(SSO)](https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/). - يوجد زر **تسجيل الخروج (`Logout`)** في شريط التنقل العلوي بكل صفحة. ## شرح طريقة عمل جلستك ### أثناء عملك بعد تسجيل الدخول، يبقي RAPTIX الجلسة نشطة ما دمت تستخدم المنصة. يعيد كل طلب تنفذه عدّاد النشاط إلى بدايته. وإذا اقتربت الجلسة من حد انتهائها، ترسل المنصة طلبًا خفيفًا في الخلفية لتمديدها تلقائيًا؛ ولن ترى مطالبة أو مقاطعة. ### عند العودة إلى علامة تبويب إذا غادرت علامة RAPTIX ثم عدت إليها، تتحقق المنصة من صلاحية الجلسة. إن بقيت صالحة، تعود مباشرة إلى موضعك؛ وإن انتهت، تُنقل إلى صفحة تسجيل الدخول. ### عند انتهاء الجلسة إذا تركت المنصة خاملة مدة تكفي لانتهاء الجلسة تمامًا ولم يتمكن التجديد الخلفي من تمديدها، فستعود إلى صفحة الدخول وترى الرسالة: > **«انتهت جلستك أو عُطّل حسابك. يرجى تسجيل الدخول مرة أخرى (`Your session has expired or your account has been deactivated. Please log in again.`)»** سجّل الدخول كالمعتاد للمتابعة. إذا كنت تملأ نموذجًا، فتحقق مما إذا كانت مدخلاتك حُفظت قبل انتهاء الجلسة؛ إذ لا تحفظ معظم نماذج RAPTIX المسودات تلقائيًا. ### هويتك في الشريط العلوي أثناء تسجيل الدخول، يعرض الشريط دائمًا: - **دائرة صورتك الرمزية**، وفيها أول حرف من اسمك بالذهبي. - **اسمك الكامل وبريدك الإلكتروني** على الشاشات العريضة. - **شارة أو شارات دورك** بألوانها: المسؤول ذهبي، والمدير بنفسجي، والمستخدم أخضر. وهكذا تؤكد بنظرة الحساب والدور المستخدمين. ## كيفية تسجيل الخروج خطوة بخطوة 1. انظر إلى أعلى يمين أي صفحة؛ سترى الصورة الرمزية، وفي الشاشة العريضة اسمك وبريدك. 2. اعثر على زر **تسجيل الخروج (`Logout`)**. يظهر على الحاسوب في الشريط العلوي بجوار معلوماتك، وعلى الهاتف داخل القائمة المنزلقة التي تفتح برمز الخطوط الثلاثة أعلى اليسار. 3. اختر **تسجيل الخروج**. 4. تُبطل المنصة الجلسة فورًا وتمسح بيانات التوثيق المحلية من المتصفح، ثم تنقلك إلى صفحة الدخول. 5. يؤكد ظهور صفحة تسجيل الدخول أن خروجك اكتمل. > **ما يحدث في الخلفية:** عندما تختار تسجيل الخروج، تسجل المنصة الجلسة على الخادم على أنها غير صالحة نهائيًا. حتى لو نسخ أحدهم جلستك بطريقة ما، تصبح غير قابلة للاستخدام فورًا. ولا تحتاج إلى مسح ذاكرة المتصفح المؤقتة. ## شرح الخيارات والإعدادات | العنصر | مكانه | وظيفته | |---|---|---| | زر **تسجيل الخروج** على الحاسوب | يمين شريط التنقل العلوي بجانب الصورة الرمزية | ينهي الجلسة فورًا وينقلك إلى صفحة الدخول. | | خيار **تسجيل الخروج** على الهاتف | القائمة المنزلقة التي تُفتح برمز الخطوط الثلاثة أعلى اليسار | ينهي الجلسة مثل زر الحاسوب. | | دائرة الصورة الرمزية | الشريط العلوي، وتظل ظاهرة | تعرض أول حرف من اسمك. اختيارها لا يفتح قائمة؛ استخدم زر الخروج مباشرة. | | عرض الاسم والبريد | الشريط العلوي على الحاسوب، ويُخفى في الشاشات الصغيرة | يؤكد الحساب المسجل حاليًا. | | شارة الدور | بجانب اسمك في الشريط العلوي | تعرض الأدوار المسندة؛ المسؤول ذهبي والمدير بنفسجي والمستخدم أخضر. | ## شرح حالات الجلسة | الحالة | ما تراه | ما ينبغي فعله | |---|---|---| | **جلسة نشطة** | تعمل المنصة بالكامل ويظهر اسمك وصورتك في الشريط. | تابع العمل كالمعتاد. | | **تجديد تلقائي للجلسة** | لا شيء ظاهر؛ يحدث التجديد بصمت في الخلفية. | لا يلزم شيء. | | **جلسة منتهية** | تُنقل إلى الدخول مع رسالة انتهاء الجلسة أو تعطيل الحساب. | سجّل الدخول مجددًا. | | **تم تسجيل الخروج** | تظهر صفحة الدخول وتكون الجلسة منتهية تمامًا في الخادم. | ادخل مجددًا عندما تكون جاهزًا. | ## نصائح وأفضل الممارسات - **استخدم زر تسجيل الخروج دائمًا عند الانتهاء،** خصوصًا على الأجهزة العامة أو المشتركة. إغلاق علامة المتصفح أو نافذته لا ينهي الجلسة فورًا في الخادم. - **على الجهاز المشترك،** سجّل الخروج بلا استثناء في نهاية كل جلسة؛ فتركها مفتوحة قد يسمح للشخص التالي باستخدام حسابك. - **على جهازك الشخصي،** يمكنك إبقاء العلامة مفتوحة بين فترات العمل. تجدّد المنصة الجلسة أثناء نشاطك وتطلب الدخول إذا ابتعدت مدة كافية لانتهائها. - **فتح المنصة في عدة علامات تبويب مدعوم،** وجميعها تشترك في جلسة واحدة. ينهي الخروج من أي علامة الجلسة في الكل. - **إذا لاحظت أنك تستخدم حسابًا غير صحيح،** فسجّل الخروج فورًا ثم ادخل بالبيانات الصحيحة. - **لا تشارك جلستك مع الزملاء.** ينبغي أن يدخل كل شخص بحسابه حتى تُنسب الإجراءات بدقة وتصح سجلات التدقيق. ## الأسئلة الشائعة **س: كم تدوم الجلسة؟** يضبط مسؤول مؤسستك مدتها. أثناء استخدامك النشط تُجدّد تلقائيًا، وقد يُطلب منك الدخول مجددًا إذا ابتعدت مدة طويلة، مثل طوال الليل. **س: أغلقت المتصفح من دون تسجيل الخروج. هل ما زلت مسجلًا؟** تبقى الجلسة نشطة في الخادم حتى تنتهي طبيعيًا. وإذا فتح شخص المتصفح نفسه على الجهاز ذاته قبل ذلك، فقد يتمكن من الوصول باسمك. لذلك استخدم زر الخروج دائمًا على الأجهزة المشتركة. **س: هل يؤثر الخروج في علامات RAPTIX الأخرى؟** نعم. لأن العلامات تشترك في الجلسة، يبطل خروجك من واحدة الجلسة في الجميع. وعند الانتقال إلى علامة أخرى سترى صفحة الدخول. **س: سجلت الخروج لكن صفحة الدخول تقول إن جلستي لا تزال نشطة. هل هذا ممكن؟** لا. يبطل الخادم الجلسة فور اختيار الخروج، ولا تحتفظ صفحة الدخول بحالتها. إذا رأيت سلوكًا غير معتاد، فامسح ملفات تعريف الارتباط للموقع وحاول مجددًا. **س: عطّل المسؤول حسابي. ماذا يحدث للجلسة؟** عند الفحص التالي للجلسة، الذي يحدث مرة في الدقيقة على الأقل أثناء وجودك في المنصة، تُنقل إلى الدخول برسالة انتهاء الجلسة أو تعطيل الحساب. إذا ظننت أن ذلك خطأ، فتواصل مع المسؤول. **س: هل يمكنني الدخول على جهازين في الوقت نفسه؟** نعم. لكل جهاز أو متصفح جلسة مستقلة، والخروج من جهاز لا يؤثر في جلسات الأجهزة الأخرى. **س: ماذا يحدث لعملي إذا خرجت فجأة في منتصف مهمة؟** تُحفظ معظم الإجراءات فور إرسالها. لكن إذا كنت تملأ نموذجًا يتطلب الإرسال، فقد تضيع البيانات غير المحفوظة. ادخل مجددًا وتحقق من تسجيل الإجراء قبل انتهاء الجلسة. ## أدلة ذات صلة - [الدخول باسم المستخدم وكلمة المرور](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/) - [الدخول بحساب Microsoft ‏(SSO)](https://raptix.app/user-guide/ar/00-getting-started/00-2-login-microsoft-sso/) - [ماذا تفعل عندما تظهر «الوصول مقيّد»](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) - [التنقل في المنصة: الشريط العلوي والجانبي وقائمة الهاتف](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/ # استخدام الصفحة الرئيسية: المهام وسير العمل والعناصر الحديثة في التطبيقات > **المنطقة:** الصفحة الرئيسية > > **الجمهور:** الأعضاء والمنشئون والمسؤولون > > **الوصول المطلوب:** حساب RAPTIX مسجل الدخول؛ تعتمد الأقسام الفردية على الصلاحيات المسندة إليك > > **ما ستتعلمه:** كيفية قراءة حالة الصفحة الرئيسية، والتعامل مع المهام المعلقة، ومتابعة سير العمل، وإعادة فتح صفحات التطبيقات والنماذج الحديثة. الصفحة الرئيسية هي نقطة انطلاقك الشخصية في RAPTIX. تجمع العمل الذي يحتاج إلى انتباهك، ومسارات سير العمل التي تشارك فيها، والصفحات أو النماذج التي فتحتها مؤخرًا في «التطبيقات». يراعي المحتوى صلاحيات الوصول، لذلك قد تحتوي صفحتك أقسامًا أقل من صفحة زميلك. ## قبل أن تبدأ - سجّل الدخول عبر `https://.raptix.app`. - افتح **الرئيسية (`Home`)** من شريط التنقل، أو انتقل إلى `/home` على نطاق مساحة عملك. - إذا غاب قسم موضح أدناه، فتحقق أولًا من أن دورك يتضمن الوصول إليه. غياب القسم لا يعني وحده وجود خطأ في التحميل. ## قراءة التحية وسطر الحالة يتغير العنوان بين **صباح الخير (`Good morning`)** و**مساء الخير (`Good afternoon` أو `Good evening`)** وفق التوقيت المحلي لجهازك. ويضيف RAPTIX اسمك الأول عندما يكون متاحًا. قد يتضمن سطر الحالة أسفل التحية: - عدد المهام التي تحتاج إلى تدخلك. - عدد المهام المتأخرة منها. - نسبة إكمالك للعمليات عندما يكون ذلك المقياس متاحًا. - **لا شيء مطلوب منك (`You're all clear`)** عندما يكون لديك وصول إلى المهام ولا توجد مهام معلقة. سطر الحالة ملخص وليس صندوق وارد مستقلًا. استخدم قسم **تحتاج إليك (`Needs you`)** لفتح العمل نفسه. ## العمل من قسم «تحتاج إليك» يسرد **تحتاج إليك** مهام سير العمل المعلقة والمسندة إليك. وقد يرى المسؤولون مهام مساحة العمل كلها. 1. راجع اسم المهمة وسير العمل التابع لها. 2. استخدم علامة الأولوية ونص تاريخ الاستحقاق لتحديد ما تبدأ به. تظهر المهام المتأخرة أولًا، ثم الأعلى أولوية، ثم الأقرب استحقاقًا. 3. اختر صفًا لفتح **مهامي (`My Tasks`)** داخل «التطبيقات». 4. إذا تجاوز عدد المهام المعلقة خمسًا، فاختر **عرض الكل (`View all`)** لفتح القائمة كاملة. عندما لا توجد مهام، يعرض القسم **لا شيء مطلوب منك** و**لا يوجد ما يحتاج إلى إجراء منك الآن (`Nothing needs your action right now`)**. ## متابعة «مسارات سير عملك» يعرض **مسارات سير عملك (`Your workflows`)** عمليات التشغيل التي تكون فيها بادئًا أو مشاركًا أو مراقبًا. وقد يرى المسؤولون جميع المسارات. يمكن أن يعرض كل صف: - اسم سير العمل وحالته الحالية. - علاقتك به، مثل **بدأته أنت (`Started by you`)** أو **أُسند إليك (`You're assigned`)** أو **تراقبه (`Observing`)**. - المدة منذ آخر تغيير. - عدد المهام التي تنتظر إجراءً منك حاليًا. اختر سير عمل لفتح تفاصيله إذا كانت لديك صلاحية عرضها. وإلا يفتح RAPTIX قائمة سير العمل في «التطبيقات». وإذا توفر أكثر من خمسة مسارات، فاستخدم **عرض الكل**. إن لم تكن لديك مسارات، تعرض الصفحة **لا يوجد شيء قيد التشغيل بعد (`Nothing running yet`)**. وقد يُعرض للمنشئين الذين يملكون وصول «منشئ التدفق» إجراء لبدء أول سير عمل في تطبيق متاح. ## إعادة فتح «المستخدمة مؤخرًا في التطبيقات» يحتوي هذا القسم ما يصل إلى خمس صفحات تطبيق أو نماذج سير عمل قابلة للتشغيل فُتحت مؤخرًا. 1. اعثر على الصفحة أو النموذج بالاسم. يظهر التطبيق الأصل عندما يكون متاحًا. 2. راجع الوقت النسبي للتأكد من أحدث عنصر استخدمته. 3. اختر الصف لفتحه مرة أخرى. 4. اختر **فتح التطبيقات (`Open Applications`)** لتصفح منطقة «التطبيقات» كاملة. لا تبقى إلا العناصر التي لا تزال متاحة. وقد تختفي العناصر المحذوفة أو المعطلة أو غير المنشورة. وإذا لم تفتح شيئًا بعد، يقول القسم **افتح صفحة أو نموذجًا في التطبيقات وسيظهر هنا (`Open a page or form in Applications and it will appear here`)**. ## فهم حالات التحميل والفراغ والوصول | الحالة | معناها | ما ينبغي فعله | |---|---|---| | صفوف وكتل مؤقتة | يحمّل RAPTIX بيانات الوصول والصفحة الرئيسية. | انتظر اكتمال التحميل قبل التحديث. | | **لا شيء مطلوب منك** | يمكنك استخدام المهام، لكن لا توجد مهمة معلقة. | لا يلزم إجراء. | | **لا يوجد شيء قيد التشغيل بعد** | لا توجد عمليات سير عمل مشاركة لعرضها. | ابدأ سير عمل أو انضم إليه عند الحاجة. | | قائمة العناصر الحديثة فارغة | لم تُفتح مؤخرًا صفحة أو نموذج ما زال متاحًا. | افتح عنصرًا من «التطبيقات». | | قسم غير موجود | دورك لا يشمل قسم الصفحة الرئيسية ذاك، أو منطقة المنتج المرتبطة غير متاحة لك. | اطلب من المسؤول مراجعة وصولك إن كنت تتوقع ظهوره. | | **لا توجد تطبيقات متاحة (`No applications available`)** | لا يملك حسابك وصولًا إلى تطبيق أو قسم رئيسي يمكن عرضه. | تواصل مع المسؤول لطلب الوصول. | ## استخدام الصفحة الرئيسية على الشاشات الصغيرة وفي الوضع الداكن في الشاشة الضيقة، تتراص الأقسام نفسها رأسيًا وينتقل التنقل الرئيسي إلى زر القائمة. لا يتغير المحتوى المتاح ولا قواعد الوصول. يغير الوضع الداكن المظهر فقط، ولا يغير الإجراءات المتاحة أو معنى ألوان الحالة. ## استكشاف المشكلات وحلها **مهمة أو سير عمل توقعت وجوده مفقود.** افتح القائمة الكاملة للمهام أو سير العمل في «التطبيقات». إذا كان مفقودًا هناك أيضًا، فتحقق مع المسؤول من الإسناد والصلاحيات. **اختفى عنصر حديث.** يزيل RAPTIX العناصر الحديثة التي لم تعد متاحة، ومنها النماذج المعطلة أو غير المنشورة والصفحات المحذوفة. ابحث عنه في «التطبيقات» أو اسأل مالكه إن كان قد تغير. **اختيار صفحة حديثة يفتح شاشة تسجيل الدخول.** ارجع إلى RAPTIX وتأكد أن جلستك نشطة ثم افتح العنصر مجددًا. إذا استمر الأمر، فراجع [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/). **تبقى الصفحة الرئيسية في حالة تحميل.** حدّث الصفحة مرة واحدة. إذا فشلت صفحات RAPTIX الأخرى أيضًا، فتحقق من الاتصال وسجّل الدخول مجددًا. أبلغ عن المشكلة المستمرة مع وقت حدوثها والقسم المتأثر. ## أدلة ذات صلة - [فهم وصولك إلى التطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-9-app-access-permissions/) - [كيفية التنقل في RAPTIX](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [فهم شارة جرس «مهامي»](https://raptix.app/user-guide/ar/00-getting-started/00-14-my-tasks-bell-badge/) - [البدء مع التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [حل مشكلات الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) RAPTIX مشغّلة بواسطة OneLogic Technology. --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-9-app-access-permissions/ # فهم الوصول إلى الصفحة الرئيسية والتطبيقات > **الوحدة:** أساسيات المنصة    **الجمهور:** المستخدم النهائي بجميع الأدوار > **ما ستتعلمه:** لماذا تختلف أقسام الصفحة الرئيسية وعناصر التنقل وموارد «التطبيقات» بين المستخدمين، وما الذي تطلبه عند غياب محتوى متوقع. --- ## ما هذه الميزة؟ يكيّف RAPTIX الصفحة الرئيسية والتنقل العام بحسب دورك. ثم تطبق «التطبيقات» منح الموارد لتحدد مساحات العمل والتطبيقات والصفحات التي يمكنك تصفحها. لذلك قد يرى زميل قسمًا أو عنصر تنقل أو موردًا في «التطبيقات» لا يظهر لك. --- ## لماذا تفيدك؟ - **مساحة عمل نظيفة ومركزة.** لا تعرض الصفحة الرئيسية والتنقل إلا الأقسام ومناطق المنتج المرتبطة بدورك. - **أمان افتراضي.** تختفي تلقائيًا عن غير المعنيين التطبيقات التي تحتوي بيانات حساسة أو إعدادات متقدمة أو تحكمًا إداريًا. - **وصول محدد النطاق إلى التطبيقات.** تُحذف الموارد التي لا يمكنك عرضها من القائمة بدلًا من عرض بطاقات مقفلة. - **تحديث سريع.** تظهر تغييرات الصلاحيات والمنح بعد إعادة تحميل الصفحة المتأثرة. --- ## قبل أن تبدأ - يجب أن تكون مسجل الدخول. راجع [كيفية تسجيل الدخول](https://raptix.app/user-guide/ar/00-getting-started/00-1-login-username-password/). - لا يلزم دور خاص لقراءة هذا الدليل؛ فهو ينطبق على كل مستخدم. - **مكان التحقق من وصولك:** استخدم `/home` لأقسام الصفحة الرئيسية و`/applications` لمساحات العمل والتطبيقات والصفحات الممنوحة لك. --- ## كيف يعمل نظام الصلاحيات؟ ### الأدوار والصلاحيات يُسند إلى كل مستخدم RAPTIX دور واحد أو أكثر، مثل المستخدم (`User`) أو المدير (`Manager`) أو المسؤول (`Admin`). يحمل كل دور مجموعة **صلاحيات**، ومنها **صلاحيات النظام** التي تتحكم في وحدات التطبيق التي يمكن فتحها. علاقات الوصول الرئيسية هي: | المنطقة أو القسم | الوصول الذي تستخدمه الواجهة الحالية | |-----------------|---------------------| | الرئيسية — تحتاج إليك | `home.tasks` أو وصول المسؤول | | الرئيسية — مسارات سير عملك | `home.workflows` أو وصول المسؤول | | الرئيسية — المستخدمة مؤخرًا في التطبيقات | `home.recent-apps` أو وصول «التطبيقات» أو وصول المسؤول | | التطبيقات | وصول «التطبيقات»، ثم منح الموارد | | وكلاء الذكاء الاصطناعي | وصول وكلاء الذكاء الاصطناعي | | الإدارة | دور المسؤول أو صلاحية الإدارة المناسبة | هذه المفاتيح تسميات تنفيذية. عند طلب الوصول، اذكر اسم المنطقة الظاهر للمستخدم واسم مساحة العمل أو التطبيق أو الصفحة بدقة بدلًا من طلب وصول غير محدود. ### أين يظهر دورك؟ يظهر دورك الحالي في **شريط التنقل العلوي** بكل صفحة، على هيئة شارة ملونة صغيرة بجانب اسمك: - **مسؤول (`Admin`)** — شارة ذهبية. - **مدير (`Manager`)** — شارة بنفسجية. - **مستخدم (`User`)** أو أي دور آخر — شارة خضراء. يساعدك ذلك في التأكد بسرعة من مستوى الوصول الذي تعمل به. ### كيف يُحدد الوصول؟ عند تسجيل الدخول، يجلب RAPTIX أدوارك وصلاحياتك. تستخدم الصفحة الرئيسية هذه القيم لإظهار أقسامها، بينما تحمّل «التطبيقات» منح الموارد المطبقة على حسابك. أعد تحميل الصفحة المتأثرة بعد أن يغير المسؤول وصولك. --- ## طريقة الاستخدام خطوة بخطوة ### التحقق مما يمكنك الوصول إليه حاليًا 1. افتح `/home` ولاحظ توفر **تحتاج إليك** و**مسارات سير عملك** و**المستخدمة مؤخرًا في التطبيقات**. 2. افتح `/applications` وتصفح تسلسل مساحة العمل والتطبيق والصفحة. 3. دوّن شارة دورك في الشريط العلوي عندما تطلب من المسؤول مقارنة وصولك. ### تحديد وحدة مفقودة 4. إذا غاب قسم رئيسي أو عنصر تنقل، فدوّن اسمه الحالي الظاهر للمستخدم. 5. إذا كان المحتوى مفقودًا داخل «التطبيقات»، فدوّن أسماء مساحة العمل والتطبيق والصفحة. امسح البحث الحالي أولًا حتى لا تخلط نتيجة التصفية مع مشكلة وصول. ### طلب الوصول من المسؤول 6. تواصل مع مسؤول RAPTIX في مؤسستك وقدم أسماء المنطقة والموارد التي سجلتها. 7. بعد منح الوصول، أعد تحميل «الرئيسية» أو «التطبيقات» وتحقق مجددًا. > **ملاحظة:** في «التطبيقات»، تحل صلاحية المنتج العامة ومنحة المورد مشكلتين مختلفتين. اطلب من المسؤول التحقق منهما معًا إذا كانت المنطقة تفتح لكن موردًا بعينه غائب. ### الانتقال إلى وحدة تملك صلاحيتها لكن لا تجدها إذا كان ينبغي أن تتوفر منطقة منتج لكنك لا تجدها: 8. اختر **رمز قائمة الخطوط الثلاثة** أعلى يسار الترويسة لفتح لوحة التنقل الجانبية. 9. تعرض اللوحة المناطق الرئيسية المتاحة لحسابك. اختر **التطبيقات (`Applications`)** لتصفح مواردها؛ فهي لا تظهر كشبكة تطبيقات في الصفحة الرئيسية. 10. إذا غابت المنطقة عن الشريط الجانبي، أو بقي المورد غائبًا بعد مسح البحث، فاتبع الخطوات 5–7 أعلاه. --- ## شرح الخيارات والإعدادات | العنصر | الوصف | |---------|-------------| | **شارة الدور في الشريط العلوي** | تعرض دورك الحالي الذي يحدد الصلاحيات التي تملكها. | | **أقسام الصفحة الرئيسية** | تعرض المهام وعمليات سير العمل وعناصر التطبيقات الحديثة بحسب وصول كل قسم. | | رسالة **لا توجد تطبيقات متاحة** | تظهر حين لا يكون في الرئيسية محتوى تطبيق أو قسم يمكن الوصول إليه. تواصل مع المسؤول. | | **تسلسل التطبيقات** | لا يعرض إلا مساحات العمل والتطبيقات والصفحات والنماذج القابلة للتشغيل المتاحة لحسابك. | | **التنقل الجانبي** | يسرد مناطق المنتج الرئيسية المتاحة لدورك. | --- ## نصائح وأفضل الممارسات - **لا تحاول فتح وحدة بعنوان مباشر إذا لم تملك صلاحيتها.** فكتابة `/workflow-management` من دون صلاحية `workflow-management` تنقلك إلى شاشة **الوصول مقيّد (`Access Restricted`)** لا إلى الصفحة المطلوبة. - **يمكن إضافة الصلاحيات من دون تعطيل.** عندما يمنحك المسؤول الوصول، لا تحتاج إلى إنهاء الجلسة؛ أعد تحميل الشاشة الرئيسية فقط. - **إذا كنت مسؤولًا** وتريد منح وصول إلى صفحة أو تعديله، فافتح **الإدارة ← إدارة المستخدمين ← الأدوار والوصول**. راجع [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/). - **تُدعم الأدوار المتعددة.** إذا أُسند إلى حسابك أكثر من دور، فصلاحياتك الفعلية هي مجموع صلاحيات تلك الأدوار، وتظهر عدة شارات في الشريط العلوي. --- ## الأسئلة الشائعة **س: كان لدي وصول إلى منطقة أو مورد أمس لكنه اختفى اليوم. ماذا حدث؟** ج: ربما أزال المسؤول الصلاحية من دورك أو غيّر دورك. راجعه للتأكد. **س: تقول شارة دوري «مستخدم»، لكنني أحتاج إلى وصول المسؤول. هل أغيره بنفسي؟** ج: لا. لا يغير إسناد الأدوار إلا مسؤول النظام. تواصل معه واشرح الوصول الإضافي الذي تحتاج إليه. **س: أرى موارد في التطبيقات أكثر من زميل يحمل الدور نفسه. كيف يحدث ذلك؟** ج: قد تجمع مؤسستك أدوارًا متعددة مع منح موارد مباشرة أو مستندة إلى الدور. لذلك قد يختلف وصول مستخدمين يحملان الشارة نفسها. **س: أنا مسؤول وقسم رئيسي أو مورد في التطبيقات مفقود.** ج: تحقق من صلاحية الدور لمنطقة المنتج، ومن منحة المورد في «التطبيقات». امسح البحث وأعد تحميل الصفحة قبل تغيير الوصول. **س: ماذا يحدث إذا فتحت رابطًا مشاركًا إلى وحدة لا أملك صلاحيتها؟** ج: تعرض المنصة شاشة **الوصول مقيّد**، وتوضح الصلاحية المطلوبة، وتتيح زري **رجوع (`Go Back`)** و**فتح الرئيسية (`Open Home`)**. تبقى جلستك نشطة ولا يُسجّل خروجك. **س: هل يمكنني طلب الوصول بالنيابة عن شخص آخر؟** ج: يمكنك أن تطلب من المسؤول تغيير صلاحيات مستخدم آخر، لكنك لا تستطيع تغييرها بنفسك إلا إذا كنت مسؤولًا لديه وصول إلى منطقة الإدارة. --- ## أدلة ذات صلة - [استخدام الرئيسية: المهام وسير العمل والعناصر الحديثة في التطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [كيفية التنقل في المنصة: الشريط العلوي والجانبي وقائمة الهاتف](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [فهم شارة جرس «مهامي»](https://raptix.app/user-guide/ar/00-getting-started/00-14-my-tasks-bell-badge/) - [ماذا تفعل عندما تظهر «الوصول مقيّد»](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) *(دليل المسؤول)* - [مسرد RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/ # كيفية التنقل في المنصة: الشريط العلوي والجانبي وقائمة الهاتف > **الوحدة:** أساسيات المنصة    **الجمهور:** المستخدم النهائي والمسؤول > **ما ستتعلمه:** كيفية الانتقال بين مناطق RAPTIX الحالية باستخدام الشريط العلوي، والشريط الجانبي على الحاسوب، وقائمة الهاتف. ## ما هذه الميزة؟ يوفر RAPTIX شريطًا علويًا ثابتًا وتنقلًا رئيسيًا يراعي صلاحيات الوصول. يظهر التنقل في الشاشات العريضة كشريط جانبي يمكن طيه بزر الخطوط الثلاثة، بينما تنتقل الوجهات نفسها في الهواتف والأجهزة اللوحية إلى قائمة مريحة للمس. ## لماذا تفيدك؟ - **كل شيء على بُعد نقرة.** يبقى الشريط العلوي مثبتًا مهما تحركت في الصفحة، فتظل الإجراءات الأساسية متاحة. - **لا روابط غير متاحة.** تُصفّى قائمة التنقل الشخصية لتعرض الأدوات التي يمكنك استخدامها فقط؛ وتظهر عناصر جديدة تلقائيًا عندما يمنحك المسؤول الوصول. - **تعرف مكانك بوضوح.** تُميّز الوجهة الحالية في القائمة حتى تعرف دائمًا أين أنت. - **وصول سريع إلى الحالة.** يبقي الشريط العلوي عناصر المظهر والإشعارات والحساب وتسجيل الخروج في متناولك. - **يعمل على كل جهاز.** يتكيف التخطيط تلقائيًا من شاشة حاسوب عريضة إلى هاتف ضيق مع مناطق لمس مريحة. ## قبل أن تبدأ - يجب أن تكون مسجل الدخول لرؤية شريط التنقل؛ فهو لا يظهر في صفحتي الدخول وإعادة تعيين كلمة المرور. - تعتمد عناصر القائمة المتاحة على الصلاحيات المسندة إلى حسابك. تواصل مع المسؤول إذا لم تظهر وحدة تحتاج إليها. ## طريقة الاستخدام خطوة بخطوة ### على الحاسوب المكتبي أو المحمول 1. بعد تسجيل الدخول، يظهر **الشريط العلوي** أعلى الشاشة ويبقى في كل صفحة. 2. اختر **رمز الخطوط الثلاثة** في أقصى اليسار لطي التنقل الجانبي أو توسيعه. 3. يسرد التنقل المناطق الرئيسية المتاحة لحسابك: | عنصر القائمة | ينقلك إلى | |-----------|-------------| | الرئيسية (`Home`) | المهام وعمليات سير العمل والعناصر الحديثة في «التطبيقات» | | التطبيقات (`Applications`) | مساحات العمل والتطبيقات والصفحات والنماذج القابلة للتشغيل والمستندات وسير العمل | | وكلاء الذكاء الاصطناعي (`AI Agents`) | مساعدو الذكاء الاصطناعي المتاحون | | الإدارة (`Admin`) | الإدارة والإعدادات للمسؤولين فقط | | الدعم (`Support`) | خيارات المساعدة والدعم | | غرفة التحكم (`Control Room`) | إدارة المنصة لمسؤول منصة RAPTIX فقط | 4. اختر عنصرًا للانتقال. يأخذ العنصر المحدد مظهر الحالة النشطة المعتمد في RAPTIX. 5. اختر **التطبيقات** للوصول من منطقة واحدة إلى مثيلات سير العمل، و«مهامي»، والمستندات، وتسلسل مساحة العمل والتطبيق والصفحة. 6. اختر رمز الخطوط الثلاثة مجددًا عندما تحتاج إلى مساحة أكبر لمحتوى الصفحة. 7. **شعار RAPTIX** في الشريط العلوي رابط أيضًا؛ اختياره يعيدك إلى الشاشة الرئيسية من أي موضع. ### على الهاتف أو الجهاز اللوحي 1. يتحول نظام التنقل تلقائيًا إلى تخطيط محسن للهاتف في الشاشات الصغيرة. سترى **ترويسة هاتف مدمجة** في الأعلى وعنوان المنصة في الوسط. 2. المس **رمز القائمة** ذي الخطوط الثلاثة في يسار الترويسة لفتح القائمة المنزلقة. يتحول الرمز إلى **X** أثناء فتحها. 3. تنزلق لوحة من الحافة اليسرى وتغطي الجزء الأيسر من الشاشة، ويظهر فوق بقية الصفحة غطاء داكن شبه شفاف. 4. المس أي عنصر للانتقال؛ وتغلق القائمة تلقائيًا بعد الاختيار. 5. لإغلاقها من دون انتقال، المس المنطقة الداكنة أو زر **X** في الترويسة. 6. أسفل قائمة الهاتف سترى: - عبارة **مسجل الدخول باسم (`Signed in as`)** يليها اسم العرض لتأكيد الحساب المستخدم. - زر **تسجيل الخروج (`Logout`)** باللون الأحمر. ### استخدام الشريط العلوي للإجراءات السريعة على كل الأجهزة يحتوي الجانب الأيمن من الشريط العلوي عناصر تظل ظاهرة: | العنصر | وظيفته | |---------|--------------| | مبدّل الوضع الداكن والفاتح، برمز الشمس أو القمر | يبدل مظهر المنصة كلها. راجع [التبديل بين الوضع الفاتح والداكن](https://raptix.app/user-guide/ar/00-getting-started/00-11-dark-mode/). | | رمز الجرس | يفتح **التطبيقات ← سير العمل ← مهامي**، وتعرض شارته عدد المهام المعلقة المتاحة لحسابك. | | دائرة الصورة الرمزية | تعرض الحرف الأول من اسمك وتؤكد أنك مسجل الدخول. | | الاسم والبريد وشارة الدور | في الشاشات العريضة، يظهر اسمك الكامل وبريدك وشارة الدور، مثل المسؤول أو المدير أو المستخدم، بجانب الصورة الرمزية. | | زر تسجيل الخروج | ينهي جلستك فورًا. تظهر كلمة `Logout` في الشاشات العريضة، بينما يظهر رمز الباب وحده في الشاشات الضيقة. | ## شرح الخيارات والإعدادات | العنصر | الوصف | |------|-------------| | رمز الخطوط الثلاثة على الحاسوب | يطوي الشريط الجانبي أو يوسعه. | | رمز القائمة أو X على الهاتف | يفتح القائمة المنزلقة ويغلقها. | | تمييز الصفحة النشطة | يستخدم عنصر الصفحة الحالية مظهر RAPTIX النشط بالذهبي والرمادي. | | شارة «مهامي» | تظهر على الجرس عند احتساب مهمة سير عمل معلقة واحدة أو أكثر. | | شارة الدور | تعرض الدور المسند بجانب هوية الحساب حين تسمح المساحة. | | رابط الشعار | يعيدك شعار RAPTIX في الشريط العلوي دائمًا إلى الشاشة الرئيسية. | ## نصائح وأفضل الممارسات - **أبقِ الشريط الجانبي موسعًا على الشاشات العريضة** إذا كنت تنتقل كثيرًا بين الرئيسية والتطبيقات ووكلاء الذكاء الاصطناعي. - **استخدم الرئيسية لمتابعة حالة العمل.** يلخص قسما **تحتاج إليك** و**مسارات سير عملك** نشاط المهام والعمليات، بينما تعرض «التطبيقات» القوائم الكاملة. - **تحقق من شارة دورك إذا بدا شيء مفقودًا.** قد لا يملك حسابك الصلاحية المطلوبة. دوّن الدور الظاهر وقدمه للمسؤول عند طلب الوصول. - **قائمة الهاتف قابلة للتمرير.** إذا فعّل المسؤول وحدات كثيرة، فمرر داخلها لرؤية جميع العناصر. ## الأسئلة الشائعة **س: أرى عناصر قائمة أقل من زميلي. لماذا؟** لا تعرض قائمتك إلا العناصر التي يُسمح لحسابك بفتحها. هذا مقصود وفق الدور والصلاحيات التي ضبطها المسؤول. اطلب منه الوصول إلى الوحدة التي تحتاجها. **س: عنصر تنقل مفقود.** يراعي العنصر صلاحيات الوصول. اطلب من المسؤول التحقق من صلاحية الدور لمنطقة المنتج. وإذا كان المورد مفقودًا داخل «التطبيقات»، فتحقق أيضًا من منحة ذلك المورد. **س: الشريط الجانبي مطوي. كيف أعيده؟** اختر رمز الخطوط الثلاثة أعلى يسار ترويسة RAPTIX. **س: هل تستخدم نسخة الهاتف وجهات مختلفة؟** لا. تنتقل الوجهات نفسها، مع مراعاة صلاحيات الوصول، إلى قائمة الهاتف، ويبقى شعار RAPTIX في الترويسة المدمجة. **س: هل يمكنني حفظ صفحة محددة في المفضلة؟** نعم. لكل صفحة عنوانها. احفظ أي صفحة في المتصفح، وستفتحها العودة مباشرة، مع مطالبتك بتسجيل الدخول إذا كانت الجلسة قد انتهت. ## أدلة ذات صلة - [التبديل بين الوضع الفاتح والداكن](https://raptix.app/user-guide/ar/00-getting-started/00-11-dark-mode/) - [فهم الإشعارات المنبثقة وما تخبرك به](https://raptix.app/user-guide/ar/00-getting-started/00-18-toast-notifications/) - [استخدام الرئيسية: المهام وسير العمل والعناصر الحديثة في التطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-11-dark-mode/ # التبديل بين الوضع الفاتح والوضع الداكن > **الوحدة:** أساسيات المنصة    **الجمهور:** المستخدم النهائي والمسؤول > **ما ستتعلمه:** كيفية تبديل ألوان المنصة بين الفاتح والداكن، وكيف يُحفظ تفضيلك، وما المتوقع عند تغيير الجهاز. ## ما هذه الميزة؟ يدعم RAPTIX مظهرين لونيين: **الوضع الفاتح** بخلفيات بيضاء ورمادية فاتحة ونص داكن، و**الوضع الداكن** بخلفيات فحمية وكحلية ونص فاتح. تبدل نقرة واحدة على الزر في الشريط العلوي أو ترويسة الهاتف مظهر المنصة كلها فورًا. ويحفظ المتصفح اختيارك باستمرار، فلا تحتاج إلى ضبطه مجددًا على ذلك الجهاز. ## لماذا تفيدك؟ - **لمسة واحدة وتغيير فوري.** تتبدل الواجهة كلها دفعة واحدة: كل صفحة ولوحة ومكوّن. - **مريحة في جميع البيئات.** يناسب الوضع الفاتح المكاتب المضيئة، بينما يقلل الداكن إجهاد العين في الإضاءة الخافتة والغرف الداكنة. - **يُحفظ تفضيلك.** تحفظ المنصة اختيارك على كل جهاز، فيبقى المظهر نفسه بعد إعادة فتح المتصفح أو العودة في اليوم التالي. - **إعداد أولي تلقائي.** في زيارتك الأولى، تقرأ المنصة تفضيل الألوان في نظام التشغيل أو المتصفح وتبدأ بالمظهر المطابق من دون إعداد. - **من دون إعادة تحميل.** التبديل فوري وسلس، ولا يُعاد تحميل الصفحة أو يُفقد العمل الجاري. ## قبل أن تبدأ - يجب أن تكون مسجل الدخول للوصول إلى مبدّل الوضع الداكن. - لا يوجد إعداد يفرض به المسؤول مظهرًا على الجميع؛ فكل مستخدم يتحكم في تفضيله باستقلال. - يُحفظ التفضيل لكل جهاز، وتحديدًا لكل متصفح عليه. إذا استخدمت جهازًا أو متصفحًا آخر، فقد تحتاج إلى اختياره هناك أيضًا. ## طريقة الاستخدام خطوة بخطوة ### على الحاسوب المكتبي أو المحمول 1. انظر إلى **الشريط العلوي** الممتد أعلى الشاشة. 2. اعثر على **الزر المربع ذي الحواف المستديرة** في الجزء الأيمن، بين منطقة الشعار والجرس. يعرض في الوضع الفاتح **رمز الشمس** بلون كهرماني أو ذهبي، وفي الداكن **رمز القمر** باللون الأزرق. 3. اختر الزر مرة واحدة، فتنتقل المنصة فورًا إلى الوضع المقابل. يتحرك الرمز أثناء الانتقال: - عند الانتقال إلى الداكن، تدور الشمس وتصغر ثم يظهر القمر. - عند الانتقال إلى الفاتح، يصغر القمر ثم تظهر الشمس. 4. تتحدث فورًا جميع أجزاء الواجهة: الشريط العلوي ولوحة التنقل وخلفيات الصفحات والبطاقات والجداول والنصوص وحقول الإدخال. 5. يُحفظ اختيارك تلقائيًا. أغلق المتصفح وافتحه غدًا، وستبقى المنصة بالمظهر الذي اخترته. ### على الهاتف أو الجهاز اللوحي 1. انظر إلى **ترويسة الهاتف** أعلى الشاشة. 2. يوجد زر **الشمس أو القمر** في الجانب الأيمن بجوار صورتك الرمزية. 3. المسه مرة واحدة للتبديل. يتحرك الرمز وتتغير الواجهة الظاهرة كلها فورًا. 4. تستخدم قائمة الهاتف المنزلقة المظهر النشط أيضًا؛ افتحها بعد التبديل لرؤيتها بالألوان الجديدة. ## شرح الخيارات والإعدادات | الإعداد | التفاصيل | |---------|---------| | الوضع الفاتح | خلفيات بيضاء ورمادية فاتحة، ونص داكن، وأيقونات كاملة اللون. يناسب البيئات المضيئة. | | الوضع الداكن | خلفيات فحمية وكحلية، ونص فاتح أو أبيض، وألوان أيقونات معدلة. يناسب العمل ليلًا أو في الإضاءة الخافتة. | | كيفية حفظ التفضيل | يُحفظ تلقائيًا في التخزين المحلي للمتصفح بالمفتاح `darkMode`. لا يتغير إعداد في الحساب؛ فالتفضيل خاص بالمتصفح والجهاز. | | الإعداد الافتراضي للزيارة الأولى | إذا لم تحدد تفضيلًا، تفحص المنصة إعداد نظامك أو متصفحك `prefers-color-scheme` وتبدأ بالمظهر المطابق. | | زر التبديل على الحاسوب | في الجانب الأيمن من الشريط العلوي، إلى يسار الجرس. يعرض الشمس في الفاتح والقمر في الداكن. | | زر التبديل على الهاتف | في الجانب الأيمن من ترويسة الهاتف، إلى يسار الصورة الرمزية، وبالرمزين نفسيهما. | ## نصائح وأفضل الممارسات - **استخدم الوضع الداكن في جلسات مراجعة المستندات الطويلة.** يقلل وهج الشاشة والإجهاد عند مراجعة عدة ملفات PDF أو شاشات سير عمل طويلة. - **التفضيل خاص بالجهاز.** إذا كنت تعمل على حاسوبين، فاضبطه في كل منهما؛ وستحفظه المنصة بصورة مستقلة. - **يعمل الوضع الداكن في جميع الوحدات.** تدعمه بالكامل الرئيسية وسير العمل والمستندات ووكلاء الذكاء الاصطناعي والمعرفة والتطبيقات وشاشات الإدارة. - **لا مزامنة فورية بين علامات التبويب.** إذا كانت المنصة مفتوحة في علامتين وبدّلت الوضع في واحدة، فحدّث الأخرى لتطبيقه. ## الأسئلة الشائعة **س: بدلت إلى الداكن لكنه عاد فاتحًا عند فتح علامة تبويب جديدة. لماذا؟** يُطبق الوضع فور اختياره ويُحفظ في المتصفح. فتح علامة جديدة بالوضع الفاتح قد يعني أن الحفظ لم ينجح؛ بدّل مرة أخرى وحدّث العلامة الجديدة. وإذا استمر الأمر، فتحقق إن كان المتصفح يمسح التخزين المحلي عند الإغلاق. **س: هل يستطيع المسؤول تعيين مظهر افتراضي للمؤسسة كلها؟** لا؛ المظهر تفضيل شخصي لكل مستخدم وجهاز، ولا يستطيع المسؤول فرض وضع معين. **س: لماذا تبدأ المنصة بالوضع الداكن مع أنني لم أحدده؟** تقرأ المنصة في زيارتك الأولى تفضيل نظام التشغيل. إذا كان الهاتف أو الحاسوب يستخدم الوضع الداكن على مستوى النظام، تبدأ المنصة به كي تطابقه. ويمكنك تغييره في أي وقت. **س: هل يوجد اختصار لوحة مفاتيح لتبديل الوضع؟** لا يوجد اختصار مخصص حاليًا؛ استخدم زر التبديل في الشريط العلوي. **س: يبدو الشريط العلوي مختلفًا في الوضع الداكن. هل هذا مقصود؟** نعم. يستخدم الشريط خلفية بيضاء نظيفة في الفاتح، وتدرجًا داكنًا من الرمادي الغامق إلى درجة أفتح قليلًا في الداكن لإضافة عمق مع الحفاظ على راحة العين. ## أدلة ذات صلة - [كيفية التنقل في المنصة: الشريط العلوي والجانبي وقائمة الهاتف](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [جولة في الشاشة الرئيسية ومشغل التطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-12-install-as-app-pwa/ # تثبيت المنصة كتطبيق على جهازك > **الوحدة:** أساسيات المنصة    **الجمهور:** المستخدم النهائي والمسؤول > **ما ستتعلمه:** كيفية تثبيت RAPTIX كتطبيق مستقل على حاسوب Windows أو هاتف Android أو iPhone أو Mac، كي تفتحه فورًا من شريط المهام أو الشاشة الرئيسية من دون الحاجة إلى المتصفح. ## ما هذه الميزة؟ يمكن تثبيت منصة RAPTIX مباشرة على جهازك، مثل أي تطبيق من متجر التطبيقات، من دون تنزيل منفصل أو تدخل قسم تقنية المعلومات. بعد التثبيت، تفتح في نافذتها الخاصة من دون شريط عنوان المتصفح أو علامات تبويبه، وتنطلق خلال ثوانٍ من شريط المهام أو قائمة Start أو شاشة الهاتف الرئيسية، وتعمل كتطبيق أصلي. يستغرق التثبيت أقل من دقيقة ويعمل على Windows وmacOS وAndroid وiOS. ## لماذا تفيدك؟ - **لمسة واحدة للفتح.** اعثر على رمز المنصة في الشاشة الرئيسية أو شريط المهام وشغّلها فورًا، من دون فتح متصفح وكتابة العنوان أولًا. - **لا عناصر متصفح تعيقك.** يفتح التطبيق في نافذة نظيفة ملء الشاشة، بلا علامات تبويب أو شريط عنوان أو قوائم تنافس المحتوى على المساحة. - **يعمل على جميع المنصات.** تتاح العملية نفسها على Windows وmacOS وهواتف Android وiPhone وiPad، ولا يلزم إصدار مختلف لكل جهاز. - **أحدث إصدار دائمًا.** تُطبق التحديثات تلقائيًا في الخلفية عند الاتصال. لا يوجد تنزيل أو تثبيت يدوي؛ وفي المرة التالية يكون التطبيق محدّثًا. - **اختصارات إلى أكثر مناطقك استخدامًا.** يدعم رمز التطبيق المثبت على Android وWindows اختصارات الضغط المطول للانتقال إلى الرئيسية أو المهام المعلقة أو سير العمل. راجع [استخدام اختصارات التطبيق من الشاشة الرئيسية أو شريط المهام](https://raptix.app/user-guide/ar/00-getting-started/00-13-app-shortcuts/). - **معرفة حالة الشبكة.** ينبهك التطبيق فور انقطاع الاتصال ثم عودته، فلا تحتار في سبب توقف إجراء ما. ## قبل أن تبدأ - يجب تسجيل الدخول قبل ظهور مطالبة التثبيت. - يجب أن يدعم المتصفح تثبيت التطبيقات. تدعم ذلك Google Chrome على الحاسوب وAndroid، وMicrosoft Edge على الحاسوب، وSamsung Internet على Android، وSafari على iPhone وiPad بالطريقة اليدوية. - لا يدعم Firefox حاليًا مطالبة التثبيت التلقائية، لكن يمكنك حفظ الصفحة على الشاشة الرئيسية من قائمة المتصفح. - إذا سبق تثبيت التطبيق، فسيشير فتح المنصة في المتصفح إلى أنها مثبتة ولن يظهر الشريط مجددًا. ## طريقة الاستخدام خطوة بخطوة ### الطريقة 1: استخدام شريط التثبيت داخل التطبيق في Chrome وEdge وAndroid هذه أسهل الطرق؛ إذ تكتشف المنصة تلقائيًا دعم المتصفح وتعرض المطالبة. 1. سجّل الدخول واستخدم المنصة قليلًا. بعد نحو 30 ثانية، ينزلق **شريط تثبيت** من أسفل الشاشة، أو يظهر أسفل اليمين في الشاشات العريضة. > **ما ستراه:** بطاقة برمز تنزيل ذهبي، وعنوان **تثبيت تطبيق RAPTIX (`Install RAPTIX App`)**، وعبارة «احصل على تجربة التطبيق الكاملة»، ورسالة عن التثبيت للوصول الأسرع ودعم العمل دون اتصال وتجربة شبيهة بالتطبيق. وأسفلها زرا **ثبّت الآن (`Install Now`)** و**ليس الآن (`Not Now`)**، مع ملاحظة أنه يعمل على Android وiOS وWindows وMac. 2. اختر **ثبّت الآن**. 3. يعرض المتصفح مربع تأكيد تابعًا للنظام يختلف شكله حسب المتصفح. أكد التثبيت. 4. يُثبّت التطبيق ويعمل عادة فورًا في نافذته. ويُضاف رمز إلى شريط المهام أو سطح المكتب في Windows، أو Dock في Mac، أو الشاشة الرئيسية في Android. 5. إذا لم تكن جاهزًا، فاختر **ليس الآن**. لن يظهر الشريط لمدة سبعة أيام، ثم يعرض التثبيت مرة أخرى. ### الطريقة 2: استخدام خيار التثبيت في Chrome أو Edge إذا لم يظهر الشريط، يمكنك بدء التثبيت من شريط أدوات المتصفح في أي وقت وأنت على المنصة. **في Google Chrome على الحاسوب:** 1. ابحث في أقصى يمين شريط العنوان عن **رمز حاسوب وسهم متجه إلى أسفل**؛ يظهر عندما يمكن تثبيت الموقع. 2. اختره ثم اختر **تثبيت (`Install`)** في مربع الحوار. **في Microsoft Edge على الحاسوب:** 1. اختر قائمة **النقاط الثلاث (...)** أعلى يمين النافذة. 2. اختر **التطبيقات (`Apps`)**. 3. اختر **تثبيت هذا الموقع كتطبيق (`Install this site as an app`)**. 4. سمّه أو أبقِ الاسم الافتراضي، ثم اختر **تثبيت**. ### الطريقة 3: الإضافة إلى الشاشة الرئيسية في iPhone أو iPad باستخدام Safari لا يعرض Safari على iOS شريطًا تلقائيًا. استخدم طريقة المشاركة اليدوية: 1. افتح المنصة في Safari وسجّل الدخول. 2. المس **زر المشاركة** أسفل الشاشة، وهو مربع بسهم متجه إلى أعلى. 3. مرر في ورقة المشاركة واختر **إضافة إلى الشاشة الرئيسية (`Add to Home Screen`)**. 4. عدّل الاسم إن أردت ثم المس **إضافة (`Add`)** أعلى اليمين. 5. يظهر الرمز على الشاشة الرئيسية ويفتح المنصة بملء الشاشة عند لمسه. ### الطريقة 4: الإضافة إلى الشاشة الرئيسية في Android باستخدام Chrome إذا لم يظهر شريط التطبيق: 1. المس قائمة **النقاط الثلاث (...)** في Chrome. 2. المس **إضافة إلى الشاشة الرئيسية (`Add to Home screen`)** أو **تثبيت التطبيق (`Install app`)** في الإصدارات الأحدث. 3. أكد باختيار **إضافة** أو **تثبيت**. ## شرح الخيارات والإعدادات | الخيار | الوصف | |--------|-------------| | ثبّت الآن (`Install Now`) | يبدأ تأكيد المتصفح. وبعد التأكيد يُثبّت التطبيق وتُنشأ رموز الاختصار. | | ليس الآن (`Not Now`) | يغلق الشريط، ولن يظهر مجددًا لمدة سبعة أيام. | | أحجام الرموز | يُثبّت التطبيق برموز في عشرة أحجام من 72 إلى 512 بكسل مع دعم الأقنعة، ليظهر حادًا وبالشكل الصحيح على كل منصة. | | اسم التطبيق | اسم التطبيق المثبت هو `RAPTIX`، للاسم الكامل والمختصر على الشاشات الرئيسية. | | لون المظهر | يطابق لون شريط التطبيق، في الأجهزة الداعمة، ذهبي RAPTIX ‏`#d7b765`. | | وضع العرض | يفتح التطبيق بوضع مستقل من دون شريط عنوان أو علامات تبويب أو عناصر تنقل المتصفح؛ ويتولى تنقل المنصة كل شيء. | | التحديثات | تُطبق تلقائيًا في الخلفية أثناء الاتصال. لا يوجد رقم إصدار يلزم تتبعه أو خطوة تحديث يدوية. | ## نصائح وأفضل الممارسات - **ثبّت التطبيق على أكثر الأجهزة استخدامًا.** إذا كنت تراجع المهام على الحاسوب والهاتف، فثبّته عليهما للوصول الأسرع. - **ثبّت الرمز في شريط مهام Windows أو Dock في Mac.** بعد التثبيت، انقر عليه بالزر الأيمن واختر التثبيت للوصول الأسرع. - **التطبيق المثبت ونسخة المتصفح هما المنصة نفسها.** استخدم أيهما في أي وقت؛ فالجلسات والتفضيلات مشتركة لأنهما يستخدمان عنوان الويب نفسه. - **إعادة التثبيت سهلة.** إذا أزلته أو غيرت الجهاز، فافتح المنصة في المتصفح وسجّل الدخول ثم استخدم الشريط أو قائمة المتصفح. لا تُفقد بيانات. ## الأسئلة الشائعة **س: لم يظهر شريط التثبيت. ماذا أفعل؟** يظهر بعد نحو 30 ثانية من تسجيل الدخول، بشرط ألا تكون قد رفضته خلال الأيام السبعة السابقة وألا يكون التطبيق مثبتًا. إذا لم يظهر، فاستخدم الطريقة الثانية. ولا تدعم كل المتصفحات الشريط؛ فـSafari على iPhone يتطلب طريقة المشاركة اليدوية. **س: ثبّت التطبيق لكنه ما زال يعرض علامات تبويب المتصفح وشريط العنوان. ماذا حدث؟** ربما لم يكتمل التثبيت بوضع مستقل. أزله وأعد تثبيته بخيار تثبيت التطبيق في المتصفح بدلًا من حفظ إشارة مرجعية عادية. **س: هل يستهلك التثبيت مساحة كبيرة؟** التطبيق خفيف جدًا ولا يخزن ملفات بيانات كبيرة على جهازك. تُحفظ المستندات وسير العمل والبيانات بأمان على خوادم المنصة وتُحمّل عند الطلب أثناء الاتصال. **س: ماذا يحدث دون اتصال؟** يعرض التطبيق إشعارًا موجزًا عند انقطاع الاتصال «أنت غير متصل (`You are offline`)» وآخر عند عودته «عدت إلى الاتصال (`Back online`)». وقد تعرض بعض الصفحات الحديثة نسخة مؤقتة مخزنة، لكن الوظائف الكاملة تتطلب اتصالًا نشطًا. **س: هل يمكنني تثبيته على عدة أجهزة؟** نعم، ثبّته على ما تحتاج من أجهزة؛ وكل تثبيت مستقل. **س: كيف أزيل التطبيق؟** في Windows، انقر بالزر الأيمن في Start أو شريط المهام واختر `Uninstall`. وفي Android اضغط الرمز مطولًا واسحبه إلى الإزالة أو استخدم «الإعدادات ← التطبيقات». وفي iPhone أو iPad اضغط مطولًا واختر `Remove App`. ## أدلة ذات صلة - [استخدام اختصارات التطبيق من الشاشة الرئيسية أو شريط المهام](https://raptix.app/user-guide/ar/00-getting-started/00-13-app-shortcuts/) - [كيفية التنقل في المنصة: الشريط العلوي والجانبي وقائمة الهاتف](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [فهم الإشعارات المنبثقة وما تخبرك به](https://raptix.app/user-guide/ar/00-getting-started/00-18-toast-notifications/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-13-app-shortcuts/ # استخدام اختصارات تطبيق RAPTIX > **المنطقة:** تطبيق RAPTIX المثبت > > **ما ستتعلمه:** كيفية فتح الرئيسية أو «مهامي» أو «منشئ التدفق» من رمز التطبيق المثبت. ## قبل أن تبدأ ثبّت RAPTIX كتطبيق باتباع [تثبيت RAPTIX كتطبيق](https://raptix.app/user-guide/ar/00-getting-started/00-12-install-as-app-pwa/). تعتمد الاختصارات على دعم المتصفح ونظام التشغيل، ولا تظهر في إشارة مرجعية عادية. ## الاختصارات الحالية | الاختصار | الوجهة | الاستخدام | |---|---|---| | **الرئيسية (`Home`)** | `/home` | فتح ملخص المهام وسير العمل والعناصر الحديثة في «التطبيقات». | | **مهامي (`My Tasks`)** | `/applications?view=workflows&wf=tasks` | فتح مهام سير العمل التي تنتظر إجراءً. | | **منشئ التدفق (`Flow Builder`)** | `/workflow-management` | فتح مكتبة تصميم سير العمل. | يحدد RAPTIX هذه الاختصارات ولا يمكن تخصيصها حاليًا من داخل المنتج. ## Android 1. اعثر على رمز **RAPTIX** المثبت. 2. اضغط عليه مطولًا. 3. اختر **الرئيسية** أو **مهامي** أو **منشئ التدفق**. ## Windows أو macOS أو متصفح حاسوب مدعوم 1. اعثر على RAPTIX في شريط المهام أو قائمة Start أو Dock أو قائمة التطبيقات. 2. انقر بزر الفأرة الأيمن على رمز التطبيق. 3. اختر الاختصار المطلوب عندما يعرض نظام التشغيل قائمة الاختصارات. لا تعرض بعض أنظمة التشغيل أو مشغلات التطبيقات اختصارات تطبيقات الويب. إذا غابت القائمة، فافتح RAPTIX كالمعتاد واستخدم التنقل الداخلي. ## الوصول وتسجيل الدخول لا تتجاوز الاختصارات تسجيل الدخول أو ضوابط الوصول. إذا انتهت الجلسة، فسجّل الدخول وسيعيدك RAPTIX إلى الوجهة المطلوبة متى كان ذلك مدعومًا. وإذا لم يكن حسابك قادرًا على فتح المنطقة، فاطلب الوصول من المسؤول. ## استكشاف المشكلات وحلها | المشكلة | الحل | |---|---| | لا تظهر اختصارات | تأكد أن RAPTIX مثبت كتطبيق لا محفوظ كإشارة متصفح، وتحقق من دعم النظام والمتصفح للاختصارات. | | يبقى اسم اختصار قديم | أعد تثبيت التطبيق أو تحديثه كي يحمّل بيان التطبيق الحالي. | | يفتح الاختصار صفحة الدخول | أكمل تسجيل الدخول؛ فقد انتهت الجلسة السابقة. | | «مهامي» فارغة | تحقق من وجود مهام معلقة لحسابك ومن فتح نطاق التطبيق الصحيح. | ## أدلة ذات صلة - [تثبيت RAPTIX كتطبيق](https://raptix.app/user-guide/ar/00-getting-started/00-12-install-as-app-pwa/) - [التنقل في RAPTIX](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [إدارة منشئ التدفق](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-14-my-tasks-bell-badge/ # فهم شارة جرس «مهامي» > **المنطقة:** شريط تنقل RAPTIX العلوي > > **ما ستتعلمه:** معنى العدد على الجرس وكيفية فتح «مهامي». ## ماذا يعرض الجرس؟ يظهر الجرس أعلى يمين التنقل عندما يستطيع حسابك استخدام مهام سير العمل، بين عنصر التحكم في الوضع الفاتح أو الداكن ومعلومات حسابك. | الحالة | المعنى | |---|---| | جرس رمادي بلا شارة | لا توجد مهام معلقة محتسبة حاليًا. | | مظهر التحميل | جارٍ جلب عدد المهام. | | جرس كهرماني مع شارة رقمية | توجد مهمة معلقة واحدة أو أكثر. | | **99+** | توجد 100 مهمة معلقة على الأقل. | تستخدم التسمية المتاحة لقارئات الشاشة والتلميح عدد المهام المعلقة، بينما تحمل صفحة الوجهة اسم **مهامي (`My Tasks`)**. ## فتح «مهامي» اختر الجرس. يفتح RAPTIX: `/applications?view=workflows&wf=tasks` وهذه صفحة **التطبيقات ← سير العمل ← مهامي**. افتح صفًا لمراجعة المهمة في **مدير مهام سير العمل (`Workflow Task Manager`)** وإرسال إجراء مسموح. ## مهام من التي تُحتسب؟ - يتلقى المستخدم العادي عدد المهام المعلقة المتاحة لحسابه. - قد يتلقى المسؤول إجماليًا أوسع تسمح به صلاحيات الخادم. - لا تُحتسب الأعمال المكتملة أو المرفوضة أو المعلقة مؤقتًا أو المنتهية أو الملغاة ضمن المعلق. تتحكم صلاحيات المهام في الخادم في قائمة «مهامي» نفسها؛ ولا تمنح الشارة وصولًا إضافيًا. ## متى يتحدث العدد؟ يُحمّل العدد بعد تسجيل الدخول، ويتحدث عندما يطلب RAPTIX ذلك، بما في ذلك بعد إجراءات المهام المدعومة وعندما تستعيد صفحات ذات صلة تركيز المتصفح. وقد يؤدي إكمال مهمة في علامة أخرى أو بواسطة شخص مخول آخر إلى اختلاف مؤقت بين الرقم المعروض والقائمة الحية. ## استكشاف المشكلات وحلها | المشكلة | الحل | |---|---| | الجرس غير موجود | ربما لا يملك حسابك وصولًا إلى مهام سير العمل في «التطبيقات». اطلب من المسؤول المراجعة. | | تعرض الشارة رقمًا لكن «مهامي» فارغة | حدّث الصفحة؛ ربما اكتملت المهمة أو انتهت بعد تحميل العدد. وتحقق من النطاق الحالي. | | لا ينخفض العدد بعد إجراء | انتظر استجابة نجاح الإجراء، ثم حدّث «مهامي» أو أعد التركيز إلى علامة التبويب. | | يرى مستخدمان عددين مختلفين | تُحدد الأعداد حسب كل مستخدم، إلا إذا كان للحساب رؤية إدارية. | ## أدلة ذات صلة - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [استخدام الصفحة الرئيسية](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [التنقل في RAPTIX](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/ # حل مشكلة «الوصول مقيّد» > **الجمهور:** جميع المستخدمين المسجلين > > **ما ستتعلمه:** لماذا قد تكون منطقة غير متاحة، وما المعلومات التي ترسلها إلى المسؤول. ## لماذا تظهر؟ تعني **الوصول مقيّد (`Access Restricted`)** أنك مسجل الدخول، لكن الحساب الحالي لا يستطيع فتح المنطقة أو المورد المطلوب. ومن الأسباب الشائعة: - منطقة التنقل ليست ضمن دورك؛ - مساحة عمل أو تطبيق أو صفحة أو ملف أو سير عمل أو مساعد ذكاء اصطناعي أو مورد معرفة خارج المنح المتاحة لك؛ - رابط مشارك يشير إلى مورد نُقل أو حُذف؛ - تغير وصولك بعد أن كانت الصفحة مفتوحة. قد يخفي RAPTIX المناطق غير المتاحة بدلًا من عرض عنصر مقفل. لذلك قد يكون غياب الصفحة من التنقل وظهور «الوصول مقيّد» ناتجين عن سبب الصلاحية نفسه. ## استخدام إجراءات الصفحة - اختر **رجوع (`Go Back`)** للعودة إلى الصفحة السابقة. - اختر **فتح الرئيسية (`Open Home`)** للانتقال إلى `/home`. - لا تكرر التحديث إذا لم يُمنح حسابك وصولًا إلى المنطقة من قبل. ## طلب الوصول الصحيح أرسل إلى المسؤول: 1. اسم المنطقة الظاهر للمستخدم، مثل التطبيقات أو منشئ التدفق أو سير العمل أو المستندات أو وكلاء الذكاء الاصطناعي أو المعرفة أو الإدارة أو الدعم؛ 2. اسم مساحة العمل أو التطبيق أو الصفحة أو سير العمل أو الملف أو المساعد إذا كانت المشكلة خاصة بمورد؛ 3. بريد حسابك والدور المعروض؛ 4. عنوان الصفحة التي حاولت فتحها؛ 5. وقت المشكلة وأي معرّف طلب أو مرجع ظاهر. اطلب أقل قدر من الوصول يحل حاجتك. وفي «التطبيقات»، قد يحتاج المسؤول إلى التحقق من وصول المنتج ومنحة المورد معًا. ## فروق شائعة | العَرَض | ما يُرجح التحقق منه | |---|---| | تفتح «التطبيقات» لكن مساحة عمل مفقودة | منحة مورد مساحة العمل أو التطبيق وحالة البحث الحالية. | | «منشئ التدفق» غير موجود | وصول منتج منشئ التدفق. | | يفتح سير العمل لكن «كل المثيلات» أو «مهامي» لا يفتح | وصول سير العمل في «التطبيقات» إلى ذلك العرض. | | ملف مفقود | وصول منتج «المستندات» مع صلاحيات الملف أو المجلد أو النطاق. | | تفتح «وكلاء الذكاء الاصطناعي» لكن مساعد مفقود | قائمة الأدوار أو المستخدمين المسموح لهم وحالة تفعيل المساعد. | | «الإدارة» غير موجودة | وصول المسؤول. | ## بعد تغيير الوصول أعد تحميل الصفحة المتأثرة. إذا بقيت غير متاحة، فسجّل الخروج ثم الدخول كي تعيد الجلسة تحميل الأدوار والمنح. بعد ذلك امسح حالة البحث والتصفية قبل الإبلاغ عن النتيجة. ## أدلة ذات صلة - [فهم الوصول إلى الرئيسية والتطبيقات](https://raptix.app/user-guide/ar/00-getting-started/00-9-app-access-permissions/) - [التنقل في RAPTIX](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [حل مشكلات الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-18-toast-notifications/ # فهم الإشعارات المنبثقة وما تخبرك به > **الوحدة:** أساسيات المنصة    **الجمهور:** المستخدم النهائي والمسؤول > **ما ستتعلمه:** ما الإشعار المنبثق، وما معنى كل لون، وكيف تقرأه وتغلقه، وما الذي تفعله مع كل نوع. ## ما هذه الميزة؟ **الإشعار المنبثق (`toast`)** بطاقة صغيرة تظهر لوقت قصير في زاوية الشاشة لتعطيك استجابة فورية لشيء حدث للتو. تظهر إشعارات RAPTIX في **أعلى يمين الشاشة**، وتتراص إذا وصلت عدة إشعارات معًا، ثم تختفي تلقائيًا بعد ثوانٍ. لا يلزمك فعل شيء إلا إذا أردت قراءة أحدها بعناية أو إغلاقه مبكرًا. تُستخدم هذه الإشعارات في جميع وحدات المنصة لتأكيد الإجراءات، والتحذير من مشكلة، وتقديم معلومة، أو تنبيهك إلى تغير حالة الشبكة. ## لماذا تفيدك؟ - **استجابة فورية لا تعطل العمل.** تعرف إن نجح الإجراء أو فشل من دون مربع حوار يوقفك ويحتاج إلى إغلاق. - **لا إخفاقات صامتة.** إذا فشل حفظ أو رفع ملف أو حدثت مشكلة جلسة، يخبرك الإشعار فورًا وبلغة واضحة. - **ألوان مفهومة بنظرة.** يدل اللون مباشرة على نجاح باللون الأخضر، أو تحذير بالأصفر، أو خطأ يحتاج إلى انتباه بالأحمر، أو معلومة بالأزرق. - **تختفي تلقائيًا.** لا تتراكم البطاقات على الشاشة، ويمكنك إغلاقها يدويًا بزر الإغلاق إن أردت. - **معرفة حالة الشبكة.** تعرف فور انقطاع الإنترنت وعودته، فلا تحتار في سبب توقف الصفحة. ## قبل أن تبدأ - تظهر الإشعارات تلقائيًا ولا يوجد شيء يلزم تفعيله أو ضبطه؛ يراها كل مستخدم. - تظهر **أعلى يمين الشاشة** على الحاسوب، وقد تظهر **أسفلها** في بعض سياقات الهاتف. وهي لا تحرك شريط التنقل ولا تحجبه. - إذا وصلت عدة إشعارات في الوقت نفسه، تتراص رأسيًا. ## طريقة الاستخدام خطوة بخطوة تعرض المنصة الإشعارات تلقائيًا عند الحاجة. تفاعل معها كالآتي: 1. **اقرأ الرسالة.** عندما تظهر بطاقة، انظر إلى لونها ثم اقرأ النص القصير لفهم ما حدث. 2. **انتظر اختفاءها.** تختفي معظم الإشعارات تلقائيًا: - إشعارات النجاح بعد نحو **5 ثوانٍ**. - إشعارات الخطأ والتحذير من منطقة المحرك بعد **8 إلى 12 ثانية** لتمنحك وقتًا لقراءة التفاصيل. - إشعارات اتصال الشبكة تظهر وتختفي مع تغير الاتصال. 3. **أغلقها مبكرًا.** بعد القراءة، اختر زر **✕** في يمين البطاقة لإزالتها فورًا. 4. **نفذ ما تطلبه الرسالة عند الحاجة.** تشير بعض البطاقات الحمراء أو الصفراء إلى مشكلة تستدعي إجراءً، مثل إعادة محاولة الرفع أو تحديث الصفحة أو التواصل مع المسؤول. ## شرح الخيارات والإعدادات ### ألوان الإشعارات ومعناها | اللون | الرمز | المعنى | أمثلة شائعة | |--------|------|---------|-----------------| | **أخضر** | ✅ | **نجاح** — اكتمل الإجراء بنجاح. | رُفع ملف، حُفظ سير عمل، أُرسلت مهمة، حُدثت الإعدادات. | | **أحمر** | ❌ | **خطأ** — حدث خلل ولم يكتمل الإجراء. | فشل الرفع أو الاتصال أو الحفظ، أو رُفضت الصلاحية. | | **أصفر أو كهرماني** | ⚠️ | **تحذير** — اكتمل الإجراء لكن توجد ملاحظة، أو هناك حالة تحتاج إلى الانتباه. | انقطع الإنترنت، أو ميزة غير متاحة مؤقتًا، أو بلغ حد ما. | | **أزرق** | ℹ️ | **معلومة** — تحديث حالة محايد أو تأكيد لا يحتاج إلى إجراء. | بدأت عملية خلفية، أو تجددت جلسة، أو أصبح تنزيل جاهزًا. | ### إشعارات الشبكة الخاصة يدير مراقب الشبكة إشعارين على مستوى المنصة ويعرضهما في أي صفحة: | الإشعار | اللون | معناه | |-------|--------|---------------| | «أنت غير متصل (`You are offline`)» | أصفر | فقد جهازك اتصال الإنترنت ولا تستطيع المنصة الوصول إلى الخادم. ستفشل إجراءات مثل إرسال النماذج ورفع الملفات حتى يعود الاتصال. | | «عدت إلى الاتصال (`Back online`)» | أخضر | استُعيد الاتصال، وأصبحت المنصة متصلة ويمكنك استئناف العمل. | تظهر هذه الإشعارات تلقائيًا كلما تغيرت حالة الاتصال، ولا تحتاج إلى تشغيلها. ### مكونات بطاقة الإشعار ```text ┌─────────────────────────────────────────────┐ │ [الرمز] نص الرسالة القصير [✕] │ └─────────────────────────────────────────────┘ ``` | العنصر | الوصف | |---------|-------------| | الخلفية الملونة | توضح فورًا النجاح أو الخطأ أو التحذير أو المعلومة. | | الرمز | يعزز نوع الرسالة: ✅ أو ❌ أو ⚠️ أو ℹ️. | | نص الرسالة | وصف قصير وواضح لما حدث أو للحالة. | | زر الإغلاق ✕ | يغلق البطاقة فورًا قبل انتهاء مؤقتها. | ### مدة الاختفاء التلقائي | نوع الإشعار | المدة | |------------|------------------| | نجاح عام | نحو 5 ثوانٍ | | خطأ أو تحذير في لوحة المحرك وعمليات التنزيل | 8–12 ثانية | | حالة الشبكة | نحو 3 ثوانٍ | | معلومة | نحو 5 ثوانٍ | ## نصائح وأفضل الممارسات - **انظر إلى اللون أولًا.** في لحظة مزدحمة، يخبرك اللون وحده إن كان عليك التوقف والقراءة أم يمكنك المتابعة. - **لا تغلق إشعار الخطأ فورًا.** غالبًا يحمل الأحمر أهم المعلومات؛ اقرأه بعناية قبل الإغلاق. - **إذا فاتك إشعار، فراجع الإجراء الأخير.** الإشعار يؤكد الإجراء أو يبلغ عن نتيجته. فإذا كنت تحفظ سير عمل ورأيت بطاقة حمراء، فعلى الأرجح فشل الحفظ؛ أعد المحاولة. - **إشعار «غير متصل» الأصفر ليس خطأ في المنصة.** يدل على مشكلة شبكة مؤقتة. عند ظهور الأخضر تكون الشبكة قد عادت ويمكنك إعادة الإجراء. - **تتراص عدة إشعارات.** قد ترى بطاقتين أو ثلاثًا إذا اكتملت إجراءات بسرعة، ولكل بطاقة مؤقتها وزر إغلاقها. ## الأسئلة الشائعة **س: رأيت إشعارًا أحمر لكنه اختفى قبل أن أقرأه. ماذا أفعل؟** أعد الإجراء الذي شغّله. إن تكرر الخطأ، ستظهر البطاقة مجددًا ويمكنك قراءتها. وإن كان عابرًا، فقد ينجح الإجراء الآن. وإذا استمر خطأ غير مفهوم، فأخبر المسؤول بما كنت تفعله عند ظهوره. **س: هل يمكن تعطيل الإشعارات؟** لا. إنها آلية أساسية لتقديم استجابة المنصة، ولا يمكن تعطيلها. وهي قصيرة وغير حاجبة كي لا تعطل عملك. **س: ظهر إشعار أحمر عن صلاحية. ماذا يعني؟** يعني أن حسابك لا يملك الحق اللازم لإكمال ذلك الإجراء. تواصل مع المسؤول واشرح ما حاولت فعله ليُراجع دورك وصلاحياتك. **س: ظهر «غير متصل» مع أن الإنترنت يبدو سليمًا.** قد تكتشف المنصة انقطاعًا لحظيًا حتى لو كان اتصالك العام مستقرًا. انتظر ثوانٍ؛ إذا تبعته بطاقة «عدت إلى الاتصال»، فكل شيء طبيعي ولم تُفقد بيانات. **س: هل تُحفظ الإشعارات في سجل أراجعه لاحقًا؟** لا يوجد سجل إشعارات مرئي للمستخدم. وبالنسبة إلى الإجراءات والأحداث الدائمة في وحدات معينة، يستطيع المخولون الرجوع إلى السجلات التشغيلية. راجع [سجلات تدقيق المستندات](https://raptix.app/user-guide/ar/20-documents/20-14-audit-log/) و[قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/). **س: لماذا يختلف إشعاري عن إشعار زميل في الصفحة نفسها؟** تنتج الإشعارات من الإجراء الذي نفذته أو الحدث في جلستك. وقد يرى مستخدمان بطاقات مختلفة لأنهما نفذا إجراءين أو حصلا على نتيجتين مختلفتين. ## أدلة ذات صلة - [التنقل في المنصة](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [فهم شارة جرس «مهامي»](https://raptix.app/user-guide/ar/00-getting-started/00-14-my-tasks-bell-badge/) - [تثبيت المنصة كتطبيق](https://raptix.app/user-guide/ar/00-getting-started/00-12-install-as-app-pwa/) - [المسرد](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-19-getting-help-support/ # الحصول على المساعدة من الدعم > **المنطقة:** الدعم > > **الجمهور:** جميع المستخدمين المسجلين > > **الوصول المطلوب:** حساب RAPTIX مسجل الدخول > > **ما ستتعلمه:** كيفية إرسال طلب، وإرفاق أدلة مفيدة، ومتابعة حالته، والرد على فريق الدعم. ## فتح الدعم اختر **الدعم (`Support`)** من التنقل الرئيسي أو افتح `/support`. تتاح الصفحة لكل مستخدم مسجل، ولا تحتوي إلا طلباتك أنت؛ فهي ليست قائمة عامة بطلبات المستخدمين الآخرين. ## إرسال طلب جديد 1. اختر **طلب جديد (`New request`)**. وإذا لم ترسل طلبًا من قبل، فاختر **إرسال طلب (`Submit a request`)** من الحالة الفارغة. 2. اكتب **موضوعًا (`Subject`)** قصيرًا ومحددًا لا يتجاوز 255 حرفًا. 3. اختر **الفئة (`Category`)**: | الفئة | استخدامها | |---|---| | **سؤال (`Question`)** | مساعدة في استخدام ميزة. | | **خلل (`Bug`)** | شيء لا يعمل كما هو متوقع. | | **حادث (`Incident`)** | انقطاع خدمة أو مشكلة تشغيلية عاجلة. | | **الفوترة (`Billing`)** | سؤال عن الفاتورة أو الاشتراك. | | **طلب ميزة (`Feature request`)** | اقتراح تحسين. | | **الوصول إلى الحساب (`Account access`)** | مشكلة في الدخول أو الوصول. | | **أخرى (`Other`)** | طلب لا يناسب الفئات السابقة. | 4. في **الوصف (`Description`)**، اشرح ما حدث وما توقعته والخطوات التي أدت إليه. 5. أضف مرفقات إن أردت. 6. اختر **إرسال الطلب (`Submit request`)**. يستخدم RAPTIX حسابك المسجل للطلب. لا تضع كلمات مرور أو رموز وصول أو مفاتيح خاصة في الموضوع أو الوصف أو المرفقات. ## إرفاق أدلة مفيدة اسحب الملفات إلى منطقة المرفقات، أو الصقها، أو اختر **تصفح (`browse`)**. تعرض الصفحة الحدود الحالية لعدد الملفات وحجم كل ملف. الإعداد الافتراضي ستة ملفات و10 ميغابايت لكل ملف، لكن اتبع القيم المعروضة في مساحة عملك لأن المسؤول يستطيع تغييرها. تُدعم الصور وملفات PDF والمستندات إذا وافقت الحدود. عند الإبلاغ عن مشكلة في «التطبيقات» أو سير العمل، أرفق الخطأ الظاهر واسم الصفحة ووقت الحدث ومعرّف المثيل إن وجد. وأخفِ البيانات الشخصية أو التجارية السرية قبل إرفاق لقطة شاشة. ## متابعة الطلب بعد الإرسال، ارجع إلى قائمة الدعم. يعرض كل صف: | العنصر | المعنى | |---|---| | مرجع الطلب | معرّف طلبك. اذكره عند المتابعة خارج RAPTIX. | | الفئة | النوع الذي اخترته. | | الحالة | **جديد (`New`)** أو **مفتوح (`Open`)** أو **معلق (`Pending`)** أو **محلول (`Resolved`)** أو **مغلق (`Closed`)**. | | آخر نشاط | أحدث رد أو تحديث. | اختر صفًا لفتح المحادثة كاملة. ## الرد وإعادة فتح الطلب اقرأ رد الدعم وأي ملاحظة **حل (`Resolution`)** في تفاصيل الطلب. أضف رسالة أو مرفقًا ثم اختر **إرسال (`Send`)**. يمكنك الرد على طلب محلول أو مغلق عندما تكون لديك معلومات إضافية أو تعود المشكلة. يعيد ردك فتحه للمتابعة. ## استكشاف المشكلات وحلها **زر إرسال الطلب غير متاح.** أضف الموضوع والوصف ثم حاول مجددًا. **رُفض مرفق.** قلّل حجمه أو عدد الملفات وفق الحدود المعروضة. أزل البيانات الحساسة قبل إعادة المحاولة. **الطلب غير موجود في القائمة.** حدّث صفحة الدعم وتأكد أنك دخلت بالحساب نفسه الذي أرسله. ## أدلة ذات صلة - [حل أخطاء اتصال التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-24-troubleshooting-connection-errors/) - [حل مشكلات الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) - [استخدام الإدارة](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) --- URL: https://raptix.app/user-guide/ar/00-getting-started/00-21-welcome-preferences-and-guided-tours/ # استخدام شاشة الترحيب والتفضيلات والجولات الإرشادية > **الوحدة:** بدء الاستخدام > > **الجمهور:** جميع المستخدمين المسجّل دخولهم > > **الوصول المطلوب:** حساب RAPTIX؛ تُصفّى خطوات الجولة وفق الصفحات والإجراءات التي يُسمح لك باستخدامها > > **ستتعلم:** كيف تعمل شاشة الترحيب الأولى، وكيف تختار مسارًا إرشاديًا، وتغيّر اللغة أو المظهر، وتعيد الجولة الرئيسية، وتفهم الإرشاد السياقي الذي يظهر في المستندات وقاعدة المعرفة والمهام ومنشئ التدفقات. ## البدء من لحظة الترحيب عندما يفتح RAPTIX للمرة الأولى لحساب مؤهل، تعرض لوحة ترحيب ثلاث طرق عملية للبدء: | المسار | ما يوضحه | |---|---| | **أرسله بالبريد (Email it)** | أرسل عملًا حقيقيًا إلى عنوان RAPTIX الخاص بك، وتابع الرسالة إلى البريد الإلكتروني. | | **اسأله (Ask it)** | اسأل المساعد عن العمل والمستندات والبريد المسموح لك برؤيته. | | **علّمه (Teach it)** | صِف عملية تعتمد على البريد بلغة طبيعية، وراجع سير العمل المقترح، وحدد وقت تنشيطه. | اختر **أرني (Show me)** تحت المسار الذي يطابق ما تريد تجربته. ويمكنك أيضًا اختيار الاستكشاف بنفسك. لا يؤدي إغلاق شاشة الترحيب أو تجاوزها إلى إزالة وصولك إلى RAPTIX، ولا إلى اعتماد سير عمل أو إجراء فوترة. قد يكون المسار المتاح وخطواته أقصر عندما لا تتاح صفحة أو رسالة أو مساعد أو ميزة إدارية لدورك. هذا مقصود؛ فالجولة لا تعلّمك أبدًا استخدام عنصر تحكم لا تستطيع الوصول إليه. ## التنقل في الجولة استخدم **التالي (Next)** و**رجوع (Back)** في بطاقة الجولة. يعرض مؤشر التقدم عدد الخطوات المنطبقة بعد تصفية الصلاحيات. اختر **تجاوز (Skip)** لمغادرة الجولة من دون تغيير العمل في الصفحة. قد تفتح الجولة صفحة RAPTIX أخرى للإشارة إلى الجزء التالي من الرحلة. إذا لم يكن العنصر المتوقع جاهزًا، مثل رسالة ترحيب لا تزال في طريقها، تمنحك الجولة بديلًا آمنًا بدلًا من تركك في خطوة معطلة. تشرح الجولات موضع العمل والغرض من عناصر التحكم. وهي لا تنقر **اعتماد (Approve)**، ولا تنشّط سير عمل، ولا ترسل نموذجًا، ولا تتخذ قرارًا مهمًا آخر نيابة عنك. ## إعادة جولة المنصة بعد تسجيل شاشة الترحيب الأولى، افتح عنصر المساعدة أو الحساب في الرأس، واختر **أرني المنصة مرة أخرى (Show me around again)**. يبدأ RAPTIX جولة المنصة الرئيسية من الصفحة الرئيسية. لا يمكن تشغيل أكثر من جولة واحدة في الوقت نفسه. إذا كانت الإعادة غير متاحة مؤقتًا، فأكمل الجولة الظاهرة أو أغلقها أولًا. تفتح القائمة نفسها أيضًا **دليل المستخدم (User guide)** في علامة تبويب مستقلة، حتى تبقي عملك الحالي مفتوحًا أثناء قراءة التعليمات الكاملة. ## استخدام جولات الصفحات السياقية يستطيع RAPTIX عرض دليل قصير لمرة واحدة عند وصولك أول مرة إلى منطقة عمل مدعومة: | المنطقة | ما يشرحه الدليل | |---|---| | **المستندات (Documents)** | موضع الملفات، وكيف تبدأ المشاركة، وكيف يمكن للمستندات المسموح بها دعم إجابات الذكاء الاصطناعي. | | **قاعدة المعرفة (Knowledge)** | المصادر التي تستند إليها الإجابات، وكيف يُضاف المحتوى، وأهمية الاستشهادات. | | **مهامي (My Tasks)** | موضع ورود الاعتمادات والمراجعات والنماذج، وكيف تفتح سياق العمل كاملًا. | | **لوحة منشئ التدفقات (Flow Builder canvas)** | كيف تقرأ العملية وتتعرف على مُشغّلها وتتحكم في تنشيطها. | لا يظهر الدليل السياقي إلا عندما تكون صفحته الحقيقية والسياق المطلوب جاهزين. ولا يقاطعك مرارًا بعد رؤيته، وينتظر إذا كانت جولة أخرى نشطة. ## تغيير اللغة والمظهر افتح عنصر الحساب في الرأس: 1. اختر **English** أو **العربية** تحت **التفضيلات (Preferences)**. 2. استخدم **المظهر (Appearance)** للتبديل بين الوضع الفاتح والداكن. 3. أغلق القائمة وتابع العمل. يحفظ RAPTIX تفضيلات اللغة واتجاه القراءة والمظهر. تغيّر العربية الواجهة إلى اتجاه من اليمين إلى اليسار، وتستخدم الإنجليزية الاتجاه من اليسار إلى اليمين. تظل القيم التقنية مثل عناوين البريد وعناوين URL مقروءة باتجاهها الطبيعي. تعرض قائمة الحساب أيضًا الهوية المسجّل دخولها والأدوار ذات الصلة. ولا تظهر الوجهات الإدارية إلا عندما يسمح وصولك بها. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب فعله | |---|---| | لم تظهر شاشة الترحيب | ربما سبق عرضها، أو ربما تكون التهيئة معطلة لمساحة العمل، أو لا يوجد مسار مؤهل جاهز. استخدم **أرني المنصة مرة أخرى** في الرأس. | | تم تجاوز خطوة | لم يكن عنصر الصفحة أو الإذن المطلوب متاحًا. تابع الخطوات المتبقية؛ فالجولة لا تمنح صلاحيات. | | إعادة الجولة معطلة | أغلق الجولة العاملة، ثم أعد فتح قائمة المساعدة أو الحساب. | | تغيرت اللغة لكن قيمة لا تزال تُقرأ من اليسار إلى اليمين | تحتفظ عناوين البريد وعناوين URL والأكواد وأسماء المنتجات عمدًا باتجاهها المقروء. | | وحدة مفقودة من الجولة أو التنقل | قد لا يتضمنها دورك أو خطتك أو إعداد مساحة العمل. اطلب من مشرف مساحة العمل مراجعة الوصول. | ## أدلة ذات صلة - [استخدام الصفحة الرئيسية: المهام ومسارات سير العمل والتطبيقات الحديثة](https://raptix.app/user-guide/ar/00-getting-started/00-8-home-and-app-launcher/) - [كيفية التنقل في المنصة](https://raptix.app/user-guide/ar/00-getting-started/00-10-navigation/) - [التبديل بين الوضع الفاتح والداكن](https://raptix.app/user-guide/ar/00-getting-started/00-11-dark-mode/) - [فهم شارة جرس مهامي](https://raptix.app/user-guide/ar/00-getting-started/00-14-my-tasks-bell-badge/) - [استخدام فقاعات المحادثة العائمة](https://raptix.app/user-guide/ar/30-ai-agents/30-31-floating-chat-bubbles/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-1-quickstart-first-workflow/ # البدء السريع بسير العمل: أنشئ أول سير عمل خلال 10 دقائق > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي > **ستتعلم:** كيفية إنشاء سير عمل جديد من البداية، وإضافة أولى العُقد إلى لوحة التصميم المرئية، وربطها في عملية بسيطة، ثم حفظها — وكل ذلك خلال نحو 10 دقائق. ## ما هذه الميزة؟ عمليات سير العمل هي وحدة الأتمتة المرئية للعمليات داخل RAPTIX. تصمم العملية بسحب وحدات البناء المتتابعة وربطها على لوحة لا نهائية، من دون الحاجة إلى كتابة أي كود. بعد بناء سير العمل، يمكنه التشغيل تلقائيًا، وإشعار الأشخاص المناسبين، وانتظار الموافقات، وتوجيه القرارات، وغير ذلك الكثير. يرشدك هذا الدليل السريع إلى إنشاء أول سير عمل لك: يبدأ يدويًا، ويسند مهمة إلى شخص للموافقة، ويرسل إشعارًا بالبريد الإلكتروني، ثم ينتهي. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **لا تحتاج العملية الأساسية إلى كود:** اسحب العُقد، واضبط حقولها الظاهرة، وارسم الروابط بينها. - **منطق العملية واضح:** تظهر كل خطوة وقرار على شاشة واحدة، ما يسهّل مراجعة العملية وشرحها للزملاء. - **تشغيل موثوق في الخلفية:** بعد بدء سير العمل، يواصل العمل حتى لو أغلقت المتصفح أو أعيد تشغيل الخادم، ولا تضيع العملية في منتصف التنفيذ. - **نتيجة سريعة تعزز الثقة:** يستطيع معظم المستخدمين حفظ أول سير عمل عامل وجاهز للاختبار خلال 10 دقائق. - **أساس قابل لإعادة الاستخدام:** يمكنك توسيع أول سير عمل، أو نسخه، أو مشاركته مع زملائك. ## قبل أن تبدأ - تحتاج إلى صلاحية الوصول إلى عمليات سير العمل. إذا لم يظهر **سير العمل** في الشريط الجانبي أو على الشاشة الرئيسية، فاطلب من المسؤول منحك صلاحية سير العمل. - لا تحتاج إلى دور خاص لتصميم سير عمل أساسي وحفظه؛ يستطيع معظم المستخدمين فعل ذلك. بعض العُقد المتقدمة، مثل **برنامج Python النصي**، مخصصة للمسؤولين. - افتح منصة RAPTIX في متصفحك وتأكد من تسجيل الدخول. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1: افتح إدارة عمليات سير العمل 1. افتح **التطبيقات**. 2. اختر **منشئ التدفق** من إجراءات **البناء**. تفتح صفحة **إدارة عمليات سير العمل** على مستوى مساحة العمل. اختر مساحة عمل وتطبيقًا عندما تريد مراجعة عمليات سير العمل الموجودة في ذلك الموقع. ### الخطوة 2: أنشئ سير عمل جديدًا 3. اختر **سير عمل جديد** من رأس الصفحة. يظهر نموذج بيانات يطلب منك إدخال تفاصيل سير العمل الجديد. 4. أكمل الحقول التالية: | الحقل | ما يجب إدخاله | |---|---| | **مساحة العمل** | اختر مساحة العمل المالكة لسير العمل. قد تكون محددة مسبقًا إذا فتحت إنشاء سير العمل من داخلها. | | **التطبيق** | اختر التطبيق المالك لسير العمل. | | **اسم سير العمل** | أدخل اسمًا وصفيًا فريدًا، مثل: `أول سير عمل للموافقة` | | **الوصف** | اختياريًا، أضف ملاحظة موجزة مثل: `سير عمل البرنامج التعليمي للبدء السريع` | 5. اختر **المتابعة إلى المصمم**. يفتح المصمم المرئي تلقائيًا بسير عمل جديد وفارغ. ### الخطوة 3: أضف عقدة بدء يفتح سير العمل الجديد بلوحة فارغة. إذا كنت تعدّل سير عمل موجودًا أو منسوخًا، فلا تمسح اللوحة إلا إذا كنت تقصد إزالة جميع عُقدها الحالية. 6. تظهر لوحة **عناصر سير العمل** في يسار اللوحة، وبأعلاها علامتا تبويب: **أساسي** (`BASIC`) و**منطق** (`LOGIC`). تأكد من اختيار **أساسي**. 7. ابحث عن عقدة **بدء**، وهي العنصر الذهبي ذو رمز التشغيل. اسحبها إلى اللوحة ثم أفلتها قرب منتصف الجزء العلوي. تظهر عقدة البدء على اللوحة. انقر عليها نقرًا مزدوجًا، أو انقر مرة واحدة وابحث عن لوحة التحرير أو الخصائص، ثم اضبطها: - **التسمية:** `بدء`، اتركها كما هي أو غيّرها إلى اسم مثل `بدء الطلب`. - **نوع المشغّل:** اختر **تشغيل يدوي**. - اختر **حفظ** أو **إغلاق** لحفظ إعدادات العقدة. ### الخطوة 4: أضف عقدة مهمة 8. من علامة تبويب **أساسي** في لوحة عناصر سير العمل، ابحث عن **مهمة** ذات رمز قائمة الاختيار البرتقالي، ثم اسحبها أسفل عقدة البدء. 9. انقر على عقدة المهمة لفتح لوحة خصائصها، ثم أدخل: | الحقل | ما يجب إدخاله | |---|---| | **عنوان المهمة** | `موافقة المدير` | | **الوصف** | `مراجعة الطلب المرسل والموافقة عليه` | | **مسندة إلى** | اختر المستخدم أو الدور الذي ينبغي أن يتلقى المهمة | | **الأولوية** | `متوسطة` | 10. اختر **حفظ**، أو أغلق لوحة الخصائص لتأكيد الإعدادات. ### الخطوة 5: أضف عقدة بريد إلكتروني 11. من علامة تبويب **أساسي**، ابحث عن **بريد إلكتروني** ذات رمز الظرف البنفسجي، ثم اسحبها أسفل عقدة المهمة. 12. انقر على عقدة البريد الإلكتروني لفتح خصائصها. أدخل على الأقل: - **الموضوع:** `تمت معالجة طلبك` - **المستلمون:** أدخل عنوان بريد إلكتروني أو اختر متغير سير عمل للمستلم. 13. يمكنك استخدام منشئ البريد بالسحب والإفلات لإنشاء نص الرسالة، أو إبقاؤه بالتخطيط الافتراضي الآن. اختر **حفظ**. ### الخطوة 6: أضف عقدة نهاية 14. من علامة تبويب **منطق**، ابحث عن **نهاية** ذات رمز المربع الرمادي، ثم اسحبها أسفل عقدة البريد الإلكتروني. تحدد عقدة النهاية الموضع الذي ينتهي عنده هذا الفرع من سير العمل. ### الخطوة 7: اربط العُقد ارسم الآن الروابط، أو الأسهم، بين العُقد لتحديد مسار التدفق: 15. مرّر مؤشر الفأرة فوق الحافة السفلية لعقدة **بدء**. تظهر دائرة صغيرة، وهي مقبض الاتصال. 16. انقر واسحب من ذلك المقبض إلى الحافة العلوية لعقدة **مهمة**، ثم أفلت زر الفأرة فوقها. يظهر سهم يصل بين العقدتين. 17. كرر العملية لربط عقدة **مهمة** بعقدة **بريد إلكتروني**، ثم اربط عقدة **بريد إلكتروني** بعقدة **نهاية**. ### الخطوة 8: احفظ سير العمل 18. اضغط **Ctrl+S** على لوحة المفاتيح، أو **Cmd+S** على جهاز Mac، أو اختر زر **حفظ سير العمل** الذهبي ذي رمز القرص المرن في أعلى يسار شريط الأدوات. يظهر تأكيد **تم الحفظ!** لفترة قصيرة أعلى الشاشة، ويُنشأ إدخال إصدار تلقائيًا. تهانينا — لقد أنشأت وحفظت أول سير عمل لك في RAPTIX! ## شرح الخيارات والإعدادات | العنصر | ما الذي يفعله؟ | |---|---| | **لوحة عناصر سير العمل (الشريط الجانبي الأيسر)** | تعرض جميع أنواع العُقد المتاحة. تضم علامة **أساسي** عُقد الإجراءات مثل البدء والمهمة والبريد الإلكتروني، وتضم علامة **منطق** عُقد التوجيه والتحكم في التدفق مثل إذا/وإلا والتقسيم والإيقاف المؤقت والنهاية. | | **علامة أساسي** | تعرض: بدء، مشغّل البريد الإلكتروني، بريد إلكتروني، مهمة، برنامج Python النصي للمسؤولين فقط، وكيل الذكاء الاصطناعي، المستندات، التقرير، استعلام قاعدة البيانات، لكل عنصر، ومجدول التذكير. تتطلب عقد استعلام قاعدة البيانات ولكل عنصر ومجدول التذكير باقة Enterprise. | | **علامة منطق** | تعرض: شرط إذا/وإلا، الفرع الشرطي، الإيقاف المؤقت، تقسيم الفروع، دمج الفروع، الحلقة، والنهاية. | | **اللوحة** | شبكة لا نهائية تُفلت عليها العُقد وترتبها. تدعم التحريك بالنقر والسحب في مساحة فارغة، والتكبير بعجلة التمرير. | | **شريط الأدوات** | الحفظ، والتصدير، والاستيراد، وعمليات سير العمل المحفوظة، والتراجع، والإعادة، والنسخ، والترتيب التلقائي، واتجاه التخطيط، والتكبير، والشبكة، والخريطة المصغرة، ونشط/غير نشط، والتشغيل، وإعادة الضبط، والمسح، ولوحة المتغيرات، ومنشئ الذكاء الاصطناعي، والوضع الفاتح/الداكن. | | **عنوان سير العمل (وسط شريط الأدوات)** | يعرض اسم سير العمل. انقر عليه نقرًا مزدوجًا لإعادة تسميته مباشرة. | | **أسهم الاتصال** | ارسمها بالسحب من مقبض إخراج إحدى العُقد إلى مقبض إدخال عقدة أخرى. تكون ملونة وتحمل تسميات في العُقد متعددة النتائج. | | **زر الحفظ (Ctrl+S)** | يحفظ اللوحة الحالية وينشئ إصدارًا جديدًا في السجل. | | **زر التشغيل (Ctrl+R)** | يبدأ تشغيلًا يدويًا لسير العمل، ويظهر ضمن **كل المثيلات**. | ## نصائح وأفضل الممارسات - **ابدأ ببساطة.** أنشئ سير عمل من ثلاث أو أربع عُقد، وتأكد من أنه يعمل، ثم أضف التعقيد. يمكنك دائمًا إضافة الفروع والشروط والخطوات لاحقًا. - استخدم **التخطيط التلقائي**، وهو رمز العصا في شريط الأدوات أو الاختصار **Ctrl+L**، إذا أصبحت اللوحة مزدحمة؛ إذ يرتب كل العُقد في تسلسل رأسي أو أفقي منظم بنقرة واحدة. - **استخدم أسماء واضحة للعُقد.** بدلًا من «المهمة 1»، استخدم اسمًا مثل «مراجعة مدير المالية» كي يشرح المخطط نفسه من أول نظرة. - **احفظ باستمرار.** يستغرق ضغط **Ctrl+S** ثانية واحدة فقط. يعمل الحفظ التلقائي كل 30 ثانية، لكن الحفظ اليدوي ينشئ نقاطًا في سجل الإصدارات يسهل تمييزها لاحقًا. - استخدم **لوحة المتغيرات**، ذات الرمز `{ }` في شريط الأدوات، لعرض حقول البيانات التي تنتجها كل عقدة، كي تستخدمها في العُقد الأخرى بصيغة `{{variable_name}}`. - **عاين قبل المشاركة.** قبل مطالبة زملائك باستخدام سير العمل، اختر صفه الأساسي في إدارة عمليات سير العمل لفتحه في وضع القراءة فقط. هذه هي الصورة التي سيراها الآخرون، وتساعدك في التأكد من وضوح التصميم. ## الأسئلة الشائعة **س: لا أرى لوحة عناصر سير العمل. أين ذهبت؟** انقر على رمز القائمة في أقصى يسار شريط الأدوات لإظهار اللوحة. قد تكون مخفية افتراضيًا في الشاشات الصغيرة. **س: رسمت اتصالًا، لكن السهم اتجه إلى العقدة الخطأ. كيف أحذفه؟** انقر على سهم الاتصال لتحديده، ثم اضغط مفتاح **Delete**. يُحذف الاتصال، وبعدها يمكنك رسم الاتصال الصحيح. **س: أخطأت في وضع العُقد. هل يمكنني التراجع؟** نعم. اضغط **Ctrl+Z**، أو **Cmd+Z** على جهاز Mac، للتراجع عن الإجراء الأخير، أو اختر زر **تراجع** في شريط الأدوات. يمكنك أيضًا فتح سجل الإصدارات من زر **حفظ** والعودة إلى إصدار محفوظ سابق. **س: هل يمكنني تغيير اسم سير العمل بعد إنشائه؟** نعم. انقر نقرًا مزدوجًا على عنوان سير العمل في وسط شريط الأدوات، وعدّله مباشرة، ثم احفظ سير العمل. **س: لا أرى عقدة برنامج Python النصي في الشريط الجانبي. هل هي مفقودة؟** لا تظهر عقدة برنامج Python النصي إلا للمستخدمين ذوي دور المسؤول. هذا مقصود لأنها عقدة متقدمة ومقيدة بالمسؤولين. **س: كيف أشغّل سير العمل لاختباره؟** اختر **تشغيل سير العمل** من شريط الأدوات، ثم استخدم **التطبيقات ← سير العمل ← كل المثيلات** لمتابعة المثيل الناتج. راجع [تشغيل سير العمل ومراقبته](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/). **س: هل يبدأ سير العمل فور حفظه؟** لا. يحفظ الإجراء التصميم فقط. يجب أن تبدأه صراحة بالنقر على تشغيل، أو إعداد جدول، أو ضبط مشغّل webhook حتى يبدأ التنفيذ. ## أدلة ذات صلة - [شاشة إدارة عمليات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) — تصفح عمليات سير العمل والبحث فيها ونسخها وحذفها - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) — مرجع كامل للوحة وشريط الأدوات والشبكة واختصارات لوحة المفاتيح - [سجل الإصدارات والحفظ التلقائي](https://raptix.app/user-guide/ar/10-workflows/10-19-version-history-autosave/) — تعرّف على كيفية حماية تغييراتك - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) — كيفية بدء سير العمل واختباره - [مرجع العقد — مشغّلات البدء](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) — ضبط عقدة البدء بالتفصيل - [تصميم خطوات المهام](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) — شرح معمق لخيارات عقدة المهمة - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/ # إدارة عمليات سير العمل في منشئ التدفق > **الوحدة:** التطبيقات ← منشئ التدفق > > **الجمهور:** مصممو عمليات سير العمل ومشغلوها > > **الوصول المطلوب:** صلاحية الوصول إلى منشئ التدفق > > **ستتعلم:** كيفية تصفح عمليات سير العمل حسب مساحة العمل والتطبيق، والبحث في مكتبة عمليات سير العمل الكاملة وتصفيتها، وفهم كل صف، واستخدام العرض والتحرير والنسخ والحذف وإنشاء سير عمل جديد وقاعدة بيانات سير العمل. ## ما الذي تتحكم فيه إدارة عمليات سير العمل؟ إدارة عمليات سير العمل هي مكتبة تصاميم سير العمل المحفوظة، ومسارها `/workflow-management`. تنظم الشاشة الحالية عمليات سير العمل وفق التسلسل التالي: `مساحة العمل ← التطبيق ← مجموعة الصفحة (إن وجدت) ← سير العمل` وهي تختلف عن منطقة **سير العمل** ضمن التطبيقات، التي تعرض المثيلات قيد التشغيل و**مهامي**. استخدم إدارة عمليات سير العمل عندما تحتاج إلى إنشاء تصميم سير عمل أو تغييره، واستخدم لوحة معلومات سير العمل عندما تحتاج إلى متابعة عملية قيد التشغيل أو اتخاذ إجراء فيها. ## فتح إدارة عمليات سير العمل 1. افتح **التطبيقات**. 2. اختر **منشئ التدفق** من إجراءات **البناء**. يمكنك أيضًا فتح `/workflow-management` مباشرة بعد عنوان مساحة العمل. إذا لم يظهر منشئ التدفق أو عرض المسار المباشر رسالة **الوصول مقيّد**، فاطلب من المسؤول منحك صلاحية الوصول إليه. ## قراءة رأس الصفحة يعرض الرأس عنوان **إدارة عمليات سير العمل** والأعداد الحالية لكل من: - **مساحات العمل** التي تحتوي على عمليات سير عمل مصنفة؛ - **التطبيقات** التي تحتوي على عمليات سير عمل مصنفة؛ - **عمليات سير العمل** التي أعادتها المكتبة. يظهر إجراءان في الجهة اليمنى: | الإجراء | الغرض | |---|---| | **قاعدة بيانات سير العمل** | تفتح السجلات التشغيلية لسير العمل، مثل المثيلات والمهام والإجراءات والإشعارات والخطوات وقوالب الاتصال والتذكيرات. | | **سير عمل جديد** | يفتح `/workflow-metadata?mode=create` لاختيار الوجهة وإنشاء تصميم سير عمل. | ## التصفح حسب مساحة العمل والتطبيق ### مساحات العمل يعرض المستوى الأول بطاقة لكل مساحة عمل. تُظهر البطاقة عدد عمليات سير العمل والتطبيقات، وإجراء **عرض التطبيقات**. اختر مساحة عمل لفتح تطبيقاتها. استخدم مسار التنقل أعلى شريط الأدوات للعودة إلى **مساحات العمل**. ### التطبيقات تعرض بطاقة كل تطبيق عدد عمليات سير العمل التي يحتويها. اختر **عرض عمليات سير العمل** لفتح القائمة. قد تظهر بطاقة **غير مسند** عندما يكون لسير العمل مساحة عمل من دون تطبيق. تحمل البطاقة تسمية **مستوى مساحة العمل**. لا يمكن إنشاء سير عمل جديد من دون اختيار مساحة عمل وتطبيق معًا، لذا استخدم هذه المجموعة أساسًا لتحديد السجلات الأقدم التي تحتاج إلى معالجة. ### عمليات سير العمل غير المصنفة تظهر بطاقة **غير مصنف** في نهاية قائمة مساحات العمل عندما لا تكون للسجلات الأقدم مساحة عمل. تعرض البطاقة **لم تُحدد مساحة عمل** وتفتح تلك العمليات في قائمة واحدة. إذا كانت كل عمليات سير العمل المحفوظة غير مصنفة، تتجاوز إدارة عمليات سير العمل بطاقات المساحات وتعرض القائمة المسطحة مع توضيح. ### مجموعات الصفحات بعد فتح تطبيق، قد تُجمع عمليات سير العمل تحت عناوين صفحات عندما تحتوي السجلات الحالية على معلومات الصفحة. تبقى العمليات التي لا ترتبط بصفحة ضمن مجموعة مستوى التطبيق. لا تطلب شاشة الإنشاء تحديد صفحة. تنتمي تصاميم سير العمل الجديدة إلى التطبيق المختار. ### رابط الموقع القابل للمشاركة ينعكس اختيار مساحة العمل والتطبيق في العنوان باستخدام معاملي الاستعلام `ws` و`app`. انسخ عنوان المتصفح الحالي عندما يحتاج مستخدم مخوّل آخر إلى فتح الموقع نفسه. ## البحث في جميع عمليات سير العمل 1. اختر **البحث في جميع عمليات سير العمل بالاسم…**، أو اضغط `/` عندما لا تكون بصدد الكتابة في حقل آخر. 2. أدخل جزءًا من اسم سير العمل أو وصفه. 3. راجع النتائج ومسار مساحة العمل والتطبيق والصفحة لكل منها. يجري البحث في مكتبة عمليات سير العمل كلها، وليس فقط في مساحة العمل أو التطبيق المفتوح حاليًا. يتغير مسار التنقل إلى **البحث في جميع عمليات سير العمل عن…**، ويتحدث عدد النتائج. اختر **مسح**، أو علامة X داخل حقل البحث، أو **مسح عوامل التصفية** للعودة إلى التسلسل المعتاد. ## تصفية عمليات سير العمل وفرزها تظهر عوامل التصفية في قائمة سير العمل، أو البحث العام، أو عندما تكون جميع السجلات غير مصنفة. | عنصر التحكم | الخيارات | الأثر | |---|---|---| | **كل الحالات** | كل الحالات، نشط، غير نشط | يقصر عمليات سير العمل الظاهرة على حالة تمكينها الحالية. | | الفرز | الأحدث تحديثًا، الاسم (أ–ي)، الاسم (ي–أ) | يغيّر ترتيب النتائج الظاهرة. | **مسودة** ليست خيار تصفية حاليًا. تستقبل إدارة عمليات سير العمل عادة حالة **نشط** أو **غير نشط** من حالة تمكين سير العمل. ## فهم صف سير العمل يمكن أن يعرض كل صف ما يلي: | العنصر | المعنى | |---|---| | اسم سير العمل | الاسم الفريد للتصميم المحفوظ. يؤدي اختيار الصف الأساسي إلى فتحه في وضع العرض ضمن علامة تبويب جديدة. | | الوصف | الوصف الاختياري. أما نتائج البحث فتعرض المسار الكامل لمساحة العمل والتطبيق والصفحة. | | وسم الصفحة | اسم الصفحة المحفوظ عندما يحتوي السجل الحالي عليه. | | عدد المزامنة التلقائية المرتبطة | عدد قواعد المزامنة التلقائية للمعرفة الظاهرة والمرتبطة بسير العمل. اختره لفتح قواعد المزامنة التلقائية. | | الحالة | **نشط** أو **غير نشط**. | | الإصدار | إصدار سير العمل المحفوظ، ويظهر على الشاشات الأكبر. | | تاريخ التحديث | وقت آخر تحديث محفوظ، ويظهر على الشاشات الأكبر. | | تحرير | يفتح منشئ التدفق في وضع التحرير. | | نسخ | يفتح شاشة البيانات الحالية مع اسم السجل الأصلي ووصفه ولوحته وقد أُعدّت كنسخة. | | حذف | يفتح رسالة تأكيد الحذف النهائي. | قد تُخفى معلومات الإصدار أو التاريخ أو مؤشر المزامنة التلقائية على الشاشات الصغيرة كي تبقى الإجراءات سهلة الاستخدام. ## إنشاء سير عمل في الوجهة الصحيحة يؤثر الموقع الذي تختار منه **سير عمل جديد** في القيم الأولية لنموذج البيانات: - عند البدء من مستوى مساحة العمل، تكون تلك المساحة محددة مسبقًا. - عند البدء من قائمة عمليات سير عمل أحد التطبيقات، تكون مساحة العمل والتطبيق محددين مسبقًا. - عند البدء من المستوى الجذر، تختار الحقلين بنفسك. أكمل **مساحة العمل** و**التطبيق** و**اسم سير العمل** و**الوصف** الاختياري، ثم اختر **المتابعة إلى المصمم**. لا تحتوي شاشة البيانات على حقلي الإصدار أو الحالة، ولا تستخدم زر **حفظ** عامًا. راجع [إنشاء سير عمل أو نسخه](https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/) للاطلاع على الإجراء الكامل وقواعد التحقق. ## عرض سير العمل أو تحريره - اختر الصف الأساسي لسير العمل لفتحه في وضع **العرض** ضمن علامة تبويب جديدة. - اختر إجراء القلم لفتح سير العمل نفسه في وضع **التحرير**. وضع العرض مخصص لمعاينة اللوحة. لا تستخدم التحرير إلا عندما تكون مخوّلًا بتغيير التصميم وحفظه. ## نسخ سير العمل 1. حدد سير العمل المصدر. 2. اختر **نسخ سير العمل هذا**. 3. انتظر حتى تقترح شاشة البيانات اسمًا ينتهي بعبارة **(نسخة)**. 4. اختر مساحة العمل والتطبيق الوجهة. 5. استخدم اسمًا فريدًا واختر **المتابعة إلى المصمم**. 6. راجع اللوحة المنسوخة والمشغّلات والمسند إليهم والمستلمين وبيانات الاعتماد والروابط قبل تمكينها أو تشغيلها. تصبح النسخة سير عمل مستقلًا. لا تؤدي التعديلات اللاحقة عليها إلى تحديث المصدر. ## حذف سير العمل 1. اختر **حذف سير العمل هذا** في الصف الصحيح. 2. تحقق من الاسم في مربع حوار **حذف سير العمل**. 3. اقرأ التنبيه **لا يمكن التراجع عن هذا الإجراء**. 4. اختر **حذف سير العمل**. يؤدي الحذف إلى إزالة تصميم سير العمل وإعداداته المحفوظة نهائيًا. يؤدي اختيار **إلغاء** أو الضغط على Escape أو النقر خارج مربع الحوار إلى إغلاقه من دون حذف. قبل الحذف: - تحقق مما إذا كان أحد لا يزال يشغّل سير العمل أو يتولى صيانته؛ - راجع عدد قواعد المزامنة التلقائية المرتبطة وافتحها عند الحاجة؛ - انسخ سير العمل أولًا إذا كنت تحتاج إلى نسخة قابلة لإعادة الاستخدام؛ - استخدم قاعدة بيانات سير العمل للتحقق من السجلات التشغيلية على نحو مستقل. إذا فشل الحذف، يعرض مربع الحوار أو الصفحة الخطأ. احتفظ باسم سير العمل وحاول مرة أخرى بعد التحقق من الاتصال. ## حالات الفراغ والأخطاء | الحالة | ما يجب فعله | |---|---| | **لا توجد عمليات سير عمل بعد** | اختر **إنشاء أول سير عمل لك**. | | **لا توجد عمليات سير عمل تطابق بحثك** | غيّر نص البحث أو اختر **مسح عوامل التصفية**. | | **لا توجد عمليات سير عمل تطابق عوامل التصفية** | اختر حالة أخرى أو امسح عوامل التصفية. | | **تعذر تحميل عمليات سير العمل** | تحقق من الاتصال واختر **إعادة المحاولة**. | | يظهر سير عمل ضمن **غير مصنف** أو **غير مسند** | عامله كسجل قديم لم يكتمل نطاق مساحة العمل أو التطبيق فيه. | | لا تظهر قاعدة مزامنة تلقائية مرتبطة | لا يرى غير المسؤولين إلا القواعد المرتبطة المتاحة لحساباتهم. | ## أدلة ذات صلة - [إنشاء سير عمل أو نسخه](https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [استخدام سير العمل: كل المثيلات ومهامي](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/ # إنشاء سير عمل أو نسخه > **الوحدة:** التطبيقات ← منشئ التدفقات > > **الجمهور:** مصممو سير العمل > > **الوصول المطلوب:** صلاحية منشئ التدفقات والوصول إلى مساحة العمل والتطبيق الوجهة > > **ستتعلم:** كيف تختار موضع سير العمل، وتنشئ بياناته الوصفية، وتتجنب تكرار الاسم، وتنسخ سير عمل قائمًا، وتفهم حالته، وتتابع إلى المصمم المرئي. ## قبل أن تبدأ - تستخدم شاشة الإنشاء المسار `/workflow-metadata?mode=create`. ويمكن إضافة قيم استعلام مساحة العمل والتطبيق والنسخ تلقائيًا عند فتحها من إدارة سير العمل. - حدّد **مساحة العمل (Workspace)** و**التطبيق (Application)** اللذين يملكان سير العمل. - اختر اسمًا فريدًا يتراوح طوله بين 3 و100 حرف. - جهّز وصفًا قصيرًا لما تفعله العملية وموعد تشغيلها. الوصف اختياري ويمكن أن يصل إلى 500 حرف. - تحتاج إلى صلاحية منشئ التدفقات. إذا لم يتوفر **سير عمل جديد (New Workflow)** أو **نسخ (Duplicate)**، فاطلب من المشرف مراجعة وصولك إلى الصفحة. ## إنشاء سير عمل 1. افتح **التطبيقات (Applications)**. 2. اختر **سير العمل (Workflow)**. 3. افتح مساحة العمل والتطبيق المناسبين إذا أردت تحديد الوجهة مسبقًا. 4. اختر **سير عمل جديد (New Workflow)**. تُفتح صفحة **إنشاء سير عمل (Create a workflow)**. تلخّص اللوحة اليسرى الوجهة المحددة وتوضح أن المصمم المرئي هو الخطوة التالية. ## اختيار الوجهة 1. اختر **مساحة عمل (Workspace)**. 2. اختر **تطبيقًا (Application)** داخل مساحة العمل تلك. كلا الاختيارين مطلوب. يؤدي اختيار مساحة عمل مختلفة إلى مسح التطبيق السابق حتى تتمكن من اختيار تطبيق من مساحة العمل الجديدة. تنتمي مسارات سير العمل إلى تطبيق. لا تُحدد صفحة في هذه الشاشة؛ فالصفحات تبقى أسطحًا منفصلة داخل التطبيقات. ## إدخال البيانات الوصفية لسير العمل 1. أدخل **اسم سير العمل (Workflow name)**. 2. أدخل **وصفًا (Description)** اختياريًا. 3. راجع ملخص الوجهة في الجهة اليسرى. يتحقق النموذج من الأسماء قبل الحفظ: | التحقق | المتطلب | |---|---| | مطلوب | يجب أن يكون لسير العمل اسم. | | الحد الأدنى للطول | 3 أحرف على الأقل. | | الحد الأقصى للطول | لا يزيد على 100 حرف. | | التفرد | لا يمكن لسير عمل آخر استخدام الاسم نفسه. لا تراعي مطابقة الأسماء حالة الأحرف اللاتينية. | | الوصف | اختياري، حتى 500 حرف. | تعني علامة الاختيار الخضراء بجوار الاسم أن القيمة الحالية اجتازت التحقق الظاهر. ## فهم حالة سير العمل لا تحتوي صفحة البيانات الوصفية على محدد حالة. بعد الإنشاء، تعرض إدارة سير العمل حالة **نشط (Active)** أو **غير نشط (Inactive)** الحالية والمشتقة من حالة تمكين سير العمل. لا يعني إنشاء البيانات الوصفية وفتح المصمم أن سير العمل قد شُغّل. صمّم خطواته واحفظها، ثم مكّنه أو شغّله باستخدام عناصر التحكم المتاحة في إدارة سير العمل أو المصمم. ## المتابعة إلى منشئ التدفقات 1. اختر **متابعة إلى المصمم (Continue to Designer)**. 2. انتظر ظهور **تم إنشاء سير العمل (Workflow created)**. 3. اختر **متابعة (Continue)** إذا لم تبدأ إعادة التوجيه تلقائيًا. يفتح منشئ التدفقات في وضع التحرير مستخدمًا اسم سير العمل الجديد. تكون اللوحة الأولية فارغة إلى أن تضيف الخطوات أو تولّدها. إذا ظهر **فشل الحفظ (Save failed)**، فاختر **إعادة المحاولة (Try Again)** بعد تصحيح المشكلة المبلغ عنها. يعيدك اختيار **إلغاء (Cancel)** إلى إدارة سير العمل من دون إنشاء سير العمل. ## نسخ سير عمل قائم ينشئ النسخ سير عمل مستقلًا يحتوي على نسخة من لوحة سير العمل الأصلية. 1. افتح **التطبيقات ← منشئ التدفقات** واعثر على سير العمل. 2. افتح إجراءاته واختر **نسخ (Duplicate)**. 3. تحمّل صفحة الإنشاء البيانات الوصفية الأصلية وتقترح اسمًا ينتهي بـ **(Copy)**. 4. اختر مساحة العمل والتطبيق الوجهة. 5. غيّر الاسم إذا تعارض مع سير عمل قائم. 6. راجع الوصف أو عدّله. 7. اختر **متابعة إلى المصمم**. يحصل سير العمل الجديد على سجل واسم مستقلين. لا تغيّر التعديلات التي تُجرى على النسخة الأصل. افتح النسخة في منشئ التدفقات وراجع إعدادات المُشغّل والمكلّفين والمستلمين وبيانات الاعتماد والروابط الخارجية قبل تمكينها. ## حل أخطاء الاسم المكرر تحمّل الصفحة أسماء مسارات سير العمل القائمة وتحذّر عندما يكون الاسم الجديد مستخدمًا بالفعل. وإذا أنشأ مستخدم آخر الاسم نفسه قبل حفظك، فقد يرفضه الخادم أيضًا. اختر اسمًا يوضح غرض النسخة، مثل: - `اعتماد المشتريات — إقليمي` - `تهيئة الموظفين — المتعاقدون` - `مراجعة الفواتير — 2026` لا تعتمد على إضافة مسافات أو تغيير حالة الأحرف فقط؛ إذ تُقارن الأسماء من دون اعتبار لاختلاف حالة الأحرف اللاتينية. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | زر **متابعة إلى المصمم** معطّل | اختر مساحة عمل وتطبيقًا، وأدخل اسمًا لسير العمل. | | تظهر رسالة اسم مكرر | أدخل اسمًا فريدًا. | | التطبيق المتوقع مفقود | تأكد من اختيار مساحة العمل الصحيحة ومن امتلاكك صلاحية الوصول إلى التطبيق. | | لوحة سير العمل المنسوخة فارغة | ارجع إلى إدارة سير العمل وانسخ سير العمل الأصلي مرة أخرى. إذا استمرت المشكلة، فتواصل مع الدعم واذكر اسمي سير العمل. | | يظهر **فشل الحفظ** | اقرأ الرسالة المعروضة، وصحح البيانات الوصفية، ثم اختر **إعادة المحاولة**. | | لا تجد سير العمل الجديد | ارجع إلى التطبيقات ← منشئ التدفقات، وافتح مساحة العمل والتطبيق المحددين، وامسح أي بحث أو عوامل تصفية للحالة. | ## أدلة ذات صلة - [شاشة إدارة سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [سجل الإصدارات والحفظ التلقائي](https://raptix.app/user-guide/ar/10-workflows/10-19-version-history-autosave/) - [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/ # منشئ التدفق: اللوحة وشريط الأدوات ولوحة العُقد > **الوحدة:** التطبيقات ← منشئ التدفق > > **الجمهور:** مصممو عمليات سير العمل > > **ستتعلم:** كيفية استخدام اللوحة الحالية، وجميع عناصر التحكم الظاهرة في شريط الأدوات، ولوحتي العُقد الأساسية والمنطقية، والمتغيرات، وأدوات التخطيط. ## فتح المصمم افتح **التطبيقات ← منشئ التدفق**، وحدد سير عمل، ثم اختر صفه الأساسي لوضع العرض أو إجراء القلم لوضع التحرير. يفتح **سير عمل جديد** صفحة البيانات أولًا ثم ينتقل إلى منشئ التدفق. وضع العرض للقراءة فقط. يسمح لك وضع التحرير بإضافة العُقد وربطها وضبطها ونقلها وإزالتها. ## العمل على اللوحة - اسحب عقدة من **عناصر سير العمل** إلى اللوحة. - اختر عقدة لفتح إعداداتها عندما تدعم تلك العقدة إعدادات قابلة للضبط. - اسحب من مقبض إخراج إلى مقبض إدخال عقدة أخرى لإنشاء اتصال. - حدد عقدة أو اتصالًا واضغط Delete أو Backspace لإزالته. - اسحب مساحة فارغة من اللوحة لتحريكها، واستخدم عجلة الفأرة أو شريط الأدوات للتكبير والتصغير. - استخدم Shift مع النقر أو ارسم مربع تحديد لاختيار عدة عناصر. - تطلب منك العُقد متعددة النتائج تحديد النتيجة التي يمثلها الاتصال الجديد. احفظ بعد ضبط العُقد وقبل تشغيل سير العمل. ## لوحة العُقد الحالية تحتوي اللوحة على العُقد التالية الظاهرة للمستخدم تحديدًا. ### أساسي | العقدة | الغرض الظاهر | التوفر | |---|---|---| | **بدء** | اختيار كيفية بدء سير العمل. | قياسية | | **مشغّل البريد الإلكتروني** | البدء عند ورود رسالة مطابقة أو انتظارها في منتصف سير العمل. | قياسية | | **بريد إلكتروني** | إرسال الإشعارات. | قياسية | | **مهمة** | إسناد بنود عمل وتحصيل إجراء. | قياسية | | **برنامج Python النصي** | تشغيل كود Python مع إدخال ملفات وإخراجها. | للمسؤولين فقط | | **وكيل الذكاء الاصطناعي** | تشغيل خطوة مدعومة بالذكاء الاصطناعي. | قياسية | | **المستندات** | جلب المستندات أو حفظها. | قياسية | | **التقرير** | تعبئة قالب Word أو إنشاء تقرير يكتبه الذكاء الاصطناعي. | قياسية | | **استعلام قاعدة البيانات** | الاستعلام عن بيانات منشئ التطبيقات أو قاعدة بيانات سير العمل. | Enterprise | | **لكل عنصر** | تكرار الخطوات على قائمة من العناصر. | Enterprise | | **مجدول التذكير** | إرسال تذكيرات بالبريد الإلكتروني بناءً على التاريخ. | Enterprise | ### منطق | العقدة | الغرض الظاهر | |---|---| | **شرط إذا/وإلا** | التوجيه إلى نعم أو لا بناءً على شرط واحد. | | **الفرع الشرطي** | الاختيار بين عدة مسارات مشروطة. | | **إيقاف مؤقت** | تعليق سير العمل للمدة المحددة. | | **تقسيم الفروع** | بدء مسارات متوازية. | | **دمج الفروع** | إعادة جمع المسارات المتوازية باستخدام الكل أو أي منها أو العدد. | | **حلقة** | العودة إلى خطوة سابقة لإعادة المحاولة أو المراجعة. | | **نهاية** | إنهاء فرع من سير العمل. | ## عناصر التحكم في شريط الأدوات ### عناصر الملفات والتحرير | عنصر التحكم | الاختصار | النتيجة | |---|---|---| | **حفظ سير العمل** | Ctrl/Cmd+S | حفظ اللوحة. | | **تصدير سير العمل** | Ctrl/Cmd+E | تنزيل التصميم بصيغة JSON. | | **استيراد سير العمل** | — | تحميل ملف JSON لسير عمل إلى اللوحة. راجعه قبل الحفظ لأنه قد يستبدل التصميم الحالي. | | **إدارة عمليات سير العمل المحفوظة** | — | العودة إلى إدارة عمليات سير العمل. | | **التراجع إلى الإصدار السابق** | Ctrl/Cmd+Z | الرجوع خطوة واحدة ضمن التغيير أو الإصدار المتاح. | | **الإعادة إلى الإصدار التالي** | Ctrl/Cmd+Shift+Z | إعادة تطبيق التغيير أو الإصدار التالي المتاح. | | **نسخ العناصر المحددة** | Ctrl/Cmd+C | نسخ العُقد المحددة حاليًا. | | **ترتيب التخطيط تلقائيًا** | Ctrl/Cmd+L | ترتيب الرسم الكامل. | | **تخطيط أفقي/رأسي** | — | تحديد الاتجاه الذي يستخدمه الترتيب التلقائي. | يظهر اسم سير العمل في الوسط. انقر عليه نقرًا مزدوجًا لتحريره، واضغط Enter لقبول التعديل أو Escape لإلغائه. تعني عبارة **غير محفوظ** أن اللوحة تختلف عن آخر إصدار محفوظ. ### العرض والتنفيذ واللوحات | عنصر التحكم | الاختصار | النتيجة | |---|---|---| | **تصغير** | Ctrl/Cmd+- | خفض نسبة التكبير. | | **ملاءمة للعرض** | Ctrl/Cmd+0 | إظهار جميع العُقد ضمن مساحة العرض. | | **تكبير** | Ctrl/Cmd++ | رفع نسبة التكبير. | | **تبديل الشبكة** | Ctrl/Cmd+G | إظهار شبكة النقاط أو إخفاؤها. | | **تبديل الخريطة المصغرة** | Ctrl/Cmd+M | إظهار نظرة عامة على اللوحة أو إخفاؤها. | | **نشط/غير نشط** | — | تغيير إمكانية تشغيل سير عمل محفوظ. يُخفى هذا العنصر لسير العمل الذي لم يُحفظ بعد. | | **تشغيل سير العمل** | Ctrl/Cmd+R | بدء تشغيل يدوي عندما يسمح التصميم والمشغّل بذلك. | | **إعادة ضبط سير العمل** | — | إعادة اللوحة إلى آخر حالة محفوظة والتخلص من التغييرات غير المحفوظة. | | **مسح جميع العناصر** | — | إزالة كل العُقد والاتصالات من اللوحة. | | **لوحة المتغيرات** | Ctrl+Shift+V | فتح قيم سير العمل المتاحة أو إغلاقها. | | **منشئ الذكاء الاصطناعي** | — | بناء سير العمل أو تعديله من خلال اقتراح محادثة يخضع للمراجعة. | | **الوضع الفاتح/الداكن** | Ctrl/Cmd+D | تغيير سمة المصمم. | تتعطل إجراءات شريط الأدوات التي تغيّر سير العمل في وضع العرض. ## لوحة المتغيرات افتح **لوحة المتغيرات** لاستعراض القيم التي تنتجها عقدة البدء والعُقد السابقة. تُجمع المتغيرات حسب المصدر. اختر قيمة لنسخ رمزها `{{variable_name}}`، ثم الصقه في حقل يقبل متغيرات سير العمل، مثل موضوع البريد الإلكتروني أو وصف المهمة أو الشرط أو الاستعلام أو التقرير. استخدم فقط المتغيرات المتاحة قبل العقدة التي تستهلكها. لا تتوفر في موضع سابق قيمة تنتجها عقدة لاحقة في الرسم. ## الشبكة والخريطة المصغرة والتخطيط - الشبكة وسيلة بصرية للمحاذاة. - تعرض الخريطة المصغرة الرسم كاملًا، وتفيد في اللوحات الكبيرة. - **ملاءمة للعرض** هي أسرع وسيلة لاستعادة الرسم عندما يصبح خارج الشاشة. - يطبق **ترتيب التخطيط تلقائيًا** الاتجاه الأفقي أو الرأسي المحدد على الرسم كله. ## قائمة تحقق للتحرير الآمن 1. امنح كل عقدة مهمة تسمية وصفية. 2. صِل كل نتيجة مطلوبة، وليس المسار الافتراضي فقط. 3. تأكد من أن كل فرع يعود إلى المسار بصورة صحيحة أو يصل إلى **نهاية**. 4. افتح لوحة المتغيرات وتحقق من الأسماء المستخدمة في الحقول اللاحقة. 5. احفظ، وتحقق من حالة **نشط/غير نشط**، ثم نفّذ اختبارًا مضبوطًا. 6. افتح **التطبيقات ← سير العمل ← كل المثيلات** للتأكد من النتيجة. ## أدلة ذات صلة - [كتالوج العُقد الحالية](https://raptix.app/user-guide/ar/10-workflows/10-34-current-node-catalogue/) - [منشئ الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-30-ai-builder/) - [مشغّلات البدء](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) - [المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [سجل الإصدارات والحفظ التلقائي](https://raptix.app/user-guide/ar/10-workflows/10-19-version-history-autosave/) - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/ # عقدة البدء: أنواع المشغّلات الحالية > **الوحدة:** منشئ التدفق ← بدء > > **الجمهور:** مصممو عمليات سير العمل > > **ستتعلم:** خيارات المشغّلات الخمسة الظاهرة حاليًا في عقدة البدء، والوقت المناسب لاستخدام كل منها. ## اختيار المشغّل أضف عقدة **بدء** أو اخترها، ثم حدد **ما الذي يشغّل سير العمل هذا؟**. تحتوي شاشة الاختيار الحالية على الخيارات التالية تحديدًا: 1. **تشغيل يدوي** (`Trigger Manually`) 2. **عند استدعاء Webhook** (`On Webhook Call`) 3. **مشغّل مجدول** (`Schedule Trigger`) 4. **عند استلام بريد إلكتروني** (`On Email Received`) 5. **تكامل Appsmith عبر HTTP** (`Appsmith Integration (HTTP)`) مشغّلا **عند استدعاء Webhook** و**تكامل Appsmith عبر HTTP** متاحان في باقة Enterprise. ينبغي أن يكون لسير العمل إعداد دخول واحد. احفظ خصائص عقدة البدء ثم احفظ سير العمل. ## التشغيل اليدوي استخدم هذا الخيار عندما ينبغي لشخص فتح نموذج سير عمل وإرساله، أو عندما ينبغي لمصمم مخوّل بدء سير العمل من منشئ التدفق. يدعم إعداد النموذج اليدوي الحقول و**ترتيب عرضها**، تليها عناصر النشر: - **من يمكنه فتح هذا النموذج؟** — اختر الوصول العام أو الوصول للمستخدمين المسجلين/الخاص وفق الخيار المتاح. - **اسم التطبيق** و**رابط الشعار** و**لون التمييز** — تتحكم في هوية النموذج المنشور. - **رسالة النجاح** — النص الذي يظهر بعد الإرسال الناجح. - **عنوان إعادة التوجيه (اختياري)** — الوجهة التي يفتحها النظام بعد النجاح. - **رابط المشاركة** — يُنشأ أو يُحدّث عند حفظ خصائص البدء؛ لا تنسخه إلا بعد مراجعة الوصول. اختر **حفظ خصائص البدء**. إذا كان النموذج خاصًا، فلا ترسل رابطه إلا للمستخدمين المسجلين والمخوّلين. ## عند استدعاء Webhook استخدم هذا الخيار عندما ينبغي لخدمة خارجية بدء سير العمل بطلب HTTP. 1. اختر **عند استدعاء Webhook**. 2. اضبط نقطة النهاية وخيارات المصادقة ومحتوى الطلب الظاهرة في اللوحة. 3. انسخ نقطة النهاية التي تنشئها الواجهة بدلًا من كتابتها من الذاكرة. 4. احفظ خصائص عقدة البدء وسير العمل. 5. أرسل طلب اختبار مضبوطًا، ثم تحقق من المثيل في **كل المثيلات**. عامل عناوين نقاط النهاية والرموز ومفاتيح API وأمثلة المحتوى كبيانات اعتماد للتكامل. نقطة النهاية الحالية التي يعرضها المنتج هي المرجع المعتمد. ## المشغّل المجدول استخدم هذا الخيار عندما ينبغي للمنصة إنشاء المثيلات تلقائيًا. اضبط **إعدادات الجدولة** للتوقيت، و**التحكم في التنفيذ** لحدود التشغيل المتاحة أو سلوك التزامن. تحقق من المنطقة الزمنية قبل الحفظ. يجب حفظ سير العمل وضبطه على «نشط» حتى تبدأ عمليات التنفيذ المستقبلية. بعد أول وقت متوقع، تأكد من ظهور صف جديد في **التطبيقات ← سير العمل ← كل المثيلات**. ## عند استلام بريد إلكتروني استخدم هذا الخيار عندما ينبغي لرسالة واردة أن تبدأ سير العمل. يؤدي اختياره إلى فتح إعدادات مشغّل البريد الإلكتروني نفسها التي تستخدمها عقدة **مشغّل البريد الإلكتروني** المستقلة. اضبط صندوق البريد وقواعد المرسل والموضوع ومتطلبات المرفقات وأي خيارات إضافية متاحة لحسابك ضمن عوامل التصفية والمؤسسة والجدولة وحدود المعدل والاختبار. احفظ سير العمل قبل بدء الاشتراك. راجع [مشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/). ## تكامل Appsmith عبر HTTP هذه هي التسمية الحالية الظاهرة في منشئ التدفق لتكامل HTTP مع صفحة في منشئ التطبيقات. اتبع الإرشادات داخل اللوحة لربط إجراء الصفحة بنقطة نهاية سير العمل وضبط الطلب المتوقع. احتفظ بتسمية **تكامل Appsmith عبر HTTP** (`Appsmith Integration (HTTP)`) في التعليمات ما دامت هي التسمية الظاهرة في المنتج. هذا الخيار ليس عقدة مستقلة في سير العمل؛ بل هو مشغّل لعقدة البدء. ## ملخص توفر المشغّلات | المشغّل | مصدر البدء | إجراء المستخدم المعتاد | |---|---|---| | **تشغيل يدوي** | نموذج منشور أو عنصر تشغيل لدى المصمم | فتح النموذج وتعبئته وإرساله | | **عند استدعاء Webhook** | طلب HTTP خارجي | يرسل التكامل طلبًا | | **مشغّل مجدول** | جدول محفوظ | لا يلزم إجراء وقت التشغيل | | **عند استلام بريد إلكتروني** | رسالة مطابقة في صندوق البريد | إرسال رسالة مطابقة أو استلامها | | **تكامل Appsmith عبر HTTP** | صفحة متصلة في منشئ التطبيقات | استخدام إجراء الصفحة المضبوط | ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | لا يبدأ سير العمل | تأكد من حفظه ومن أن حالته «نشط»، ثم تحقق من المشغّل المحدد. | | لا يمكن فتح نموذج يدوي | تحقق من الوصول العام/الخاص وحدّث رابط المشاركة. | | يُرفض طلب webhook | انسخ نقطة النهاية الحالية مجددًا وتحقق من المصادقة ومحتوى الطلب. | | لم يعمل الجدول | تحقق من التوقيت والمنطقة الزمنية وعناصر التحكم في التنفيذ والحالة المحفوظة وحالة «نشط». | | لا يبدأ سير العمل بالبريد الإلكتروني | تحقق من اشتراك صندوق البريد وحالة التشغيل وعوامل التصفية والجدولة وحدود المعدل. | | لا يفعل إجراء منشئ التطبيقات شيئًا | راجع تعليمات التكامل وإعدادات الطلب الظاهرة في عقدة البدء. | ## أدلة ذات صلة - [مشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [مشغّل Webhook](https://raptix.app/user-guide/ar/10-workflows/10-28-webhook-trigger/) - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [التطبيقات: ربط صفحة من منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-28-webhook-trigger/ # مُشغّل Webhook: بدء سير العمل من الأنظمة الخارجية عبر API > **الوحدة:** مسارات سير العمل > > **الجمهور:** المشرفون > > **ستتعلم:** كيف تعدّ مُشغّل Webhook في سير عمل، وتعثر على عنوان نقطة النهاية المولّد وتنسخه، وتعرّف مخطط الحمولة، وتصادق الاستدعاءات، وتختبر الاتصال، وتستخدم البيانات الواردة في العُقد اللاحقة. ## ما هو؟ يمنح **مُشغّل Webhook** في مسارات سير العمل، الذي يحمل اسم **عند استدعاء Webhook (On Webhook Call)** في إعدادات عقدة البداية، كل سير عمل نقطة نهاية HTTP فريدة؛ وهي عنوان URL يستطيع أي نظام خارجي استدعاءه لبدء مثيل جديد. عندما يرسل نظام مخوّل طلب HTTP إلى ذلك العنوان بالبيانات المتوقعة، يبدأ تشغيل جديد فورًا وتتاح البيانات المرسلة كمتغيرات في كل أنحاء العملية. يتيح لك ذلك ربط أنظمة عملك الحالية، مثل منصات ERP وأنظمة الموارد البشرية وأدوات إدارة العقود وبرامج الدعم والبرامج النصية المخصصة وأي برنامج يستطيع إرسال طلب HTTP، بعمليات سير العمل من دون كتابة شفرة تكامل داخل المنصة. ## أهميته وفوائده الرئيسية - **بدء سير العمل من أي نظام يرسل طلبات HTTP.** تستطيع مُشغّلات ERP وأتمتة البريد وأنظمة التذاكر والبرامج النصية المجدولة وتكاملات الأطراف الخارجية بدء عمليات سير العمل باستدعاء عنوان URL، من دون تسجيل الدخول إلى المنصة. - **لكل سير عمل عنوان مخصص مستقل.** لا يوجد مفتاح API مشترك يؤثر في جميع المسارات. كل عنوان Webhook خاص بسير عمل واحد ولا يحمل إلا بيانات تلك العملية. - **تتحول البيانات الواردة فورًا إلى متغيرات سير عمل.** تصبح الحقول التي تعرّفها في مخطط الحمولة متغيرات مسماة متاحة في أوصاف المهام وعُقد البريد والشروط وكل عقدة لاحقة من دون خطوة ربط. - **خيارات مصادقة متعددة.** اختر عدم المصادقة أو Bearer Token أو API Key أو Basic Auth بحسب ما يدعمه نظامك الخارجي. - **أداة اختبار مضمّنة.** أرسل طلب اختبار مباشرة من المصمم من دون مغادرة المتصفح، للتأكد من إمكانية الوصول إلى نقطة النهاية واستلام البيانات بصورة صحيحة. - **تعمل المسارات التي يبدأها Webhook بموثوقية المسارات اليدوية نفسها.** بعد البدء، يستمر المثيل طوال المدة اللازمة، سواء دقائق أو أيامًا أو أسابيع، ويستأنف من النقطة نفسها حتى بعد إعادة تشغيل الخادم، من دون فقد بيانات. ## قبل أن تبدأ - يلزم **دور المشرف** لإعداد مُشغّل Webhook. - يجب **حفظ** سير العمل باسم، لا مجرد فتحه في المصمم، قبل توليد عنوان نقطة النهاية. تعرض المسارات بلا عنوان أو غير المحفوظة عنوانًا نائبًا. - لكي تستدعي الأنظمة الخارجية Webhook، يجب أن تتمكن شبكيًا من الوصول إلى نطاق RAPTIX الخاص بك: `https://.raptix.app`. - لاستخدام Bearer Token أو API Key أو Basic Auth، ستحتاج إلى إنشاء بيانات الاعتماد أو الاتفاق عليها مع الفريق المالك للنظام الخارجي. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — فتح عقدة البداية واختيار مُشغّل Webhook 1. افتح سير العمل في **المصمم المرئي (Visual Designer)** باختيار إجراء القلم في صفه ضمن إدارة سير العمل. 2. انقر نقرًا مزدوجًا على عقدة **البداية (Start)**، ذات رمز التشغيل الذهبي أعلى اللوحة. تفتح لوحة اختيار المُشغّل. 3. انقر **عند استدعاء Webhook (On Webhook Call)** في قائمة أنواع المُشغّلات. تتوسع اللوحة لعرض إعدادات Webhook. --- ### الخطوة 2 — مراجعة عنوان نقطة النهاية ونسخه تُنشأ نقطة النهاية تلقائيًا من اسم سير العمل، وتظهر في حقل **نقطة النهاية (Endpoint)** كقيمة للقراءة فقط. 4. يعرض الحقل مسارًا مثل `/api/v1/dynamic-workflow/http-start/your-workflow-name`. 5. يظهر أسفل الحقل **العنوان الكامل** باللون الأزرق: `https://.raptix.app/api/v1/dynamic-workflow/http-start/your-workflow-name` 6. انقر **نسخ (Copy)**، رمز الحافظة إلى يمين الحقل، لنسخ العنوان الكامل إلى الحافظة. > **مهم:** يتغير عنوان نقطة النهاية إذا تغيّر اسم سير العمل. حدّث كل الأنظمة الخارجية التي تحفظ العنوان كلما أعدت تسمية سير العمل. --- ### الخطوة 3 — إعداد المصادقة 7. اختر من قائمة **المصادقة (Authentication)** المنسدلة طريقة تعريف النظام الخارجي بنفسه: | الخيار | معناه | |---|---| | **بلا مصادقة (None)** | يستطيع أي مستدعٍ بدء سير العمل من دون بيانات اعتماد. استخدمه فقط في الشبكات الداخلية المحمية بجدار ناري أو للتطوير. | | **Bearer Token** | يجب أن يضمّن المستدعي `Authorization: Bearer ` في رأس الطلب. مناسب لمعظم التكاملات الحديثة. | | **API Key** | يجب أن يضمّن المستدعي رأس API Key. يُتفق على اسم المفتاح وقيمته بينك وبين النظام المستدعي. | | **Basic Auth** | يجب أن يضمّن المستدعي `Authorization: Basic ` في الرأس. | 8. اختر الطريقة التي يطابقها نظامك الخارجي. --- ### الخطوة 4 — تحديد طريقة HTTP 9. اختر من قائمة **الطريقة (Method)** المنسدلة طريقة HTTP التي يستخدمها النظام الخارجي لإرسال الطلب: | الطريقة | متى تستخدمها؟ | |---|---| | **POST** | موصى بها لمعظم التكاملات. ترسل البيانات في نص الطلب. | | **GET** | استخدمها فقط عندما يتعذر على المستدعي إرسال نص للطلب، وهو أمر نادر. تأتي البيانات من معاملات الاستعلام فقط. | | **PUT** | مثل POST، لكنها تشير دلاليًا إلى تحديث مورد قائم. | | **DELETE** | نادرًا ما تُستخدم لمُشغّلات سير العمل. | اتركها **POST** لمعظم التكاملات. --- ### الخطوة 5 — تعريف رؤوس مخصصة اختياريًا 10. إذا كان على نظامك الخارجي تضمين رؤوس معينة، مثل رأس `X-Source-System` مخصص للتوجيه أو التدقيق، فانقر **+ إضافة رأس (+ Add Header)**. 11. أدخل **اسم الرأس (Header name)** في الحقل الأول و**قيمة الرأس (Header value)** في الثاني. 12. أضف أي عدد مطلوب من الرؤوس. انقر علامة **X** الحمراء في صف لإزالته. --- ### الخطوة 6 — تعريف الحمولة المتوقعة بمخطط JSON يتيح لك حقل **الحمولة المتوقعة (Expected Payload)** وصف بيانات JSON التي سيرسلها النظام الخارجي. يصبح كل حقل في المستوى الأعلى تعرّفه متغيرًا لسير العمل تستطيع العُقد اللاحقة استخدامه. 13. أدخل في منطقة نص **الحمولة المتوقعة (مخطط JSON)** كائن JSON يصف حقولك بالصورة الآتية: ```json { "employee_id": "string", "department": "string", "request_type": "string", "amount": "number", "description": "string", "submission_date": "date" } ``` الأنواع المدعومة: `string` و`number` و`boolean` و`date` و`array` و`object`. 14. أثناء الكتابة، يكتشف الحقل المخطط وتظهر شارة تقول **تم اكتشاف N من المتغيرات (N variables detected)**. 15. انقر **معاينة المتغيرات (Preview Variables)** لعرض القائمة الكاملة لمتغيرات سير العمل التي سينشئها المخطط. تُسبق أسماء الحقول بـ`httpstart_` لتكوين اسم المتغير: | الحقل في الحمولة | اسم متغير سير العمل | |---|---| | `employee_id` | `{{httpstart_employee_id}}` | | `department` | `{{httpstart_department}}` | | `amount` | `{{httpstart_amount}}` | 16. دوّن أسماء المتغيرات المولّدة؛ فستستخدمها في عُقد أخرى. على سبيل المثال: - في موضوع عقدة بريد: `New request from {{httpstart_employee_id}}` - في وصف عقدة مهمة: `Amount: {{httpstart_amount}}` - في شرط If/Else: `httpstart_amount > 10000` --- ### الخطوة 7 — اختبار نقطة النهاية 17. انقر زر **الاختبار الآن (Test Now)**، وهو الرابط الأخضر في قسم **اختبار نقطة النهاية (Test Endpoint)**. يرسل المصمم طلب `POST` تجريبيًا إلى نقطة النهاية باستخدام مخطط الحمولة الذي عرّفته أو حمولة اختبار افتراضية. 18. تظهر نافذة منبثقة تعرض النتيجة: - **نجح الاختبار (Test Successful)** — استجابة HTTP 200 مع النص، بما فيه معرّف المثيل الجديد. يؤكد ذلك أن نقطة النهاية تعمل وأن سير العمل جاهز. - **فشل الاختبار (Test Failed)** — رمز خطأ HTTP مع رسالة الخطأ. من الأسباب الشائعة أن سير العمل لم يُحفظ بعد، أو أن اسمه فارغ، أو أن حالته غير نشطة. 19. إذا فشل الاختبار، فتحقق من: 1) حفظ سير العمل ووجود اسم له، و2) أن حالته **نشط (Active)** في شاشة إدارة سير العمل، و3) عدم وجود قيد شبكي يمنع استدعاءات API المحلية. --- ### الخطوة 8 — حفظ العنوان ومشاركته 20. انقر **حفظ (Save)** أسفل لوحة الإعدادات. تتحدث عقدة البداية في اللوحة لتعرض رمز كرة أرضية أخضر يشير إلى نشاط مُشغّل Webhook. 21. شارك عنوان نقطة النهاية الكامل وتفاصيل المصادقة مع الفريق المسؤول عن النظام الخارجي، ليدمجها من جهته. 22. بعد إعداد النظام الخارجي، اختبر تشغيلًا متكاملًا وتأكد من ظهور مثيل جديد في **كل المثيلات**. --- ## استخدام بيانات Webhook في العُقد اللاحقة بعد حفظ المُشغّل مع مخطط الحمولة، تتاح المتغيرات في سير العمل كاملًا. لاستخدامها: - في أي حقل نص، اكتب `{{httpstart_` وستكمل لوحة المتغيرات الأسماء المتاحة تلقائيًا. - في **لوحة المتغيرات (Variable Panel)**، التي تفتح برمز المتغير في شريط أدوات المصمم، مرّر للعثور على جميع متغيرات `httpstart_` المدرجة تحت عقدة البداية. - في عُقد **الشرط (Condition)** من نوع If/Else، استخدمها مباشرة في حقول التعبير، مثل: `httpstart_amount` `أكبر من` `10000`. --- ## استدعاء Webhook من أدوات شائعة ### من cURL في سطر الأوامر ```bash curl -X POST \ "https://.raptix.app/api/v1/dynamic-workflow/http-start/your-workflow-name" \ -H "Content-Type: application/json" \ -H "Authorization: ${RAPTIX_WEBHOOK_AUTH:?set the complete authorization value}" \ -d '{"employee_id":"EMP-1042","department":"Engineering","amount":15000}' ``` ### من متصفح باستخدام JavaScript fetch ```javascript const response = await fetch( 'https://.raptix.app/api/v1/dynamic-workflow/http-start/your-workflow-name', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer your-token-here' }, body: JSON.stringify({ employee_id: 'EMP-1042', department: 'Engineering', amount: 15000 }) } ); const result = await response.json(); console.log(result.instance_id); // The new workflow instance ID ``` ### من Postman 1. أنشئ طلب POST جديدًا. 2. اضبط URL على عنوان نقطة النهاية الكامل. 3. أضف تحت **Headers** الرأس `Content-Type: application/json` وأي رأس مصادقة. 4. الصق الحمولة تحت **Body > raw > JSON**. 5. انقر **Send**. تؤكد استجابة 200 التي تتضمن `instance_id` نجاح العملية. --- ## شرح الخيارات والإعدادات | الإعداد | ما يفعله | |---|---| | **الاسم (Name)** | تسمية العرض في عقدة البداية داخل اللوحة. القيمة الافتراضية: `HTTP Request Start`. | | **الوصف (Description)** | ملاحظة اختيارية تظهر في لوحة الخصائص. | | **الطريقة (Method)** | طريقة HTTP التي يجب على المستدعي استخدامها: GET أو POST أو PUT أو DELETE. يُنصح بـPOST. | | **المصادقة (Authentication)** | طريقة الأمان: None أو Bearer Token أو API Key أو Basic Auth. | | **نقطة النهاية (Endpoint)** | مسار URL مولّد تلقائيًا وللقراءة فقط، ويعتمد على اسم سير العمل. ينسخ زر النسخ العنوان الكامل. | | **الرؤوس (Headers)** | رؤوس مطلوبة اختيارية. يحتوي كل صف على حقل للاسم والقيمة. انقر **+ إضافة رأس** للمزيد. | | **الحمولة المتوقعة (مخطط JSON)** | وصف JSON لحقول البيانات الواردة. تصبح أسماء الحقول متغيرات سير عمل مسبوقة بـ`httpstart_`. | | **معاينة المتغيرات (Preview Variables)** | زر لعرض قائمة متغيرات سير العمل المولّدة من مخطط الحمولة. | | **اختبار نقطة النهاية / الاختبار الآن** | يرسل طلب اختبار مباشرًا إلى نقطة النهاية ويعرض الاستجابة. | ## نصائح وأفضل الممارسات - **استخدم أسماء حقول وصفية في مخطط الحمولة.** يكون `httpstart_vendor_invoice_number` أوضح من `httpstart_num` عندما تستخدمه بعد عشر عُقد. - **وثّق مخطط الحمولة خارج المنصة.** شارك مخطط JSON مع الفريق الذي يبني التكامل الخارجي حتى يعرف بدقة ما ينبغي إرساله. - **تحقق من اسم سير العمل قبل مشاركة العنوان.** الاسم جزء من URL، وقد ينتج عن المحارف الخاصة ترميز URL غير متوقع. استخدم أسماء أبجدية رقمية بسيطة مع شرطات. - **لا تترك المصادقة على None في بيئة الإنتاج على خادم متاح للعامة.** استخدم Bearer Token على الأقل لمنع بدء سير العمل من جهات غير مخوّلة. - **اختبر حمولة نموذجية قبل الإطلاق.** استخدم زر **الاختبار الآن** في المصمم أو Postman للتأكد من وصول البيانات بصورة صحيحة وظهور المتغيرات الصحيحة في **كل المثيلات**. - **أبقِ سير العمل نشطًا.** يعيد استدعاء Webhook لسير عمل غير نشط خطأ. تحقق من الحالة النشطة في إدارة سير العمل قبل تسليم العنوان. - **إذا كان لا بد من تغيير اسم سير العمل، فحدّث كل المستدعين في الوقت نفسه.** لا توجد إعادة توجيه للعنوان، وتتوقف العناوين القديمة فورًا. ## الأسئلة الشائعة **س: هل تتطلب نقطة نهاية Webhook حساب مستخدم لاستدعائها؟** لا. صُممت نقطة النهاية لتكون قابلة للاستدعاء العام حتى تستطيع الأنظمة الخارجية استخدامها من دون تسجيل الدخول. توفر المصادقة، مثل Bearer Token أو API Key أو Basic Auth، الأمان بدلًا من ذلك. استخدم المصادقة دائمًا لنقاط نهاية الإنتاج. **س: ما رموز حالة HTTP التي تعيدها نقطة النهاية؟** - `200 OK` — تم إنشاء مثيل سير العمل بنجاح. يحتوي النص على `instance_id` و`status` و`workflow_name`. - `400 Bad Request` — نص الطلب غير صالح أو الحقول المطلوبة مفقودة. - `404 Not Found` — لا يوجد سير عمل نشط بهذا الاسم. - `405 Method Not Allowed` — استُخدمت طريقة HTTP خاطئة. - `429 Too Many Requests` — تم تجاوز حد معدل الطلبات. - `500 Internal Server Error` — حدث خطأ من جهة الخادم. **س: كيف أتعامل مع إخفاق Webhook من جهة النظام المستدعي؟** لا تعيد مسارات سير العمل تلقائيًا محاولة استدعاءات Webhook الفاشلة؛ فالنظام المستدعي مسؤول عن إعادة المحاولة. إذا احتجت إلى منطق إعادة محاولة، فطبّقه من جهة المستدعي. للمراقبة، راجع **كل المثيلات** للتأكد من إنشاء المثيلات كما هو متوقع. **س: هل يمكنني إرسال كائنات JSON متداخلة في الحمولة؟** نعم. تُحلل الكائنات المتداخلة في الحمولة وتتاح كمتغيرات سير عمل أيضًا. إذا عرّفت حقلًا من نوع `object`، فسيُحفظ كمتغير نص JSON. ويمكنك الإشارة إلى قيم متداخلة محددة باستخدام ترميز النقطة في عُقد الشروط، بحسب إمكانات منشئ التعبيرات. **س: ماذا لو احتجت إلى تمرير بيانات ثنائية، مثل الملفات؟** تقبل نقطة نهاية Webhook بيانات JSON فقط. لمسارات سير العمل المبنية على الملفات، استخدم نموذج **التشغيل اليدوي (Trigger Manually)** المنشور بحقوق ملفات، أو اجمع الملفات في عقدة مهمة لاحقة. **س: هل يمكن لأنظمة خارجية عدة استدعاء عنوان Webhook نفسه؟** نعم. ما دام كل مستدعٍ يستخدم العنوان وتنسيق الحمولة والمصادقة الصحيحة، ينشئ كل استدعاء مثيلًا مستقلًا. تنطبق حدود المعدل على جميع المستدعين. **س: هل تُسجّل بيانات الطلب الواردة في مكان ما لأغراض التدقيق؟** نعم. تحتوي علامة **الإجراءات** في قاعدة بيانات سير العمل على سجلات إجراءات سير العمل المحفوظة. وتسمح علامة التبويب الحالية أيضًا للمستخدمين المخوّلين بإضافة تلك السجلات أو تحريرها أو حذفها، لذلك استخدم عملية الاحتفاظ المعتمدة في مؤسستك عند الحاجة إلى دليل غير قابل للتغيير. وتتاح بيانات مثيل سير العمل أيضًا عبر **عرض تفاصيل سير العمل**. ## أدلة ذات صلة - [مُشغّلات البداية](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) — مرجع لكل أنواع عقدة البداية، ومنها مُشغّل Webhook - [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) — نظرة عامة على الطرق الحالية لبدء سير العمل - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) — مراقبة المثيلات التي أنشأتها استدعاءات Webhook - [المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) — استخدام متغيرات `httpstart_` في البريد والمهام والشروط - [صلاحيات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-29-workflow-permissions/) — التحكم في مسارات سير العمل المرئية والقابلة للتنفيذ - [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) — سجل التدقيق والبيانات التشغيلية للمثيلات التي بدأها Webhook - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/ # عقدة مُشغّل البريد الإلكتروني > **الوحدة:** منشئ التدفقات ← أساسي ← مُشغّل البريد الإلكتروني > > **الجمهور:** مصممو سير العمل الذين يبدؤون العمليات أو يستأنفونها بالبريد الإلكتروني > > **ستتعلم:** كيف تبدأ سير عمل من رسالة بريد إلكتروني، أو تنتظر رسالة مطابقة في منتصف سير العمل. ## نقطة دخول أو محطة وسطية لعقدة **مُشغّل البريد الإلكتروني (Email Trigger)** استخدامان حاليان: - من دون اتصال وارد، تبدأ الرسالة المطابقة سير العمل؛ - مع وجود اتصال وارد، ينتظر سير العمل الجاري عند هذه العقدة وصول رسالة مطابقة. يفتح خيار البداية **عند استلام بريد إلكتروني (On Email Received)** إعداد المُشغّل نفسه لاستخدامه كمُشغّل دخول. ## الأساسيات افتح العقدة واضبط ما يأتي: | الإعداد | الغرض | |---|---| | **تسمية هذا المُشغّل (Name this trigger)** | تسمية اختيارية للاشتراك. | | **أي صندوق بريد نراقب؟ (Which mailbox should we watch?)** | اختر عنوان RAPTIX مُدارًا أو صندوق بريد متصلًا متاحًا. | | **عنوان RAPTIX جديد (New RAPTIX address)** | أنشئ عنوانًا مُدارًا عندما تكون مجموعة العناوين ممكّنة. | | **التحقق من الرسائل الجديدة كل (Check for new emails every)** | فاصل الاستقصاء الزمني لصندوق بريد متصل، والحد الأدنى 60 ثانية. تستقبل العناوين المُدارة الرسائل من دون هذا الفاصل. | | **مهلة الانتظار (Wait timeout)** | عدد اختياري من الدقائق أو الساعات أو الأيام لانتظار في منتصف سير العمل. استخدم مسار انتهاء المهلة عند إعداده. | | **من يرسلها؟ (Who sends it?)** | **أي شخص (Anyone)**، أو **أشخاص محددون (Specific people)**، أو **أي شخص من شركة (Anyone from a company)**. | | **يحتوي الموضوع على (Subject contains)** | مطابقة اختيارية للموضوع. | | **المرفقات (Attachments)** | **لا يهم (Doesn't matter)**، أو **يجب أن تتضمن ملفات (Must have files)**، أو **يجب ألا تتضمن ملفات (Must have no files)**؛ ويمكن تقييد أنواع الملفات اختياريًا. | | **حفظ المرفقات للعُقد اللاحقة (Save attachments for later nodes)** | الاحتفاظ بالملفات المطابقة كقيم لسير العمل تستخدمها العُقد التالية. | تتجاوز وسائل حماية المُشغّل الردود التلقائية ورسائل عدم الرد. ## عوامل التصفية اختر ما إذا كان يجب أن **تتطابق كل الشروط (All conditions match)** أو **يتطابق أي شرط (Any condition matches)**، ثم استخدم المجموعات التي تحتاج إليها العملية فقط: | المجموعة | عناصر التحكم الحالية | |---|---| | **الأشخاص (People)** | يجب وجوده في CC، ويجب وجوده في BCC، والمرسلون المستبعدون، والمرسل داخلي أو خارجي، واختلاف Reply-To عن المرسل. تستخدم فئة داخلي أو خارجي نطاقات الشركة المحددة في المنظمة. | | **المرفقات (Attachments)** | الحد الأدنى والأقصى للعدد، والحد الأدنى والأقصى للحجم بالميغابايت، ودعوة التقويم، وموضع **مرفق حقيقي (Real attachment)** أو **صورة مضمنة (Inline image)**. تتحكم علامة تبويب الأساسيات أيضًا في اشتراط الملفات أو منعها وامتدادات الملفات الاختيارية. | | **المحتوى (Content)** | يحتوي النص على، ويحتوي الموضوع أو النص على، والكلمات المستبعدة، واكتشاف رقم المستند مع تعبير نمطي اختياري، ورموز المشاريع، واللغة العربية أو الإنجليزية أو المختلطة. | | **حالة البريد (Email state)** | أولوية عالية أو عادية أو منخفضة، وحالة مقروء أو غير مقروء، ونوع سلسلة جديد أو رد أو إعادة توجيه، والحد الأدنى أو الأقصى لعمر الرسالة بالدقائق. | تعرض شارة علامة تبويب عوامل التصفية عدد عوامل التصفية المتقدمة المعدّة. قد تمنع عدة قواعد ضيقة رسائل صحيحة من المطابقة، لذا اختبر بعد إضافة أي قاعدة أو إزالتها. ## المنظمة والجدول وحدود المعدل - **المنظمة (Organization)** — أدخل **نطاقات الشركة (Company domains)** لتصنيف المرسلين داخليًا أو خارجيًا، وأدخل اختياريًا منظمات المرسلين المسموح بها. المجلد المُراقب هو مجلد صندوق البريد الذي تعرضه اللوحة، ويكون عادة `INBOX`. - **الجدول (Schedule)** — حدّد اختياريًا بداية ساعات العمل ونهايتها وأيام العمل والمنطقة الزمنية. تعمل الرسائل الواردة خارج الساعات المعدّة فورًا في المنتج الحالي، لكنها تُعلّم بأنها خارج ساعات العمل؛ فالجدول ليس نافذة إيقاف مؤقت. - **حدود المعدل (Rate limits)** — حدّد الحد الأقصى للرسائل في الساعة إجمالًا ولكل مرسل، والحد الأقصى لمسارات سير العمل العاملة في الوقت نفسه، وثواني التهدئة لكل مرسل، وحد الإخفاقات المتتالية الذي يوقف المعالجة مؤقتًا. ## الاختبار والحالة المباشرة بعد حفظ الاشتراك، تعرض اللوحة حالة **قيد التشغيل (Running)** أو **متوقف (Stopped)**، وأداة تحديث، وعدد **failed in DLQ** عند وجود إخفاقات. تعرض اللوحة الحالية العدد في شارة تحذير؛ ولا تعرض جدولًا منفصلًا للرسائل غير القابلة للتسليم أو إجراءً لإعادة المحاولة. علامة تبويب **الاختبار (Testing)** متاحة لخطة Enterprise فقط، وتوفّر: - **وضع الاختبار (Test mode / Dry Run)**، لتقييم الرسائل من دون بدء سير العمل؛ - **اختبار الاتصال (Test connection)**، ويصبح متاحًا بعد حفظ الاشتراك؛ - **معاينة المطابقات الأخيرة (Preview recent matches)**، لعرض الرسائل المطابقة والمتجاوزة وأسباب التجاوز؛ - **الاختبار برسالة نموذجية (Test with a sample email)**، باستخدام موضوع ومرسل ونص وأسماء مرفقات اختيارية من دون الحاجة إلى اشتراك محفوظ. توضح نتيجة النموذج ما إذا كان سير العمل سيعمل، وتعرض نتيجة النجاح أو الفشل لكل قاعدة جرى تقييمها. ## الحفظ والبدء 1. احفظ سير العمل أولًا ليصبح له سجل دائم. 2. احفظ عقدة مُشغّل البريد الإلكتروني مرة أخرى لإنشاء اشتراكها أو تحديثه. 3. استخدم عنصر **بدء (Start)** في المُشغّل وتأكد من أن حالته **قيد التشغيل**. 4. أرسل رسالة اختبار مضبوطة ومطابقة. 5. تحقق من المثيل الجديد أو الخطوة المنتظرة في **كل المثيلات**. استخدم **إيقاف (Stop)** عندما لا ينبغي أن ينشئ صندوق البريد مثيلات أو يطلقها بعد الآن. لا يؤدي إيقاف الاشتراك إلى حذف تصميم سير العمل. ## متغيرات البريد الإلكتروني تجعل العقدة بيانات الرسالة متاحة للعُقد التالية، بما فيها الموضوع والمرسل والنص والمرفقات المحفوظة عندما تُعدّ لذلك. افتح لوحة المتغيرات وانسخ المتغير المولّد بدقة بدلًا من كتابة اسم متوقّع. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | يتعذر حفظ الاشتراك | احفظ سير العمل، ثم احفظ العقدة مرة أخرى. | | لا تطابق أي رسالة | حالة قيد التشغيل، وصندوق البريد، والمرسل، والموضوع، وقاعدة المرفقات، وعوامل التصفية، والمنظمة، والجدول، وحدود المعدل. | | صندوق البريد المتصل بطيء | فاصل الاستقصاء لا يقل عن 60 ثانية؛ ولا تستخدم العناوين المُدارة ذلك الفاصل. | | انتظار في منتصف سير العمل لا يُستأنف | تحقق من الاتصال الوارد وقواعد المطابقة وإعداد مهلة الانتظار. | | الملفات غير متاحة لاحقًا | فعّل **حفظ المرفقات للعُقد اللاحقة**، واختر النتيجة من لوحة المتغيرات. | | يظهر تحذير DLQ | حدّث الحالة، وتحقق من حد الإخفاقات المتتالية واتصال صندوق البريد، وابحث عن خطأ سير العمل أو التسليم الأساسي. تعرض اللوحة الحالية عددًا، لا جدول DLQ. | | الاختبار غير ظاهر | علامة تبويب الاختبار متاحة لخطة Enterprise فقط. | ## أدلة ذات صلة - [مُشغّلات البداية](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) - [عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/ # تصميم خطوات المهام: الإسناد والأولوية ونماذج المهام والإجراءات ورفع المستندات > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي (مصممو عمليات سير العمل والمسؤولون) > **ستتعلم:** كيفية ضبط عقدة مهمة كي تصل إلى الشخص المناسب، وتتيح له إدخال قيم منظمة، وتوضح له القرار المطلوب بدقة، وتسمح بإرفاق المستندات المطلوبة قبل انتقال سير العمل إلى الخطوة التالية. ## ما هذه الميزة؟ عقدة المهمة هي وحدة البناء التي تضيف القرار البشري إلى عمليات سير العمل. عندما يحتاج سير العمل إلى شخص يراجع معلومات، أو يدخل قيمًا منظمة، أو يتخذ قرارًا، أو يرفع مستندًا، تضيف عقدة مهمة. يحدد المصمم من يتلقى المهمة، وأولويتها، والحقول التي يكملها المسند إليه، وأزرار القرار التي يراها، والمستندات التي يجب أن يقدمها. عند التشغيل، يرى المسند إليه شاشة مصممة لهذا الغرض، وهي **مدير مهام سير العمل**، وتجمع البيانات والنموذج والأزرار وعمليات الرفع في مكان واحد. عُقد المهام هي الوسيلة الأساسية التي تصل الخطوات المؤتمتة بالحكم البشري. وهي تستبدل سلاسل الموافقات عبر البريد الإلكتروني بعملية منظمة يمكن تتبعها. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **يتلقى الشخص المناسب إشعارًا دائمًا ولا تفوته المهمة** — يمكن إسنادها إلى مستخدم محدد، أو دور، أو متغير ديناميكي كي يحدد سير العمل بنفسه من ينبغي أن يتصرف. - **تحل أزرار القرار المخصصة محل تسميات الموافقة والرفض العامة** — سمِّ كل نتيجة بما يطابق لغة عملك، مثل «تأييد» أو «إعادة للمراجعة» أو «إرسال إلى الإدارة القانونية»، واختر لونًا يسهّل تمييزها فورًا. - **تجمع نماذج المهام قيمًا منظمة عند نقطة القرار** — أضف نصوصًا وأرقامًا وتواريخ وخيارات ومربعات اختيار وملفات مباشرة إلى عقدة المهمة. يؤدي اختيار الإجراء المسموح إلى إرسال النموذج واختيار المسار. - **رفع المستندات مدمج** — عرّف حقول رفع مسماة مع حدود الحجم والحالة المطلوبة أو الاختيارية، كي يقدم المسند إليه كل المطلوب دون مراسلات أو متابعة. - **تُرسل رسالة إشعار إلى المسند إليه تلقائيًا** — صممها في محرر السحب والإفلات نفسه المستخدم لعُقد البريد الأخرى، ويمكن أن تتضمن أي متغير سير عمل كعلامة دمج. - **تُتبع كل مهمة** — تظهر المهمة ضمن **مهامي** للمسند إليه، ويستطيع المسؤولون مراقبتها في **كل المثيلات** مع سجل تدقيق كامل. - **لا تضيع أي مهمة** — إذا لم يُتخذ إجراء قبل تاريخ الاستحقاق، تعمل التذكيرات وقواعد التصعيد تلقائيًا. راجع [إدارة المواعيد النهائية](https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/). ## قبل أن تبدأ - تحتاج إلى الوصول إلى سير عمل في المصمم المرئي بوضع التحرير. إذا كان بإمكانك العرض فقط، فاطلب من المسؤول صلاحية التحرير. راجع [صلاحيات عمليات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-29-workflow-permissions/). - افهم بنية سير العمل وحدد الخطوة التي تحتاج إلى تدخل بشري والنتائج الممكنة، مثل موافقة أو رفض أو تعليق. - إذا كنت ستسند المهمة إلى متغير، أي مسند إليه ديناميكي، فتأكد من أن سير العمل يحتوي على عقدة بدء تلتقط بريد المسند إليه كمتغير. راجع [عُقد مشغّلات البدء](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) و[استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/). - انتقل إلى **عمليات سير العمل** من الشاشة الرئيسية للمنصة، ثم افتح سير العمل المطلوب واختر **تحرير**. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — أضف عقدة مهمة إلى اللوحة 1. افتح **لوحة العناصر** في يسار المصمم المرئي. 2. من علامة تبويب **أساسي**، حدد عقدة **مهمة**. 3. اسحب عقدة المهمة إلى اللوحة وضعها بعد الخطوة التي ينبغي أن تسبق هذا القرار البشري. 4. صِل حافة إخراج العقدة السابقة بمقبض إدخال عقدة المهمة. ### الخطوة 2 — افتح إعدادات عقدة المهمة 5. انقر على عقدة المهمة نقرًا مزدوجًا، أو انقر مرة لتحديدها ثم اختر رمز الإعدادات الذي يظهر. تفتح لوحة **خصائص المهمة** في الجانب الأيمن. ### الخطوة 3 — أكمل علامة تبويب «أساسي» 6. تفتح علامة **أساسي** افتراضيًا. أكمل الحقول التالية: - **العنوان** — أدخل اسمًا قصيرًا ووصفيًا للمهمة، مثل «مراجعة المدير للعقد». يظهر هذا العنوان في **مهامي** للمسند إليه وفي رسائل الإشعار. - **الوصف** — أضف سياقًا أو تعليمات للمسند إليه. ما الذي ينبغي أن يبحث عنه؟ وما الذي تتطلبه عملية العمل؟ يظهر هذا النص في مدير مهام سير العمل. - **المسند إليه** — أدخل عنوان البريد الإلكتروني للشخص أو الدور الذي ينبغي أن يتلقى المهمة. يمكنك أيضًا إدخال متغير سير عمل بصيغة `{{variable_name}}` للإسناد الديناميكي، مثل `{{requester_manager_email}}`. - **الأولوية** — اختر **منخفضة** أو **متوسطة** أو **عالية** أو **عاجلة** من القائمة. يؤثر ذلك في شارة الأولوية الظاهرة في صندوق المهام. - **الساعات المقدرة** — أدخل رقمًا يمثل الجهد المتوقع. هذه المعلومة للإرشاد فقط وتُستخدم في التقارير. - **الوسوم** — اكتب وسمًا واضغط Enter لإضافته. تساعد الوسوم في تجميع المهام وتصفيتها عبر عمليات سير العمل. يوجد إعدادان مرتبطان في **علامات تبويب أخرى** من اللوحة نفسها: - **الفئة** *(علامة النموذج)* — اختر **موافقة** لصفحة موافقة قياسية، أو **نموذج** لجمع مدخلات منظمة داخل المهمة، أو **Appsmith** لصفحة متصلة من منشئ التطبيقات عندما يتوفر الخيار. يتحكم هذا الاختيار أيضًا في توفر **الموافقة لكل عنصر**، وليس تسمية حرة. - **العرض في مهامي** *(علامة متقدم)* — فعّل هذا الخيار إذا أردت ظهور المهمة ضمن **مهامي** للمسند إليه. عند تعطيله، تستمر رسالة المهمة في الوصول بالبريد لكنها لا تظهر في تلك القائمة. عند اختيار **نموذج**، أضف الحقول التي يجب أن يكملها المسند إليه. تصبح الإجراءات المسموحة لعقدة المهمة أزرار النموذج، ولا يوجد زر إرسال منفصل. راجع [نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) للتعرف على أنواع الحقول والقيم الافتراضية المخفية والتعامل مع الملفات ومعرّفات الإجراءات والتوجيه والمخرجات اللاحقة. ### الخطوة 4 — اضبط أزرار الإجراءات (علامة الإجراءات) 7. اختر علامة **الإجراءات**. تتحكم هذه العلامة في أزرار القرار التي يراها المسند إليه في مدير مهام سير العمل. توجد افتراضيًا ثلاثة إجراءات: **إكمال** باللون الأخضر، و**رفض** بالأحمر، و**تعليق** بالأصفر. 8. لتحرير إجراء موجود، اختره من القائمة: - **الاسم** — غيّر تسمية الزر لتوافق لغة عملك، مثل تغيير «إكمال» إلى «موافقة». - **اللون** — اختر الأخضر أو الأحمر أو الأصفر أو الأزرق أو البنفسجي أو الرمادي. يظهر اللون على الزر وعلى حافة الاتصال في المصمم. - **يتطلب تعليقًا** — فعّله لإلزام المسند إليه بكتابة تعليق قبل اختيار الإجراء. يفيد في قرارات الرفض أو التعليق التي تتطلب سببًا. - **يتطلب إعادة الجدولة** — فعّله إذا كان اختيار هذا الإجراء ينبغي أن يطلب من المسند إليه تحديد تاريخ جديد، كما في قرارات التأجيل أو إعادة الجدولة. 9. لإضافة زر إجراء جديد، اختر **+ إضافة إجراء** أسفل القائمة. 10. لإزالة إجراء، اختر رمز سلة المهملات المجاور له. > بعد الحفظ، ارسم حافة من عقدة المهمة على اللوحة. عند إفلات الحافة، يطلب مربع حوار تحديد نتيجة الإجراء التي يمثلها هذا الاتصال. اختر النتيجة من قائمتك؛ فتحمل الحافة اللون والتسمية المطابقين. ### الخطوة 5 — اضبط رسالة الإشعار (علامة الإشعارات) 11. اختر علامة **الإشعارات**. 12. فعّل **البريد الإلكتروني مُمكّن** لإرسال رسالة إشعار تلقائية عند إنشاء المهمة. 13. اختر **تحرير البريد الإلكتروني** لفتح منشئ البريد بالسحب والإفلات. صمم الرسالة التي سيتلقاها المسند إليه. يمكنك إدراج متغيرات سير العمل كعلامات دمج، مثل `{{task_title}}` و`{{assignee_name}}` و`{{due_date}}`، باستخدام **لوحة المتغيرات**. راجع [عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) للحصول على شرح كامل للمنشئ. 14. فعّل **إرسال تذكيرات** إذا أردت إرسال رسائل تذكير على فترات قبل تاريخ الاستحقاق. أدخل فواصل مثل `30m` أو `3h` أو `24h` مفصولة بفواصل، واختر **تحرير رسالة التذكير** لتخصيصها. ### الخطوة 6 — أضف حقول رفع المستندات (علامة رفع المستندات) 15. اختر علامة **رفع المستندات**. 16. اختر **+ إضافة حقل رفع** لإنشاء خانة رفع جديدة. 17. اضبط لكل حقل رفع ما يلي: | الإعداد | ما الذي يفعله؟ | |---|---| | **التسمية** | اسم حقل الرفع كما يراه المسند إليه، مثل «العقد الموقع» أو «نسخة جواز السفر». | | **الحد الأقصى لحجم الملف (MB)** | أكبر حجم مسموح لكل ملف بالميغابايت. يرفض النظام الملفات التي تتجاوز هذا الحد. | | **الحد الأقصى للملفات** | أكبر عدد من الملفات التي يمكن للمسند إليه إرفاقها بهذا الحقل. | | **مطلوب** | عند تفعيله، لا يستطيع المسند إليه إرسال المهمة حتى يرفع ملفًا واحدًا على الأقل هنا. | | **يتطلب تعليقًا** | عند تفعيله، يجب كتابة تعليق يشرح المرفق قبل الإرسال. | 18. اسحب الحقول إلى أعلى أو أسفل لتغيير ترتيب عرضها في مدير مهام سير العمل. 19. لإزالة حقل، اختر رمز سلة المهملات المجاور له. ### الخطوة 7 — احفظ إعدادات المهمة 20. اختر **حفظ المهمة** أسفل اللوحة. تتحدث العقدة على اللوحة ويظهر عليها عنوان المهمة. 21. صِل حواف نتائج عقدة المهمة: اسحب من العقدة إلى العقدة التالية في سير العمل لكل نتيجة إجراء، واختر النتيجة الصحيحة من مربع الحوار الظاهر. ## شرح الخيارات والإعدادات ### علامة أساسي | الحقل | مطلوب | ما الذي يفعله؟ | |---|---|---| | **العنوان** | نعم | اسم قصير يظهر في **مهامي** ورسائل الإشعار وسجلات التدقيق. | | **الوصف** | لا | تعليمات نصية حرة تظهر للمسند إليه في مدير مهام سير العمل. | | **المسند إليه** | نعم | عنوان البريد أو `{{variable}}` للشخص الذي يتلقى المهمة. | | **الأولوية** | نعم | منخفضة أو متوسطة أو عالية أو عاجلة، وتظهر كشارة في صندوق المهام. | | **الساعات المقدرة** | لا | الوقت المتوقع للإكمال، وهو للمعلومات فقط. | | **الوسوم** | لا | تسميات حرة لتجميع المهام وتصفيتها. | ### علامة النموذج | الحقل | ما الذي يفعله؟ | |---|---| | **الفئة** | تحدد نوع صفحة المهمة: **موافقة** لمهمة قياسية، أو **نموذج** لمدخلات منظمة يرسلها إجراء مسموح، أو **Appsmith** لصفحة متصلة من منشئ التطبيقات عند توفرها. كما تتحكم في توفر **الموافقة لكل عنصر**. | | **حقول نموذج المهمة** | تظهر مع فئة **نموذج**، وتحدد قيم النصوص والأرقام والتواريخ والخيارات ومربعات الاختيار والملفات التي تُجمع عند تصرف المسند إليه. | ### علامة متقدم | الحقل | ما الذي يفعله؟ | |---|---| | **العرض في مهامي** | عند تفعيله، تظهر المهمة ضمن مهامي للمسند إليه بالإضافة إلى البريد الإلكتروني. | ### علامة الإجراءات | الحقل | ما الذي يفعله؟ | |---|---| | **الاسم** | النص الظاهر على الزر الذي يختاره المسند إليه، مثل «موافقة» أو «رفض» أو «إعادة». | | **اللون** | لون الزر في شاشة الموافقة ولون الحافة في المصمم. | | **يتطلب تعليقًا** | يلزم المسند إليه بكتابة تعليق قبل إرسال هذا الإجراء. | | **يتطلب إعادة الجدولة** | يلزم المسند إليه بتحديد تاريخ جديد قبل إرسال هذا الإجراء. | ### علامة الإشعارات | الحقل | ما الذي يفعله؟ | |---|---| | **البريد الإلكتروني مُمكّن** | يرسل رسالة تلقائية إلى المسند إليه عند إنشاء المهمة. | | **تحرير البريد الإلكتروني** | يفتح منشئ البريد بالسحب والإفلات لإشعار الإسناد. | | **إرسال تذكيرات** | يمكّن رسائل التذكير التلقائية في الفترات المحددة. | | **فواصل التذكير** | قائمة فترات زمنية تفصلها فواصل، مثل `30m` و`3h` و`24h`. | | **تحرير رسالة التذكير** | يفتح المنشئ لتعديل محتوى رسالة التذكير. | ### علامة رفع المستندات | الحقل | ما الذي يفعله؟ | |---|---| | **التسمية** | اسم خانة الرفع الظاهر في شاشة الموافقة. | | **الحد الأقصى لحجم الملف (MB)** | حد الحجم لكل ملف. تُرفض الملفات التي تتجاوزه قبل الرفع. | | **الحد الأقصى للملفات** | أكبر عدد من الملفات المسموح به في هذه الخانة. | | **مطلوب** | لا يمكن إرسال المهمة من دون ملف واحد على الأقل في هذه الخانة. | | **يتطلب تعليقًا** | يجب إدخال تعليق عند رفع ملفات إلى هذه الخانة. | | **السماح باستبدال المستند** | يتيح للمسند إليه رفع الملفات حتى إذا لم تُعرّف خانة رفع محددة. | ## نصائح وأفضل الممارسات - **طابق أسماء الإجراءات مع لغة مؤسستك.** استخدم «تأييد» أو «تصديق» أو «تفويض» بدلًا من «إكمال». يقلل ذلك الالتباس ويجعل سجل التدقيق واضحًا فورًا. - **اقتصر في عمليات الرفع المطلوبة على الضروري.** كل حقل رفع مطلوب قد يوقف العملية؛ فإذا لم يجد المسند إليه الملف، يتعطل سير العمل. - **استخدم المسند إليهم الديناميكيين عبر المتغيرات.** يعني تثبيت عنوان بريد بعينه أنك ستضطر إلى إعادة تصميم سير العمل كلما تغير شاغل الدور. استخدم `{{manager_email}}` ودع نموذج المشغّل أو خطوة سابقة تزود القيمة. - **أضف دائمًا إجراء واحدًا على الأقل يسمح بالرفض.** قد تتوقف المهمة إلى أجل غير مسمى إذا رفض المسند إليه الموافقة ولم يوجد مسار رفض. - **فعّل «يتطلب تعليقًا» لإجراءات الرفض والتعليق.** يضمن ذلك تسجيل سبب القرار في سجل التدقيق، وهو مهم للامتثال. - فعّل **العرض في مهامي** لأي مهمة ينبغي أن تظل ظاهرة حتى إذا فاتت رسالة الإشعار. - **اختبر التدفق كاملًا** بتشغيل سير العمل يدويًا، كما يوضح [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/)، وتأكد من أن المستخدم الصحيح تلقى المهمة ورأى الأزرار وحقول الرفع الصحيحة. ## الأسئلة الشائعة **س: هل يمكنني إسناد مهمة إلى دور بدلًا من شخص محدد؟** نعم. أدخل اسم الدور أو متغيرًا يعيد معرّف الدور. يصبح كل من يحمل ذلك الدور مؤهلًا لتنفيذ المهمة، ويغلقها أول شخص يتخذ إجراءً بالنسبة إلى الآخرين. **س: ماذا يحدث إذا كان عنوان بريد المسند إليه خاطئًا أو كان المتغير فارغًا؟** تُنشأ المهمة، لكن يفشل تسليم رسالة الإشعار. يمكن أن تظل المهمة ظاهرة في **مهامي** للمستخدمين المخوّلين. راجع **كل المثيلات** لمعرفة حالة سير العمل، واستخدم قاعدة بيانات سير العمل عندما تحتاج إلى تحقيق أعمق. **س: هل يمكنني إضافة أكثر من ثلاثة أزرار إجراءات؟** نعم. اختر **+ إضافة إجراء** لإضافة العدد الذي تتطلبه العملية. ينشئ كل إجراء حافة خروج منفصلة على اللوحة، كي توجه كل نتيجة إلى خطوة تالية مختلفة. **س: إذا غيّرت اسم «إكمال» إلى «موافقة»، هل يتعطل شيء؟** لا. يظل معرّف الإجراء الداخلي بلا تغيير؛ الذي يتغير هو اسم العرض فقط. يستمر كل منطق التوجيه المستند إلى الإجراء في العمل. **س: هل يستطيع المسند إليه رفع ملفات إذا لم تُعرّف حقول رفع مستندات؟** لا. يجب إضافة خانات رفع المستندات صراحة في علامة رفع المستندات. إذا أردت السماح بتقديم مستندات من دون تعريف حقل بعينه، ففعّل **السماح باستبدال المستند** في العلامة نفسها. **س: هل تُرسل رسالة إشعار المهمة فور وصول سير العمل إلى عقدة المهمة؟** نعم. يرسلها النظام بمجرد إنشاء المهمة، أي عندما يصل محرك سير العمل إلى العقدة أثناء التنفيذ. لا يوجد تأخير إلا إذا وضعت عقدة إيقاف مؤقت قبل عقدة المهمة. **س: ماذا أفعل إذا احتجت إلى مرور المهمة بمستويين من الموافقة؟** استخدم عقدة مهمة ثانية بعد الأولى، واربطها بحافة «موافقة» في العقدة الأولى. للموافقات متعددة المستويات على صفوف مجمعة، راجع [الموافقات متعددة المستويات والدُفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/). ## أدلة ذات صلة - [الموافقات متعددة المستويات والدُفعات: الموافقة لكل عنصر والقرارات على مستوى الصف](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) - [نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) - [إدارة المواعيد النهائية: تواريخ الاستحقاق والتذكيرات والتصعيد والانتهاء](https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/) - [عقدة البريد الإلكتروني: إنشاء رسائل إشعار غنية](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [مدير مهام سير العمل: مراجعة المستندات واتخاذ القرارات](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [مهامي: عرض المهام المسندة وتصفيتها وتنفيذها](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/ # نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية > **الوحدة:** مسارات سير العمل > > **الجمهور:** مصممو سير العمل والمكلّفون بالمهام > > **ستتعلم:** كيف تحول عقدة مهمة إلى نموذج، وتستخدم الإجراءات المسموح بها كأزرار للنموذج، وتوجّه كل استجابة، وتستخدم القيم المجمعة في خطوات سير العمل اللاحقة. ## ما هي؟ يجمع **نموذج المهمة (Task Form)** بين جمع البيانات المنظمة واتخاذ قرار بشري في عقدة مهمة واحدة. يفتح المكلّف المهمة ويكمل الحقول، ثم يختار **إجراءً مسموحًا به (Allowed Action)**، مثل **اعتماد** أو **طلب تعديلات** أو **تصعيد**. يتحقق ذلك الإجراء من النموذج ويرسله، ويسجل القرار، ويختار مسار سير العمل الصادر. لا يوجد زر **إرسال (Submit)** منفصل؛ فالإجراءات المسموح بها هي أزرار النموذج. تختلف نماذج المهام عن نموذج البداية اليدوية: | نموذج البداية اليدوية | نموذج المهمة | |---|---| | يجمع المعلومات عند بدء سير العمل. | يجمع المعلومات بينما يكون سير العمل قيد التنفيذ. | | يبدأ مثيل سير عمل جديدًا. | يكمل مهمة بشرية معلّقة ويتابع المثيل نفسه. | | يستخدم إجراء البدء أو التشغيل الخاص به. | يستخدم الإجراءات المسموح بها في عقدة المهمة كأزرار للإرسال والتوجيه. | ## أهميتها - **تسليم متكامل واحد** — يقدّم المكلّف القيم والملفات والتعليق والقرار في شاشة المهمة نفسها. - **بيانات منظمة لسير العمل** — تستطيع عُقد البريد والمستندات والتقرير ووكيل الذكاء الاصطناعي والتوجيه اللاحقة استخدام القيم المرسلة بأسماء حقولها. - **توجيه قائم على الإجراء** — يمكن أن يقود كل زر إلى فرع مختلف من دون إضافة خطوة إرسال مصطنعة. - **عمل داخلي وخارجي متسق** — يُستخدم مخطط النموذج نفسه في مدير مهام سير العمل للمستخدم المسجّل دخوله وفي رابط مهمة خارجي صالح. - **نتائج قابلة للتتبع** — يبقى الإجراء المحدد وقيم النموذج مرتبطين بنتيجة المهمة ومثيل سير العمل. - **تصميم بمساعدة الذكاء الاصطناعي** — يفهم منشئ الذكاء الاصطناعي نماذج المهام، ويمكنه اقتراح الحقول والإجراءات والفروع من وصف بلغة طبيعية. ## قبل أن تبدأ - افتح سير العمل في وضع التحرير داخل **منشئ التدفقات**. - أضف عقدة **مهمة (Task)** أو اختر واحدة. - حدّد من سيتلقى المهمة وما نتائج العمل المطلوبة منها. - حدّد القيم التي يجب أن تستخدمها العُقد اللاحقة؛ إذ تحدد هذه القيم **اسم المتغير (Variable name)** الثابت لكل حقل. ## إعداد نموذج مهمة ### 1. اختيار تصنيف النموذج 1. انقر عقدة المهمة نقرًا مزدوجًا لفتح **خصائص المهمة (Task Properties)**. 2. أكمل الإعدادات المطلوبة في **المعلومات الأساسية (Basic Info)**، بما فيها عنوان المهمة والمكلّف. 3. افتح علامة **النموذج (Form)**. 4. اضبط **تصنيف المهمة (Task category)** على **نموذج (Form)**. تعرض اللوحة الآن **حقول نموذج المهمة (Task form fields)**. وإذا غيّرت التصنيف لاحقًا إلى قيمة غير **نموذج**، يطلب RAPTIX تأكيدك قبل إزالة الحقول المعدّة. ### 2. إضافة الحقول 1. اختر **إضافة حقل (Add field)**. 2. أدخل **اسم متغير (Variable name)**، وهو اسم الإخراج الثابت الذي تستخدمه العُقد اللاحقة. 3. أدخل **التسمية الظاهرة للمستخدم (Label shown to user)**. 4. اختر **نوع الحقل (Field type)**. 5. افتح **مزيد من الخيارات (More options)** عندما تحتاج إلى نص مساعدة أو عنصر نائب أو قيمة افتراضية أو اختيارات أو بيانات وصفية للمستند. أنواع الحقول المدعومة: | نوع الحقل | استخدامه | |---|---| | **نص (Text)** | الأسماء والمراجع والملاحظات والتفسيرات وغيرها من النصوص. | | **رقم (Number)** | المبالغ والأعداد والدرجات وغيرها من القيم الرقمية. | | **تاريخ (Date)** | تاريخ تقويمي. | | **قائمة اختيار منسدلة (Select / dropdown)** | اختيار واحد من قائمة مضبوطة. | | **مربع تحديد (Checkbox)** | تأكيد صحيح أو خطأ. يجب تحديد مربع التحديد المطلوب. | | **مجموعة مربعات تحديد (Checkbox group)** | اختيار عنصر واحد أو أكثر من قائمة مضبوطة. | | **رفع ملف (File upload)** | ملف يُرفع بأمان إلى سجل سير العمل. | أضف خيارًا واحدًا على الأقل للقائمة المنسدلة أو مجموعة مربعات التحديد. أدخل خيارًا واحدًا في كل سطر. استخدم `Label|value` عندما ينبغي أن تختلف التسمية الظاهرة للمستخدم عن القيمة المحفوظة: ```text مخاطر منخفضة|low يحتاج إلى مراجعة|review مخاطر عالية|high ``` ### 3. إعداد سلوك الحقول يمكن لكل حقل استخدام الإعدادات الآتية: | الإعداد | السلوك | |---|---| | **نص المساعدة (Help text)** | يشرح ما ينبغي للمكلّف تقديمه. | | **العنصر النائب (Placeholder)** | يعرض مثالًا أو تلميحًا قصيرًا عندما يدعمه نوع الحقل. | | **القيمة الافتراضية (Default value)** | توفّر قيمة أولية. تستخدم الحقول المخفية غير المخصصة للملفات قيمها الافتراضية دائمًا. | | **إظهار في النموذج (Show in form)** | يعرض الحقل للمكلّف. أوقفه لتمرير قيمة افتراضية مخفية إلى نتيجة المهمة. | | **مطلوب (Required)** | يمنع كل إجراء مسموح به إلى أن يحصل الحقل الظاهر على قيمة صالحة. | | **الترتيب (Order)** | يتحكم في ترتيب الحقول الظاهرة في شاشة المهمة. | | **حقل الكيان (Entity field)** | يعلّم حقلًا قياسيًا واحدًا باعتباره معرّف كيان المهمة. لا يمكن أن يوجد إلا حقل كيان واحد، ولا يمكن أن يكون ملفًا أو مجموعة مربعات تحديد. | | **المستند الرئيسي (Main document)** | يعلّم حقل ملف ظاهرًا واحدًا باعتباره المستند الأساسي لمهمة سير العمل. | لا يمكن أن تكون الحقول المخفية مطلوبة. ولا يرفع حقل ملف مخفي شيئًا أو ينتج قيمة؛ لذلك أبقِ حقول الملفات ظاهرة. ### 4. استخدام أسماء متغيرات آمنة اسم متغير الحقل: - يبدأ بحرف أو شرطة سفلية؛ - لا يحتوي إلا على الأحرف والأرقام والشرطات السفلية؛ - فريد داخل نموذج المهمة. لا تستخدم الأسماء المملوكة للمحرك: `action` أو `actor` أو `comments` أو `form_data` أو `signal_data` أو `signal_received`. لا يؤدي تغيير تسمية الحقل لاحقًا إلى تغيير اسم متغيره. تعامل مع اسم المتغير كعقد ثابت مع العُقد اللاحقة. ## إعداد الأزرار والمسارات ### 1. تعريف الإجراءات المسموح بها افتح علامة **الإجراءات (Actions)**. أضف الإجراءات التي يستطيع المكلّف اتخاذها أو عدّلها. | الإعداد | السلوك | |---|---| | **معرّف الإجراء (Action ID)** | معرّف توجيه ثابت. يجب أن يبدأ بحرف لاتيني صغير، وألا يحتوي إلا على أحرف لاتينية صغيرة وأرقام وشرطات سفلية. | | **اسم الإجراء (Action Name)** | تسمية الزر الظاهرة للمستخدم. | | **اللون (Color)** | المعالجة المرئية للإجراء ومساره. | | **يتطلب تعليقًا (Requires Comment)** | يمنع إرسال الإجراء حتى يُدخل المكلّف تعليقًا. | يجب أن تكون معرّفات الإجراءات فريدة. من المعرّفات الجيدة: `approve` و`request_changes` و`send_to_legal`. لا تضف إجراءً باسم `submit` لإرسال النموذج فقط؛ فكل إجراء مسموح به يرسل النموذج بالفعل. ### 2. توصيل كل نتيجة 1. احفظ عقدة المهمة. 2. ارسم اتصالًا صادرًا من عقدة المهمة. 3. اختر نتيجة الإجراء التي ستستخدم ذلك الاتصال. 4. كرر ذلك لكل إجراء مسموح به يحتاج إلى مسار مستقل. على سبيل المثال: ```text approve → إنشاء التقرير النهائي request_changes → إرسال بريد إلى مقدم الطلب → العودة إلى المراجعة send_to_legal → إسناد مهمة مراجعة قانونية ``` قبل تشغيل سير العمل، تأكد من أن كل إجراء معرّف له خطوة تالية صالحة. يجب أن يطابق معرّف الإجراء على الاتصال معرّف الإجراء في خصائص المهمة. ## ما الذي يراه المكلّف؟ عندما يفتح المكلّف المسجّل دخوله المهمة من **مهامي** أو تفاصيل سير العمل: 1. يعرض RAPTIX سياق المهمة وأي مستند مرتبط. 2. يعرض قسم **نموذج المهمة** الحقول الظاهرة بالترتيب المعدّ. 3. تُعلّم الحقول المطلوبة ويُتحقق منها. 4. يعرض قسم **الإجراءات المسموح بها** أزرار الإجراءات المعدّة. 5. يؤدي اختيار إجراء إلى رفع الملفات المعلّقة، والتحقق من الحقول ومتطلب التعليق، وتسجيل الاستجابة كاملة، والمتابعة عبر مسار ذلك الإجراء. يرى المكلّف الخارجي الذي يحمل رابط إجراء آمنًا وصالحًا حقول نموذج المهمة نفسها من دون الحاجة إلى حساب في مساحة العمل. يبقى الرابط مقصورًا على تلك المهمة والإجراء المخوّل له؛ ويؤدي تأكيده إلى إرسال الحقول والمتابعة عبر مسار الإجراء. ## استخدام قيم نموذج المهمة لاحقًا يصبح كل حقل مرسل إخراجًا لعقدة المهمة تحت **اسم المتغير** الخاص به. وتحتفظ النتيجة أيضًا بالقيم مجمعة تحت `form_data` لمراجعتها معًا وفي عروض التدقيق. مثال للحقول: ```text risk_level review_notes signed_contract ``` يمكن للعُقد اللاحقة استخدام هذه المخرجات من أجل: - توجيه شرط If/Else باستخدام `risk_level`؛ - تضمين `review_notes` في رسالة أو تقرير مولّد؛ - تمرير القيم إلى وكيل ذكاء اصطناعي؛ - إرفاق `signed_contract` أو حفظه من خلال عقدة لاحقة تتعامل مع الملفات. تُحفظ حقول الملفات كمراجع مستندات محمية، لا كعناوين ملفات عامة. استخدم منتقي المتغيرات أو المخرجات في العقدة اللاحقة لاختيارها بدلًا من كتابة مسار متوقع. ## بناء نموذج مهمة باستخدام منشئ الذكاء الاصطناعي صِف الخطوة البشرية والحقول والإجراءات ونتائج الفروع معًا. على سبيل المثال: > أضف مهمة مراجعة عقد إلى `legal@company.com`. اجمع مستوى مخاطر مطلوبًا بخيارات منخفض ومراجعة وعالٍ؛ وملاحظات مراجعة اختيارية؛ وملف عقد موقّع مطلوبًا. أضف إجراءي الاعتماد وطلب التعديلات. يجب أن ينشئ الاعتماد تقريرًا، وأن يرسل طلب التعديلات بريدًا إلى مقدم الطلب ثم يعود في حلقة إلى المراجعة. يمكن لمنشئ الذكاء الاصطناعي اقتراح حقول نموذج المهمة والإجراءات المسموح بها، ثم توصيل الفروع اللاحقة باستخدام معرّفات الإجراءات الدقيقة. راجع التغييرات المقترحة قبل اختيار **تطبيق على اللوحة (Apply to canvas)**، ثم افتح **خصائص المهمة** وتحقق من أسماء الحقول وقواعد الإلزام والمستلم والمسارات. ## التحقق والأمان - لا تقبل عمليات إرسال نموذج المهمة إلا الحقول المعرّفة في عقدة المهمة. - يتحقق الخادم من القيم المطلوبة وأنواع الأرقام والتواريخ واختيارات مربعات التحديد والقوائم المنسدلة. - يجب أن تنتمي الملفات المرفوعة إلى مثيل سير العمل نفسه؛ ولا يمكن لمهمة إرسال مرجع ملف من حالة أخرى. - يجب أن يكون الإجراء المحدد واحدًا من الإجراءات المسموح بها للمهمة. - لا يمكن إرسال مهمة مكتملة مرة ثانية عبر الإجراء المعلّق نفسه. - تُحفظ نتائج نموذج المهمة في التنفيذ العادي والمتوازي وتنفيذ Foreach. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | **حقول نموذج المهمة** غير ظاهرة في خصائص المهمة | افتح علامة **النموذج** واضبط **تصنيف المهمة** على **نموذج**. | | لا تعرض المهمة نموذجًا وقت التشغيل | تأكد من أن التصنيف لا يزال **نموذجًا**، ومن وجود حقل ظاهر واحد على الأقل، ومن حفظ أحدث إصدار لسير العمل قبل بدء التشغيل. | | يرفض **حفظ المهمة (Save Task)** حقلًا | تحقق من أن اسم متغيره صالح وفريد، ومن وجود خيارات لحقول القائمة ومجموعة مربعات التحديد. | | يظل زر إجراء معطلًا أو يعيد أخطاء تحقق | أكمل كل الحقول المطلوبة، وارفع الملفات المطلوبة، وأدخل تعليقًا عندما يتطلبه الإجراء. | | يسلك سير العمل الفرع الخطأ | قارن نتيجة الاتصال بمعرّف الإجراء المسموح به؛ يمكن أن تتغير التسميات، لكن المعرّف هو عقد التوجيه. | | لا تعثر عقدة لاحقة على قيمة | اختر الإخراج من عقدة المهمة في منتقي المتغيرات، وتأكد من عدم تغيير اسم متغير الحقل. | | أدى تغيير التصنيف إلى إزالة الحقول | يؤدي الانتقال من **نموذج** إلى مسح حقول نموذج المهمة بعد التأكيد. استعد إصدار سير العمل أو أعد إضافة الحقول. | ## أدلة ذات صلة - [تصميم خطوات المهمة](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [منشئ الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-30-ai-builder/) - [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [بوابة المعتمد الخارجي](https://raptix.app/user-guide/ar/10-workflows/10-26-external-approver-portal/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [منطق التوجيه](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/ # الموافقات متعددة المستويات والدُفعات: الموافقة لكل عنصر والقرارات على مستوى الصف > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي (مصممو عمليات سير العمل ومالكو العمليات) > **ستتعلم:** كيفية ضبط عقدة مهمة للموافقة المجمعة على مستوى الصف، بحيث يحصل كل عنصر بيانات في الجدول على قرار مستقل، وكيفية ربط عدة مستويات موافقة على مجموعة البيانات نفسها. ## ما هذه الميزة؟ تحوّل ميزة **الموافقة لكل عنصر** في عمليات سير العمل، وتسمى أيضًا الموافقة بالدُفعات، عقدة مهمة واحدة إلى شاشة قوية للقرارات المجمعة. بدلًا من أن يوافق شخص على سير العمل كله أو يرفضه بإجراء واحد، يرى المسند إليه كل صف في مجموعة البيانات، مثل كل سجل حضور أو بند مصروفات أو طلب شراء، ويتخذ قرارًا مستقلًا بالموافقة أو الرفض أو التعليق لكل صف. عندما تتطلب العملية عدة مستويات مراجعة لمجموعة البيانات نفسها، مثل موافقة المشرف أولًا ثم مراجعة مدير المالية للصفوف نفسها، تربط عُقد مهام متتالية. يرى كل مستوى تلقائيًا الصفوف الجاهزة لدوره فقط. يُسجل كل قرار على مستوى الصف، ويُحفظ سجل تدقيق كامل في **شاشة قرارات الدُفعة**. راجع [شاشة قرارات الدُفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/). ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **عالج مئات العناصر في شاشة واحدة** — لا تحتاج إلى بدء مثيل سير عمل مستقل لكل عنصر؛ تغطي مهمة واحدة مجموعة البيانات كلها. - **مساءلة على مستوى الصف** — يحصل كل عنصر في الجدول على قراره وتعليقه وطابعه الزمني. يستطيع المدقق معرفة العناصر التي تمت الموافقة عليها أو رفضها أو تعليقها، ومن اتخذ القرار. - **سلاسل متعددة المستويات على البيانات نفسها** — يوافق المستوى الأول، ثم يرى المستوى الثاني الصفوف التي اجتازت المستوى الأول فقط، وهكذا، من دون تنسيق يدوي بين المستويات. - **القرارات محفوظة وقابلة للاستعلام** — تُكتب نتيجة كل قرار مجمع في جدول منظم تستطيع خطوات سير العمل اللاحقة الاستعلام عنه أو تصفيته أو تصديره. - **سلسلة محادثة كاملة** — تُحفظ تعليقات المسند إليه على كل صف في سلسلة شبيهة بالمحادثة يستطيع الموافقون اللاحقون قراءتها. - **تصدير التدقيق بنقرة واحدة** — تتيح شاشة قرارات الدُفعة لأي طرف معني تصدير سجل القرارات الكامل على مستوى الصف كملف CSV للامتثال أو التقارير. ## قبل أن تبدأ - يجب أن يكون سير العمل مفتوحًا في وضع **التحرير** داخل المصمم المرئي. راجع [تصميم خطوات المهام](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) للتعرف على أساسيات عُقد المهام. - يجب أن تكون البيانات المطلوب اعتمادها صفًا بصف متاحة، إما كاستعلام في تطبيقاتك الداخلية أو كمخرجات موافقة بالدُفعة من عقدة مهمة سابقة. - للموافقة المجمعة المستندة إلى استعلام، وهي الإعداد الأكثر شيوعًا، تحتاج إلى معرفة مساحة العمل والتطبيق والصفحة واسم الاستعلام الذي يحتوي على البيانات في التطبيقات. - لربط عدة مستويات، يجب ضبط عقدة مهمة المستوى الأول مع تفعيل الموافقة لكل عنصر قبل إعداد المستوى الثاني. ## طريقة الاستخدام خطوة بخطوة ### الجزء أ — ضبط عقدة مهمة للموافقة المجمعة على مستوى الصف 1. افتح خصائص عقدة المهمة بالنقر المزدوج عليها في اللوحة. 2. اختر علامة **النموذج** حيث يظهر قسم **الموافقة لكل عنصر**. 3. ابحث عن مفتاح **الموافقة لكل عنصر** وفعّله. > **المتطلبات:** لا تتوفر الموافقة لكل عنصر إلا في باقة **Enterprise**، وفقط عندما تكون **فئة** المهمة، الموجودة أيضًا في علامة النموذج، مضبوطة على **موافقة**. إذا لم يظهر المفتاح، فتحقق من الشرطين. 4. ضمن **مصدر البيانات**، اختر أحد الوضعين: - **استعلام** — تأتي مجموعة البيانات من استعلام مباشر في تطبيقاتك الداخلية. هذا هو الخيار المناسب لمستوى الموافقة الأول عند جلب البيانات مباشرة من قاعدة بيانات. - **المهام السابقة** — تأتي مجموعة البيانات من القرارات المسجلة بواسطة عقدة موافقة بالدُفعات سابقة في سير العمل نفسه. استخدمه للمستوى الثاني وما بعده. --- **إذا اخترت استعلامًا:** 5. اختر **تحديد مساحة العمل** وحدد المساحة التي تحتوي على البيانات. 6. اختر **تحديد التطبيق** وحدد التطبيق داخل تلك المساحة. 7. اختر **تحديد الصفحة** وحدد صفحة التطبيق التي يوجد فيها الاستعلام. 8. اختر **تحديد الاستعلام** وحدد الاستعلام الذي يعيد مجموعة البيانات، مثل `GetAttendanceLogs` أو `GetExpenseLines`. > عند اختيار الاستعلام، تتحقق عمليات سير العمل من وجود جدول موافقات لمجموعة البيانات. إذا لم يوجد، يُطلب منك تأكيد إنشائه. اختر **إنشاء جدول الموافقات** للمتابعة. يعرض مربع التأكيد اسم الجدول وعدد الصفوف المستوردة. 9. اضبط **مستوى الموافقة** على **1** للمستوى الأول في السلسلة. --- **إذا اخترت المهام السابقة:** 5. تظهر قائمة بعُقد المهام السابقة في سير العمل نفسه التي فُعّلت فيها الموافقة بالدُفعات. 6. اختر عقدة أو عُقد المهام التي تريد لهذا المستوى استقبال قراراتها. يمكنك تحديد عدة أزواج من المهمة والإجراء، مثل «مراجعة المستوى الأول — تمت الموافقة» و«مراجعة المستوى الأول — موافقة جزئية». 7. اضبط **مستوى الموافقة** على **2**، أو رقم المستوى المناسب لهذه الخطوة في السلسلة. --- 10. اختر **حفظ المهمة** لحفظ الإعدادات. ### الجزء ب — ربط حواف الخروج لعقدة المهمة 11. ارسم على اللوحة حواف من عقدة المهمة إلى الخطوة التالية، حافة لكل نتيجة إجراء، مثل «إكمال» و«رفض». 12. عندما يطلب مربع الحوار تحديد النتيجة التي تمثلها كل حافة، اختر الإجراء المناسب. تحدد هذه الحواف وجهة سير العمل بعد إرسال المسند إليه قرارات الدُفعة. ### الجزء ج — إضافة مستوى موافقة ثانٍ 13. أضف عقدة مهمة أخرى إلى اللوحة بعد العقدة الأولى. 14. افتح خصائصها، وانتقل إلى **متقدم ← الموافقة لكل عنصر**، ثم فعّلها. 15. اضبط **مصدر البيانات** على **المهام السابقة**. 16. اختر عقدة المهمة الأولى والإجراء أو الإجراءات التي ينبغي أن تنتقل صفوفها، مثل إجراء «موافقة» من المستوى الأول؛ وبذلك تظهر للمستوى الثاني فقط الصفوف التي وافق عليها المستوى الأول. 17. اضبط **مستوى الموافقة** على **2**. 18. اضبط العنوان والمسند إليه وأزرار الإجراءات للمستوى الثاني حسب الحاجة. راجع [تصميم خطوات المهام](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/). 19. اختر **حفظ المهمة** وصِل الحواف. ### ما الذي يراه المسند إليه أثناء التشغيل؟ عندما يصل سير العمل إلى عقدة موافقة بالدُفعات ويفتح المسند إليه مدير مهام سير العمل، يرى: - جدول بيانات يحتوي على صف لكل عنصر في مجموعة البيانات. - في كل صف: جميع أعمدة البيانات ذات الصلة، إضافة إلى أزرار الإجراءات على مستوى الصف، مثل موافقة أو رفض أو تعليق. - حقل تعليق لكل صف، ويكون اختياريًا أو مطلوبًا بحسب إعداد زر الإجراء. - بعد اتخاذ إجراء في كل الصفوف، زر **إرسال** يرسل جميع القرارات دفعة واحدة. يمكن تصفية الجدول وفرزه، كي يركز المسند إليه على مجموعة محددة، مثل الصفوف عالية القيمة فقط. بعد الإرسال، يتقدم سير العمل وتُحفظ القرارات للمستوى التالي أو لأغراض التدقيق. ## شرح الخيارات والإعدادات | الإعداد | ما الذي يفعله؟ | |---|---| | **الموافقة لكل عنصر (مفتاح)** | يحوّل عقدة المهمة من مهمة ذات قرار واحد إلى مهمة قرارات مجمعة على مستوى الصف. | | **مصدر البيانات — استعلام** | يجلب مجموعة البيانات من استعلام مباشر في تطبيقاتك الداخلية. يُستخدم لمستوى الموافقة الأول. | | **مصدر البيانات — المهام السابقة** | يجلب مجموعة البيانات من القرارات المسجلة في عقدة موافقة بالدُفعات سابقة. يُستخدم للمستوى الثاني وما بعده. | | **تحديد مساحة العمل** | في وضع الاستعلام، مساحة العمل في تطبيقاتك الداخلية التي تحتوي على البيانات. | | **تحديد التطبيق** | في وضع الاستعلام، التطبيق داخل مساحة العمل. | | **تحديد الصفحة** | في وضع الاستعلام، الصفحة داخل التطبيق التي تحتوي على الاستعلام. | | **تحديد الاستعلام** | في وضع الاستعلام، الاستعلام المسمى الذي يعيد الصفوف المطلوب اعتمادها. | | **مستوى الموافقة** | يحدد المستوى الرقمي للعقدة في سلسلة متعددة المستويات: 1 أو 2 أو 3… ويتحكم في الصفوف الظاهرة وقت التشغيل؛ إذ يرى المستوى الثاني الصفوف المعتمدة في المستوى الأول فقط. | | **عُقد المهام المحددة** | في وضع المهام السابقة، عُقد المهام السابقة والإجراءات المحددة التي تنتقل صفوف مخرجاتها إلى هذا المستوى. يمكن اختيار عدة أزواج. | ### كيفية ظهور الصفوف عبر المستويات | المستوى | الصفوف التي تظهر للمسند إليه | |---|---| | المستوى 1 | كل الصفوف ذات الحالة **قيد الانتظار** التي لم يُتخذ إجراء بشأنها. | | المستوى 2 | الصفوف التي **اكتمل** مستواها الأول فقط، أي تمت الموافقة عليها أو اتُّخذ فيها الإجراء الذي ضبطته، بينما لا يزال المستوى الثاني قيد الانتظار. | | المستوى N | الصفوف التي اكتملت فيها كل المستويات السابقة وما زال المستوى الحالي قيد الانتظار. | تعني هذه التصفية التلقائية أن كل موافق يرى ما يخص مستواه فقط، من دون إعداد إضافي لكل تشغيل. ## نصائح وأفضل الممارسات - **استخدم أسماء واضحة لعُقد المهام في المصمم.** تسهّل تسميات مثل «المستوى 1 — موافقة المشرف» و«المستوى 2 — موافقة المالية» اختيار عقدة المصدر الصحيحة عند ضبط المستوى الثاني وما بعده. - **حافظ على حداثة بيانات الاستعلام.** تشغّل الموافقة لكل عنصر الاستعلام عند إنشاء المهمة. إذا تغيرت البيانات الأساسية بعد الإنشاء، يرى المسند إليه اللقطة المأخوذة وقت الإنشاء. صمم عمليتك وفق ذلك. - **استخدم «يتطلب تعليقًا» مع إجراءات الرفض.** غالبًا ما يتطلب الامتثال تعليقًا عند رفض صف. فعّل ذلك لزر الرفض كما يوضح [تصميم خطوات المهام](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/)، كي يكتب المسند إليه السبب. - **قلل عدد المستويات.** يمثل مستويان أو ثلاثة الحد العملي لمعظم العمليات. تزيد المستويات الإضافية التأخير؛ ففكر فيما إذا كان يمكن دمج بعضها أو أتمتته بعقدة وكيل الذكاء الاصطناعي. راجع [عقدة وكيل الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/). - **راجع شاشة قرارات الدُفعة بعد كل موافقة.** بعد إكمال مستوى، افتح شاشة قرارات الدُفعة للتأكد من صحة القرارات قبل بدء المستوى التالي. راجع [شاشة قرارات الدُفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/). - **صدّر CSV مبكرًا لمجموعات البيانات الكبيرة.** ينشئ زر تصدير CSV في شاشة قرارات الدُفعة سجل تدقيق كاملًا على مستوى الصف. نزله بمجرد اكتمال المستوى واحفظه للامتثال. ## الأسئلة الشائعة **س: هل يمكنني استخدام عقدة مهمة عادية وعقدة مهمة مفعّل فيها «الموافقة لكل عنصر» في سير العمل نفسه؟** نعم، يمكنك الجمع بينهما بحرية. الموافقة لكل عنصر مجرد إعداد لعقدة مهمة منفردة، وتستمر العُقد الأخرى في سير العمل نفسه في العمل بصورة عادية. **س: ماذا يحدث إذا رفض المستوى الأول صفًا، لكن المستوى الثاني مضبوط لاستقبال «أي» إجراء من المستوى الأول؟** يعتمد السلوك على الإجراءات التي اخترتها عند ضبط مصدر المهام السابقة للمستوى الثاني. إذا اخترت إجراء «موافقة» فقط من المستوى الأول، فلا تنتقل الصفوف المرفوضة إلى المستوى الثاني. وإذا اخترت «الكل» أو ضمّنت «رفض»، فإنها تنتقل. صمم اختيار الإجراءات بعناية. **س: هل يمكن أن يكون الشخص نفسه هو المسند إليه في المستويين الأول والثاني؟** نعم، لا يوجد قيد. لكن ذلك يفقد المراجعة متعددة المستويات غرضها. من الأفضل إسناد المستويات إلى أدوار أو أشخاص مختلفين. **س: تعرض المهمة صفرًا من الصفوف. ما الخطأ؟** تشمل الأسباب الشائعة: (1) لم يُعد الاستعلام بيانات وقت إنشاء المهمة؛ تحقق من وجود سجلات قيد الانتظار في جدول المصدر. (2) تبحث عقدة المستوى الثاني عن قرارات المستوى الأول قبل إرسالها؛ ينبغي ألا تُنشأ مهمة المستوى الثاني إلا بعد إكمال الأول. (3) اختير استعلام أو مهمة سابقة غير صحيحة. راجع قاعدة بيانات سير العمل للحصول على التفاصيل. انظر [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/). **س: هل يمكنني إضافة مستوى موافقة رابع أو خامس؟** نعم. أضف عقدة مهمة أخرى، واضبط مصدر البيانات على المهام السابقة، واختر عقدة المستوى الثالث وإجراءها المناسبين، واضبط مستوى الموافقة على 4. لا يوجد حد أقصى ثابت لعدد المستويات. **س: ماذا يحدث لبيانات الدُفعة بعد اكتمال جميع المستويات؟** تُحفظ قرارات كل صف في كل مستوى، بما فيها الإجراء والتعليق والطابع الزمني والمستخدم، في جدول الموافقات بقاعدة بيانات سير العمل. تستطيع الخطوات اللاحقة الاستعلام عنه بعقدة استعلام قاعدة البيانات، أو تستطيع تصدير السجل الكامل من شاشة قرارات الدُفعة. ## أدلة ذات صلة - [تصميم خطوات المهام: الإسناد والأولوية وأزرار الإجراءات ورفع المستندات](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [إدارة المواعيد النهائية: تواريخ الاستحقاق والتذكيرات والتصعيد والانتهاء](https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/) - [مدير مهام سير العمل: مراجعة المستندات واتخاذ القرارات](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [شاشة قرارات الدُفعة: الموافقات المجمعة على مستوى الصف وتصدير التدقيق](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/) - [كل المثيلات: تتبع مثيلات سير العمل الجارية والمكتملة](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/ # إدارة المواعيد النهائية: تحديد تواريخ الاستحقاق والتذكيرات والتصعيد والانتهاء > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي (مصممو عمليات سير العمل ومالكو العمليات) > **ستتعلم:** كيفية ضبط تواريخ الاستحقاق ورسائل التذكير التلقائية وقواعد التصعيد وإجراءات الانتهاء في عقدة المهمة، كي لا تتعطل أي مهمة أو تضيع. ## ما هذه الميزة؟ تشمل إدارة المواعيد النهائية في عمليات سير العمل كل ما يحدث عندما لا يُتخذ إجراء بشأن مهمة في الوقت المناسب. يمكنك في كل عقدة مهمة ضبط: - **تاريخ استحقاق** ثابت أو نسبي أو ديناميكي يوضح للمسند إليه موعد إكمال المهمة. - **رسائل تذكير** تُرسل تلقائيًا في الفترات التي تحددها قبل تاريخ الاستحقاق، لحث المسند إليه على التصرف. - **سياسة تصعيد** تعيد الإسناد أو تُشعر مشرفًا تلقائيًا بعد مدة قابلة للضبط إذا ظلت المهمة معلقة. - **إجراء انتهاء** يتولى المهمة إذا بلغت موعدًا نهائيًا صارمًا من دون إجراء؛ فيستطيع مثلًا رفض الطلب تلقائيًا أو إكماله كي يواصل سير العمل التقدم. تلغي هذه الإعدادات مجتمعة الحاجة إلى رسائل المتابعة اليدوية، وتضمن تقدم كل سير عمل بالسرعة المطلوبة. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **لا تضيع المهام في صندوق بريد مزدحم** — تُرسل التذكيرات تلقائيًا وفق جدولك، ولا تعتمد على مبادرة المسند إليه. - **لا تتعطل عمليات سير العمل إلى أجل غير مسمى** — يبدأ التصعيد تلقائيًا عندما لا يستجيب شخص، ويوجه المهمة إلى مشرف دون تدخل يدوي. - **تُطبق المواعيد الصارمة تلقائيًا** — يستطيع إجراء الانتهاء رفض المهمة أو تصعيدها أو إكمالها أو تعليقها عند انقضاء الموعد، فتستمر العملية حتى من دون تدخل بشري. - **سجل تدقيق كامل** — يُسجل كل تذكير مرسل وتصعيد بدأ وإجراء انتهاء نُفّذ في سجل سير العمل، لتتمكن من إثبات اتباع العملية للخطوات الصحيحة. - **صيغ تاريخ مرنة** — يمكن أن يكون تاريخ الاستحقاق ثابتًا، أو إزاحة محسوبة من بدء سير العمل مثل «+5 أيام»، أو تاريخًا ديناميكيًا من متغير سير عمل، وبذلك يخدم تصميم واحد حالات استخدام متعددة. ## قبل أن تبدأ - افتح سير العمل المطلوب في المصمم المرئي بوضع التحرير، وتأكد من ضبط إعدادات عقدة المهمة الأساسية، مثل العنوان والمسند إليه والإجراءات. راجع [تصميم خطوات المهام](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/). - إذا كنت ستستخدم تاريخ استحقاق ديناميكيًا من متغير، فتأكد من التقاط سير العمل لهذا التاريخ في متغير بعقدة البدء أو بخطوة سابقة. راجع [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/). - حدد مستلم التصعيد: عنوان بريد إلكتروني أو دور أو متغير. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — افتح خصائص عقدة المهمة 1. انقر على عقدة المهمة في اللوحة نقرًا مزدوجًا لفتح لوحة الخصائص. 2. حدد حقل **تاريخ الاستحقاق** في علامة **أساسي**. ### الخطوة 2 — حدد تاريخ الاستحقاق 3. أدخل تاريخ الاستحقاق بإحدى الطرق الثلاث: | الصيغة | المثال | المعنى | |---|---|---| | تاريخ/وقت ثابت | `2026-12-31T17:00:00` | موعد نهائي مطلق بغض النظر عن وقت بدء سير العمل. | | إزاحة نسبية | `+5d` أو `+3h` أو `+2w` | تاريخ محسوب من وقت إنشاء المهمة. يرمز `d` إلى الأيام و`h` إلى الساعات و`w` إلى الأسابيع. | | متغير سير عمل | `{{contract_expiry_date}}` | تاريخ مأخوذ من متغير سير عمل، ويجب أن يكون بصيغة ISO 8601. | > يعني ترك تاريخ الاستحقاق فارغًا أن المهمة ليس لها موعد نهائي ملزم. تستمر التذكيرات والتصعيد في العمل، لكن قد يختلف سلوكهما في غياب تاريخ أساس. ### الخطوة 3 — اضبط رسائل التذكير 4. اختر علامة **الإشعارات** في لوحة خصائص المهمة. 5. فعّل **إرسال تذكيرات**. 6. أدخل في حقل **فواصل التذكير** قائمة فترات تفصلها فواصل، وتُقاس رجوعًا من تاريخ الاستحقاق أو تقدمًا من إنشاء المهمة. أمثلة: - `24h, 4h` — إرسال تذكير قبل تاريخ الاستحقاق بـ24 ساعة، ثم تذكير آخر قبله بأربع ساعات. - `30m, 3h, 8h` — إرسال ثلاثة تذكيرات متصاعدة. 7. اختر **تحرير رسالة التذكير** لفتح منشئ البريد بالسحب والإفلات وتخصيص الرسالة. يتضمن القالب الافتراضي علامات الدمج `{{task_title}}` و`{{assignee_name}}` و`{{due_date}}` و`{{reminder_number}}` و`{{total_reminders}}`. 8. اختر **حساب الإرسال**، أي إعداد البريد، المستخدم للتذكيرات. ### الخطوة 4 — اضبط التصعيد 9. انتقل إلى قسم **سياسة التصعيد** في علامة **الإكمال**. 10. فعّل **التصعيد مُمكّن**. 11. أدخل في **التصعيد بعد** المدة التي تلي إنشاء المهمة، أو تاريخ الاستحقاق، قبل بدء التصعيد. استخدم الصيغة نفسها، مثل `48h` أو `3d` أو `1w`. 12. أدخل في **التصعيد إلى** عنوان البريد الإلكتروني أو `{{variable}}` للشخص أو الدور الذي ينبغي أن يتلقى إشعار التصعيد، مثل مدير المسند إليه. 13. اختر **تحرير رسالة التصعيد** لتخصيص الرسالة التي يتلقاها مستلم التصعيد. يشرح القالب الافتراضي الحالة ويوفر روابط الإجراءات الأصلية. ### الخطوة 5 — اضبط إجراء الانتهاء 14. حدد قسم **الانتهاء** في علامة **الإكمال**. 15. فعّل **الانتهاء مُمكّن**. 16. أدخل في **مدة الانتهاء** الزمن الذي ينبغي بعده بدء الانتهاء، محسوبًا من إنشاء المهمة أو تاريخ الاستحقاق. مثال: `7d`. 17. اختر من **الإجراء عند الانتهاء** ما ينبغي أن يفعله سير العمل إذا لم يتصرف أحد قبل لحظة الانتهاء: | الخيار | ما الذي يحدث؟ | |---|---| | **رفض** | تُرفض المهمة تلقائيًا، ويتبع سير العمل حافة «مرفوض» إلى الخطوة التالية. | | **تصعيد** | يعاد إسناد المهمة إلى عنوان بريد التصعيد المحدد وتُرسل رسالة إشعار. | | **إكمال** | تُستكمل المهمة تلقائيًا ويتبع سير العمل حافة «مكتمل». | | **تعليق** | توضع المهمة في حالة تعليق ويتبع سير العمل حافة «تعليق» إذا كانت معرفة. | 18. إذا اخترت **تصعيد**، فأدخل عنوان البريد في حقل **التصعيد إلى (الانتهاء)**. 19. اختر **تحرير رسالة الانتهاء** لتخصيص الإشعار المرسل عند تنفيذ إجراء الانتهاء. 20. اختر **حفظ المهمة** لتطبيق جميع إعدادات الموعد النهائي. ## شرح الخيارات والإعدادات ### حقل تاريخ الاستحقاق (علامة أساسي) | الصيغة | الوصف | الاستخدام المناسب | |---|---|---| | تاريخ/وقت ثابت | تاريخ ووقت مطلقان بصيغة ISO 8601 | المواعيد التنظيمية وتواريخ العقود والأحداث لمرة واحدة | | إزاحة نسبية (`+Nd` أو `+Nh` أو `+Nw`) | تُحسب من وقت إنشاء المهمة | اتفاقيات مستوى الخدمة القياسية | | متغير سير عمل (`{{variable_name}}`) | قيمة تاريخ من حقل نموذج أو خطوة سابقة | العمليات المعتمدة على التاريخ، مثل تجديد العقود | ### فواصل التذكير (علامة الإشعارات) | الإعداد | الوصف | |---|---| | **إرسال تذكيرات** | المفتاح الرئيسي؛ عند تعطيله لا تُرسل تذكيرات مهما كانت الإعدادات الأخرى. | | **فواصل التذكير** | قائمة رموز زمنية تفصلها فواصل. يطلق كل رمز رسالة تذكير، ويُقاس رجوعًا من تاريخ الاستحقاق؛ فمثلًا `24h` تعني 24 ساعة قبله. | | **تحرير رسالة التذكير** | يفتح منشئ السحب والإفلات للرسالة، وتتوفر فيه جميع متغيرات سير العمل كعلامات دمج. | ### سياسة التصعيد (علامة الإشعارات) | الإعداد | الوصف | |---|---| | **التصعيد مُمكّن** | المفتاح الرئيسي للتصعيد التلقائي. | | **التصعيد بعد** | المدة من إنشاء المهمة أو تاريخ الاستحقاق إلى بدء التصعيد. استخدم `h` للساعات و`d` للأيام و`w` للأسابيع. | | **التصعيد إلى** | عنوان البريد أو `{{variable}}` لمستلم التصعيد، وغالبًا يكون مشرف المسند إليه. | | **تحرير رسالة التصعيد** | يخصص الرسالة التي يتلقاها مستلم التصعيد. | ### إعدادات الانتهاء (علامة متقدم) | الإعداد | الوصف | |---|---| | **الانتهاء مُمكّن** | المفتاح الرئيسي لإجراء الانتهاء التلقائي. | | **مدة الانتهاء** | المدة التي تلي إنشاء المهمة قبل بدء الانتهاء، مثل `7d` أو `14d`. | | **الإجراء عند الانتهاء** | ما يفعله النظام عند الانتهاء: رفض أو تصعيد أو إكمال أو تعليق. | | **التصعيد إلى (الانتهاء)** | إذا كان الإجراء «تصعيد»، فهذا عنوان البريد أو المتغير الذي يعاد الإسناد إليه. | | **تحرير رسالة الانتهاء** | يخصص الإشعار المرسل عند تنفيذ إجراء الانتهاء. | ## نصائح وأفضل الممارسات - **حدد تذكيرات في أوقات مفيدة.** نادرًا ما يفيد تذكير واحد قبل الموعد بخمس دقائق. استخدم `5d, 1d, 4h` لمهمة تمتد أسبوعًا كي تمنح المسند إليه وقتًا كافيًا. - **افصل التصعيد عن الانتهاء.** يُشعر التصعيد المشرف ويبقي المهمة مفتوحة للإجراء البشري، أما الانتهاء فيغلقها تلقائيًا. استخدم التصعيد أولًا، ثم اجعل الانتهاء ضمانًا نهائيًا بعد مدة أطول. - **طابق الانتهاء مع اتفاقية مستوى الخدمة.** إذا كانت السياسة تتطلب معالجة الطلبات خلال عشرة أيام عمل، فاضبط الانتهاء على `10d` وإجراءه على «تصعيد» إلى مدير يستطيع التحقيق، بدلًا من «رفض» الذي قد تترتب عليه عواقب على العمل. - **اختبر التصعيد في بيئة التطوير.** اضبطه على `2m`، أي دقيقتين، في سير عمل اختباري وشغله وتأكد من وصول الرسالة، ثم غيّر المدة إلى القيمة الفعلية قبل الإطلاق. - **استخدم المتغيرات لتواريخ الاستحقاق** عندما يكون الموعد قائمًا على البيانات، مثل انتهاء عقد في تاريخ أُدخل في نموذج المشغّل. يلغي ذلك تحديثات التاريخ اليدوية عبر الإصدارات. - **لا تضبط الانتهاء على «إكمال» إلا إذا كانت الموافقة التلقائية مقبولة.** يتجاوز الإكمال التلقائي المراجعة البشرية في معظم عمليات الموافقة. استخدمه فقط في المهام الإدارية التي يعني فيها عدم الرد الموافقة ضمنيًا. ## الأسئلة الشائعة **س: هل يمكنني ضبط تذكير وتصعيد للمهمة نفسها؟** نعم. تُشعر التذكيرات المسند إليه الأصلي، بينما يُشعر التصعيد شخصًا مختلفًا، أو الشخص نفسه بدرجة إلحاح أعلى. يعملان بصورة مستقلة. **س: ماذا يحدث إذا كان متغير تاريخ الاستحقاق فارغًا عند إنشاء المهمة؟** إذا كان فارغًا، فلا يُحدد تاريخ الاستحقاق ولا تعمل مؤقتات التذكير أو التصعيد المرتبطة به. تستمر المؤقتات المحسوبة من إنشاء المهمة في العمل. تحقق دائمًا من تعبئة متغيرات التاريخ المطلوبة قبل بلوغ عقدة المهمة. **س: هل يعيد التصعيد إسناد المهمة بعيدًا عن المسند إليه الأصلي؟** يرسل التصعيد إشعارًا إلى مستلمه، لكنه لا يزيل المسند إليه الأصلي تلقائيًا؛ ويمكن لكليهما التصرف. لإعادة إسناد نهائية، اضبط إجراء الانتهاء على «تصعيد» فتنتقل المهمة إلى المسند إليه الجديد. **س: كم عدد فواصل التذكير التي يمكنني تعريفها؟** لا يوجد حد ثابت، لكن أكثر من أربعة أو خمسة تذكيرات لمهمة واحدة قد يكون مزعجًا للمستلمين. ثلاثة تذكيرات ممارسة شائعة جيدة. **س: ماذا يحدث لرسائل التذكير المعلقة إذا اكتملت المهمة قبل إرسالها؟** تُلغى التذكيرات بمجرد اتخاذ إجراء في المهمة. لا يتلقى المسند إليه تذكيرات بعد إكمال المهمة أو رفضها أو تعليقها. **س: هل يمكنني استخدام التصعيد في كل مستوى من سلسلة موافقات متعددة المستويات؟** نعم. لكل عقدة مهمة إعداداتها المستقلة للموعد والتذكير والتصعيد والانتهاء. اضبط كل مستوى على حدة وفق اتفاقية مستوى الخدمة المناسبة لتلك المرحلة. **س: انتهى سير العمل ورفض تلقائيًا طلبًا كان ينبغي قبوله. هل يمكنني التراجع؟** لا يمكن عكس الإجراء التلقائي من الواجهة. فضّل «تصعيد» كإجراء انتهاء في العمليات الحساسة للامتثال، كي يراجع المدير يدويًا قبل القرار النهائي. إذا حدث خطأ، فقد يحتاج المسؤول إلى بدء سير العمل يدويًا من جديد. ## أدلة ذات صلة - [تصميم خطوات المهام: الإسناد والأولوية وأزرار الإجراءات ورفع المستندات](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [الموافقات متعددة المستويات والدُفعات: الموافقة لكل عنصر والقرارات على مستوى الصف](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) - [عقدة مجدول التذكير: أتمتة رسائل التذكير المستندة إلى التاريخ](https://raptix.app/user-guide/ar/10-workflows/10-18-reminder-scheduler-node/) - [عقدة البريد الإلكتروني: إنشاء رسائل إشعار غنية](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [مهامي: عرض المهام المسندة وتصفيتها وتنفيذها](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [كل المثيلات: تتبع مثيلات سير العمل الجارية والمكتملة](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/ # منطق التوجيه: شروط إذا/وإلا والفروع الشرطية ومنشئ التعبيرات > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي > **ستتعلم:** كيفية إضافة نقاط قرار إلى سير العمل ترسل كل مثيل في المسار الصحيح بناءً على قيم البيانات الفعلية، باستخدام عُقد إذا/وإلا البسيطة وعُقد الفروع الشرطية متعددة المسارات. ## ما هذه الميزة؟ عُقد التوجيه هي نقاط قرار تفحص البيانات التي جُمعت حتى الآن وتختار المسار الذي ينبغي اتباعه. توفر عمليات سير العمل أداتين متكاملتين للتوجيه: - **عقدة شرط إذا/وإلا** — تقسيم تقليدي إلى مسارين؛ يسلك سير العمل مسارًا إذا تحققت الشروط، ومسارًا آخر إذا لم تتحقق. - **عقدة الفرع الشرطي** — تقسيم إلى أي عدد من المسارات المسماة، ولكل فرع مجموعته الخاصة من الشروط. يُتخذ أول فرع مطابق. تعمل العقدتان مع كل أنواع البيانات التي يعالجها سير العمل: النصوص والأرقام والتواريخ وقيم صحيح/خطأ والقوائم والكائنات. كما تدعمان مقارنة الحقول بقيم ثابتة أو بمتغيرات سير عمل أخرى. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **أتمتة القرارات التي كانت ستحتاج إلى مراجع بشري.** أرسل طلبات الشراء الصغيرة إلى الموافقة التلقائية، ووجّه الكبيرة إلى مدير، وصعّد العاجلة إلى مدير تنفيذي، من دون تدخل يدوي. - **بناء منطق متعدد المسارات ومعقد من دون تداخل.** تعالج عقدة الفرع الشرطي ثلاث نتائج أو خمسًا أو عشرًا في عقدة واحدة بدلًا من سلسلة عُقد إذا/وإلا متداخلة. - **استخدام البيانات الفعلية في الشروط.** يتوفر للمقارنة كل متغير جُمع في سير العمل، بما فيه حقول النموذج ومخرجات المهمة ونتائج وكيل الذكاء الاصطناعي. - **دمج عدة قواعد بدقة.** اختر داخل مجموعة الشرط **مطابقة الكل** كي تمر كل القواعد، أو **مطابقة أي منها** كي تكفي قاعدة واحدة. اربط عدة مجموعات بعامل AND أو OR آخر لمزيد من التحكم. - **عوامل تراعي النوع وتمنع الأخطاء الصامتة.** تُقارن التواريخ كتواريخ لا كنصوص، وتستخدم الأرقام مقارنة رقمية. تتكيف قائمة العوامل تلقائيًا عند تغيير نوع البيانات. - **يواصل سير العمل بأمان حتى عندما تكون الشروط غير محسومة.** يسلك المثيل الذي لا يطابق أي فرع في عقدة الفرع الشرطي اتصال الرجوع الافتراضي بدلًا من التوقف على نحو مفاجئ. ## قبل أن تبدأ - تحتاج إلى الوصول إلى مصمم عمليات سير العمل للعملية التي تريد تحريرها. إذا كان سير العمل مقفلًا، فاطلب من المسؤول فتحه أو منحك الوصول. - ينبغي أن يحتوي سير العمل بالفعل على عقدة بدء مضبوطة، لأن الشروط تشير إلى المتغيرات الواردة منها. - افتح سير العمل من **إدارة عمليات سير العمل** باختيار إجراء القلم في صفه. ## طريقة الاستخدام خطوة بخطوة ### إضافة عقدة شرط إذا/وإلا 1. افتح علامة **منطق** في الشريط الجانبي للعُقد يسار المصمم المرئي. 2. اسحب عقدة **شرط إذا/وإلا** إلى اللوحة وضعها بعد الخطوة التي تجمع البيانات المطلوب اختبارها. 3. صِل مقبض إخراج العقدة السابقة بمقبض إدخال عقدة إذا/وإلا. تظهر حافة ذات تسمية. 4. انقر على العقدة نقرًا مزدوجًا، أو اختر رمز الترس الذي يظهر عند المرور، لفتح مربع **شروط إذا/وإلا**. 5. في لوحة **الإعدادات العامة** أعلى مربع الحوار: - اضبط **منطق المجموعات** على **مطابقة كل المجموعات (AND)** إذا كان لا بد أن تمر جميعها، أو **مطابقة أي مجموعة (OR)** إذا كان مرور مجموعة واحدة كافيًا. - اترك **تحويل النوع** مفعّلًا ما لم تكن تريد تطابقًا صارمًا للأنواع، مثل منع النص `"5"` من مطابقة الرقم `5`. 6. في مجموعة الشرط الأولى: - اضبط محدد **مطابقة الكل/مطابقة أي منها** الداخلي للتحكم في كيفية جمع قواعد المجموعة. - أكمل حقل **عندما** بالقيمة أو المتغير المطلوب اختباره. استخدم زر **المتغيرات** لاختيار قيمة جمعتها عقدة البدء بدلًا من كتابة الاسم يدويًا. - اختر نوع البيانات: نص أو رقم أو تاريخ أو قيمة منطقية أو مصفوفة أو كائن. تتحدث قائمة العوامل لتعرض الخيارات المناسبة فقط. - اختر **الوضع** لقيمة الجانب الأيسر: **ثابت** لإدخال قيمة حرفية، أو **تعبير** للصق رمز `{{variable}}`. - اختر عامل **يكون** من القائمة. - أكمل حقل **القيمة** في الجانب الأيمن. استخدم **ثابت** للمقارنة بقيمة حرفية، أو **تعبير** وزر **المتغيرات** للمقارنة بمتغير آخر. 7. لإضافة قاعدة أخرى إلى المجموعة نفسها، اختر **إضافة شرط** أسفل بطاقة المجموعة. 8. لإضافة مجموعة ثانية بعامل OR أو AND على مستوى المجموعات، اختر **إضافة مجموعة شروط** أسفل المجموعات الحالية. 9. أدخل **وصفًا** اختياريًا كي توثق العقدة نفسها على اللوحة. 10. اختر **حفظ الشروط**. يُغلق مربع الحوار. 11. ارسم حافتين من مخرجي **نعم** و**لا** إلى الخطوتين التاليتين المناسبتين. 12. اختر **حفظ** أو اضغط **Ctrl+S** لحفظ سير العمل. --- ### إضافة عقدة فرع شرطي 1. اسحب عقدة **فرع شرطي** من علامة **منطق** في الشريط الجانبي إلى اللوحة. 2. صِل مخرج العقدة السابقة بمدخل هذه العقدة. 3. انقر على العقدة نقرًا مزدوجًا لفتح مربع **خصائص الفرع الشرطي**. 4. اختر **إضافة فرع جديد** لإنشاء أول فرع مسمى. 5. لكل فرع: - أدخل **اسم الفرع** الذي يصف النتيجة، مثل «قيمة عالية» أو «تمت الموافقة» أو «بانتظار المراجعة». - ضمن **ضبط الشروط**، اختر الرمز **+** لإضافة صف شرط أو أكثر. - حدد في كل صف **الحقل** من القائمة التي تضم حقول النموذج الثابتة وأي متغيرات سير عمل، ثم اختر **الحالة**، أي العامل، وأدخل أو اختر **القيمة** إذا كانت مطلوبة. - إذا كان للفرع أكثر من شرط، يظهر محدد **إذا تطابقت كل الشروط/أي منها**؛ اختر المنطق المناسب. 6. كرر لكل فرع إضافي باختيار **إضافة فرع جديد** مرة أخرى. 7. أدخل **وصف الفرع** أسفل الصفحة لتوثيق الغرض العام من العقدة. 8. اختر **حفظ**. يُغلق مربع الحوار. 9. ارسم في المصمم حافة من مقبض كل فرع مسمى إلى الخطوة التالية المناسبة. يأخذ المحرك أول فرع تتحقق شروطه، وإذا لم يطابق أي فرع، فيستخدم الحافة الافتراضية إن رسمتها. 10. اختر **حفظ** أو اضغط **Ctrl+S**. ## شرح الخيارات والإعدادات ### عقدة شرط إذا/وإلا — الإعدادات العامة | الإعداد | الخيارات | ما الذي يفعله؟ | |---|---|---| | **منطق المجموعات** | مطابقة كل المجموعات (AND) / مطابقة أي مجموعة (OR) | يتحكم في جمع مجموعات الشروط. يعني AND ضرورة مرورها كلها، ويعني OR أن مرور واحدة كافٍ. | | **تحويل النوع** | تشغيل/إيقاف | عند تفعيله، يحوّل المحرك القيم قبل مقارنتها، مثل مساواة النص `"5"` بالرقم `5`. عند تعطيله، يجب أن تتطابق الأنواع تمامًا. الإعداد الافتراضي: مفعّل. | ### حقول صف الشرط | الحقل | ما الذي يفعله؟ | |---|---| | **عندما** | قيمة الجانب الأيسر المطلوب اختبارها. أدخل قيمة ثابتة أو رمز `{{variable}}`. | | **نوع البيانات** (يسار) | يحدد تفسير القيمة والعوامل الظاهرة. الخيارات: نص، رقم، تاريخ، قيمة منطقية، مصفوفة، كائن. | | **الوضع** (يسار) | **ثابت** لإدخال قيمة حرفية مباشرة، أو **تعبير** لإدخال رمز `{{variable}}` أو لصقه للبحث الديناميكي. | | **زر المتغيرات** | يفتح منتقيًا يعرض كل متغير متاح من العُقد السابقة؛ يؤدي اختيار متغير إلى إدراج `{{variable_name}}`. | | **يكون** (العامل) | المقارنة المطلوب تطبيقها. تعتمد الخيارات على نوع البيانات المحدد. | | **القيمة** (يمين) | قيمة الجانب الأيمن أو المتغير الذي ستُجرى المقارنة معه. | | **نوع البيانات** (يمين) | نوع قيمة المقارنة، ويمكن أن يختلف عن النوع الأيسر عندما يكون تحويل النوع مفعّلًا. | | **الوضع** (يمين) | مثل الوضع الأيسر: ثابت أو تعبير. | ### عوامل التشغيل حسب نوع البيانات | نوع البيانات | العوامل المتاحة | |---|---| | **كل الأنواع** | موجود، غير موجود، فارغ، غير فارغ | | **نص** | يساوي، لا يساوي، يحتوي، لا يحتوي، يبدأ بـ، ينتهي بـ، يطابق تعبيرًا نمطيًا | | **رقم** | يساوي، لا يساوي، `>` أكبر من، `<` أصغر من، `>=` أكبر من أو يساوي، `<=` أصغر من أو يساوي | | **تاريخ** | يساوي، بعد، قبل | | **قيمة منطقية** | صحيح، خطأ، يساوي | | **مصفوفة** | تحتوي، طولها يساوي، طولها أكبر من، طولها أصغر من | ### حقول عقدة الفرع الشرطي | الحقل | ما الذي يفعله؟ | |---|---| | **اسم الفرع** | تسمية مسار النتيجة، وتصبح أيضًا تسمية الحافة على اللوحة. | | قائمة **الحقل** | حقل النموذج أو متغير سير العمل المطلوب اختباره. تتضمن المتغيرات الديناميكية عند وجود عقدة بدء ذات متغيرات. | | **الحالة** (العامل) | المقارنة: فارغ، معبأ، قبل، بعد، يحتوي، يبدأ بـ، يساوي، لا يساوي، أكبر من، أصغر من، والخيارات الخاصة بالتاريخ. | | **القيمة** | قيمة المقارنة. تعرض حالات التاريخ إدخال تاريخ، والحالات الرقمية إدخال رقم، وغيرها إدخال نص. | | **زر المتغيرات** | يدرج رمز `{variable_name}` من سير العمل في حقل القيمة. | | **كل الشروط/أي منها** | عند وجود عدة شروط في الفرع: الكل يعني وجوب مرور كل شرط، وأي منها يعني أن مرور شرط واحد يكفي. | | **وصف الفرع** | ملاحظة نصية حرة واختيارية تُحفظ مع العقدة. | ## نصائح وأفضل الممارسات - **سمِّ الفروع والشروط بوضوح.** يسهل الحفاظ بعد ستة أشهر على فرع باسم «المبلغ أكبر من 10,000 دولار» أكثر من فرع باسم «الفرع 2». - **ضع الفرع الأكثر تحديدًا أولًا.** تتخذ عقدة الفرع الشرطي أول فرع مطابق. إذا سبق فرع عام فرعًا محددًا، فلن يصل التنفيذ إلى المحدد. - **استخدم زر المتغيرات بدلًا من كتابة `{{variable_name}}` يدويًا.** يمنع الأخطاء ويضمن تطابق الاسم مع ما يتوقعه المحرك. - **استخدم حقل الوصف في عُقد إذا/وإلا** لتسجيل قاعدة العمل وراء الشرط، لا سيما عندما يتولى عدة أشخاص صيانة سير العمل. - **اختبر الحالات الحدّية.** شغّل اختبارًا بقيمة تقع على حد الشرط تمامًا، مثل الرقم المطابق للعتبة، للتأكد من صحة اتجاه العامل. - **اجعل المجموعات مسطحة قدر الإمكان.** يسهل فهم مجموعة واحدة ذات عدة قواعد AND أكثر من تسلسل مجموعات متداخل. لا تضف مجموعة ثانية إلا عندما تحتاج فعلًا إلى منطق OR بين مجموعتين منفصلتين من القواعد. - **استخدم «غير موجود» للحقول الاختيارية.** احمِ المنطق من القيم الفارغة باختبار «غير موجود» أو «فارغ» قبل استخدامها في شروط لاحقة. ## الأسئلة الشائعة **س: ماذا يحدث إذا لم يطابق مثيل سير العمل أي فرع في عقدة الفرع الشرطي؟** إذا رسمت حافة خروج افتراضية لا ترتبط بمخرج فرع محدد، يسلك المثيل تلك الحافة. وإذا لم توجد حافة افتراضية، يتوقف المثيل عند العقدة. راجع **كل المثيلات** للعثور على المثيلات المتوقفة. **س: هل يمكنني الإشارة إلى قيمة أدخلها المسند إليه في مهمة، لا في النموذج الأولي فقط؟** نعم. تتوفر المتغيرات الناتجة عن المهام في منتقي المتغيرات ضمن مجموعة عقدة المهمة. تأكد من أن العقدة التي تجمع القيمة تسبق عقدة الشرط. **س: لا يظهر زر «المتغيرات». ما الخطأ؟** لا يظهر الزر إلا عندما يستطيع المصمم اكتشاف متغيرات من العُقد السابقة، وغالبًا من عقدة بدء ذات webhook أو تكامل نموذج التطبيقات أو من مخرجات المهام. إذا لم يكتشف متغيرات، يمكنك كتابة `{{variable_name}}` مباشرة في وضع التعبير. **س: ماذا تعني «مطابقة الكل (AND)» مقارنة بـ«مطابقة أي منها (OR)» داخل مجموعة شرط؟** تعني مطابقة الكل وجوب صحة كل قاعدة كي تمر المجموعة، بينما تعني مطابقة أي منها أن صحة قاعدة واحدة تكفي. استخدم AND للفحوص الضيقة الدقيقة، وOR للفحوص المرنة التي يكفي فيها شرط من عدة شروط. **س: هل يمكن مقارنة متغيري سير عمل بدلًا من مقارنة متغير بقيمة ثابتة؟** نعم. اضبط الجانبين الأيسر والأيمن على وضع التعبير، وأدرج رمز `{{variable}}` في كل منهما. يحل المحرك القيمتين وقت التشغيل ويقارنهما. **س: إذا حدّثت شرطًا بعد بدء سير العمل، فهل يؤثر في المثيلات الجارية؟** لا. تتبع المثيلات الجارية إصدار سير العمل الذي كان نشطًا عند بدئها. يؤثر حفظ إصدار جديد في المثيلات المستقبلية فقط. ## أدلة ذات صلة - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [المعالجة المتوازية: تقسيم الفروع ودمجها والحلقات](https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/ # التقسيم والدمج ولكل عنصر والحلقة > **الوحدة:** منشئ التدفق > > **الجمهور:** مصممو عمليات سير العمل > > **ستتعلم:** أوجه الاختلاف بين المسارات المتوازية الحالية وتكرار القوائم وحلقات إعادة المحاولة، وكيفية ضبط كل منها. ## اختيار العقدة الصحيحة | الحاجة | العقدة | |---|---| | تشغيل مسارين أو أكثر بالتوازي | **تقسيم الفروع** | | إعادة جمع المسارات المتوازية | **دمج الفروع** | | إنشاء مهمة لكل عنصر في قائمة | **لكل عنصر** — Enterprise | | العودة إلى خطوة سابقة لإعادة المحاولة أو المراجعة | **حلقة** | عقدتا `Foreach` و`Loop` مختلفتان. تستهلك الأولى قائمة، بينما تنشئ الثانية مسار رجوع مقصودًا وتحد عدد المحاولات عند ضبطه. ## تقسيم الفروع 1. اسحب **تقسيم الفروع** من **منطق** وضعها بعد الخطوة التي يبدأ عندها العمل المتوازي. 2. صِل العقدة السابقة بها. 3. ارسم اتصال خروج لكل مسار متوازٍ. 4. أنشئ كل مسار بصورة مستقلة. 5. أنهِ كل مسار أو صِل عقدته الأخيرة بعقدة **دمج الفروع** نفسها. لا تحتوي عقدة تقسيم الفروع على نموذج خصائص؛ اتصالات الخروج هي التي تحدد المسارات المتوازية. ## دمج الفروع صِل جميع الفروع المشاركة بعقدة **دمج الفروع**، وافتح خصائصها، ثم اختر: | الخيار | السلوك | |---|---| | **انتظار جميع الفروع** | لا تتابع إلا بعد اكتمال كل فرع وارد. | | **انتظار أي فرع** | تابع بعد اكتمال أول فرع، وأنهِ صلاحية الفروع النشطة الأخرى. | | **انتظار عدد محدد** | تابع بعد اكتمال العدد المطلوب؛ الحد الأقصى هو عدد الفروع الواردة. | استخدم «الجميع» عندما تحتاج كل النتائج، و«أي» في حالة السباق، و«العدد» عند الحاجة إلى نصاب. احفظ العقدة، ثم صِل مخرجها بالخطوة التالية. ## لكل عنصر تظهر عقدة **لكل عنصر** في لوحة **أساسي** لحسابات Enterprise. تكرر التنفيذ على قائمة وتنشئ مهمة لكل عنصر. اضبط الحقول التالية: | الحقل | المعنى | |---|---| | **متغير العناصر** | متغير مطلوب يحمل القائمة، مثل `db_rows`. | | **الاسم البديل للعنصر** | الاسم المستخدم للعنصر الحالي؛ القيمة الافتراضية `item`. | | **قاعدة الإكمال — الكل** | المتابعة بعد اتخاذ إجراء في كل المهام الناتجة. | | **قاعدة الإكمال — أي** | المتابعة بعد اتخاذ إجراء في أول مهمة ناتجة. | يتوفر العنصر الحالي من خلال اسمه البديل. فمثلًا، إذا كان الاسم `employee`، تستطيع حقول المهمة اللاحقة استخدام قيمة مثل `{{employee.email}}` عندما تكون الخاصية موجودة. تعرض عقدة «لكل عنصر» أيضًا قيم النتائج لمتغير العناصر المحدد: - `{items_variable}_results.items_processed` - `{items_variable}_results.tasks_completed` - `{items_variable}_results.completion_rule` استخدم لوحة المتغيرات لنسخ الأسماء الدقيقة التي أنشأتها العقدة الحالية. ## الحلقة استخدم **حلقة** للعودة إلى عقدة سابقة. افتح خصائصها وأدخل **تسمية العقدة** المطلوبة ووصفًا اختياريًا. اختر سلوك المحاولات: | الإعداد | السلوك | |---|---| | **محدودة** | أعد المحاولة حتى **الحد الأقصى للمحاولات**، ثم استخدم نتيجة **تم بلوغ الحد**. | | **غير محدودة** | استمر في نتيجة **إعادة المحاولة** إلى أن يوجه قرار سابق التنفيذ إلى موضع آخر. | | **الحد الأقصى للمحاولات** | مطلوب للحالة المحدودة؛ يقبل من 1 إلى 100، والقيمة الافتراضية 3. | بعد الحفظ، صِل النتيجتين عند انطباقهما: - تعود **إعادة المحاولة** إلى الخطوة السابقة. - تذهب **تم بلوغ الحد** إلى التصعيد أو معالجة الفشل أو النهاية. تحتاج الحلقة غير المحدودة إلى شرط خروج حقيقي في موضع سابق من الدورة. من دونه، قد يستمر المثيل إلى أجل غير مسمى. ## قائمة التحقق 1. يصل كل مسار مقسم إلى الدمج المقصود أو ينتهي بصورة مستقلة. 2. لا يتجاوز عدد الدمج عدد الاتصالات الواردة. 3. تتلقى عقدة «لكل عنصر» قائمة قبل تشغيلها، ويطابق الاسم البديل المتغيرات اللاحقة. 4. لعقدة الحلقة المحدودة مسارا **إعادة المحاولة** و**تم بلوغ الحد**. 5. للحلقة غير المحدودة شرط سابق أو نتيجة بشرية تسمح بالخروج. 6. احفظ واختبر بقائمة صغيرة أو بعدد محاولات منخفض قبل الاستخدام الإنتاجي. ## أدلة ذات صلة - [شروط التوجيه](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [استعلام قاعدة البيانات](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) - [لوحة المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-13-pause-delay-node/ # عقدة الإيقاف المؤقت/التأخير: المدد الثابتة والتواريخ المحددة والتأخير المعتمد على المتغيرات > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي > **ستتعلم:** كيفية إضافة فترة انتظار زمنية إلى سير العمل، بحيث لا تبدأ الخطوة التالية إلا بعد مرور مدة محددة، أو حلول تاريخ ووقت تختارهما، أو بلوغ تاريخ محفوظ ضمن بياناتك. ## ما هذه الميزة؟ تعلّق عقدة **الإيقاف المؤقت** مثيل سير عمل قيد التشغيل عند نقطة محددة لمدة زمنية مضبوطة. عند انتهاء الانتظار، يستأنف سير العمل تلقائيًا وينتقل إلى الخطوة التالية من دون الحاجة إلى إجراء يدوي. تتوفر ثلاثة أوضاع للانتظار: - **لمدة زمنية** — الانتظار عددًا ثابتًا من الثواني أو الدقائق أو الساعات أو الأيام أو الأسابيع أو الأشهر. - **إيقاف مؤقت حتى تاريخ** — الانتظار حتى تاريخ ووقت محددين تضبطهما في المصمم. - **إيقاف مؤقت حتى تاريخ متغير** — الانتظار حتى تاريخ محفوظ في أحد متغيرات سير العمل، مثل تاريخ انتهاء عقد مأخوذ من نموذج، مع إمكانية إضافة إزاحة زمنية. أثناء الإيقاف المؤقت يُعلّق مثيل سير العمل لكنه لا يضيع. يستأنف التنفيذ من الموضع نفسه تمامًا، بغض النظر عما يحدث للخادم خلال فترة الانتظار. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **إضافة فترات انتظار مضبوطة من دون مراقبة يدوية.** تتولى عقدة الإيقاف التوقيت تلقائيًا؛ فلا تحتاج إلى ضبط تذكير في التقويم أو التحقق يدويًا لبدء الخطوة التالية. - **إرسال الإشعارات في اللحظة المناسبة تمامًا.** ضع عقدة إيقاف مؤقت قبل عقدة بريد لإرسال تذكير متابعة بعد ثلاثة أيام بالضبط من الرسالة الأصلية. - **الالتزام بتقاويم العمل وفترات اتفاقية مستوى الخدمة.** استخدم مدة ثابتة لفرض فترة مراجعة قبل نشر قرار، أو انتظارًا قائمًا على التاريخ لضمان عدم تنفيذ إجراء على عقد قبل تاريخ بدئه. - **التفاعل مع بياناتك.** عند استخدام التأخير المستند إلى المتغيرات، يتحدد الانتظار بتاريخ من العملية الفعلية، مثل تاريخ التعيين أو انتهاء المستند أو موعد أُدخل في نموذج. تضبطه مرة واحدة ثم يتكيف تلقائيًا مع كل مثيل. - **إضافة مدة احتياطية حول تاريخ مهم.** يدعم وضع التاريخ المتغير إزاحة زمنية؛ فيمكن الانتظار حتى سبعة أيام قبل الانتهاء، أو أسبوعين بعد تاريخ الإرسال. - **استئناف سير العمل حتى بعد إعادة تشغيل الخادم.** يعود المثيل المتوقف من موضعه نفسه ولا تضيع أي بيانات خلال الانتظار. ## قبل أن تبدأ - تحتاج إلى صلاحية المصمم لسير العمل المطلوب. - في وضع **الإيقاف المؤقت حتى تاريخ متغير**، يجب أن يحتوي سير العمل على متغير واحد على الأقل يحمل تاريخًا. يأتي ذلك عادة من نموذج عقدة البدء أو مخرجات عقدة مهمة. - افتح سير العمل من شاشة **إدارة عمليات سير العمل** واختر **تحرير**. ## طريقة الاستخدام خطوة بخطوة 1. افتح علامة **منطق** في الشريط الجانبي الأيسر للمصمم المرئي. 2. اسحب عقدة **إيقاف مؤقت** إلى اللوحة وضعها بين الخطوة التي ينبغي أن تعمل قبل الانتظار والخطوة التي ينبغي أن تعمل بعده. 3. صِل مقبض إخراج العقدة السابقة بمدخل عقدة الإيقاف المؤقت، ثم صِل مخرجها بالخطوة التالية. 4. انقر على العقدة نقرًا مزدوجًا، أو اختر رمز الترس، لفتح مربع **خصائص الإيقاف المؤقت**. 5. ضمن **العمليات**، اختر أحد الأوضاع الثلاثة واضبطه: **الوضع أ — لمدة زمنية:** - اختر زر **لمدة زمنية**. - استخدم زري **−** و**+** أو اكتب مباشرة لتحديد العدد. - اختر الوحدة من القائمة: **ثوانٍ** أو **دقائق** أو **ساعات** أو **أيام** أو **أسابيع** أو **أشهر**. - تتحدث المعاينة في التذييل لتعرض «إيقاف مؤقت لمدة 3 أيام»، أو المدة التي ضبطتها. **الوضع ب — إيقاف مؤقت حتى تاريخ:** - اختر **إيقاف مؤقت حتى تاريخ**. - اختر **حقل التاريخ** ذي رمز التقويم وحدد تاريخ استئناف سير العمل. - اختر **حقل الوقت** ذي رمز الساعة وأدخل الوقت. - يستأنف سير العمل في ذلك التاريخ والوقت بالضبط. **الوضع ج — إيقاف مؤقت حتى تاريخ متغير:** - اختر **إيقاف مؤقت حتى تاريخ متغير**. - افتح قائمة **تحديد متغير تاريخ**. تعرض متغيرات سير العمل التي تبدو محتوية على تواريخ، أي التي يتضمن اسمها أو نوعها كلمات مثل «تاريخ» أو «موعد نهائي» أو «انتهاء» وما شابه. إذا لم يظهر المتغير المطلوب، فعّل **عرض جميع المتغيرات**. - اختر المتغير المطلوب. - تظهر بطاقة تأكيد تعرض المتغير المحدد بصيغة `{{variable_name}}`. - اضبط اختياريًا **إزاحة زمنية** لتغيير وقت الاستئناف بالنسبة إلى تاريخ المتغير: - استخدم زري **−** و**+** لتحديد رقم الإزاحة، أو اكتبه مباشرة. - اختر الوحدة: **ساعات** أو **أيام** أو **أسابيع** أو **أشهر** أو **سنوات**. - تتحدث المعاينة لتعرض مثلًا `{{contract_expiry}} + 7 أيام`. - لإزالة الإزاحة، اختر **مسح**. 6. ضمن **طلب التعليقات**، فعّل المفتاح إذا أردت منع إنهاء الإيقاف المؤقت يدويًا قبل موعده، عندما يكون مثل هذا الإجراء متاحًا، ما لم يُقدم تعليق. > **ملاحظة:** عند تفعيل هذا المفتاح يظهر مربع نص **التعليقات**، ويمكنك إدخال ملاحظة أو تعليمات ثابتة للمراجعين. 7. راجع سطر المعاينة في التذييل؛ إذ يعرض «إيقاف مؤقت [ملخص الاختيار]» لتتأكد من الإعداد سريعًا. 8. اختر **حفظ الإيقاف المؤقت**. يُغلق مربع الحوار. 9. اختر **حفظ** أو اضغط **Ctrl+S** لحفظ سير العمل. ## شرح الخيارات والإعدادات ### العمليات (وضع الإيقاف المؤقت) | الوضع | متى تستخدمه؟ | الإعداد | |---|---|---| | **لمدة زمنية** | عندما تريد فترة انتظار ثابتة لجميع المثيلات، مثل الانتظار دائمًا 48 ساعة قبل إرسال المتابعة. | أدخل عددًا واختر وحدة: ثوانٍ أو دقائق أو ساعات أو أيام أو أسابيع أو أشهر. | | **إيقاف مؤقت حتى تاريخ** | عندما تريد الانتظار حتى تاريخ ووقت معروفين مسبقًا أثناء تصميم سير العمل. | اختر التاريخ من منتقي التقويم والوقت من منتقي الوقت. | | **إيقاف مؤقت حتى تاريخ متغير** | عندما يختلف تاريخ الانتظار لكل مثيل ويأتي من بيانات جُمعت في سير العمل، مثل تاريخ بدء عقد أُدخل في نموذج. | اختر متغير التاريخ ثم أضف اختياريًا إزاحة زمنية موجبة أو سالبة بالأيام أو الأسابيع أو الأشهر وغيرها. | ### وحدات المدة | الوحدة | الاستخدام المعتاد | |---|---| | الثواني | التأخير في الاختبارات القصيرة أو الانتظار المؤتمت القصير جدًا، ونادرًا ما يُستخدم في الإنتاج. | | الدقائق | فترات التهدئة الموجزة أو نوافذ المراجعة القصيرة. | | الساعات | الانتظار على مستوى ساعات العمل، مثل مهلة استجابة مدتها 24 ساعة. | | الأيام | فترات المراجعة أو الإشعار القياسية. | | الأسابيع | دورات المداولة الأطول. | | الأشهر | الانتظار المرتبط بدورات العقود أو الاشتراكات. | ### منتقي التاريخ المتغير | العنصر | ما الذي يفعله؟ | |---|---| | قائمة **تحديد متغير تاريخ** | تسرد المتغيرات التي اكتُشف أن نوعها تاريخ من العُقد السابقة. اختر واحدًا منها. | | مربع **عرض جميع المتغيرات** | يوسّع القائمة لتعرض جميع متغيرات سير العمل، لا التي اكتُشفت كتواريخ فقط. يفيد عندما يُحفظ التاريخ في متغير لا يتضمن اسمه كلمة «تاريخ». | | شارة عدد المتغيرات | تعرض عدد المتغيرات المتاحة ضمن طريقة العرض المصفاة حاليًا. | ### الإزاحة الزمنية (وضع التاريخ المتغير فقط) | العنصر | ما الذي يفعله؟ | |---|---| | زرا **−** و**+** | يخفضان رقم الإزاحة أو يرفعانه بمقدار 1. | | الإدخال الرقمي | يتيح كتابة الإزاحة مباشرة. أدخل 0 لاستخدام تاريخ المتغير دون تعديل. | | قائمة الوحدة | **ساعات** أو **أيام** أو **أسابيع** أو **أشهر** أو **سنوات**، وهي وحدة الإزاحة. | | زر **مسح** | يزيل الإزاحة ويعيدها إلى 0. لا يظهر إلا عند ضبط إزاحة. | | بطاقة معاينة الإزاحة | تعرض الصيغة النهائية، مثل `{{contract_expiry}} + 7 أيام`. | ### مفتاح طلب التعليقات | الحالة | الأثر | |---|---| | متوقف (افتراضي) | لا يلزم تعليق. | | مفعّل | يظهر مربع نص للتعليقات. تُحفظ الملاحظة مع إعدادات الإيقاف وتظهر للمراجعين. إذا دعم الإيقاف الإكمال اليدوي المبكر، يمنع هذا الخيار الإجراء حتى يُدخل تعليق. | ## نصائح وأفضل الممارسات - **استخدم وضع المدة لنوافذ اتفاقية مستوى الخدمة الثابتة.** إذا كانت السياسة تنص على «الرد خلال 72 ساعة»، فإن انتظار 72 ساعة قبل التصعيد واضح بذاته وسهل التحديث. - **استخدم وضع التاريخ بحذر.** يصبح التاريخ المثبت قديمًا فور انقضائه. فكر فيما إذا كان النهج المستند إلى متغير أكثر قابلية لإعادة الاستخدام. - **استخدم وضع التاريخ المتغير عندما يكون لكل مثيل موعده.** تضبطه مرة، ويحسب المحرك وقت الاستئناف ديناميكيًا لكل مثيل من بياناته الفعلية. - **أضف إزاحة موجبة صغيرة لوقت احتياطي.** إذا أردت إرسال تذكير قبل موعد، فاستخدم مفهوم الإزاحة السالبة؛ فمثلًا يُعبّر عن `contract_expiry - 7 days` بالصيغة `contract_expiry + (-7) days`. إذا لم تتوفر الإزاحات السالبة في الواجهة، فابنِ سير العمل بحيث يصل إلى عقدة الإيقاف قبل تاريخ الانتهاء بسبعة أيام. - **ضع عقدة الإيقاف قبل الخطوة المطلوب تأخيرها مباشرة.** يجعل ذلك منطق اللوحة مقروءًا، ويوضح أن العقدة التالية مباشرة هي التي يجري تأخيرها. - **وثّق السبب في وصف العقدة.** انقر نقرًا مزدوجًا على تسمية العقدة في اللوحة واكتب اسمًا ذا معنى، مثل «انتظار 3 أيام للمراجعة»، ليفهم قارئ اللوحة الغرض من دون فتح الإعدادات. ## الأسئلة الشائعة **س: ماذا يحدث لسير عمل متوقف مؤقتًا إذا أعيد تشغيل الخادم أثناء الانتظار؟** يستأنف من الموضع نفسه تمامًا. تُحفظ المثيلات المتوقفة بصورة دائمة، ولا تؤثر إعادة تشغيل الخادم في الانتظار أو البيانات المرتبطة بالمثيل. **س: هل يمكن استئناف سير عمل متوقف يدويًا قبل انتهاء المؤقت؟** يعتمد ذلك على إعداد المسؤول. تتضمن بعض التصاميم تجاوزًا يدويًا؛ تحقق من مصمم سير العمل أو المسؤول. يستطيع مفتاح طلب التعليقات ضبط هذا الإجراء إذا كان مسموحًا. **س: لا يظهر المتغير المطلوب في قائمة «الإيقاف المؤقت حتى تاريخ متغير». ماذا أفعل؟** فعّل **عرض جميع المتغيرات** لعرض كل متغير صادر من العُقد السابقة. إذا ظل مفقودًا، فقد لا يكون قد أُنشئ بعد عند هذه النقطة؛ تأكد من أن الخطوة التي تنشئه تسبق عقدة الإيقاف. **س: هل يمكنني الإيقاف لأقل من دقيقة؟** نعم. اختر «لمدة زمنية»، وأدخل عدد الثواني المطلوب، ثم اختر **ثوانٍ** من قائمة الوحدة. **س: هل تؤثر عقدة الإيقاف في جميع مثيلات سير العمل أم في المثيل الحالي فقط؟** يتوقف المثيل الجاري الحالي فقط. تعمل المثيلات الأخرى للعملية نفسها بصورة مستقلة ولا تتأثر. **س: ماذا يحدث إذا استخدمت «الإيقاف المؤقت حتى تاريخ متغير» وكان المتغير فارغًا؟** يتوقف سير العمل عند العقدة إلى أجل غير مسمى. أضف دائمًا شرط إذا/وإلا سابقًا لمعالجة احتمال فراغ متغير التاريخ وتوجيه التنفيذ إلى مسار بديل مناسب. ## أدلة ذات صلة - [منطق التوجيه: شروط إذا/وإلا والفروع الشرطية](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [إدارة المواعيد النهائية: تواريخ الاستحقاق والتذكيرات والتصعيد](https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/) - [عقدة مجدول التذكير](https://raptix.app/user-guide/ar/10-workflows/10-18-reminder-scheduler-node/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/ # استخدام متغيرات سير العمل وعلامات الدمج في الرسائل والشروط > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المستخدم النهائي > **ستتعلم:** ماهية متغيرات سير العمل ومصادرها، وكيفية العثور عليها في لوحة المتغيرات، واستخدامها كعلامات دمج في نصوص رسائل البريد وموضوعاتها وشروط التوجيه في مختلف أجزاء سير العمل. ## ما هذه الميزة؟ متغير سير العمل هو جزء بيانات ذو اسم، يُلتقط أو يُحسب أو يُنشأ في نقطة ما من سير العمل، ثم يصبح متاحًا لكل عقدة تأتي بعده. عندما يعبئ مقدم الطلب نموذجًا، يصبح كل حقل متغيرًا. وعندما يعمل وكيل الذكاء الاصطناعي، تصبح مخرجاته متغيرًا. وعند اكتمال مهمة، يصبح القرار المتخذ وأي تعليقات متغيرات. يُشار إلى المتغيرات بصيغة **علامة الدمج**: قوسان معقوفان مزدوجان حول اسم المتغير، مثل `{{requester_name}}` أو `{{due_date}}`. تعمل علامات الدمج في ثلاثة مواضع: 1. **موضوعات الرسائل ونصوصها** — لتخصيص رسائل الإشعار بالبيانات الفعلية. 2. **تعبيرات الشروط** — لتوجيه سير العمل بناءً على قيمة، مثل الموافقة تلقائيًا على المبالغ الصغيرة وتصعيد الكبيرة. 3. **حقول إعداد العُقد** — في أي حقل يقبل متغيرًا، مثل عناوين مستلمي البريد والمسند إليه في المهمة ومدة التأخير. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **رسائل مخصصة تلقائيًا.** تخرج كل رسالة باسم مقدم الطلب الحقيقي وعنوان المشروع الفعلي والموعد الصحيح؛ من دون تحرير يدوي أو عبارات عامة مثل «عزيزي المستخدم». - **تنتقل البيانات عبر العملية كلها.** تظل القيمة الملتقطة في الخطوة الأولى متاحة في الخطوة العاشرة، فلا تحتاج إلى البحث مجددًا عن معلومات جُمعت بالفعل. - **تستخدم قرارات التوجيه بيانات فعلية.** تستطيع عُقد الشروط إنشاء الفروع بناءً على تجاوز `{{purchase_amount}}` حدًا معينًا أو مطابقة `{{department}}` فريقًا محددًا أو أي قيمة ملتقطة أخرى، ما يجعل سير العمل ديناميكيًا بحق. - **نسخ بنقرة واحدة من لوحة المتغيرات.** لا تحتاج إلى حفظ أسماء المتغيرات أو كتابتها. تسرد اللوحة كل متغير مع عقدة مصدره ونوعه، وتنسخ علامة الدمج بنقرة واحدة. - **سحب المتغيرات وإفلاتها في المحررات.** يمكنك سحب متغير مباشرة من اللوحة إلى حقل في منشئ الشروط أو محرر البريد. - **سلامة الأنواع.** لكل متغير نوع معلن، مثل نص أو رقم أو قيمة منطقية أو تاريخ أو ملف. يستخدم منشئ الشروط النوع لعرض عوامل المقارنة المناسبة فقط، ما يمنع أخطاء المنطق. ## قبل أن تبدأ - تنشئ المتغيرات عُقد تأتي **قبل** العقدة التي تريد استخدامها فيها على رسم سير العمل. لا يكون متغير صادر من عقدة لاحقة متاحًا بعد. - الصلاحية المطلوبة: **إدارة عمليات سير العمل** لضبط عُقدها. - لعرض لوحة المتغيرات، يجب أن تكون في المصمم المرئي وأن توجد عقدة سابقة مضبوطة واحدة على الأقل. **مكان العثور عليها:** اختر رمز **لوحة المتغيرات**، وهو الزر `{}`، من شريط أدوات المصمم المرئي. تنفتح اللوحة من يمين مساحة التصميم. ## طريقة الاستخدام خطوة بخطوة ### استكشاف المتغيرات المتاحة 1. افتح سير عمل في المصمم المرئي. 2. اختر رمز **لوحة المتغيرات** من شريط الأدوات، أو استخدم اختصار لوحة المفاتيح إن ظهر. تنزلق اللوحة من اليمين. 3. تُجمع المتغيرات بحسب العقدة التي صدرت منها. تعرض كل مجموعة رمز العقدة وتسميتها، مثل «عقدة البدء» أو «مهمة: مراجعة العقد» أو «وكيل الذكاء الاصطناعي: تصنيف الطلب». 4. يعرض كل صف متغير داخل المجموعة: - **علامة الدمج** بخط ثابت العرض، مثل `{{form_project_name}}`؛ - شارة **النوع**: النص بالرمادي، والرقم بالكهرماني، والقيمة المنطقية بالأخضر، والتاريخ بالأزرق السماوي، والملف بالوردي؛ - شارة **المصدر**، مثل نموذج أو مهمة أو ذكاء اصطناعي أو Python. 5. لنسخ علامة دمج، انقر في أي موضع من صف المتغير. يؤكد مؤشر قصير باسم **تم النسخ** أن العلامة أصبحت في الحافظة وجاهزة للصق. 6. لسحب متغير إلى حقل متوافق، أمسك مقبض السحب ذي النقاط الست الذي يظهر يسار الصف عند المرور عليه، واسحبه إلى الحقل الهدف. ### استخدام علامات الدمج في موضوع البريد 7. افتح مربع **خصائص البريد الإلكتروني** بالنقر المزدوج على عقدة بريد إلكتروني. 8. انقر داخل حقل **موضوع البريد الإلكتروني**. 9. افتح لوحة المتغيرات في المصمم الأساسي وانسخ العلامة المطلوبة، أو اكتبها يدويًا بصيغة `{{variable_name}}`. 10. الصق العلامة في الموضوع. مثال: `إجراء مطلوب: {{task_title}} يستحق في {{due_date}}` > يقبل سطر الموضوع أيضًا نصًا عاديًا ممزوجًا بأي عدد من علامات الدمج. تُستبدل العلامات بقيمها الفعلية عند الإرسال. ### استخدام علامات الدمج في نص البريد 11. افتح محرر البريد Unlayer في قسم النص من علامة **البريد الإلكتروني**. 12. انقر داخل أي كتلة **نص** في لوحة المحرر. 13. ضع المؤشر في الموضع الذي تريد أن تظهر فيه قيمة المتغير. 14. نفّذ أحد الخيارين: - اختر زر **علامات الدمج** ذي الرمز `{}` في شريط أدوات Unlayer. تظهر قائمة منظمة ضمن فئات: أساسي، ومهمة، وروابط الإجراءات، وحقول النموذج، ومتغيرات المهمة. اختر أي عنصر لإدراجه. - أو انسخ العلامة من لوحة المتغيرات في المصمم الأساسي والصقها. 15. تظهر العلامة في النص بصيغة `{{variable_name}}`. تستبدلها المنصة بالقيمة الفعلية وقت الإرسال. #### علامات دمج معرفة مسبقًا ومتاحة دائمًا في البريد | الفئة | العلامة | ما الذي تدرجه؟ | |---|---|---| | أساسي | `{{form_title}}` | اسم نموذج المشغّل أو سير العمل | | أساسي | `{{submission_id}}` | المعرّف الفريد لمثيل سير العمل | | أساسي | `{{requester_name}}` | الاسم الكامل للشخص الذي بدأ سير العمل | | مهمة | `{{task_title}}` | عنوان عقدة المهمة الحالية أو الأحدث | | مهمة | `{{assignee_name}}` | اسم الشخص المسندة إليه المهمة | | مهمة | `{{due_date}}` | تاريخ استحقاق المهمة | | روابط الإجراءات | `{{complete_link}}` | رابط آمن للاستخدام مرة واحدة يُكمل المهمة للموافق الخارجي | | روابط الإجراءات | `{{reject_link}}` | رابط آمن للاستخدام مرة واحدة يرفض المهمة للموافق الخارجي | | روابط الإجراءات | `{{hold_link}}` | رابط آمن للاستخدام مرة واحدة يعلّق المهمة للموافق الخارجي | | روابط الإجراءات | `{{portal_url}}` | عنوان بوابة الموافق الخارجي لهذه المهمة | إلى جانب ما سبق، يصبح كل حقل نموذج يُرسل في خطوة المشغّل علامة دمج تحمل الاسم الداخلي للحقل مع بادئة، مثل `{{form_contract_value}}` أو `{{form_department}}`. ### استخدام المتغيرات في تعبيرات الشروط 16. افتح **عقدة شرط** أو **عقدة فرع شرطي** بالنقر المزدوج عليها في اللوحة. 17. ابحث في منشئ الشروط عن حقل **القيمة** للقاعدة، أي الجانب الأيسر من المقارنة. 18. ابدأ بكتابة `{{` للإشارة إلى متغير، ثم اكتب اسمه. يحله منشئ الشروط وقت التشغيل. 19. اضبط **عامل التشغيل** للقاعدة. راجع جدول العوامل أدناه؛ تتطابق العوامل المتاحة تلقائيًا مع نوع المتغير. 20. اضبط قيمة المقارنة في الجانب الأيمن، إما قيمة ثابتة أو `{{variable_name}}` آخر. مثال: `{{purchase_amount}}` **أكبر من** `10000` > للتفاصيل الكاملة عن عقدة الشرط ومنشئ التعبيرات، راجع [منطق التوجيه: شروط إذا/وإلا والفروع الشرطية ومنشئ التعبيرات](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/). ### استخدام المتغيرات في حقول العُقد الأخرى تقبل حقول كثيرة في إعداد العُقد علامات الدمج كلما أفادت القيمة الديناميكية: | العقدة | الحقل الذي يقبل المتغيرات | |---|---| | عقدة المهمة | حقل **المسند إليه** للإسناد الديناميكي بناءً على البيانات المرسلة | | عقدة المهمة | حقل **تاريخ الاستحقاق** لضبط الموعد من تاريخ مرسل | | عقدة البريد الإلكتروني | حقل **عناوين بريد المستلمين** للإرسال إلى عنوان جُمع في النموذج | | عقدة الإيقاف المؤقت/التأخير | حقل **حتى تاريخ** للانتظار حتى قيمة تاريخ | | عقدة مجدول التذكير | **عمود التاريخ** من متغير استعلام قاعدة البيانات | | عقدة استعلام قاعدة البيانات | حقل **استعلام SQL** لإدراج متغير في عبارة `WHERE` | ## شرح الخيارات والإعدادات ### عناصر التحكم في لوحة المتغيرات | عنصر التحكم | الوصف | |---|---| | **رؤوس مجموعات العُقد** | صفوف قابلة للطي تجمع المتغيرات بحسب عقدة مصدرها. اختر السهم للتوسيع أو الطي. | | **حقل البحث**، إن ظهر | يصفّي قائمة المتغيرات حسب الاسم أو الوصف فورًا. | | **صف المتغير**، انقر للنسخ | يؤدي النقر في أي موضع من الصف إلى نسخ علامة `{{variable_name}}` إلى الحافظة. | | **مقبض السحب**، رمز النقاط | يظهر عند المرور؛ اسحبه لإدراج العلامة في حقل هدف متوافق. | | **شارة النوع** | تعرض نوع بيانات المتغير: نص بالرمادي، رقم بالكهرماني، قيمة منطقية بالأخضر، تاريخ بالأزرق السماوي، ملف بالوردي. | | **شارة المصدر** | توضح نوع العقدة التي أنتجت المتغير، مثل نموذج أو مهمة أو ذكاء اصطناعي أو Python أو إدخال أو HTTP. | ### قواعد صيغة علامات الدمج | القاعدة | التفاصيل | |---|---| | **الصيغة** | دائمًا `{{variable_name}}`: قوسان معقوفان فاتحان، ثم الاسم، ثم قوسان مغلقان. لا تُدعم المسافات داخل الأقواس. | | **حساسة لحالة الأحرف** | تختلف `{{Task_Title}}` عن `{{task_title}}`. استخدم لوحة المتغيرات لنسخ الاسم الدقيق. | | **التداخل** | لا يمكنك وضع علامة داخل أخرى؛ كل علامة مستقلة. | | **المتغير المفقود** | إذا كان المتغير غير معرّف وقت التشغيل، كحقل اختياري تُرك فارغًا، تُستبدل العلامة بسلسلة فارغة. | ### أنواع المتغيرات وعوامل التشغيل المتوافقة | النوع | العوامل المتاحة في الشروط | |---|---| | **نص** | يساوي، لا يساوي، يحتوي، لا يحتوي، يبدأ بـ، ينتهي بـ، فارغ، غير فارغ | | **رقم** | يساوي، لا يساوي، أكبر من، أصغر من، أكبر من أو يساوي، أصغر من أو يساوي، فارغ، غير فارغ | | **قيمة منطقية** | يساوي صحيح، يساوي خطأ | | **تاريخ** | يساوي، قبل، بعد، بين، فارغ، غير فارغ | | **ملف** | فارغ، غير فارغ | ## نصائح وأفضل الممارسات - **انسخ من لوحة المتغيرات ولا تكتب من الذاكرة.** يجب أن تطابق أسماء المتغيرات تمامًا، بما فيها الشرطات السفلية والبادئات وحالة الأحرف. يؤدي خطأ واحد إلى إرسال العلامة حرفيًا في البريد. - **تحقق من شارة النوع قبل كتابة شرط.** لن تعمل مقارنة متغير نصي بعامل رقمي كما تتوقع. توضح الشارة نوع المتغير. - **استخدم روابط الإجراءات فقط مع الموافقين الخارجيين.** تنشئ علامات `{{complete_link}}` و`{{reject_link}}` و`{{hold_link}}` روابط آمنة تستخدم مرة واحدة. ضعها في الرسائل المرسلة لمن سيتصرف دون تسجيل الدخول. راجع [بوابة الموافق الخارجي](https://raptix.app/user-guide/ar/10-workflows/10-26-external-approver-portal/). - **قاعدة العُقد السابقة فقط.** لا يتوفر في عقدة بريد متغير صادر من عقدة مهمة تأتي بعدها في الرسم. ضع العُقد المنتجة للبيانات قبل العُقد المستهلكة لها. - **المتغيرات العامة متاحة دائمًا.** تحتوي مجموعة **عام** في لوحة المتغيرات، إن وجدت، على قيم متاحة في أي موضع بغض النظر عن ترتيب العُقد، مثل بيانات الإرسال الوصفية. - **اختبر ببيانات واقعية.** قبل تنشيط سير العمل، نفّذ إرسالًا تجريبيًا بقيم نموذج ممثلة وتحقق من أن الرسائل تعرض القيم المحلولة المتوقعة. راجع [تشغيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/). ## الأسئلة الشائعة **س: تظهر علامة الدمج حرفيًا في بريدي، مثل `{{task_title}}` بدلًا من اسم المهمة الفعلي. لماذا؟** الأسباب الأرجح: (1) خطأ إملائي في العلامة؛ انسخها من لوحة المتغيرات. (2) لا يوجد المتغير بعد عند إرسال البريد لأن عقدة مصدره تأتي بعد عقدة البريد. (3) كان المتغير اختياريًا وتركه مقدم الطلب فارغًا، فنتجت سلسلة فارغة. راجع لوحة المتغيرات للتأكد من الاسم وترتيب العُقد. **س: هل يمكنني استخدام متغير لتحديد من يتلقى رسالة؟** نعم. أدخل في علامة **المستلمون** لعقدة البريد علامة مثل `{{requester_email}}` في حقل عناوين المستلمين. تحلها المنصة وقت التشغيل وترسل إلى العنوان الذي تحمله القيمة. **س: كيف أعرف اسم المتغير الموافق لحقل نموذج معين؟** افتح لوحة المتغيرات ووسّع مجموعة عقدة البدء أو المشغّل. يظهر كل حقل نموذج كمتغير، ويستخدم اسم العلامة الاسم الداخلي للحقل مسبوقًا بـ`form_`. عند الشك، اسأل مصمم سير العمل أو راجع إعداد الحقل في خصائص عقدة المشغّل. **س: هل يمكن استخدام المتغيرات في موضوع البريد؟** نعم. يدعم حقل الموضوع صيغة `{{variable_name}}` نفسها التي يدعمها النص. مثال: `تمت الموافقة على طلبك «{{form_request_title}}».` **س: ماذا يحدث إذا كانت قيمة المتغير null أو تُرك الحقل فارغًا؟** تُستبدل العلامة بسلسلة فارغة وقت الإرسال. لتجنب الفراغات، اجعل حقول النموذج مطلوبة عندما تكون القيمة مهمة، أو استخدم **إخفاء الحقول الفارغة** في علامة متقدم بعقدة البريد. **س: هل يمكن استخدام متغير في عقدة إيقاف مؤقت للانتظار حتى تاريخ من النموذج؟** نعم. اختر وضع **حتى تاريخ المتغير** في عقدة الإيقاف المؤقت/التأخير، وحدد متغير التاريخ من القائمة. راجع [عقدة الإيقاف المؤقت/التأخير](https://raptix.app/user-guide/ar/10-workflows/10-13-pause-delay-node/). ## أدلة ذات صلة - [عقدة البريد الإلكتروني: إنشاء رسائل إشعار غنية بمحرر السحب والإفلات](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [مكتبة قوالب البريد: حفظ القوالب المشتركة وإعادة استخدامها وتحديثها](https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/) - [منطق التوجيه: شروط إذا/وإلا والفروع الشرطية ومنشئ التعبيرات](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [عقدة الإيقاف المؤقت/التأخير](https://raptix.app/user-guide/ar/10-workflows/10-13-pause-delay-node/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-34-current-node-catalogue/ # دليل عُقد منشئ التدفقات الحالية > **الوحدة:** منشئ التدفقات ← لوحة العُقد > > **الجمهور:** مصممو سير العمل الذين يختارون العُقد المتاحة حاليًا > > **ستتعلم:** ما العُقد الموجودة حاليًا في لوحة منشئ التدفقات، والغرض من كل منها، وأين تجد دليلها التفصيلي. هذه قائمة التحقق من اكتمال لوحة منشئ التدفقات الحالية. إذا لم تُذكر عقدة هنا، فهي غير متاحة للمستخدمين حاليًا في اللوحة. | اللوحة | العقدة | الغرض | الدليل التفصيلي | |---|---|---|---| | أساسي | **البداية (Start)** | اختيار بداية يدوية أو Webhook أو جدول أو بريد إلكتروني أو Appsmith HTTP. | [مُشغّلات البداية](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) | | أساسي | **مُشغّل البريد الإلكتروني (Email Trigger)** | بدء سير العمل أو الانتظار عند وصول بريد مطابق. | [مُشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) | | أساسي | **البريد الإلكتروني (Email)** | إرسال إشعارات البريد والمرفقات. | [عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) | | أساسي | **المهمة (Task)** | إسناد عمل بشري وجمع الإجراءات والتعليقات والنماذج والمستندات. | [خطوات المهمة](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) | | أساسي | **برنامج Python النصي (Python Script)** | تشغيل Python مع إدخال وإخراج ملفات؛ للمشرف فقط. | [برنامج Python النصي](https://raptix.app/user-guide/ar/10-workflows/10-15-python-script-node/) | | أساسي | **وكيل الذكاء الاصطناعي (AI Agent)** | تشغيل خطوة مدعومة بالذكاء الاصطناعي ضمن سير العمل. | [وكيل الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/) | | أساسي | **المستندات (Documents)** | جلب ملفات المستندات أو حفظها. | [المستندات](https://raptix.app/user-guide/ar/10-workflows/10-17-documents-node/) | | أساسي | **التقرير (Report)** | ملء قالب Word أو إنشاء تقرير يؤلفه الذكاء الاصطناعي. | [التقرير](https://raptix.app/user-guide/ar/10-workflows/10-32-report-node/) | | أساسي | **استعلام قاعدة البيانات (DB Query)** | الاستعلام عن بيانات منشئ التطبيقات أو قاعدة بيانات سير العمل؛ لخطة Enterprise. | [استعلام قاعدة البيانات](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) | | أساسي | **لكل عنصر (Foreach)** | التكرار على عناصر قائمة؛ لخطة Enterprise. | [لكل عنصر](https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/) | | أساسي | **مجدول التذكيرات (Reminder Scheduler)** | إرسال تذكيرات حسب التاريخ؛ لخطة Enterprise. | [مجدول التذكيرات](https://raptix.app/user-guide/ar/10-workflows/10-18-reminder-scheduler-node/) | | منطق | **شرط إذا/وإلا (If/Else Condition)** | التوجيه إلى نعم أو لا. | [شروط التوجيه](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) | | منطق | **فرع شرطي (Conditional Branch)** | التوجيه بين عدة نتائج للشروط. | [شروط التوجيه](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) | | منطق | **إيقاف مؤقت (Pause)** | تعليق التنفيذ حتى يتحقق تأخير أو شرط تاريخ. | [الإيقاف المؤقت](https://raptix.app/user-guide/ar/10-workflows/10-13-pause-delay-node/) | | منطق | **تقسيم الفروع (Split Branches)** | بدء مسارات متوازية. | [التقسيم والدمج](https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/) | | منطق | **دمج الفروع (Merge Branches)** | إعادة ضم كل المسارات الواردة أو أي منها أو عدد محدد منها. | [التقسيم والدمج](https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/) | | منطق | **الحلقة (Loop)** | الرجوع إلى خطوة سابقة بمحاولات محدودة أو غير محدودة. | [الحلقة](https://raptix.app/user-guide/ar/10-workflows/10-12-parallel-split-merge-loops/) | | منطق | **النهاية (End)** | إنهاء فرع. | [منشئ التدفقات](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) | ## الإتاحة - تظهر **عقدة برنامج Python النصي** للمشرفين فقط. - تظهر **عُقد استعلام قاعدة البيانات ولكل عنصر ومجدول التذكيرات** لمنظمات Enterprise فقط. - لا يستطيع منشئ الذكاء الاصطناعي تجاوز هذه القيود. ## ميزات اللوحة الحالية خارج لوحة العُقد - يقترح **منشئ الذكاء الاصطناعي** تغييرات قابلة للمراجعة، ويمكنه تأليف محتوى تقارير الذكاء الاصطناعي. - تعرض **لوحة المتغيرات** القيم التي تنتجها البداية والعُقد السابقة. - يتحكم **نشط / غير نشط (Active / Inactive)** فيما إذا كان سير العمل المحفوظ قابلًا للتشغيل. - توجد في شريط الأدوات عناصر الاستيراد والتصدير والتراجع والإعادة بين الإصدارات والنسخ والترتيب التلقائي واتجاه التخطيط والتكبير والشبكة والخريطة المصغرة والتشغيل وإعادة الضبط والمسح والسمة. راجع [منشئ التدفقات: اللوحة وشريط الأدوات ولوحة العُقد](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) لمعرفة طريقة الاستخدام الدقيقة. --- URL: https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/ # ضبط عقدة البريد الإلكتروني > **الوحدة:** منشئ التدفق ← أساسي ← بريد إلكتروني > > **الجمهور:** مصممو عمليات سير العمل > > **ستتعلم:** كيفية كتابة الرسالة، واختيار صناديق بريد الإرسال والمستلمين، وإرفاق ملفات ثابتة أو ملفات من سير العمل، وإنشاء ملفات PDF للإرسال، وحفظ قوالب قابلة لإعادة الاستخدام. ## إضافة عقدة البريد الإلكتروني وفتحها اسحب **بريد إلكتروني** من لوحة **أساسي** إلى اللوحة، وصِلها في الموضع الذي ينبغي إرسال الرسالة عنده، ثم افتح العقدة لعرض **خصائص البريد الإلكتروني**. يحتوي مربع الحوار حاليًا على ثلاث علامات: **البريد الإلكتروني** و**المستلمون** و**متقدم**. ينبغي توفر صندوق بريد إرسال نشط واحد على الأقل في **الإدارة ← البريد الإلكتروني**. إذا لم يتوفر أي صندوق، تطلب منك علامة المستلمين إضافة واحد هناك. ## البريد الإلكتروني: الموضوع ونص الرسالة 1. وسّع اختياريًا قسم **البدء من قالب** واختر قالبًا محفوظًا. يكون القسم مطويًا افتراضيًا ويعرض عدد القوالب المتاحة لسياق البريد الحالي. 2. أدخل **موضوع البريد الإلكتروني** المطلوب. 3. أكمل **محتوى البريد الإلكتروني**. يفتح المحرر الافتراضي في وضع المعاينة ويوفر: - عرضي **المعاينة** و**الكود**؛ - **اسأل الذكاء الاصطناعي** لكتابة رسالة جديدة أو تعديل HTML الحالي عندما يتوفر مساعد ذكاء اصطناعي؛ - عناصر مراجعة **الاحتفاظ** بمسودة الذكاء الاصطناعي أو **تجاهلها**، وإجراء **تراجع** بعد تطبيقها؛ - **متقدم (مرئي)** للانتقال إلى محرر السحب والإفلات المرئي؛ - **ملء الشاشة** لتوفير مساحة عمل أكبر. 4. إذا اخترت المحرر المرئي، فأكد الانتقال. يُستورد HTML الحالي ككتلة قابلة للتحرير وقد يعاد تنسيقه. يوفر المحرر كتل محتوى متجاوبة و**معاينة** لسطح المكتب و**تصديرًا** إلى ملف HTML. استخدم فقط المتغيرات التي تعرضها لوحة متغيرات سير العمل أو قائمة علامات الدمج في المحرر. لا تُستبدل قيمة مكتوبة مثل `{{requester_email}}` إلا إذا كان ذلك المتغير الدقيق موجودًا وقت التشغيل. ## المستلمون: صندوق بريد الإرسال والوجهات ### الإرسال من اختر صفًا واحدًا أو أكثر ضمن **الإرسال من**. يعرض كل صف تسمية صندوق البريد وعنوان المرسل ومزود الخدمة وشارة **افتراضي** عند انطباقها. - يُحدد صندوق البريد الافتراضي للحالة المعتادة. - يؤدي اختيار عدة صناديق إلى إرسال الرسالة من كل صندوق محدد. - قد يظهر عنوان تديره RAPTIX إلى جانب صناديق SMTP وMicrosoft 365 عندما يكون مفعّلًا في بيئة النشر. ### عناوين بريد المستلمين أدخل مستلمًا واحدًا على الأقل. اختر **إضافة مستلم آخر** للعناوين الإضافية، واستخدم زر الإزالة بجوار الصف الإضافي عندما لا تعود بحاجة إليه. يمكن أن يكون المستلم عنوان بريد ثابتًا أو متغير سير عمل دقيقًا يُحل إلى عنوان بريد. ## متقدم: المرفقات والمخرجات ### ملفات سير العمل فعّل **إرسال الملفات المرفوعة كمرفقات** لإرفاق الملفات التي جُمعت في خطوة سابقة. تكتشف العقدة قيم رفع الملفات ومخرجات Python المتاحة. - يرسل خيار **الكل** كل مصدر مكتشف. - يتيح **تحديد مصادر بعينها** اختيار قيم الرفع اليدوي أو رفع الملفات أو مخرجات Python منفردة. - إذا لم توجد مصادر، يكون مفتاح المرفقات غير متاح. - لا يرسل وضع التحديد أي مرفق من سير العمل ويعرض تحذيرًا إذا لم تحدد شيئًا. ### ملف PDF للإرسال ينشئ **إرسال ملفات PDF للإرسالات** مستندات PDF للإرسالات المحددة. يظهر هذا العنصر فقط لمستخدمي باقة Enterprise في الواجهة الحالية. ### الملفات الثابتة استخدم **إرفاق ملف** لاختيار ملف ثابت أو أكثر أو سحبها. يقبل منتقي الملفات PDF وWord وExcel وPowerPoint وTXT وCSV وJPG/JPEG وPNG وGIF وZIP. الحد الأقصى 25 ميغابايت لكل ملف. تعرض العناصر المرفوعة اسم الملف وحجمه وتوفر إجرائي **تنزيل** و**إزالة**. ### الإجابات الفارغة فعّل **إخفاء الحقول الفارغة** عندما ينبغي ألا تظهر الحقول التي لم تُجب في مخرجات البريد الإلكتروني. ## حفظ العقدة أو إعادة استخدام التصميم - يتحقق **حفظ البريد الإلكتروني** من وجود الموضوع ومستلم واحد على الأقل، ثم يحفظ إعدادات العقدة ويغلق مربع الحوار. - يخزن **حفظ كقالب** الموضوع والمحتوى الحاليين لإعادة الاستخدام. إذا كنت قد طبقت قالبًا، فاختر **تحديث القالب الحالي** أو **إنشاء قالب جديد**. - احفظ سير العمل كاملًا بعد إغلاق خصائص البريد الإلكتروني. يؤدي تطبيق قالب إلى نسخ محتواه الحالي إلى هذه العقدة. لا يؤدي تحديث القالب المشترك لاحقًا إلى تغيير العُقد التي حُفظت بالفعل تلقائيًا. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | زر **حفظ البريد الإلكتروني** معطل | أدخل موضوعًا ومستلمًا غير فارغ واحدًا على الأقل. | | لا يظهر صندوق بريد للإرسال | اطلب من مسؤول مساحة العمل إضافة صندوق أو تنشيطه في **الإدارة ← البريد الإلكتروني**. | | قالب مفقود | وسّع **البدء من قالب**، ثم تحقق من فئته في **قاعدة بيانات سير العمل ← الاتصالات**. | | يُرسل المتغير كنص | انسخ المتغير الدقيق الذي أنشأه النظام بدلًا من كتابة اسم تقديري. | | لا تظهر ملفات سير العمل | أضف حقل رفع ملفات أو مخرجات ملف Python متاحة في خطوة سابقة. | | خيار PDF للإرسال مفقود | هذا الخيار خاص بباقة Enterprise. | | الذكاء الاصطناعي غير متاح | أنشئ مساعد ذكاء اصطناعي أو فعّله، أو حرر البريد يدويًا. | ## أدلة ذات صلة - [إعادة استخدام قوالب البريد في منشئ التدفق](https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [ضبط عقدة مشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [ضبط بريد الإدارة واختباره](https://raptix.app/user-guide/ar/70-administration/70-4-email/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/ # إعادة استخدام قوالب البريد الإلكتروني في منشئ التدفق > **الوحدة:** منشئ التدفق ← عقدة البريد الإلكتروني ← خصائص البريد الإلكتروني > > **الجمهور:** مصممو عمليات سير العمل > > **ستتعلم:** كيفية بدء عقدة بريد إلكتروني من قالب محفوظ، وحفظ قالب جديد، وتحديث القالب الذي حمّلته، وإدارة القوالب من قاعدة بيانات سير العمل. ## أين تظهر القوالب؟ ليس لقوالب البريد الإلكتروني صفحة مستقلة في شريط التنقل الرئيسي. تظهر حاليًا في موضعين: - **خصائص البريد الإلكتروني ← البريد الإلكتروني ← البدء من قالب** لتطبيق تصميم بريد محفوظ على العقدة التي تحررها؛ - **قاعدة بيانات سير العمل ← الاتصالات** لإنشاء قوالب الاتصال والعثور عليها وتحريرها ومعاينتها ونسخها وحذفها. يكون منتقي القالب مطويًا عند فتح خصائص البريد الإلكتروني. وسّع **البدء من قالب** لعرض القوالب المتاحة لسياق البريد الحالي. تعرض كل بطاقة عنوان القالب ووصفه، ويؤدي اختيارها إلى تحميل الموضوع والمحتوى في عقدة البريد الإلكتروني. يؤدي تطبيق القالب إلى نسخ محتواه الحالي إلى العقدة. لا تعيد التغييرات اللاحقة على القالب المشترك كتابة عُقد البريد المحفوظة من دون إشعار؛ افتح القالب وأعد تطبيقه عندما ينبغي أن تتلقى عقدة إصدارًا جديدًا منه. ## حفظ البريد الحالي كقالب 1. افتح عقدة بريد إلكتروني وأكمل **موضوع البريد الإلكتروني** و**محتوى البريد الإلكتروني** المطلوبين. 2. اختر **حفظ كقالب**. 3. إذا لم يُفتح البريد من قالب محفوظ، فاختر **إنشاء قالب جديد**. وإذا حُمّل قالب، فاختر **تحديث القالب الحالي** أو **إنشاء قالب جديد**. 4. أكمل حقول مربع حوار **حفظ قالب البريد الإلكتروني** للقالب الجديد: - **عنوان القالب** — مطلوب، وبحد أقصى 255 حرفًا؛ - **الوصف** — إرشادات اختيارية عن الاستخدام؛ - **الفئة** — تتحكم في سياقات البريد التي يمكن أن تعرض القالب؛ - **الأولوية** — بيانات وصفية بقيم منخفضة أو متوسطة أو عالية أو عاجلة أو حرجة؛ - **الوسوم** — أدخل وسمًا واضغط Enter، واحذفه من شارته عند الحاجة. 5. راجع **معاينة القالب**، ثم اختر **حفظ القالب**. يتطلب حفظ القالب عنوانًا وموضوعًا ومحتوى للبريد الإلكتروني. تبقى اختيارات المرسل والمستلم والمرفقات جزءًا من إعدادات عقدة البريد، لذا تحقق منها على العقدة قبل اختيار **حفظ البريد الإلكتروني**. ## تحديث قالب محمّل أو إنشاء فرع منه بعد تطبيق قالب وتحرير البريد، يعرض **حفظ كقالب** الخيارين التاليين: | الاختيار | النتيجة | |---|---| | **تحديث القالب الحالي** | يستبدل الموضوع والمحتوى في القالب المشترك المحمّل حاليًا بما يوجد في العقدة. يظهر اسم القالب في مربع الاختيار. | | **إنشاء قالب جديد** | ينشئ قالبًا مستقلًا ويبقي القالب المحمّل بلا تغيير. | يؤثر تحديث القالب في عمليات اختياره المستقبلية. لا يغيّر الرسائل التي أُرسلت بالفعل، ولا يعيد حفظ عُقد سير العمل الأخرى تلقائيًا. ## فئات القوالب في عقدة البريد الإلكتروني يعرض مربع الحفظ حاليًا الفئات التالية: - إشعارات سير العمل؛ - طلبات الموافقة؛ - التذكيرات؛ - تذكيرات المهام؛ - انتهاء المهام؛ - التصعيد المبكر؛ - تحديثات الحالة؛ - تنبيهات النظام؛ - التقارير؛ - مخصص. تصفّي عقدة البريد القوالب بحسب غرضها الحالي. إذا لم يظهر قالب محفوظ، فتحقق من فئته في **قاعدة بيانات سير العمل ← الاتصالات**، ثم أغلق خصائص البريد وأعد فتحها. ## إدارة مجموعة القوالب الكاملة افتح **التطبيقات ← منشئ التدفق ← قاعدة بيانات سير العمل ← الاتصالات** عندما تحتاج إلى جدول القوالب الكامل بدلًا من منتقي عقدة البريد. يتضمن المدير الحالي ملخصات الإجمالي والنشط والمسودة وإجمالي الاستخدام، إضافة إلى البحث والتصفية حسب النوع والفئة والحالة، وإجراءات الصف للتحرير والمعاينة والنسخ والحذف. يدعم محرر الاتصالات سبعة أنواع من القوالب: البريد الإلكتروني، وSMS، والإشعار داخل التطبيق، والإشعار الفوري، ورسالة Slack، وMicrosoft Teams، وWebhook. لمعرفة الحقول والإجراءات بدقة، راجع [استخدام قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/#الاتصالات). ## أدلة ذات صلة - [ضبط عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [استخدام قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [ضبط بريد الإدارة واختباره](https://raptix.app/user-guide/ar/70-administration/70-4-email/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-18-reminder-scheduler-node/ # عقدة مجدول التذكيرات: أتمتة تذكيرات البريد المبنية على التاريخ > **الوحدة:** مسارات سير العمل > > **الجمهور:** المشرفون > > **ستتعلم:** كيف تضيف عقدة مجدول تذكيرات إلى سير عمل، وتربطها بمصدر بيانات، وتعدّ إزاحات التذكير وقالب البريد، وتمكّن اكتشاف التغيير تلقائيًا لتظل التذكيرات متزامنة عند تغير التواريخ. ## ما هي؟ تراقب **عقدة مجدول التذكيرات (Reminder Scheduler)** مجموعة سجلات، مثل تواريخ انتهاء العقود أو المواعيد النهائية لتجديد المستندات أو مراحل المشروع، وترسل تلقائيًا تذكيرات بالبريد إلى المستلمين المحددين في فواصل معدّة قبل حلول كل تاريخ. بعد الإعداد، تعمل العقدة باستمرار في الخلفية ما دام سير العمل نشطًا. تتحقق من مصدر البيانات، وتحسب السجلات ذات التواريخ القريبة، وترسل تذكيرًا عند كل إزاحة معدّة، مثل قبل 30 يومًا وقبل 7 أيام وفي اليوم نفسه. وعندما يتغير تاريخ صف أو عنوان بريده في بيانات المصدر، تستطيع العقدة اكتشاف التغيير فورًا وإعادة حساب التذكير التالي من دون تدخل يدوي. صُممت العقدة للعمل إلى جانب **عقدة استعلام قاعدة البيانات (DB Query)** التي تجلب مجموعة البيانات التي يراقبها المجدول. ## أهميتها وفوائدها الرئيسية - **عدم تفويت موعد نهائي مهم.** يعمل المجدول على مدار الساعة من دون الحاجة إلى فحص جدول بيانات أو تقويم. ويحصل كل سجل ذي تاريخ قريب على تذكيره تلقائيًا. - **نقاط تذكير عدة لكل سجل.** أعدّ أي عدد تتطلبه عمليتك من الإزاحات، مثل 30 يومًا و7 أيام ويوم واحد قبل الموعد وفي يومه، مع رسالة مستقلة لكل إزاحة. - **رسائل مخصصة ببيانات كل صف.** يدعم الموضوع والنص علامات الدمج `{{row.column_name}}`، فتضم كل رسالة اسم السجل الحقيقي وموعده وأي حقل آخر من البيانات من دون تخصيص يدوي. - **التكيف تلقائيًا عند تغير البيانات.** عندما يُؤجّل تاريخ أو يتحدث عنوان بريد في المصدر، تعيد ميزة اكتشاف التغيير حساب التذكيرات فورًا، من دون إعادة تشغيل سير العمل أو إعداد العقدة. - **تحكم تشغيلي.** تعرض علامة **التذكيرات** في قاعدة بيانات سير العمل حالة التذكيرات المعدّة، وتتيح للمشغّلين المخوّلين عرض السجلات أو تحريرها أو إلغاءها أو حذفها باستخدام الإجراءات المتاحة لكل حالة. ## قبل أن تبدأ - يلزم **دور المشرف** لإعداد هذه العقدة. - يجب أن يحتوي سير العمل على **عقدة استعلام قاعدة بيانات سابقة** لمجدول التذكيرات. تجلب عقدة الاستعلام السجلات، أي الصفوف، ذات التواريخ المطلوب مراقبتها. - يجب أن تعرف أسماء الأعمدة في مصدر بياناتك: - **عمود مفتاح** يعرّف كل صف بصورة فريدة، مثل `id` أو `contract_number`؛ - **عمود تاريخ** للموعد النهائي المراد مراقبته، مثل `expiry_date` أو `renewal_date`؛ - **عمود بريد** لعنوان المستلم في كل صف، مثل `owner_email` أو `responsible_person`. - يجب **حفظ** سير العمل وجعل حالته **نشطًا (Active)** قبل بدء الجدولة. - يجب إعداد حساب بريد واحد على الأقل في إعدادات البريد بالمنصة. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — إضافة عقدة استعلام قاعدة بيانات قبل المجدول يقرأ مجدول التذكيرات بياناته من إخراج عقدة استعلام قاعدة بيانات. ويجب أن تكون تلك العقدة متصلة وسابقة له. 1. افتح سير العمل في **المصمم المرئي** باختيار **تحرير (Edit)** من شاشة إدارة سير العمل. 2. اسحب **عقدة استعلام قاعدة بيانات** من الشريط الجانبي إلى اللوحة، وصِلها بمسار سير العمل. 3. انقرها نقرًا مزدوجًا وأعدّها لجلب السجلات المطلوب مراقبتها، مثل استعلام يعيد عقودًا بأعمدة `id` و`name` و`expiry_date` و`owner_email`. 4. امنح العقدة تسمية يسهل التعرف عليها، ودوّن اسم **متغير الإخراج (Output Variable)** الذي تنتجه، مثل `db_rows`. 5. احفظ عقدة استعلام قاعدة البيانات. --- ### الخطوة 2 — إضافة عقدة مجدول التذكيرات 6. اعثر في الشريط الجانبي على **مجدول التذكيرات (Reminder Scheduler)** تحت العُقد المنطقية أو المتقدمة. 7. اسحبه إلى اللوحة وصِله بعد عقدة استعلام قاعدة البيانات. --- ### الخطوة 3 — فتح إعدادات مجدول التذكيرات 8. انقر العقدة نقرًا مزدوجًا. تفتح لوحة إعداد بعنوان **Reminder Scheduler Node**. --- ### الخطوة 4 — اختيار مصدر البيانات **إذا كانت عقدة استعلام قاعدة بيانات متصلة قبله:** 9. تعرض قائمة **متغير الصفوف (Rows Variable)** تحت **مصدر البيانات (Data Source)** عُقد الاستعلام السابقة المتاحة. اختر العقدة التي يحتوي متغير إخراجها على سجلاتك، مثل عقدة «سجلات العقود» ذات المتغير `db_rows`. 10. يُملأ حقل **جدول المصدر (Source Table)** تلقائيًا باسم الجدول المكتشف من عقدة الاستعلام، ويظهر للقراءة فقط. **إذا لم تكن هناك عقدة استعلام متصلة بعد، بالإدخال اليدوي:** 9. اكتب في حقل **متغير الصفوف** اسم متغير إخراج عقدة الاستعلام، مثل `db_rows`. 10. اكتب في حقل **الجدول (Table)** تحت جدول المصدر اسم جدول قاعدة البيانات الدقيق، مثل `contracts`. --- ### الخطوة 5 — ربط الأعمدة 11. املأ في قسم **ربط الأعمدة (Column Mapping)**: | الحقل | ما تدخله | |---|---| | **عمود المفتاح (Key Column)** | العمود الذي يعرّف كل صف بصورة فريدة، مثل `id` أو `contract_number`. القيمة الافتراضية `id`. | | **عمود التاريخ (Date Column)** | العمود الذي يحتوي التاريخ المطلوب مراقبته، مثل `expiry_date` أو `deadline`. القيمة الافتراضية `deadline`. | | **عمود البريد (Email Column)** | العمود الذي يحتوي عنوان بريد مستلم كل صف، مثل `owner_email` أو `contact_email`. القيمة الافتراضية `email`. | 12. يجب أن تطابق أسماء الأعمدة هذه تمامًا الأسماء التي تعيدها عقدة استعلام قاعدة البيانات. --- ### الخطوة 6 — إعداد إزاحات التذكير يحدد قسم **إزاحات التذكير (Reminder Offsets)** توقيت إرسال كل رسالة بالنسبة إلى عمود التاريخ. لكل إزاحة: - **التسمية (Label)** — اسم مقروء يظهر في سجل التدقيق، مثل «قبل 7 أيام» أو «في اليوم نفسه»؛ - **الأيام (Days)** — عدد الأيام قبل التاريخ لإرسال التذكير. استخدم `0` ليوم الموعد نفسه. الإزاحات الافتراضية هي: - قبل 7 أيام، التسمية `7d` والأيام 7؛ - قبل يوم واحد، التسمية `1d` والأيام 1؛ - في اليوم نفسه، التسمية `0d` والأيام 0. **لإضافة إزاحة مخصصة:** 13. اكتب في حقل **التسمية** أسفل قسم الإزاحات اسمًا، مثل «قبل أسبوعين». 14. اكتب في حقل **الأيام** عدد الأيام قبل التاريخ، مثل `14`. 15. انقر **إضافة (Add)**. تظهر الإزاحة الجديدة كوسم في القائمة. **لإزالة إزاحة:** 16. انقر **X** على وسم الإزاحة لإزالتها. > يجب إعداد إزاحة واحدة على الأقل؛ يظل زر **حفظ** معطلًا حتى توجد واحدة. --- ### الخطوة 7 — كتابة قالب البريد 17. املأ في قسم **قالب البريد (Email Template)**: **الموضوع (Subject)** — سطر موضوع الرسالة. استخدم `{{row.column_name}}` لإدراج قيمة من بيانات الصف الحالي. مثال: `تذكير: ينتهي {{row.contract_name}} خلال {{row.days_remaining}} يومًا` **النص (Body)** — نص الرسالة. استخدم نصًا عاديًا مع علامات الدمج `{{row.column_name}}`. مثال: ```text مرحبًا، هذا تذكير بأن العقد {{row.contract_name}} سينتهي في {{row.expiry_date}}. يرجى اتخاذ إجراء التجديد اللازم قبل الموعد النهائي. مع التحية، نظام سير العمل في RAPTIX ``` يمكن استخدام أي اسم عمود تعيده عقدة الاستعلام بصيغة `{{row.column_name}}`. --- ### الخطوة 8 — إعداد الخيارات المتقدمة 18. في قسم **متقدم (Advanced):** **المنطقة الزمنية للمصدر (Source Timezone)** — اختر المنطقة الزمنية التي تُخزن بها تواريخ بياناتك، لضمان إرسال التذكيرات في الوقت الصحيح بالنسبة إلى المنطقة المحلية للبيانات. الخيارات المتاحة: Africa/Cairo وUTC وAmerica/New_York وAmerica/Los_Angeles وEurope/London وEurope/Paris وAsia/Dubai وAsia/Riyadh وAsia/Kolkata. **التثبيت التلقائي لمُشغّل اكتشاف التغيير (Auto-install change detection trigger)** — عندما تحدد هذا المربع، وهو موصى به، يثبّت النظام تلقائيًا مستمعًا لتغييرات قاعدة البيانات في جدول المصدر. وهذا يعني: - عند إدراج صف جديد، يُنشأ جدول تذكيراته فورًا؛ - عند تغير تاريخ صف أو بريده، يُعاد حساب جدول تذكيراته فورًا؛ - عند حذف صف، تُلغى تذكيراته المعلّقة تلقائيًا. إذا ألغيت التحديد، تُكتشف التغييرات كل 5 دقائق باستخدام وضع الاستقصاء بدلًا من اكتشافها فورًا. **تشغيل سير العمل عند (Trigger workflow on):** تتحكم ثلاثة مربعات مستقلة في أنواع تغير الصفوف التي تعيد حساب التذكيرات: | مربع التحديد | ما يتحكم فيه | |---|---| | **INSERT، إضافة صف جديد** | تحصل السجلات الجديدة تلقائيًا على جدول تذكيراتها. مفعّل افتراضيًا. | | **UPDATE، تغير تاريخ الصف أو بريده** | تُعاد حساب التذكيرات عند تغير التاريخ أو البريد. معطل افتراضيًا؛ فعّله إذا كانت التواريخ تتغير كثيرًا. | | **DELETE، إزالة صف وإلغاء التذكير** | تُلغى التذكيرات المعلّقة عند حذف الصف. مفعّل افتراضيًا. | --- ### الخطوة 9 — حفظ الإعداد 19. انقر **حفظ (Save)** أسفل يمين اللوحة. تتحدث عقدة مجدول التذكيرات في اللوحة وتعرض رمز جرس. 20. احفظ سير العمل كاملًا بزر **حفظ** في شريط أدوات المصمم أو باستخدام **Ctrl+S**. 21. تأكد من أن حالة سير العمل **نشط (Active)** في شاشة إدارة سير العمل؛ إذ لا تعمل التذكيرات إلا للمسارات النشطة. --- ## مراقبة التذكيرات بعد تنشيط سير العمل: - افتح **قاعدة بيانات سير العمل** من رأس إدارة سير العمل، ثم اختر **التذكيرات**. - انقر علامة **التذكيرات (Reminders)**. - سترى قائمة بكل إدخالات التذكير المعدّة مع حالتها، مثل نشط أو ملغى، وإعداد توقيتها وسير العمل المرتبط بها. - يعرض **سجل الإرسال (Send History)** لكل تذكير الرسائل التي أُرسلت والمستلمين وأوقات الإرسال. - لإيقاف تذكير محدد مؤقتًا، اختره واستخدم الإجراء المتاح. ولإلغائه، استخدم خيار الإلغاء. --- ## شرح الخيارات والإعدادات | الإعداد | القسم | ما يفعله | |---|---|---| | **الجدول (Table)** | جدول المصدر | جدول قاعدة البيانات الذي يراقبه المجدول. يُملأ تلقائيًا من عقدة استعلام متصلة، أو يُدخل يدويًا. | | **عمود المفتاح** | ربط الأعمدة | عمود المعرّف الفريد، ويُستخدم لمطابقة الصفوف عبر دورات الاستقصاء. | | **عمود التاريخ** | ربط الأعمدة | حقل التاريخ الذي يؤدي اقترابه إلى تشغيل التذكيرات. | | **عمود البريد** | ربط الأعمدة | الحقل الذي يحتوي عنوان بريد المستلم لكل صف. | | **متغير الصفوف** | مصدر البيانات | اسم المتغير من عقدة الاستعلام السابقة الذي يحتوي على الصفوف. | | **تسمية الإزاحة** | إزاحات التذكير | اسم مقروء لتوقيت كل تذكير، يظهر في سجلات التدقيق. | | **أيام الإزاحة** | إزاحات التذكير | عدد الأيام قبل التاريخ لإرسال التذكير؛ `0` يعني يوم الموعد. | | **الموضوع** | قالب البريد | موضوع رسالة التذكير، ويدعم علامات `{{row.column_name}}`. | | **النص** | قالب البريد | نص رسالة التذكير، ويدعم علامات `{{row.column_name}}`. | | **المنطقة الزمنية للمصدر** | متقدم | المنطقة الزمنية لتواريخ المصدر، وتؤثر في حساب «اليوم». | | **التثبيت التلقائي لمُشغّل اكتشاف التغيير** | متقدم | يكتشف تغيرات جدول المصدر فورًا بدلًا من كل 5 دقائق عند تمكينه. | | **مُشغّل INSERT** | متقدم | يكتشف الصفوف الجديدة ويجدول تذكيراتها. | | **مُشغّل UPDATE** | متقدم | يكتشف تغير تاريخ الصف أو بريده ويعيد جدولة تذكيراته. | | **مُشغّل DELETE** | متقدم | يلغي التذكيرات المعلّقة عند حذف الصف. | --- ## نصائح وأفضل الممارسات - **فعّل مُشغّلي INSERT وDELETE دائمًا.** من دون اكتشاف INSERT، لا تحصل السجلات الجديدة بعد بدء سير العمل على تذكيرات حتى دورة الاستقصاء التالية. ومن دون DELETE، قد تستمر التذكيرات بعد زوال السجل الأصلي. - **فعّل اكتشاف UPDATE عندما يمكن أن تتغير المواعيد.** إذا سمحت العملية بتمديد المواعيد، وهو شائع في إدارة العقود، ففعّله ليُعاد حساب الجدول بدلًا من إرسال تذكيرات قديمة. - **استخدم المنطقة الزمنية للمصدر بطريقة صحيحة.** إذا كانت التواريخ مخزنة بتوقيت UTC والمستخدمون في القاهرة، فاختر `Africa/Cairo` ليُرسل تذكير «يوم الموعد» في التاريخ المحلي الصحيح. - **اختبر أولًا بتاريخ قريب.** قبل النشر، أضف مؤقتًا صف اختبار بتاريخ بعد يوم وبريد تجريبي للتأكد من وصول التذكيرات في الموعد وبالمحتوى الصحيح. - **اجعل نص البريد موجزًا.** تكون رسائل التذكير أكثر فاعلية عندما تكون قصيرة وموجهة إلى إجراء. ضمّن الحقول الأساسية، مثل اسم السجل والموعد والإجراء المطلوب، من دون إضافات. - **استخدم تسميات وصفية للإزاحات.** تكون «قبل التجديد بـ30 يومًا» أوضح من `30d`، وتظهر التسميات في علامة التذكيرات بقاعدة بيانات سير العمل. - **أضف رابطًا أو خطوات تالية في النص.** إذا كان على المستلمين اتخاذ إجراء، فاربط مباشرة بالنظام أو المستند أو سير العمل المعني. ## الأسئلة الشائعة **س: ماذا يحدث إذا فشل إرسال رسالة تذكير؟** يمكن التحقق من الإرسال الفاشل في قاعدة بيانات سير العمل باستخدام **التذكيرات** و**الإشعارات**. راجع الخطأ وعدد المحاولات قبل تحديد ما إذا كان ينبغي لسير العمل توليد تذكير آخر. **س: هل يمكن إرسال التذكير إلى أكثر من شخص لكل سجل؟** يرتبط حقل عمود البريد بعنوان واحد لكل صف. لإشعار عدة أشخاص، إما: أ) تخزين قائمة مفصولة بفواصل في عمود البريد وإعداد نظام البريد للتعامل معها، أو ب) إضافة عدة عُقد مجدول تذكيرات تشير إلى أعمدة مختلفة، مثل `primary_email` و`secondary_email`. **س: هل تستمر التذكيرات إذا أُعيد تشغيل الخادم أثناء جدولتها؟** نعم. يُحفظ جدول التذكيرات بصورة دائمة. بعد إعادة التشغيل، يستأنف المجدول من موضعه ويرسل أي تذكيرات استحقت أثناء التوقف. **س: ماذا لو مر تاريخ سجل ثم أضفته بعد ذلك؟** لا تُرسل التذكيرات إلا للتواريخ المستقبلية. إذا أُدرج صف بتاريخ ماضٍ، فلا تُرسل الإزاحات الماضية؛ ولا تنطبق إلا النقاط التي لا تزال مستقبلية. **س: هل يمكنني إيقاف كل تذكيرات سير عمل مؤقتًا؟** نعم. اضبط سير العمل على **غير نشط (Inactive)** في شاشة إدارة سير العمل. يوقف ذلك كل نشاطه، بما فيه المجدول. أعد تنشيطه للاستئناف. **س: ما معنى وضع الاستقصاء، ومتى أستخدمه؟** عند إلغاء تحديد التثبيت التلقائي للمُشغّل، يتحقق المجدول من التغييرات كل 5 دقائق بدلًا من اكتشافها فورًا. استخدم هذا الوضع عندما لا تسمح صلاحيات قاعدة البيانات بتثبيت المُشغّلات أو عندما تكون مُشغّلات مستوى قاعدة البيانات مقيّدة. ويقابله تأخير محتمل قدره 5 دقائق قبل تحديث جدول السجلات الجديدة أو المعدلة. **س: هل يمكن إضافة عدة عُقد مجدول تذكيرات إلى سير العمل نفسه؟** نعم. يمكن لكل عقدة مراقبة مصدر مختلف أو استخدام ربط أعمدة وإزاحات مختلفة، مثل عقدة لتجديد العقود وأخرى لمواعيد فحص المعدات. **س: كيف أزيل إزاحة لم أعد أحتاج إليها؟** افتح إعدادات العقدة، واعثر على وسم الإزاحة في قسم الإزاحات، وانقر زر **X**. احفظ العقدة. لا تتأثر التذكيرات التي سبق إرسالها لتلك الإزاحة. ## أدلة ذات صلة - [مُشغّلات البداية](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) — أنواع مُشغّل البداية، بما فيها جدولة بدء مسارات سير العمل - [عقدة استعلام قاعدة البيانات](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) — إعداد العقدة التي تغذي مجدول التذكيرات بالبيانات - [إدارة المواعيد النهائية](https://raptix.app/user-guide/ar/10-workflows/10-7-deadline-management/) — ضبط المواعيد والتذكيرات داخل عُقد المهام، وهو نهج مختلف - [عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) — إرسال إشعار لمرة واحدة في خطوة محددة - [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) — مراقبة سجل التذكيرات وإدارته في علامة التذكيرات - [المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) — فهم علامات `{{row.column_name}}` ومتغيرات سير العمل الأخرى - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-36-wait-for-matching-email/ # انتظار بريد إلكتروني مطابق داخل سير عمل جارٍ > **الوحدة:** مسارات سير العمل > > **الجمهور:** منشئو سير العمل والمشرفون > > **الوصول المطلوب:** صلاحية تحرير سير العمل؛ يلزم إعداد بيئة البريد للمطابقة المباشرة، وقد تعتمد أدوات التشخيص المتقدمة على خطة مساحة العمل > > **ستتعلم:** كيف توقف سير عمل نشطًا حتى تصل رسالة مطابقة، وتختار قواعد مطابقة موثوقة، وتتيح قيم الرسالة للخطوات اللاحقة، وتعدّ مسار انتهاء مهلة، وتختبر التصميم، وتميز هذه الخطوة من مُشغّل البريد الإلكتروني. ## فهم وقت استخدام هذه الخطوة استخدم انتظار البريد المطابق عندما يكون سير العمل قد بدأ بالفعل، لكنه يحتاج إلى التوقف حتى يصل رد أو مستند لاحق. تشمل الأمثلة انتظار رد مورد أو مرفق موقّع أو توضيح مطلوب أو رسالة تؤكد إجراءً خارجيًا. يختلف ذلك عن **مُشغّل البريد الإلكتروني (Email Trigger)**: | مُشغّل البريد الإلكتروني | انتظار بريد مطابق | |---|---| | تبدأ الرسالة الواردة مثيل سير عمل جديدًا. | تستأنف الرسالة مثيلًا واحدًا محددًا قيد التشغيل. | | تحدد المطابقة سير العمل المطلوب إطلاقه. | تحدد المطابقة عملية التشغيل المنتظرة التي تملك الرسالة. | | تصبح قيم المُشغّل مدخلات العملية الأولية. | تصبح قيم الرسالة مخرجات لخطوة الانتظار تستخدمها العُقد اللاحقة. | ## إضافة خطوة الانتظار 1. افتح سير العمل في **منشئ التدفقات (Flow Builder)**. 2. أضف خطوة انتظار البريد من قائمة العُقد المتاحة. 3. صِل الخطوة بعد الإجراء الذي يطلب الرد أو ينتظره. 4. صِل مخرج النجاح بالخطوة التي ستعالج الرسالة المستلمة. 5. إذا وفرت العقدة مخرج انتهاء مهلة، فصِله بمسار التذكير أو التصعيد أو النهاية الآمنة. قد يتبع اسم العقدة الدقيق الظاهر في منشئ التدفقات المصطلحات المفعّلة لمساحة عملك. استخدم وصف العقدة للتأكد من أنها تنتظر داخل مثيل جارٍ، لا تبدأ مثيلًا جديدًا. ## اختيار قواعد المطابقة أنشئ قواعد من معلومات تعرّف الرد المتوقع بصورة فريدة. بحسب قدرة البريد المعدّة، قد تشمل الحقول الظاهرة المرسل والمستلم أو عنوان RAPTIX والموضوع ونص الرسالة واللغة وتفاصيل المرفقات ومرجع المستند أو المشروع ومتغيرات سير العمل. تجمع المطابقة الجيدة بين مرجع عمل ثابت والقناة المتوقعة. مثال: ```text Recipient is {{workflow_reply_address}} AND subject contains {{case_reference}} AND sender is {{supplier_email}} ``` تجنب قاعدة مثل «يحتوي الموضوع على invoice» وحدها. قد تطابق القاعدة الواسعة رسالة خاطئة عندما تنتظر مثيلات عدة في الوقت نفسه. استخدم المتغيرات التي أنتجتها خطوات سابقة بدلًا من كتابة قيمة تتغير في كل تشغيل. عاين القاعدة أو اختبرها بعينة عندما يتوفر ذلك العنصر. ## إعداد ما يحدث عند وصول البريد يمكن لخطوة الانتظار إتاحة معلومات الرسالة المسموح بها للعُقد التالية، مثل: - المرسل والمستلمين والموضوع ووقت الاستلام؛ - نص آمن أو نص مستخرج؛ - أسماء المرفقات ومراجع الملفات المسموح بها؛ - مرجع الرسالة أو سلسلة الرسائل؛ و - نتيجة قاعدة المطابقة. استخدم هذه المخرجات في شرط أو مهمة بشرية أو خطوة وكيل ذكاء اصطناعي أو خطوة مستندات أو رد بالبريد. تعامل مع توفر المرفق باعتباره مشروطًا؛ إذ يجب أن تجتاز الملفات المحتفظ بها فحوص أمان مساحة العمل قبل أن يستطيع المستخدم تنزيلها. ## ضبط مهلة انتظار لا تترك عملية عمل منتظرة بلا نهاية، إلا إذا كانت هذه هي السياسة المقصودة. 1. اختر أقصى مدة انتظار تعرضها العقدة. 2. وجّه نتيجة انتهاء المهلة إلى مخرج صريح. 3. أضف تذكيرًا أو إعادة إسناد أو تصعيدًا أو إغلاقًا مسجلًا حسب الحاجة. 4. اجعل الرسالة الموجهة إلى المكلّف تشرح ما لم يصل وأي مثيل يحتاج إلى متابعة. ينبغي ألا يتظاهر مسار انتهاء المهلة بوصول رد. لا تستخدم فيه متغيرات الرسالة المستلمة إلا بعد التحقق من وجودها. ## التحقق والاختبار قبل التنشيط: 1. تحقق من سير العمل وحل المخرجات غير المتصلة أو المتغيرات المفقودة. 2. شغّل مثيلًا تجريبيًا بمرجع مميز. 3. أرسل رسالة غير مطابقة وتأكد من بقاء التشغيل في الانتظار. 4. أرسل رسالة مطابقة وتأكد من استئناف المثيل الصحيح مرة واحدة. 5. اختبر مسار انتهاء المهلة بمدة قصيرة، ثم استعد القيمة المقصودة. 6. راجع الخط الزمني للمثيل وسجل أرشيف البريد المسموح به. لا تظهر أدوات التشخيص أو إعادة التشغيل أو الرسائل غير القابلة للتسليم إلا عندما توفرها بيئة البريد والخطة. ولا يجعل غيابها قاعدة واسعة آمنة. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | لا يُستأنف التشغيل | تأكد من إعداد مزود البريد ومن نشاط العقدة ومن مطابقة كل قاعدة AND للرسالة الفعلية. | | استؤنف التشغيل الخطأ | أضف مرجعًا لكل مثيل أو عنوان مستلم، وأزل قواعد الموضوع أو النص الواسعة جدًا. | | بدأ الرد تشغيلًا جديدًا بدلًا من ذلك | أعددت مُشغّل بريد بدل انتظار داخل العملية، أو أن كلا الاشتراكين يطابقان العنوان نفسه. | | لا يمكن تنزيل المرفق | ربما لم يُحتفظ بالأصل، أو لم يكتمل فحص الأمان أو لم ينجح. | | انتهت المهلة مبكرًا | تحقق من المدة الظاهرة والمنطقة الزمنية وأي متغير مستخدم لحسابها. | | التشخيص أو إعادة التشغيل مفقودان | قد تتطلب هذه العناصر بيئة بريد معدّة أو خطة أعلى. يظل الخط الزمني للمثيل يعرض النتيجة ذات الصلة بالمستخدم. | ## أدلة ذات صلة - [عقدة مُشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [إعداد عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [عقدة الإيقاف المؤقت / التأخير](https://raptix.app/user-guide/ar/10-workflows/10-13-pause-delay-node/) - [تشغيل سير عمل ومراقبته](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [حفظ بريد سير العمل والعثور عليه وقراءته](https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/ # عقدة وكيل الذكاء الاصطناعي: الموجّهات واختيار النموذج والمخرجات المنظمة والتوجيه بحسب الثقة > **الوحدة:** عمليات سير العمل  |  **الجمهور:** جميع المستخدمين > **ستتعلم:** كيفية إضافة عقدة وكيل ذكاء اصطناعي إلى سير العمل، وكتابة موجّهات فعالة، واختيار نموذج، وتعريف مخرجات منظمة أو حرة، وتوجيه سير العمل بناءً على قرار الذكاء الاصطناعي، بما في ذلك المسارات المستندة إلى درجة الثقة. ## ما هذه الميزة؟ تضيف **عقدة وكيل الذكاء الاصطناعي** إمكانات الذكاء الاصطناعي مباشرة إلى إحدى خطوات سير العمل. عندما يصل المثيل إلى هذه العقدة، يقرأ الذكاء الاصطناعي البيانات والملفات التي تحددها، ويتبع التعليمات الواردة في موجّهك، ثم ينتج قرارًا أو نتيجة استخراج. بعد ذلك يواصل سير العمل عبر المسار المطابق لمخرجاته. تشمل الاستخدامات الشائعة: - **تصنيف مستند مُرسل**، مثل تحديد ما إذا كان فاتورة أو عقدًا أو أمر شراء. - **استخراج الحقول المهمة** من المستند تلقائيًا، مثل المبالغ والتواريخ والأسماء ورموز الموافقات. - **تقديم توصية أولية بالموافقة** وفق قواعد تصفها بلغة واضحة في الموجّه. - **الإجابة عن سؤال** يتعلق بقاعدة معرفة مؤسستك أثناء العملية. - **التوجيه إلى مراجع بشري** عندما لا تكون ثقة الذكاء الاصطناعي كافية لاتخاذ القرار وحده. تحتوي العقدة على ثلاث علامات إعداد: **المدخلات**، أي البيانات والملفات التي يقرأها الذكاء الاصطناعي؛ و**النموذج والموجّه والمهارات**، أي المهمة وطريقة تنفيذها؛ و**المخرجات والتوجيه**، أي بنية النتيجة والمسار الذي يسلكه سير العمل. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **معالجة أعداد كبيرة من القرارات الروتينية تلقائيًا.** يستطيع الذكاء الاصطناعي الموافقة على الطلبات الواضحة منخفضة المخاطر أو تصنيفها أو معالجتها من دون خطوة بشرية، ليتفرغ الموظفون للحالات التي تحتاج فعلًا إلى الحكم البشري. - **استخراج بيانات منظمة فورًا من مستندات غير منظمة.** بدلًا من قراءة ملف PDF يدويًا للعثور على إجمالي فاتورة، يقرأه الذكاء الاصطناعي ويعيد الحقل كمتغير ذي نوع، متاح لكل خطوة لاحقة. - **قراءة مستندات مؤسستك للإجابة.** يستطيع الذكاء الاصطناعي الاستعلام من قاعدة المعرفة الداخلية وقت التشغيل، فتستند قراراته إلى سياساتك وسجلاتك الفعلية لا إلى معلومات تدريب عامة. - **الثقة مع التحقق والتوجيه البشري للحالات غير المؤكدة.** عندما تقل درجة الثقة عن العتبة التي تحددها، ينتقل سير العمل تلقائيًا إلى مراجعة بشرية بدلًا من اتخاذ قرار غير موثوق. - **معالجة المستندات الممسوحة والصور والتخطيطات المعقدة** إلى جانب الملفات النصية الرقمية. - **إعادة استخدام الخبرة عبر عمليات سير العمل.** المهارات حزم تعليمات قابلة لإعادة الاستخدام تكتبها مرة، ثم تربطها بأي عقدة وكيل لتطبيق قواعد استدلال متسقة من دون إعادة كتابة الإرشادات. - **اختبار العقدة قبل الإطلاق.** يتيح مشغّل الاختبار المدمج إدخال قيم متغيرات نموذجية وعرض استجابة الذكاء الاصطناعي فورًا، من دون تشغيل مثيل كامل. ## قبل أن تبدأ - تتوفر عقدة وكيل الذكاء الاصطناعي **لجميع المستخدمين**؛ ولا يلزم دور خاص لإضافتها أو ضبطها أو حفظها. وحدهما عقدتا برنامج Python النصي واستعلام قاعدة البيانات مقيّدتان بالمسؤولين. - يجب ضبط نموذج ذكاء اصطناعي واحد على الأقل في إعدادات مصادقة الذكاء الاصطناعي لمؤسستك. إذا لم يتوفر أي نموذج، فتواصل مع المسؤول. - لاستخدام قاعدة المعرفة، يجب أن تكون المستندات المطلوبة قد عولجت وفُهرست في قاعدة معرفة RAPTIX. - افتح سير العمل من شاشة **إدارة عمليات سير العمل** واختر **تحرير**. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1: ضع العقدة على اللوحة 1. افتح علامة **منطق** في الشريط الجانبي الأيسر للمصمم المرئي. 2. اسحب عقدة **وكيل الذكاء الاصطناعي** إلى اللوحة بعد الخطوة التي تجمع البيانات أو الملفات التي سيقرأها الوكيل. 3. صِل مخرج العقدة السابقة بمدخل عقدة وكيل الذكاء الاصطناعي. 4. انقر على العقدة نقرًا مزدوجًا، أو اختر رمز الترس، لفتح مربع إعداد **عقدة وكيل الذكاء الاصطناعي**. 5. أكمل حقلي **تسمية العقدة** و**وصف العقدة** في الأعلى. يظهران على اللوحة ويساعدان الآخرين في فهم وظيفة خطوة الذكاء الاصطناعي. --- ### الخطوة 2: اضبط المدخلات (علامة 1) تحدد علامة **المدخلات** البيانات والملفات التي يتلقاها الذكاء الاصطناعي. **متغيرات الإدخال:** 6. تعرض شجرة المتغيرات كل القيم المتاحة من العُقد السابقة، مجمعة حسب العقدة التي أنتجتها. يمكنك توسيع كل مجموعة بالنقر على رأسها. 7. فعّل مربع الاختيار بجوار كل متغير ينبغي أن يتلقاه الذكاء الاصطناعي. تظهر المتغيرات المحددة كشرائح بنفسجية في لوحة «المحدد» أعلى القسم. 8. استخدم حقل **البحث في المتغيرات** لتصفية القائمة عندما تضم الكثير منها. 9. اختر **إضافة الكل تلقائيًا** لتحديد جميع المتغيرات المتاحة دفعة واحدة. استخدمه عندما تريد منح الذكاء الاصطناعي السياق الكامل. 10. لنسخ رمز متغير ولصقه في الموجّه، مرّر المؤشر فوق صف المتغير واختر رمز النسخ، أو اختر الشريحة في لوحة العناصر المحددة. **ملفات الإدخال:** 11. اختر **إضافة ملف** لإرفاق ملف ينبغي للذكاء الاصطناعي قراءته. 12. في لوحة **إضافة ملف**: - اختر **المصدر**: **ملف سير العمل**، أي ملف رُفع من خلال منتقي الملفات في نموذج سير العمل، أو **المستندات**، أي مستند من مكتبة المستندات. - إذا اخترت «ملف سير العمل»، فحدد أداة منتقي الملفات من القائمة. - إذا اخترت «المستندات»، فاختر **تصفح المستندات…** وابحث عن المستند بالاسم. - ضمن **كيف يقرأ الذكاء الاصطناعي هذا الملف**، اختر: - **استخراج مباشر** — يقرأ النص فورًا من ملفات PDF الرقمية والملفات النصية. يتميز بالسرعة، لكنه لا يعالج المستندات الممسوحة أو القائمة على الصور. - **خط معالجة كامل** — يعالج المستندات الممسوحة والصور والتخطيطات المعقدة. هو أبطأ لكنه يدعم جميع أنواع المستندات. - إذا اخترت خط المعالجة الكامل، فحدد **إعدادًا مسبقًا** من ملفات المعالجة المضبوطة في مؤسستك، ثم اختر **عمق المعالجة**: - **تلقائي** — يكتشف النظام ما إذا كان المستند يحتاج إلى معالجة كاملة. - **قياسي** — التحليل والتقسيم فقط، وهو الأسرع. - **كامل** — يشمل ملخصات الجداول واستخراج الكيانات، وهو الأبطأ والأكثر شمولًا. - اختر **إضافة ملف** للتأكيد. 13. لإعادة ترتيب الملفات، اسحب صفوفها بواسطة المقبض في اليسار. يحدد الترتيب كيفية تمرير الملفات إلى الذكاء الاصطناعي. 14. لتعديل إعدادات معالجة ملف بعد إضافته، اختر رمز أشرطة الضبط في صفه. --- ### الخطوة 3: اضبط النموذج والموجّه والمهارات (علامة 2) اختر علامة **النموذج والموجّه والمهارات**. **اختيار النموذج:** 15. اختر **المولّد الافتراضي** لاستخدام نموذج الذكاء الاصطناعي الافتراضي للمؤسسة، وهو الأنسب لمعظم الحالات، أو اختر **اختيار نموذج** لتحديد نموذج بعينه من القائمة. **إعدادات التوليد:** 16. اضبط شريط **درجة العشوائية** من 0.00 إلى 1.00. تنتج القيم المنخفضة القريبة من الصفر إجابات أكثر تركيزًا واتساقًا، بينما تنتج القيم الأعلى استجابات أكثر تنوعًا. استخدم 0.1–0.3 للتصنيف والاستخراج، و0.5–0.8 للتوليد الأكثر انفتاحًا. 17. اضبط **الحد الأقصى للرموز**: يستخدم **تلقائي** الحد الافتراضي للنموذج. اختر **قيمة مخصصة** وأدخل رقمًا لتقييد طول الاستجابة. 18. اضبط **اللغة**: **اكتشاف تلقائي** كي يجيب الذكاء الاصطناعي بلغة المدخلات، أو **الإنجليزية**، أو **العربية**. **الموجّهات:** 19. أدخل في حقل **موجّه النظام** التعليمات الثابتة التي تضبط سلوك الذكاء الاصطناعي طوال هذه الخطوة. صف هنا دور الذكاء الاصطناعي وقواعده: - مثال: `أنت مراجع مستندات لفريق المشتريات. مهمتك تصنيف كل مستند واستخراج إجمالي الفاتورة واسم المورد وتاريخ الفاتورة.` - اختر زر **نسخ** لنسخ الموجّه إلى الحافظة. 20. أدخل في حقل **قالب موجّه المستخدم** التعليمات الخاصة بكل تشغيل، واستخدم رموز `{{variable_name}}` لإدراج بيانات ديناميكية: - مثال: `حلل المستند المرفق وأعد التصنيف والحقول المهمة. أرسل المستند {{submitter_name}} بتاريخ {{submission_date}}.` - يمكنك اختيار الشرائح أسفل الحقل، التي تعرض متغيرات الإدخال المحددة، لإضافة رمز `{{variable_name}}` الموافق في موضع المؤشر. **الإعدادات المتقدمة:** 21. اختر **الإعدادات المتقدمة** لتوسيع اللوحة. 22. يكون **البحث في الإنترنت** مفعّلًا افتراضيًا. اتركه مفعّلًا لمنح النموذج إذن البحث عن معلومات عامة حديثة عندما تتطلب المهمة ذلك، أو عطّله لحصر العقدة في مدخلات سير العمل وملفاته وأدواته المضبوطة. لا يجبر التفعيل النموذج على البحث في كل تشغيل. 23. اختر شريحة مهارة لتفعيلها أو تعطيلها. تضيف المهارات النشطة حزم تعليماتها إلى سياق الذكاء الاصطناعي وتؤثر في أسلوب كتابته واستدلاله. اختر **إدارة المهارات** لإنشاء المهارات أو تحريرها في مدير المهارات. 24. فعّل **الاكتشاف التلقائي للمهارات المناسبة** للسماح للذكاء الاصطناعي باختيار المهارات الأنسب من مكتبتك تلقائيًا وفق السياق. 25. فعّل **السماح للذكاء الاصطناعي باقتراح مهارات جديدة** ليقترح إنشاء حزمة تعليمات جديدة عندما يواجه موقفًا لا تغطيه أي مهارة حالية. --- ### الخطوة 4: اضبط المخرجات والتوجيه (علامة 3) اختر علامة **المخرجات والتوجيه**. **وضع المخرجات:** 25. اختر **مخرجات منظمة**، وهو الموصى به، أو **نص حر**: - **المخرجات المنظمة:** يعيد الذكاء الاصطناعي كائن JSON ذا حقول مسماة. اختر **إضافة حقل** لتعريف كل حقل؛ وأدخل الاسم والنوع، أي نص أو رقم أو قيمة منطقية أو تعداد، والوصف الذي يُستخدم تلميحًا للذكاء الاصطناعي، وحدده كمطلوب اختياريًا. - **النص الحر:** يعيد الذكاء الاصطناعي استجابة نصية عادية. أدخل اسم المتغير الذي سيحمل النص، مثل `ai_response`. **التوجيه:** 26. ضمن **المسارات**، يظهر مسار واحد على الأقل: `needs_review`، وهو مسار رجوع دائم لا يمكن حذفه. أضف مساراتك باختيار **إضافة مسار**: - أدخل **اسم المسار** الذي يصبح تسمية الحافة على اللوحة، مثل `approved` أو `rejected` أو `high_value`. - أدخل **وصفًا** يوضح متى ينبغي اتخاذ المسار. - اختر **لونًا** لتمييزه بصريًا على اللوحة. - فعّل اختياريًا **استخدام نطاق الثقة** كي لا يعمل المسار إلا عندما تقع درجة ثقة الذكاء الاصطناعي ضمن نطاق مئوي أدنى وأقصى. 27. فعّل **أدوات المستندات الذكية** إذا أردت تمكين الذكاء الاصطناعي من البحث أثناء الاستجابة عن مواقع الملفات ومحتويات المجلدات وأعداد المستندات في المكتبة. 28. فعّل **طلب درجة الثقة (0–1) من الذكاء الاصطناعي** ليبلغ الذكاء الاصطناعي عن مدى ثقته في الإجابة. يفتح ذلك التوجيه المستند إلى الثقة، ويجعل مرشح نطاق الثقة لكل مسار نشطًا. **اختبار العقدة:** 29. اختر **اختبار العقدة** لفتح مربع الاختبار. أدخل قيمًا نموذجية لكل متغير إدخال، ثم اختر **تشغيل**. تعرض نتيجة الاختبار ما قد ينتجه الذكاء الاصطناعي من دون تشغيل مثيل سير عمل حقيقي، ومن دون تنفيذ استعلامات قاعدة المعرفة. --- ### الخطوة 5: احفظ المخرجات وصِلها 30. اختر **حفظ الإعدادات**. 31. صِل في المصمم مقابض مخرجات المسارات المسماة لعقدة وكيل الذكاء الاصطناعي بالخطوات التالية المناسبة. ينبغي وصل مسار `needs_review` بمهمة مراجعة بشرية. 32. اختر **حفظ** أو اضغط **Ctrl+S**. ## شرح الخيارات والإعدادات ### علامة المدخلات | الخيار | ما الذي يفعله؟ | |---|---| | شجرة **متغيرات الإدخال** | تجمع المتغيرات بحسب العقدة السابقة. فعّل كل متغير ينبغي أن يتلقاه الذكاء الاصطناعي. | | زر **إضافة الكل تلقائيًا** | يحدد كل المتغيرات المتاحة دفعة واحدة. | | حقل **البحث في المتغيرات** | يصفّي شجرة المتغيرات فورًا. | | لوحة شرائح المتغيرات | تعرض المتغيرات المحددة حاليًا. اختر شريحة لنسخ `{{token}}` الخاص بها، أو اختر × لإلغاء تحديدها. | | زر **إضافة ملف** | يفتح لوحة منتقي الملفات. | | **المصدر: ملف سير العمل** | ملف رفعه المستخدم في نموذج سير العمل عبر أداة منتقي الملفات. | | **المصدر: المستندات** | مستند معين من مكتبة المستندات، يُحدد وقت التصميم. | | **الاستخراج المباشر** | استخراج سريع للنص من ملفات PDF الرقمية والملفات النصية. | | **خط المعالجة الكامل** | استخراج مستند إلى OCR للمستندات الممسوحة أو الغنية بالصور. | | **الإعداد المسبق** | ملف المعالجة، بما فيه نموذج التضمين وحجم الأجزاء وإعدادات خط المعالجة، الذي ضُبط في المعرفة. | | **عمق المعالجة: تلقائي** | يقرر النظام وفق نوع المحتوى. | | **عمق المعالجة: قياسي** | التحليل والتقسيم فقط، وهو الأسرع. | | **عمق المعالجة: كامل** | يشمل ملخصات الجداول واستخراج الكيانات، وهو الأكثر شمولًا. | | **التضمين التلقائي في قاعدة المتجهات** | يخزن محتوى المستند في فهرس البحث بعد المعالجة، فيصبح متاحًا لاستعلامات قاعدة المعرفة المستقبلية. | | **مقبض السحب** | يعيد ترتيب الملفات؛ ويحدد الترتيب كيفية تقديمها إلى الذكاء الاصطناعي. | ### علامة النموذج والموجّه والمهارات | الخيار | ما الذي يفعله؟ | |---|---| | **المولّد الافتراضي** | يستخدم نموذج الذكاء الاصطناعي الافتراضي للمؤسسة. | | **اختيار نموذج** | يحدد نموذجًا بعينه من النماذج المضبوطة في مصادقة الذكاء الاصطناعي. | | **درجة العشوائية** (0–1) | تتحكم في الإبداع مقابل الدقة؛ والقيمة المنخفضة أكثر تركيزًا. | | **الحد الأقصى للرموز: تلقائي** | يستخدم الحد المدمج في النموذج. | | **الحد الأقصى للرموز: قيمة مخصصة** | يقيد الاستجابة بالعدد الذي تحدده. | | **اللغة: اكتشاف تلقائي** | يجيب الذكاء الاصطناعي باللغة التي يكتشفها في المدخل. | | **اللغة: الإنجليزية/العربية** | يجبر الذكاء الاصطناعي على الإجابة باللغة المحددة. | | **موجّه النظام** | تعليمات ثابتة تحدد دور الذكاء الاصطناعي وقيوده. | | **قالب موجّه المستخدم** | تعليمات لكل تشغيل. استخدم رموز `{{variable_name}}` لإدراج البيانات الفعلية. | | **البحث في الإنترنت** | يمنح النموذج إذن استخدام أدوات الويب العامة المشتركة عند الحاجة. يكون مفعّلًا افتراضيًا ولا يفرض البحث. | | شرائح **المهارات** | حزم تعليمات قابلة لإعادة الاستخدام تضبط أسلوب الاستدلال؛ اخترها للتفعيل. | | **إدارة المهارات** | يفتح مدير المهارات لإنشاء المهارات أو تحريرها. | | **الاكتشاف التلقائي للمهارات المناسبة** | يختار الذكاء الاصطناعي المهارات المنطبقة من المكتبة تلقائيًا. | | **السماح للذكاء الاصطناعي باقتراح مهارات جديدة** | يتيح للذكاء الاصطناعي اقتراح حزم جديدة عندما لا تناسب المهارات الحالية. | ### علامة المخرجات والتوجيه | الخيار | ما الذي يفعله؟ | |---|---| | **المخرجات المنظمة** | يعيد الذكاء الاصطناعي كائن JSON ذا حقول مسماة وأنواع محددة في جدول المخطط. | | **النص الحر** | يعيد الذكاء الاصطناعي نصًا غير منظم يُحفظ في متغير الإخراج المسمى. | | **حقول المخرجات المنظمة — الاسم** | اسم المتغير الذي تُحفظ تحته قيمة الذكاء الاصطناعي للخطوات اللاحقة. | | **حقول المخرجات المنظمة — النوع** | نص أو رقم أو قيمة منطقية أو تعداد. أدخل للتعداد القيم المسموحة مفصولة بفواصل. | | **حقول المخرجات المنظمة — الوصف** | تلميح يُرسل إلى الذكاء الاصطناعي ويصف ما ينبغي أن يحتويه الحقل. | | **حقول المخرجات المنظمة — مطلوب** | عند تفعيله، يجب أن يوفر الذكاء الاصطناعي الحقل. | | **المسارات** | مسارات مخرجات مسماة، ولكل منها اسم ولون ووصف ونطاق ثقة اختياري. | | مسار `needs_review` | مسار رجوع دائم يُتخذ عندما لا يطابق أي مسار آخر أو تكون الثقة منخفضة. لا يمكن حذفه. | | **إضافة مسار** | يضيف مسارًا مخصصًا مسمى ومتصلًا بمسار في المصمم. | | **أدوات المستندات الذكية** | تتيح للذكاء الاصطناعي البحث عن بيانات المستندات الوصفية في المكتبة وقت التشغيل. | | **طلب درجة الثقة** | يطلب من الذكاء الاصطناعي إعادة قيمة ثقة من 0 إلى 1 مع الإجابة، وهو مطلوب للتوجيه بحسب نطاق الثقة. | | **نطاق ثقة المسار** | عند تفعيله لمسار، لا يُتخذ إلا عندما تقع ثقة الذكاء الاصطناعي ضمن النسبة الدنيا والعليا المحددتين. | | **اختبار العقدة** | يشغّل الموجّه بقيم متغيرات نموذجية ويعرض الاستجابة من دون بدء مثيل حقيقي. | ## نصائح وأفضل الممارسات - **اكتب موجّهات نظام واضحة ومحددة.** حدد بدقة ما ينبغي للذكاء الاصطناعي تصنيفه أو استخراجه أو تقريره، واسرد النتائج الممكنة التي تصبح أسماء المسارات. تنتج الموجّهات الغامضة توجيهًا غير موثوق. - **طابق أسماء المسارات مع قيم المخرجات.** إذا طلبت من الذكاء الاصطناعي تصنيف المستند كـ«فاتورة» أو «عقد» أو «أمر شراء»، فأنشئ مسارات بتلك الأسماء نفسها واستخدم حقل مخرجات من نوع التعداد بالقيم الثلاث. - **صِل دائمًا مسار `needs_review`.** إنه شبكة الأمان. اربطه بمهمة مراجعة بشرية كي لا يسقط أي مثيل بصمت. - **استخدم التوجيه بحسب الثقة للقرارات عالية الأهمية.** وجّه القرارات مرتفعة الثقة تلقائيًا وأرسل الأقل إلى إنسان. تقسيم نموذجي: المسار أ من 80% إلى 100%، والمسار ب من 60% إلى 79%، و`needs_review` من 0% إلى 59%. - **اجعل الموجّهات قصيرة ومحددة.** يكون موجّه من ثلاث فقرات عادة أكثر فاعلية من آخر من عشر فقرات. ركز على مهمة القرار لا على معلومات الخلفية. - **استخدم اختبار العقدة قبل النشر.** أدخل قيمًا واقعية وتأكد من أن الذكاء الاصطناعي يعيد المخرجات المنظمة المتوقعة ويختار المسار الصحيح قبل تشغيل مثيلات حية. - **أرفق المهارات لتحقيق الاتساق.** إذا كانت لديك معايير كتابة مؤسسية أو قواعد تصنيف تنطبق على عدة عمليات، فحوّلها إلى مهارة وأرفقها هنا بدلًا من تكرار النص في كل موجّه. - **استخدم إضافة الكل تلقائيًا بحذر.** منح الذكاء الاصطناعي كل متغير مريح، لكن مجموعة مدخلات مركزة تنتج نتائج أوثق. اختر ما يرتبط بالمهمة فقط. ## الأسئلة الشائعة **س: لا أرى عقدة وكيل الذكاء الاصطناعي في الشريط الجانبي. لماذا؟** تتوفر العقدة لجميع المستخدمين في لوحة العُقد. إذا لم تظهر، فحدّث صفحة منشئ التدفق وتأكد من العمل في سير عمل تملك صلاحية تحريره. **س: ما الفرق بين الاستخراج المباشر وخط المعالجة الكامل؟** يقرأ الاستخراج المباشر الطبقة النصية في ملف PDF رقمي فورًا؛ وهو سريع جدًا لكنه يعمل فقط مع ملفات PDF والملفات النصية ذات النص القابل للتحديد. يستخدم خط المعالجة الكامل التعرف على الصور لقراءة المستندات الممسوحة والصور والجداول والتخطيطات المعقدة. استخدمه لأي مستند جرى مسحه أو تصويره. **س: هل يستطيع الذكاء الاصطناعي قراءة مستند من «المستندات» واستخدام قاعدة معرفتنا الداخلية في الوقت نفسه؟** نعم. أضف مستندًا محددًا من مكتبة المستندات كملف إدخال للمستند الذي سيقرأه في هذا المثيل، وفعّل استعلامات قاعدة المعرفة بصورة مستقلة عبر وضع استعلام RAG في قسم ملفات الإدخال. يستطيع الذكاء الاصطناعي الاعتماد على المصدرين في خطوة واحدة. **س: ماذا يحدث إذا أعاد الذكاء الاصطناعي قيمة غير موجودة في قائمة التعداد؟** يتلقى الذكاء الاصطناعي تعليمات بإعادة القيم المحددة فقط. إذا لم يلتزم، يستخدم تطابق المسارات سلوك المراجعة المضبوط. افتح المثيل من **كل المثيلات** واستخدم عرض تفاصيله وسجلاته التشغيلية لتشخيص النتيجة. **س: يعرض الاختبار «وضع الاختبار لا ينفذ RAG». ماذا يعني ذلك؟** لا تعمل استعلامات قاعدة المعرفة التي تبحث في مستنداتك أثناء الاختبار. يعرض الاختبار استجابة الذكاء الاصطناعي بناءً على الموجّه والمتغيرات النموذجية فقط، من دون جلب محتوى المستندات الحقيقي. لا يعمل البحث الكامل في قاعدة المعرفة إلا ضمن مثيل حي. **س: هل يمكن وجود عدة عُقد وكيل ذكاء اصطناعي في سير العمل نفسه؟** نعم. تُضبط كل عقدة بصورة مستقلة بمدخلاتها وموجّهها وتوجيهها. يمكنك ربطها لبناء خط تحليل متعدد الخطوات داخل سير عمل واحد. **س: كيف أعرف المسار الذي اختاره الذكاء الاصطناعي لمثيل حي؟** افتح **كل المثيلات**، وحدد المثيل، ثم افتحه في عرض تفاصيل سير العمل. استخدم الحالة والسجلات التشغيلية المتاحة للتأكد من المسار المنفذ ومعاينة نتيجة خطوة الذكاء الاصطناعي. ## أدلة ذات صلة - [منطق التوجيه: شروط إذا/وإلا والفروع الشرطية](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [عقدة استعلام قاعدة البيانات](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) - [عقدة المستندات](https://raptix.app/user-guide/ar/10-workflows/10-17-documents-node/) - [عقدة البرنامج النصي للمسؤولين](https://raptix.app/user-guide/ar/10-workflows/10-15-python-script-node/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-30-ai-builder/ # منشئ الذكاء الاصطناعي > **الوحدة:** شريط أدوات منشئ التدفقات ← منشئ الذكاء الاصطناعي > > **الجمهور:** مصممو سير العمل > > **ستتعلم:** كيف تبني لوحة سير العمل أو تعدّلها بالمحادثة، مع مراجعة كل تغيير مقترح قبل تطبيقه. ## فتح منشئ الذكاء الاصطناعي افتح سير عمل في وضع التحرير داخل منشئ التدفقات، ثم اختر **منشئ الذكاء الاصطناعي (AI Builder)** من الجانب الأيمن لشريط الأدوات. تحمل اللوحة التسمية **AI Builder — build this workflow by chatting**. يمكنك تغيير عرضها، وسيتذكر المنتج العرض الذي اخترته. إذا تعذر تحميل مساعد البناء المعدّ، فاختر **إعادة المحاولة (Try again)**. تبقى لوحة سير العمل الحالية من دون تغيير. ## بدء عملية بناء صِف سير العمل بلغة المستخدم، وضمّن: - كيف يبدأ؛ - الخطوات بالترتيب؛ - من يستلم المهام أو البريد الإلكتروني؛ - الشروط والنتائج؛ - المستندات أو التقارير المطلوبة؛ - كيف ينتهي سير العمل. في لوحة فارغة، يمكن لمنشئ الذكاء الاصطناعي تقديم اقتراحات بداية مثل: - **شغّله كل صباح (Run it every morning)** - **ابدأ عند وصول بريد إلكتروني (Start when an email arrives)** - **ابدأه يدويًا (Start it manually)** - **شغّله من Webhook (Trigger from a webhook)** عندما تكون هناك عقدة بداية بالفعل، استخدم الإجراء المقترح لإعدادها أو فتحها. ## المراجعة قبل التطبيق لا يستبدل منشئ الذكاء الاصطناعي لوحة سير العمل بصمت. يظهر البناء الذي يغيّر الرسم البياني باسم **تغييرات مقترحة (لم تُطبّق بعد) (Proposed changes — not applied yet)**، ويمكن أن يتضمن: - معاينة للرسم البياني عندما يمكن عرضها بأمانة؛ - قائمة دقيقة بالتغييرات؛ - تحذيرات بشأن إعادة توصيل المسارات أو الأعمال الهدّامة؛ - **تطبيق على اللوحة (Apply to canvas)**؛ - **تجاهل (Discard)**. اقرأ قائمة التغييرات والتحذيرات. لا تختر **تطبيق على اللوحة** إلا عندما يطابق المقترح العملية المقصودة. استخدم **تجاهل** لترك الرسم البياني الحالي من دون تغيير. بعد التطبيق، تعرض اللوحة **التغييرات على اللوحة (Changes on canvas)**. استخدم **التراجع عن هذا البناء (Undo this build)** للعودة إلى نقطة الاستعادة التي أُنشئت مباشرة قبل ذلك البناء. يظل التراجع والإعادة المعتادان وسجل الإصدارات في لوحة سير العمل متاحين أيضًا. ## الإعداد الموجّه يمكن لمنشئ الذكاء الاصطناعي طلب القيم الناقصة بدلًا من تخمينها. أكمل عناصر التحكم الظاهرة للنص أو الملف أو التاريخ والوقت أو الاختيار أو المكلّف أو المستلم أو الإعداد، ثم تابع البناء. يمكنك الرجوع إلى نقطة موجّهة سابقة عندما تعرض اللوحة إجراء رجوع. تغطي تجربة البداية الموجّهة الحالية البداية اليدوية والمجدولة ومُشغّل البريد الإلكتروني. وقد تفتح إعدادات Webhook وتكامل Appsmith إعداد البداية المعتاد الخاص بها بدلًا من إكمالها بالكامل داخل المحادثة. ## تغطية العُقد الحالية يمكن لمنشئ الذكاء الاصطناعي بناء خطوات لوحة سير العمل الحالية أو تعديلها من أجل: - **البريد الإلكتروني (Email)** - **المهمة (Task)** - **وكيل الذكاء الاصطناعي (AI Agent)** - **الإيقاف المؤقت (Pause)** - **دمج الفروع (Merge Branches)** - **برنامج Python النصي (Python Script)** عندما يحق للمستخدم المسجّل دخوله استخدامه - **المستندات (Documents)** - **التقرير (Report)** - **استعلام قاعدة البيانات (DB Query)** عند توفر خطة Enterprise - **لكل عنصر (Foreach)** عند توفر خطة Enterprise - **الحلقة (Loop)** - **مجدول التذكيرات (Reminder Scheduler)** عند توفر خطة Enterprise - **النهاية (End)** يمكنه أيضًا بناء الرسم البياني المحيط وخيارات البداية الحالية. تظل قيود الإتاحة سارية؛ فلا يمنح منشئ الذكاء الاصطناعي صلاحية المشرف أو خطة Enterprise. ## بناء التقارير بالمحادثة عندما تستخدم عقدة **تقرير (Report)** خيار **يكتبه الذكاء الاصطناعي (AI writes it)**، أخبر منشئ الذكاء الاصطناعي بالتقرير المطلوب، وقيم سير العمل التي ينبغي تضمينها، والبنية المرغوبة. يظهر محتوى التقرير المولّد في عقدة التقرير للمراجعة. افتح تلك العقدة قبل التشغيل، وافحص المعاينة أو HTML ونمط اسم الملف وتنسيق الإخراج ووجهة المستند، ثم احفظ. ## بناء نماذج المهام بالمحادثة عندما يحتاج شخص إلى إدخال قيم منظمة أثناء إكمال مهمة، صِف الحقول ونتائج العمل في الطلب نفسه. يمكن لمنشئ الذكاء الاصطناعي اقتراح عقدة مهمة يكون فيها **تصنيف المهمة = نموذج (Task category = Form)**، مع حقول النموذج والإجراءات المسموح بها المخصصة. على سبيل المثال: > أضف مهمة مراجعة عقد للفريق القانوني. اجمع مستوى مخاطر إلزاميًا، وملاحظات مراجعة اختيارية، وعقدًا موقّعًا إلزاميًا. أضف إجراءي الاعتماد وطلب التعديلات. ينبغي أن ينشئ الاعتماد التقرير النهائي، وأن يرسل طلب التعديلات بريدًا إلى مقدم الطلب ثم يعيد المسار إلى المراجعة. يتعامل منشئ الذكاء الاصطناعي مع **الإجراءات المسموح بها (Allowed Actions)** باعتبارها أزرار النموذج، ويوصل كل فرع بواسطة معرّف الإجراء الثابت الخاص به. ولا ينشئ إجراء إرسال منفصلًا من عنده. راجع المقترح وطبقه، ثم افتح **خصائص المهمة (Task Properties)** للتحقق من أسماء الحقول وقواعد الإلزام والمكلّف وكل مسار صادر. ## عمليات البناء في الخلفية والمنقطعة يمكن أن يستمر البناء في الخلفية بينما تكون اللوحة مغلقة. أعد فتح منشئ الذكاء الاصطناعي للاطلاع على حالته. إذا انقطع الاتصال، تبقى لوحة سير العمل الحالية آمنة؛ استخدم **متابعة البناء (Continue build)** عندما يظهر بدلًا من بدء طلب منافس. ## قائمة تحقق للاستخدام الآمن 1. حدّد المُشغّل وشرط النهاية بوضوح. 2. قدّم تسميات العُقد الحقيقية والمكلّفين والنتائج المقصودة. 3. راجع تحذيرات إعادة التوصيل والحذف. 4. طبّق مقترحًا واحدًا متماسكًا في كل مرة. 5. افتح خصائص العُقد الناتجة وتحقق من القيم وبيانات الاعتماد المطلوبة. 6. احفظ سير العمل واختبره ببيانات مضبوطة. 7. راجع التشغيل في **كل المثيلات**، واستخدم **التراجع عن هذا البناء** أو سجل الإصدارات إذا كان التصميم غير صحيح. يساعد منشئ الذكاء الاصطناعي في تأليف سير العمل، لكنه لا يحل محل مسؤولية المصمم عن التحقق من الصلاحيات والمستلمين وبيانات الاعتماد والمتغيرات وقواعد العمل. ## أدلة ذات صلة - [لوحة منشئ التدفقات وشريط الأدوات](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [دليل العُقد الحالية](https://raptix.app/user-guide/ar/10-workflows/10-34-current-node-catalogue/) - [عقدة التقرير](https://raptix.app/user-guide/ar/10-workflows/10-32-report-node/) - [نماذج المهام](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) - [سجل الإصدارات والحفظ التلقائي](https://raptix.app/user-guide/ar/10-workflows/10-19-version-history-autosave/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-15-python-script-node/ # عقدة برنامج Python النصي (للمسؤولين): تشغيل منطق مخصص مع إدخال الملفات وإخراجها > **الوحدة:** عمليات سير العمل  |  **الجمهور:** المسؤول > **ستتعلم:** كيفية إضافة عقدة برنامج نصي إلى سير العمل، وكتابة كود Python يقرأ الملفات وبيانات سير العمل، وتعريف ملفات وقيم المخرجات، وربط النتيجة بالخطوات اللاحقة. ## ما هذه الميزة؟ تتيح **عقدة البرنامج النصي**، التي تظهر أيضًا باسم «عقدة برنامج Python النصي» في المصمم، للمسؤول تضمين خطوة كود مخصصة مباشرة في سير العمل. عندما يصل مثيل سير العمل إلى هذه العقدة، يعمل الكود داخل بيئة معزولة ويستطيع: - **قراءة الملفات** المرفوعة أثناء سير العمل، مثل كشف دوام أو تقرير بصمة رفعه مقدم الطلب. - **قراءة قيم البيانات** التي جمعتها أي خطوة سابقة، مثل قيم حقول النموذج وقرارات المهام ومخرجات وكيل الذكاء الاصطناعي. - **كتابة ملفات مخرجات** تستطيع الخطوات اللاحقة، مثل عقدة البريد الإلكتروني، إرفاقها وإرسالها تلقائيًا. - **إعادة قيم مخرجات مسماة** في قاموس من أزواج المفتاح والقيمة، لتصبح متغيرات سير عمل متاحة لكل عقدة لاحقة. هذه العقدة هي وسيلة تنفيذ أي منطق عمل مخصص لا يمكن التعبير عنه بالعُقد المدمجة وحدها: تحويل البيانات وصيغ الملفات والحسابات والتحقق وفق قواعد خارجية وغير ذلك. ## لماذا تفيدك؟ وما مزاياها الأساسية؟ - **معالجة أي منطق عمل مخصص أو تحويل بيانات أثناء العملية.** إذا لم تستطع العُقد المدمجة التعبير عن قاعدة، تستطيع عقدة البرنامج النصي ذلك، ولا يوجد قيد على ما يمكن للكود حسابه. - **تحويل صيغ الملفات تلقائيًا.** حوّل ملف CSV أو Excel مرفوعًا إلى ملخص PDF، أو استخرج مجموعة من الصفوف؛ يشغّل البرنامج النصي التحويل وينتج الملف ثم يتابع سير العمل. - **التحقق من البيانات وفق قواعد معقدة قبل وصولها إلى الموافقين.** نفّذ فحصًا لا يمكن تمثيله بعقدة شرط بسيطة، ثم وجّه سير العمل بحسب النتيجة. - **إنشاء ملفات ترفقها عُقد البريد اللاحقة وترسلها.** تُحفظ ملفات مخرجات البرنامج النصي في مكتبة المستندات ويمكن الرجوع إليها في عقد البريد، ما يكمل سلسلة أتمتة من البيانات إلى الرسالة. - **إبقاء الأسرار خارج سير العمل.** يعمل البرنامج النصي على الخادم في بيئة مضبوطة. تبقى بيانات الاعتماد ومفاتيح API والمنطق الحساس على الخادم ولا تظهر للمستخدمين النهائيين أو في المتصفح. - **ضبط مهلة تمنع البرامج غير المنتهية.** تضمن المهلة القابلة للضبط من 5 ثوانٍ إلى ساعة ألا يحظر برنامج عالق مثيل سير العمل إلى أجل غير مسمى. > **للمسؤولين فقط.** تُخفى عقدة البرنامج النصي عن المستخدمين غير المسؤولين في الشريط الجانبي للمصمم، ولا تستطيع حساباتهم حفظها. يُطبق التحكم في الوصول على الخادم، وليس في الواجهة فقط. ## قبل أن تبدأ - يجب أن تحمل دور **المسؤول**. يُرفض حفظ عقدة برنامج نصي من حساب غير مسؤول. - ينبغي أن تكون ملمًا ببرمجة Python. يعمل الكود المُدخل في هذه العقدة كما هو ضمن بيئة خادم تحتوي على المكتبات الشائعة. - راجع أدوات منتقي الملفات المستخدمة في عقدة البدء لسير العمل، أي تكامل نموذج التطبيقات، كي تعرف أسماء الأدوات الدقيقة التي تشير إليها في البرنامج النصي. - افتح سير العمل من شاشة **إدارة عمليات سير العمل** واختر **تحرير**. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1: ضع العقدة على اللوحة 1. افتح علامة **منطق** في الشريط الجانبي الأيسر للمصمم المرئي. > **ملاحظة:** لا تظهر عقدة البرنامج النصي في الشريط الجانبي إلا للمسؤولين. إذا لم ترها، فتحقق من دورك. 2. اسحب **عقدة برنامج Python النصي** إلى اللوحة بعد الخطوة التي تجمع الملفات أو البيانات التي يحتاجها البرنامج. 3. صِل مقبض إخراج العقدة السابقة بمدخل عقدة البرنامج النصي. 4. انقر على العقدة نقرًا مزدوجًا، أو اختر رمز الترس عند المرور، لفتح مربع إعداد **عقدة برنامج Python النصي**. ### الخطوة 2: اضبط التسمية والوصف والمهلة 5. أدخل في حقل **عنوان العقدة** اسمًا يصف وظيفة البرنامج النصي، مثل «معالج كشف الدوام» أو «مدقق الفاتورة». يظهر الاسم على اللوحة. 6. أدخل في حقل **الوصف** ملاحظة موجزة واختيارية تشرح غرض البرنامج. 7. اضبط في حقل **المهلة (بالثواني)** أقصى مدة يُسمح للبرنامج بالعمل خلالها قبل إيقافه قسرًا. النطاق من **5 إلى 3600 ثانية**، أي حتى ساعة، والقيمة الافتراضية 300 ثانية، أي خمس دقائق. > اضبط مهلة مناسبة لوقت التشغيل المتوقع. تعني المهلة الطويلة جدًا أن برنامجًا عالقًا سيحظر المثيل طوال تلك المدة قبل ظهور الفشل. ### الخطوة 3: اكتب الكود (علامة الكود) 8. اختر علامة **الكود**، وهي المحددة افتراضيًا. 9. اكتب كود Python في المحرر. توفر البيئة ثلاثة كائنات مدمجة يمكنك استخدامها مباشرة: | الكائن | كيفية استخدامه | |---|---| | `input_files["widgetName"][0]` | الملف المرفوع عبر أداة منتقي الملفات المسماة `widgetName`. يعيد كائنًا شبيهًا بالملف. | | `output_files["outputKey"]` | مسار ملف قابل للكتابة لملف المخرجات المسجل بالمفتاح `outputKey`. اكتب إلى هذا المسار لإنتاج الملف. | | `workflow_data.get("key", default)` | قيمة متغير سير العمل المسمى `key`. قدم قيمة افتراضية لحالة غياب المفتاح. | مثال بسيط: ```python import openpyxl # Read the uploaded Excel file wb = openpyxl.load_workbook(input_files["uploadBiometricFile"][0]) ws = wb.active # Count non-empty rows (excluding header) row_count = sum(1 for row in ws.iter_rows(min_row=2) if any(c.value for c in row)) # Save the processed workbook as the output wb.save(output_files["timesheet"]) # Return values to use in downstream nodes return {"rows_processed": row_count} ``` > تكشف عبارة `return` في نهاية البرنامج قاموسًا من أزواج المفتاح والقيمة كمتغيرات لسير العمل. فمثلًا تجعل `return {"rows_processed": 42}` المتغير `{{rows_processed}}` متاحًا لكل عقدة لاحقة. ### الخطوة 4: اضبط ملفات الإدخال (علامة ملفات الإدخال) 10. اختر علامة **ملفات الإدخال**. **أدوات منتقي الملفات:** 11. يعرض القسم العلوي جميع أدوات منتقي الملفات المكتشفة في عقدة البدء، إذا ضُبط تكامل نموذج التطبيقات. تظهر كل أداة كزر قابل للتحديد. 12. اختر زر كل أداة ينبغي أن يتلقى البرنامج ملفها المرفوع. تتحول الأدوات المحددة إلى اللون السماوي وتظهر عليها علامة اختيار. استخدم في الكود `input_files["widgetName"][0]` للوصول إلى الملف. 13. إذا لم تظهر الأداة المطلوبة في القائمة، فاختر **إضافة يدويًا** واكتب اسمها مطابقًا تمامًا لما يظهر في النموذج. **متغيرات بيانات سير العمل:** 14. يعرض القسم السفلي، **متغيرات بيانات سير العمل**، جميع أدوات النص والإدخال التي تتوفر قيمها عبر `workflow_data.get("key")`. هذا قسم مرجعي للقراءة فقط، ويعرض أسماء المفاتيح الدقيقة التي تستخدمها في البرنامج النصي؛ ولا تحتاج إلى اتخاذ إجراء فيه. ### الخطوة 5: عرّف ملفات المخرجات (علامة ملفات المخرجات) 15. اختر علامة **ملفات المخرجات**. 16. اختر **إضافة ملف مخرجات** لكل ملف سيكتبه البرنامج. 17. اضبط لكل ملف مخرجات: - **المفتاح (المستخدم في الكود)** — المفتاح المستخدم في `output_files["yourKey"]` داخل البرنامج، مثل `timesheet`. اجعله قصيرًا وبأحرف صغيرة ومن دون مسافات. - **تسمية العرض** — اسم واضح للملف، مثل «مخرجات كشف الدوام». يُستخدم عند تحديد المخرج في خطوات سير العمل اللاحقة. - مفتاح **الحفظ في المستندات** — عند تفعيله، وهو الافتراضي، يُحفظ الملف الذي ينتجه البرنامج تلقائيًا في مكتبة المستندات ويمكن إرفاقه بعقدة بريد لاحقة. عطّله إذا لم تحتج إلى حفظ الملف. 18. اختر رمز سلة المهملات الأحمر لإزالة إدخال ملف مخرجات. ### الخطوة 6: احفظ وصِل العقدة 19. اختر **حفظ** في تذييل مربع الحوار. يُغلق المربع. 20. ارسم في المصمم حوافًا من مقبض إخراج عقدة البرنامج النصي إلى الخطوة التالية. 21. اختر **حفظ** أو اضغط **Ctrl+S**. ## شرح الخيارات والإعدادات ### حقول الرأس | الحقل | ما الذي يفعله؟ | |---|---| | **عنوان العقدة** | التسمية الظاهرة على اللوحة وفي سياق تنفيذ سير العمل. | | **الوصف** | ملاحظة نصية حرة واختيارية تُحفظ مع العقدة ولا تظهر للمستخدم النهائي. | | **المهلة (بالثواني)** | أقصى ثوانٍ يمكن للبرنامج العمل خلالها. النطاق 5–3600، والافتراضي 300. عند تجاوزها يُنهى البرنامج ويُعلّم المثيل كفاشل عند هذه الخطوة. | ### علامة الكود | العنصر | ما الذي يفعله؟ | |---|---| | محرر الكود | مساحة نصية كاملة بخط ثابت العرض، تقبل أي كود Python 3.11+ صحيح. | | `input_files["name"][0]` | يقرأ الملف المرفوع عبر أداة النموذج المسماة `name`. يصل `[0]` إلى أول ملف مرفوع، وقد يوفر الرفع المتعدد ملفات إضافية. | | `output_files["key"]` | مسار ملف قابل للكتابة. اكتب ملف المخرجات إليه، وتخزنه المنصة تلقائيًا. | | `workflow_data.get("key", default)` | يقرأ متغير سير عمل بالاسم ويعيد `default` إذا لم يوجد المفتاح. | | `return {...}` | يعيد قاموس Python. يصبح كل زوج مفتاح وقيمة متغير سير عمل متاحًا للعُقد اللاحقة عبر `{{key}}`. | ### علامة ملفات الإدخال | العنصر | ما الذي يفعله؟ | |---|---| | أزرار أداة منتقي الملفات | تحدد الملفات المرفوعة التي يستطيع البرنامج الوصول إليها. تُبرز الأدوات المحددة. | | **إضافة يدويًا** | تتيح إدخال اسم أداة لم تُكتشف تلقائيًا. أدخل الاسم الدقيق الظاهر في النموذج. | | قسم متغيرات بيانات سير العمل | مرجع للقراءة فقط يعرض تعبيرات `workflow_data.get("key")` لكل أداة نص أو إدخال. | ### علامة ملفات المخرجات | الحقل | ما الذي يفعله؟ | |---|---| | **المفتاح (المستخدم في الكود)** | المفتاح المستخدم في `output_files["key"]` داخل البرنامج، ويجب أن يكون فريدًا ضمن العقدة. | | **تسمية العرض** | الاسم الواضح المستخدم لملف المخرجات في منتقيات العُقد اللاحقة. | | مفتاح **الحفظ في المستندات** | مفعّل افتراضيًا: يُخزن الملف تلقائيًا في المكتبة. عند تعطيله، لا يبقى الملف إلا أثناء خطوة سير العمل الحالية ولا يُحفظ. | ## نصائح وأفضل الممارسات - **اجعل البرامج النصية مركزة وقصيرة.** يسهل الحفاظ على برنامج يؤدي مهمة واحدة وتصحيح أخطائه أكثر من برنامج يفعل كل شيء. اربط عدة عُقد برامج نصية للتحويلات المعقدة متعددة الخطوات. - **قدم دائمًا قيمًا افتراضية في `workflow_data.get()`**، مثل `workflow_data.get("amount", 0)`، لمنع أخطاء `KeyError` إذا تُرك حقل اختياري فارغًا. - **استخدم مفاتيح وصفية في قاموس `return`.** تصبح المفاتيح أسماء متغيرات سير العمل. تسهل الإشارة إلى أسماء واضحة مثل `invoice_total` أو `approval_status` في الشروط والموجّهات اللاحقة أكثر من `result` أو `val1`. - **اختبر الحالات الحدّية.** شغّل سير العمل يدويًا بملف فارغ أو قيمة صفرية أو حقل اختياري مفقود. تؤدي أخطاء البرنامج إلى تعليم المثيل كفاشل وإيقافه عند هذه العقدة. - **امنح البرامج التي تعالج ملفات مهلة كافية** من دون مبالغة. تكفي خمس دقائق لمعظم التحويلات؛ ولا تخصص ساعة إلا للمعالجة الثقيلة فعلًا. - **فعّل «الحفظ في المستندات»** لملفات المخرجات إذا احتاجت خطوة لاحقة، مثل عقدة البريد، إلى إرفاق الملف. يجب حفظه في مكتبة المستندات حتى يمكن إرفاقه. - **طابق أسماء مفاتيح المخرجات مع عقدة البريد.** إذا سميت المخرج `invoice_pdf`، فستجده بهذا الاسم ضمن خيارات مرفقات البريد. - **وثّق وظيفة البرنامج النصي** في وصف العقدة وتعليقات الكود. يفيد ذلك في الصيانة؛ فقد لا يعرف المسؤول التالي الذي يحرر سير العمل الغرض الأصلي. ## الأسئلة الشائعة **س: لا أرى عقدة البرنامج النصي في الشريط الجانبي. ما الخطأ؟** تُخفى عن المستخدمين غير المسؤولين. وحدها الحسابات التي تحمل دور المسؤول تستطيع رؤية عُقد البرامج النصية أو إضافتها أو حفظها. تحقق من دورك في شريط التنقل العلوي. **س: هل يمكنني استيراد مكتبات Python خارجية؟** يعمل البرنامج في بيئة خادم مضبوطة مسبقًا. تتوفر عادة وحدات المكتبة القياسية ومكتبات معالجة البيانات الشائعة مثل `openpyxl` و`pandas` وما شابه. تواصل مع مسؤول النظام للحصول على القائمة الكاملة أو لطلب حزم إضافية. **س: ماذا يحدث إذا أثار البرنامج النصي استثناءً؟** يُعلّم مثيل سير العمل كفاشل عند عقدة البرنامج النصي. افتح المثيل من **كل المثيلات** وراجع عرض تفاصيل سير العمل والسجلات التشغيلية. أصلح البرنامج واحفظ التصميم ثم ابدأ تشغيلًا مضبوطًا جديدًا. **س: هل يستطيع البرنامج النصي إرسال طلبات HTTP إلى أنظمة خارجية؟** يعتمد ذلك على إعداد شبكة الخادم. يمكن أن يتضمن الكود طلبات HTTP، لكن السماح بالاتصالات الصادرة إعداد على مستوى النظام. تحقق من مسؤول البنية التحتية. **س: هل يمكنني استخدام قيمة `return` من عقدة برنامج نصي في شرط إذا/وإلا لاحق؟** نعم. يصبح كل مفتاح في القاموس المُعاد متغيرًا. إذا أعاد البرنامج `{"status": "approved"}`، فيمكنك الإشارة إلى `{{status}}` في شرط إذا/وإلا لاحق. **س: كيف أرفق ملفًا أنشأه البرنامج النصي برسالة بريد؟** فعّل **الحفظ في المستندات** لملف المخرجات في علامة ملفات المخرجات. ثم اختر في إعدادات مرفقات عقدة البريد اللاحقة «ملفات مخرجات محددة»، وحدد الملف بتسمية عرضه. **س: هل يمكن وجود عدة عُقد برنامج نصي في سير العمل نفسه؟** نعم. تُضبط كل عقدة بصورة مستقلة، وتصبح المتغيرات المعادة من إحداها متاحة لكل العُقد اللاحقة، بما فيها عُقد البرامج النصية الأخرى. ## أدلة ذات صلة - [عقدة وكيل الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/) - [عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [عقدة استعلام قاعدة البيانات](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [منطق التوجيه: شروط إذا/وإلا والفروع الشرطية](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [صلاحيات عمليات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-29-workflow-permissions/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/ # عقدة استعلام قاعدة البيانات: قراءة بيانات أنظمتك المباشرة أثناء العملية > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون النهائيون للاستخدام الأساسي، والمشرفون للمُشغّلات التفاعلية > > **ستتعلم:** كيف تضيف عقدة استعلام قاعدة بيانات إلى سير عمل، وتكتب استعلامًا لاسترداد بيانات مباشرة من قواعدك المتصلة، وتحفظ النتائج كمتغير سير عمل، وتعدّ اختياريًا مُشغّلات تفاعلية ليستجيب سير العمل تلقائيًا عند تغير بيانات المصدر. ## ما هي؟ تتيح عقدة **استعلام قاعدة البيانات (DB Query)** لسير العمل التوقف عند خطوة محددة، واسترداد سجلات مباشرة من قاعدة بيانات متصلة، وإتاحة تلك السجلات كمتغير لكل الخطوات اللاحقة. فبدلًا من الاقتصار على البيانات التي كتبها مقدم الطلب في نموذج، يستطيع سير العمل البحث عن معلومات حالية، مثل حالة عقد راهنة أو ميزانية مقدم الطلب المتاحة أو أوامر شراء مفتوحة أو سجلات موظفين، واستخدامها لتوجيه القرارات أو ملء إشعارات البريد أو تغذية خطوة تحليل بالذكاء الاصطناعي. تدعم العقدة مصدرين للبيانات: **قاعدة بيانات التطبيقات (App Database)** التي تستخدمها التطبيقات الداخلية منخفضة البرمجة المنشأة في التطبيقات، و**قاعدة بيانات سير العمل (Workflow DB)** التشغيلية الخاصة بمحرك سير العمل. بعد تنفيذ الاستعلام، تُحفظ نتائجه في متغير مسمى تختاره، مثل `{{db_rows}}`، وتستطيع كل عقدة لاحقة قراءة البيانات. في السيناريوهات المتقدمة، تثبّت ميزة **المُشغّلات التفاعلية (Reactive Triggers)** الاختيارية مستمعًا للتغييرات في جدول المصدر. وعند إدراج صف في ذلك الجدول أو تحديثه أو حذفه، يُخطر المستمع محرك سير العمل فورًا لتستجيب العُقد اللاحقة من دون انتظار دورة استقصاء. ## أهميتها وفوائدها الرئيسية - **قرارات مبنية على بيانات حقيقية، لا على مدخلات النموذج وحدها.** قبل توجيه اعتماد، يستطيع سير العمل التحقق من الميزانية المتبقية لمقدم الطلب، أو إدراج المورد ضمن القائمة المعتمدة، أو استمرار صلاحية العقد، باستخدام سجلات مباشرة لا لقطات قديمة. - **إلغاء عمليات البحث اليدوية.** تصبح العمليات التي كانت تتطلب من المعتمد فتح نظام آخر والبحث عن سجل ثم العودة للاعتماد مؤتمتة بالكامل؛ إذ يحدث البحث داخل سير العمل. - **توجيه ديناميكي مدعوم بالبيانات المباشرة.** اجمع بين عقدة استعلام قاعدة البيانات وعقدة شرط للتفرع تلقائيًا: إذا أظهر السجل `status = approved` يُسلك مسار، وإذا أظهر `status = pending review` يُسلك آخر، من دون تدخل بشري. - **تغذية تحليل الذكاء الاصطناعي اللاحق.** يمكن تمرير مجموعة نتائج عقدة استعلام قاعدة البيانات مباشرة إلى عقدة وكيل ذكاء اصطناعي، ليحلل السجلات ويعيد قرارًا منظمًا. - **استجابة فورية لتغير البيانات باستخدام المُشغّلات التفاعلية.** يعني هذا الخيار أن سير العمل يستطيع بدء الاستجابة لحظة تغير صف في نظام المصدر؛ مثل اعتماد يبدأ عند `INSERT` في قاعدة البيانات، أو مهام تُلغى عند `DELETE`، من دون تأخير الاستقصاء المجدول. - **إخراج مسمى لتسهيل المراجع اللاحقة.** تختار اسم المتغير، مثل `db_rows` أو `active_contracts`، فتستخدم العُقد اللاحقة وسمًا مقروءًا وذا معنى مثل `{{active_contracts}}` بدلًا من معرّف غامض. ## قبل أن تبدأ - تتاح عقدة استعلام قاعدة البيانات لمصممي سير العمل. ويتطلب إعداد ميزة **المُشغّلات التفاعلية** في علامة **المُشغّلات** صلاحية المشرف، لأنها تثبّت مستمعًا على مستوى قاعدة البيانات في جدول المصدر. - يجب أن تعرف قاعدة البيانات المراد الاستعلام منها، سواء قاعدة بيانات التطبيقات أو قاعدة بيانات سير العمل، وأن تكون لديك معرفة أساسية باستعلامات SQL من نوع SELECT. - الحد الافتراضي في **الحد الأقصى للصفوف (Max Rows)** هو 1000، ويمكن رفعه إلى 10,000. قد تؤثر النتائج الكبيرة جدًا في الأداء؛ لذلك صمّم الاستعلامات بشروط WHERE وقيم LIMIT مناسبة. - الصلاحية المطلوبة: **إدارة مسارات سير العمل (Manage Workflows)**. **مكان العثور عليها:** في لوحة **العناصر (Elements)** داخل المصمم المرئي، انتقل إلى علامة **المنطق (LOGIC)**، واسحب عقدة **استعلام قاعدة البيانات** إلى اللوحة. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — وضع العقدة 1. افتح سير عمل في المصمم المرئي. 2. انقر علامة **المنطق** في لوحة العناصر إلى اليسار. 3. اسحب عقدة **استعلام قاعدة البيانات** إلى موضع تنفيذ البحث في اللوحة. ضعها قبل أي عقدة ستستخدم البيانات المستردة. 4. صِلها بالعقدة السابقة وبالعقدة التي ينبغي أن تستلم نتائج الاستعلام. 5. انقر عقدة استعلام قاعدة البيانات نقرًا مزدوجًا لفتح مربع إعداد **عقدة استعلام قاعدة البيانات**. ### الخطوة 2 — إعداد الاستعلام في علامة الاستعلام تظهر علامة **الاستعلام (Query)** أولًا. 6. **الاسم (Name)**، اختياري: أدخل اسم عرض قصيرًا للعقدة، مثل «تحميل العقود النشطة» أو «التحقق من رصيد الميزانية». يظهر الاسم في تسمية العقدة على اللوحة وفي سجل الإصدارات. 7. **الوصف (Description)**، اختياري: صِف بإيجاز ما يسترده الاستعلام، مثل «يعيد كل أوامر الشراء المفتوحة لقسم مقدم الطلب». يساعد ذلك الزملاء في صيانة سير العمل. 8. **مصدر البيانات (Datasource):** اختر قاعدة البيانات المطلوب الاستعلام منها. - **قاعدة بيانات التطبيقات (Applications Database)** — قاعدة التطبيقات التي تستخدمها التطبيقات الداخلية المنشأة في التطبيقات؛ وهذه هي التسمية في القائمة الظاهرة. استخدمها للبحث في بيانات التطبيقات. - **قاعدة بيانات سير العمل (Workflow DB)** — البيانات التشغيلية الخاصة بمحرك سير العمل، مثل المثيلات والمهام والإجراءات. استخدمها في سيناريوهات فحص سير العمل نفسه. > لا تتاح المُشغّلات التفاعلية، الموضحة في الخطوة 3، إلا لمصدر **قاعدة بيانات التطبيقات**. 9. **استعلام SQL:** اكتب عبارة SELECT في منطقة الشفرة. يقبل الحقل SQL القياسية. أمثلة: - `SELECT * FROM public.purchase_orders WHERE status = 'pending' LIMIT 100` - `SELECT budget_remaining FROM public.budgets WHERE department = '{{form_department}}'` - `SELECT id, vendor_name, status FROM public.vendors WHERE approved = true ORDER BY vendor_name` > **استخدام متغيرات سير العمل في الاستعلامات:** يمكنك تضمين علامات دمج من العُقد السابقة مباشرة في SQL، مثل `WHERE employee_id = '{{form_employee_id}}'`. تستبدل المنصة القيمة عند التشغيل قبل تنفيذ الاستعلام. هذه قدرة قوية، لكن استخدمها بحذر مع مدخلات موثوقة جرى التحقق منها فقط. 10. **اسم متغير الإخراج (Output Variable Name):** أدخل الاسم الذي ستستخدمه للإشارة إلى النتائج في العُقد اللاحقة. القيمة الافتراضية `db_rows`. اختر اسمًا يوضح البيانات، مثل `active_contracts` أو `budget_info` أو `pending_orders`. - يعرض نص المساعدة أسفل الحقل علامة الدمج الدقيقة التي ستُنشأ، مثل `{{db_rows}}` أو `{{active_contracts}}`. 11. **الحد الأقصى للصفوف (Max Rows):** حدد أكبر عدد من الصفوف المعادة. القيمة الافتراضية 1000 والحد الأقصى 10000. اضبط قيمة أقل إذا كنت تعرف أن مجموعة النتائج صغيرة لتحسين الأداء. واستخدم `LIMIT` في SQL أيضًا لتوفير تحكم مزدوج. ### الخطوة 3 — إعداد المُشغّلات التفاعلية اختياريًا للمشرف > هذه الخطوة اختيارية وتتطلب صلاحية المشرف. 12. انقر علامة **المُشغّلات (Triggers)**. 13. إذا اخترت **قاعدة بيانات سير العمل** مصدرًا، يظهر تنبيه بأن المُشغّلات متاحة لقاعدة بيانات التطبيقات فقط. ارجع إلى علامة الاستعلام واختر **قاعدة بيانات التطبيقات** إذا كنت تحتاج إليها. 14. حدّد مربع **تمكين المُشغّلات التفاعلية (Enable Reactive Triggers)** لتفعيل الاستماع إلى تغييرات جدول المصدر. عند التمكين، يثبّت محرك سير العمل مستمعًا يطلق المعالجة اللاحقة تلقائيًا عند وقوع الأحداث المحددة. 15. تحت **التشغيل عند (Trigger on)**، حدد أنواع الأحداث المطلوبة: - **INSERT** — «تشغيل الخطوات اللاحقة عند إضافة صف جديد». استخدمه لبدء سير عمل أو تقديمه عند إنشاء سجل جديد في نظام المصدر. - **UPDATE** — «إعادة تشغيل الخطوات اللاحقة عند تغير صف». استخدمه لإعادة تقييم التوجيه عند تعديل سجل قائم. - **DELETE** — «إلغاء المهام اللاحقة للصفوف المحذوفة». استخدمه لتنظيف مهام سير العمل عند حذف سجل المصدر. 16. **عمود المفتاح (Key Column):** أدخل اسم العمود الذي يعرّف كل صف تعريفًا فريدًا، ويكون عادة `id`. يستخدمه المستمع لمطابقة الأحداث الواردة مع مثيل سير العمل الصحيح. - يُكتشف حقل **الجدول (Table)** أدناه تلقائيًا من عبارة FROM في استعلام SQL ويظهر للتأكيد. ### الخطوة 4 — الحفظ والاختبار 17. انقر **حفظ (Save)** في تذييل مربع الحوار. يُغلق المربع وتعرض العقدة على اللوحة الاسم الذي اخترته ورمز قاعدة بيانات. 18. احفظ سير العمل كاملًا باستخدام **Ctrl+S** أو زر **حفظ** في شريط الأدوات. 19. للتحقق من عمل العقدة، شغّل مثيلًا تجريبيًا؛ راجع [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/)، وافحص عرض تفاصيل سير العمل للتأكد من أن متغير `{{db_rows}}` يحتوي الصفوف المتوقعة. ## شرح الخيارات والإعدادات ### علامة الاستعلام | الحقل | الوصف | |---|---| | **الاسم** | تسمية عرض اختيارية للعقدة في اللوحة وسجل الإصدارات. | | **الوصف** | ملاحظة نصية اختيارية تصف ما يسترده الاستعلام. | | **مصدر البيانات** | يحدد قاعدة البيانات: **قاعدة بيانات التطبيقات**، وهي قاعدة التطبيقات والتسمية الظاهرة، أو **قاعدة بيانات سير العمل**، وهي بيانات المحرك. | | **استعلام SQL** | عبارة SELECT المطلوب تنفيذها. تدعم SQL القياسية ويمكن تضمين علامات الدمج من العُقد السابقة. يظهر افتراضيًا العنصر النائب `SELECT * FROM public.your_table LIMIT 100`. | | **اسم متغير الإخراج** | اسم المتغير الذي تُحفظ تحته صفوف النتائج. يُستخدم بصيغة `{{}}` في العُقد اللاحقة. القيمة الافتراضية `db_rows`. | | **الحد الأقصى للصفوف** | حد قطعي لعدد الصفوف المعادة، من 1 إلى 10,000. القيمة الافتراضية 1,000. | ### علامة المُشغّلات لقاعدة بيانات التطبيقات فقط | الحقل | الوصف | |---|---| | مربع **تمكين المُشغّلات التفاعلية** | يفعّل مستمع تغير قاعدة البيانات لجدول المصدر. تظهر خيارات إضافية عند تحديده. | | مربع **INSERT** | يطلق المعالجة اللاحقة عند إدراج صف جديد في جدول المصدر. | | مربع **UPDATE** | يطلق المعالجة اللاحقة عند تحديث صف قائم. | | مربع **DELETE** | يطلق المعالجة اللاحقة، وغالبًا الإلغاء، عند حذف صف. | | **عمود المفتاح** | العمود الذي يعرّف كل صف تعريفًا فريدًا، وغالبًا `id`. يُستخدم لربط الأحداث بمثيلات سير العمل. | | **الجدول (يُكتشف تلقائيًا)** | اسم الجدول المستخرج من عبارة FROM في استعلام SQL، ويظهر للتأكيد. | | شارة **ON** في علامة المُشغّلات | يظهر مؤشر `ON` أزرق صغير في علامة المُشغّلات عند تمكينها. | ### بنية متغير الإخراج متغير الإخراج مصفوفة من كائنات الصفوف. يحتوي كل كائن على مفتاح لكل عمود يعيده استعلام SQL. مثلًا، إذا اختار الاستعلام `id` و`vendor_name` و`status`، يحتوي المتغير `{{active_vendors}}` على: ``` [ { "id": 1, "vendor_name": "Acme Corp", "status": "approved" }, { "id": 2, "vendor_name": "Beta Ltd", "status": "pending" } ] ``` يمكن للعُقد اللاحقة، مثل الشرط ووكيل الذكاء الاصطناعي ونص البريد، استخدام المصفوفة كاملة، أو استخدام الحقول الفردية بترميز النقطة عندما تدعم المنصة ذلك. ## نصائح وأفضل الممارسات - **اجعل استعلامات SQL محددة.** اختر الأعمدة التي تحتاج إليها فقط، وتجنب `SELECT *` في مسارات الإنتاج. الاستعلامات المحددة أسرع والمتغير الناتج أسهل استخدامًا لاحقًا. - **أضف عبارة LIMIT في SQL نفسها** إلى جانب ضبط الحد الأقصى للصفوف. يمنع الحدان المستقلان مجموعات النتائج الكبيرة بطريق الخطأ. - **استخدم شروط WHERE مع متغيرات سير العمل لتصفية السجل الصحيح.** بدلًا من إعادة 10,000 صف ثم تصفيتها في عقدة شرط، اكتب `WHERE employee_id = '{{form_employee_id}}'` وأعد السجل ذي الصلة وحده. - **سمِّ متغير الإخراج حسب محتواه.** تكون `{{active_contracts}}` أسهل قراءة في نصوص البريد والشروط اللاحقة من `{{db_rows}}` الافتراضية. - **ضع عقدة استعلام قاعدة البيانات قبل أي عقدة تحتاج إلى بياناتها.** لا تتاح في مرحلة سابقة المتغيرات الناتجة من عُقد تعمل لاحقًا في الرسم البياني. - **لا تمكّن المُشغّلات التفاعلية إلا عند الحاجة الحقيقية إلى استجابة فورية.** يثبّت كل مُشغّل مستمعًا في جدول المصدر. أبقِها متوقفة لمسارات سير العمل التي تحتمل الجدولة أو البدء اليدوي. - **اختبر أولًا باستعلام LIMIT 1.** تحقق من صياغة الاستعلام وبنية متغير الإخراج قبل توسيع مجموعة النتائج. - **ادمجها مع عقدة وكيل ذكاء اصطناعي.** مرر نتيجة استعلام قاعدة البيانات إلى وكيل للحصول على تحليل ذكي، مثل «لخّص أوامر الشراء هذه وحدد أيها يتجاوز السياسة». ## الأسئلة الشائعة **س: هل يمكنني تحديث السجلات أو حذفها بعقدة استعلام قاعدة البيانات؟** لا. تنفذ العقدة استعلامات SELECT للقراءة فقط. لتعديل البيانات، استخدم تكاملًا مخصصًا أو عقدة Webhook لاستدعاء API خارجية تنفذ الكتابة. **س: ماذا يحدث إذا لم يُعد الاستعلام أي صفوف؟** يُضبط متغير الإخراج على مصفوفة فارغة `[]`. يجب أن تتعامل عُقد الشرط اللاحقة مع هذه الحالة، كالتفرع إلى مسار «لم يُعثر على بيانات» عندما تكون المصفوفة فارغة باستخدام عامل «فارغ» على المتغير. **س: هل يمكنني استخدام علامة دمج داخل عبارة SQL WHERE؟** نعم. مثلًا: `SELECT * FROM budgets WHERE department = '{{form_department}}'`. تستبدل المنصة قيمة المتغير قبل تنفيذ الاستعلام. تحقق دائمًا من مدخلات النموذج ونقّحها في مرحلة سابقة لمنع سلوك استعلام غير متوقع. **س: كم صفًا يمكنني استرداده؟** الحد الأقصى 10,000 صف. اضبط الحد الأقصى للصفوف في علامة الاستعلام، وأضف عبارة LIMIT في SQL للحماية المزدوجة. يُفضل التعامل مع النتائج الكبيرة بشروط WHERE أدق بدلًا من زيادة الحد. **س: ما الذي تفعله المُشغّلات التفاعلية بالضبط؟** عند تمكينها، تثبّت المنصة آلية إشعار خفيفة في جدول قاعدة بيانات المصدر. كلما وقع INSERT أو UPDATE أو DELETE مطابق، تُخطر المنصة فورًا، ويمكنها إعادة تشغيل خطوات سير العمل المعنية أو تقديمها من دون استقصاء مجدول. وبذلك يستجيب سير العمل خلال ثوان بدلًا من دقائق لتغير بيانات المصدر. **س: هل يمكنني إضافة أكثر من عقدة استعلام قاعدة بيانات إلى سير العمل نفسه؟** نعم. تنفذ كل عقدة استعلامًا مستقلًا على مصدرها وتحفظ النتائج في متغير إخراج مستقل. استخدم أسماء مميزة لتتمكن العُقد اللاحقة من الإشارة إلى مجموعة البيانات الصحيحة. **س: يعمل الاستعلام لكن متغير الإخراج فارغ. ما الذي أراجعه؟** تحقق من: 1) كتابة أسماء الجدول والأعمدة بصورة صحيحة ومطابقتها مخطط قاعدة البيانات بدقة؛ إذ تراعي PostgreSQL حالة الأحرف. 2) عدم استبعاد شرط WHERE كل الصفوف بطريق الخطأ؛ جرّب إزالته مؤقتًا لترى إن كانت الصفوف تعود. 3) صحة مصدر البيانات، قاعدة التطبيقات أو قاعدة سير العمل. 4) عدم ضبط الحد الأقصى للصفوف على صفر. ## أدلة ذات صلة - [استخدام متغيرات سير العمل وعلامات الدمج في البريد والشروط](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [منطق التوجيه: شروط If/Else والفروع الشرطية ومنشئ التعبيرات](https://raptix.app/user-guide/ar/10-workflows/10-11-routing-conditions/) - [عقدة وكيل الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/) - [قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-17-documents-node/ # عقدة المستندات: جلب المستندات وحفظها ضمن سير العمل > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون النهائيون ومصممو سير العمل > > **ستتعلم:** كيف تضيف عقدة مستندات إلى سير عمل، وتعدّها لجلب ملف محدد أو مجلد كامل من مكتبة المستندات، أو لحفظ ملف أنشأته خطوة سابقة في المكتبة بالموقع الذي تختاره. ## ما هي؟ تربط عقدة **المستندات (Documents)** مسارات سير العمل المؤتمتة بمكتبة مستندات مؤسستك. تستطيع تنفيذ عمليتين: **جلب** مستند أو مجلد مستندات كامل من المكتبة وإتاحته للخطوات التالية، أو **حفظ** ملف أنتجته خطوة سابقة، مثل تقرير مكتمل أو PDF موقّع، في المستندات بالمسار الذي تحدده. في وضع الجلب، يمكنك اختيار ملف مسمى واحد من متصفح مرئي، أو اختيار مجلد كامل لاسترداد كل ملفاته معًا، مع ضغطها اختياريًا في أرشيف ZIP. وفي وضع الحفظ، تحدد الموقع الذي سيصل إليه الملف في المستندات، سواء مسار مجلد ثابتًا أو مسارًا يحدده متغير سير عمل عند التشغيل، كما تستطيع منحه اسم ملف مخصصًا. يجعل ذلك التعامل مع المستندات مؤتمتًا بالكامل: تُؤرشف العقود لحظة اعتمادها، وتُحفظ التقارير في مجلد المشروع الصحيح فور إنشائها، وتُسترد المرفقات الداعمة وتُرسل مع رسائل الاعتماد؛ وكل ذلك من دون نقل يدوي للملفات. ## أهميتها وفوائدها الرئيسية - **انتقال المستندات تلقائيًا خلال العملية.** لا يحتاج أحد إلى تنزيل ملف وإرفاقه برسالة ثم رفعه إلى مكان آخر؛ فالعقدة تتولى النقل داخل سير العمل. - **استرداد الملف أو المجلد الصحيح بدقة.** يعرض متصفح الملفات المضمّن مكتبتك كاملة، منظمة بحسب الكيان والمثيل والمجلد. اختر الملف بنقرة من دون معرفة تفاصيل المسار أو كتابتها. - **أرشفة المخرجات تلقائيًا في مواضعها.** يمكن توجيه التقارير المولّدة والعقود الموقّعة والنماذج المكتملة إلى مجلد المستندات الصحيح فور انتهاء الخطوة، لتظل المكتبة منظمة من دون عمل يدوي. - **الدمج مع عُقد أخرى لأتمتة المستند من البداية إلى النهاية.** اجلب قالبًا بعقدة المستندات، ومرره إلى وكيل ذكاء اصطناعي لاستخراج البيانات، ثم احفظ النتيجة المحسنة في المستندات؛ وكل ذلك ضمن سير عمل واحد. - **ضغط ZIP للتنزيلات المجمعة.** عند جلب مجلد، فعّل الضغط للحصول على كل الملفات في أرشيف ZIP واحد، وهو مفيد للأرشفة أو إرسال مجموعة كاملة بالبريد. - **استخدام مسارات حفظ ديناميكية.** عندما يُحدد مجلد الوجهة عند التشغيل، بحسب العقد أو المشروع مثلًا، مرر المسار كمتغير وستحلّه العقدة تلقائيًا. وتُنشأ المجلدات المستهدفة إذا لم تكن موجودة. - **العمل مع كل أنواع الملفات.** لا تقتصر العقدة على PDF؛ بل تتعامل مع مستندات Word والصور وملفات Excel وأي نوع مخزن في مكتبتك. ## قبل أن تبدأ - يجب أن تكون لديك مستندات مخزنة بالفعل تريد جلبها، **أو** عقدة سابقة تنتج متغير ملف تريد حفظه. - لعمليات الحفظ، تحتاج إلى معرفة معرّف الكيان ومعرّف المثيل واسم الحقل، أي مسار المجلد، في المستندات، أو إلى متغير سابق يوفّر هذا المسار. - الصلاحية المطلوبة: **إدارة مسارات سير العمل (Manage Workflows)**، وعلى الأقل صلاحية **عرض (View)** لمجلد المستندات الذي تجلب منه. - تتاح عقدة المستندات في المصمم المرئي لجميع المستخدمين. **مكان العثور عليها:** انقر علامة **أساسي (BASIC)** في لوحة **العناصر (Elements)** داخل المصمم المرئي، واسحب عقدة **المستندات** إلى اللوحة. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — وضع العقدة 1. افتح سير عمل في المصمم المرئي. 2. انقر علامة **أساسي** في لوحة العناصر إلى اليسار. 3. اسحب عقدة **المستندات** إلى موضع نقل المستند في التدفق. 4. صِلها بالعقدة السابقة، وفي وضع الجلب بالعقدة التي ستستخدم الملف المسترد. 5. انقر العقدة نقرًا مزدوجًا لفتح مربع إعداد **عقدة المستندات (Documents Node)**. ### الخطوة 2 — تسمية العقدة اختياريًا 6. اكتب في حقل **تسمية العقدة (Node Label)** اسمًا وصفيًا يظهر في اللوحة، مثل «جلب العقد الموقّع» أو «أرشفة التقرير النهائي» أو «استرداد المستندات الداعمة». 7. أضف في **الوصف (Description)** ملاحظة اختيارية تشرح دور العقدة في السياق. ### الخطوة 3 — اختيار العملية 8. اختر تحت **العملية (Operation)** أحد الخيارين: - **جلب من المستندات (Fetch from Documents)** — لاسترداد ملف أو مجلد من المكتبة. - **حفظ في المستندات (Save to Documents)** — لكتابة ملف أنتجته خطوة سابقة في المكتبة. يتغير القسم السفلي من مربع الحوار لعرض الخيارات المناسبة. --- ### إعداد الجلب من المستندات #### وضع الجلب: ملف واحد 9. اختر **ملف واحد (Single File)**، وهو الافتراضي، تحت **وضع الجلب (Fetch Mode)**. 10. انقر **تصفح المستندات… (Browse Documents…)**، الزر ذي الحد المتقطع. يفتح مربع **تصفح المستندات — اختيار ملف**. 11. وسّع صفوف الكيان والمثيل بالنقر عليها لإظهار المجلدات تحتها. 12. انقر اسم المستند المطلوب داخل مجلد. يُغلق المربع تلقائيًا وتظهر في مربع الإعداد الرئيسي تسمية الملف المحدد ونوعه وحجمه. 13. لتغيير الاختيار لاحقًا، انقر رابط **تغيير (Change)** بجوار معاينة الملف. #### وضع الجلب: مجلد 14. اختر **مجلد (Folder)** تحت وضع الجلب. 15. لديك ثلاث طرق لاختيار المجلد: - **التصفح:** انقر **تصفح… (Browse…)** لفتح متصفح المجلد. وسّع الشجرة إلى مستوى المجلد وانقر **اختيار (Select)** بجوار المطلوب. - **لصق المسار:** الصق عنوان مجلد المستندات، مثل `https://yourplatform/documents/direct/entity/instance/field`، في حقل اللصق. يحلل النظام تلقائيًا معرّف الكيان ومعرّف المثيل واسم الحقل. - **الكتابة يدويًا:** املأ الحقول الثلاثة مباشرة: **معرّف الكيان (Entity ID)** و**معرّف المثيل (Instance ID)** و**اسم الحقل (Field Name)**. 16. عند ضبط المعرّفات الثلاثة، يظهر سطر تأكيد: `✓ entity / instance / fieldname`، ويتيح لك رابط **فتح في المستندات (Open in Documents)** التحقق من المجلد في علامة تبويب جديدة. 17. مفتاح **الضغط إلى ZIP (Compress to ZIP):** فعّله لتجميع كل ملفات المجلد في أرشيف ZIP واحد قبل تمريرها إلى العُقد اللاحقة. اتركه متوقفًا للحصول على مصفوفة من الملفات الفردية. 18. مفتاح **الإصدارات الحالية فقط (Current versions only):** يكون مفعّلًا افتراضيًا ويسترد الإصدار الحالي لكل ملف فقط. أوقفه لتضمين كل الإصدارات السابقة، وهو أمر نادر الحاجة. > مفتاح **التحويل إلى PDF (Convert to PDF):** فعّله لتحويل كل ملف مجلوب إلى PDF قبل تمريره إلى العُقد اللاحقة؛ يفيد عندما تتوقع خطوة تالية، مثل مرفق بريد أو طلب توقيع، ملفات PDF. --- ### إعداد الحفظ في المستندات #### مصدر الحفظ 19. افتح قائمة **متغير الملف المصدر (Source File Variable)** لرؤية كل متغيرات مسارات الملفات من العُقد السابقة، مثل عقدة برنامج Python النصي أو عقدة جلب مستندات. تنتهي هذه المتغيرات بـ`_path` ويكتشفها النظام تلقائيًا. 20. اختر المتغير الذي يحمل الملف المراد حفظه. تعرض القائمة اسم المتغير والعقدة التي جاء منها. - إذا لم تظهر متغيرات، تظهر الملاحظة «لم يُعثر على متغيرات ملفات. أضف عقدة برنامج Python النصي أو جلب مستندات قبل هذه العقدة»؛ عدّل بنية سير العمل. #### وجهة الحفظ تحفظ العقدة افتراضيًا وبصورة تلقائية في مجلد المستندات الخاص بسير العمل نفسه. يكون مفتاح **الحفظ تلقائيًا في مجلد سير العمل (Save automatically to this workflow's folder)** مفعّلًا من البداية، ولا تحتاج معه إلى تحديد معرّف كيان أو مثيل أو اسم حقل. وهذا أبسط خيار، ويجمع كل ملف ينتجه سير العمل في موضع واحد. لإرسال الملف إلى موضع آخر، أوقف المفتاح وحدد الوجهة بإحدى طريقتين: **الخيار أ — من متغير، لمسار وقت التشغيل:** 21. اختر متغيرًا نصيًا من قائمة قسم **من متغير (From variable)**. يجب أن ينتج المتغير عند التشغيل مسارًا بصيغة `/documents/direct/entity/instance/field`. يفيد ذلك عندما تعتمد الوجهة على مثيل سير العمل، مثل حفظ كل عقد معتمد في مجلد ذلك العقد. - عند اختيار متغير، يصبح قسم **المسار الثابت (Fixed path)** أدناه معطلًا. **الخيار ب — مسار ثابت:** 22. إذا كانت الوجهة هي المجلد نفسه دائمًا، فاملأ حقول معرّف الكيان ومعرّف المثيل واسم الحقل، أو الصق عنوان مجلد المستندات في حقل اللصق لملئها تلقائيًا. 23. يظهر سطر تأكيد ورابط **فتح في المستندات** بعد ضبط الحقول الثلاثة للتحقق من المجلد المستهدف. #### اسم ملف مخصص 24. اكتب اختياريًا في **اسم الملف المخصص (Custom File Name)** اسمًا يتضمن الامتداد لإعادة تسمية الملف عند حفظه. إذا تركته فارغًا، يحتفظ الملف باسمه الأصلي من متغير المصدر. 25. مفتاح **التحويل إلى PDF قبل الحفظ (Convert to PDF before saving):** فعّله لتحويل ملف المصدر إلى PDF قبل وصوله إلى المستندات. استخدمه لأرشفة كل الملفات بصيغة PDF بصرف النظر عن تنسيقها الأصلي. 25. انقر **حفظ (Save)** في تذييل مربع الحوار لتأكيد الإعداد. يُغلق المربع. 26. احفظ سير العمل كاملًا باستخدام **Ctrl+S** أو زر **حفظ** في شريط الأدوات. ## شرح الخيارات والإعدادات ### خيارات مشتركة بين العمليتين | الحقل | الوصف | |---|---| | **تسمية العقدة** | اسم العرض في عقدة اللوحة. غير مطلوب، والقيمة الافتراضية «Documents». | | **الوصف** | ملاحظة اختيارية تظهر في سجل الإصدارات وعند تمرير المؤشر فوق العقدة. | | **مفتاح العملية** | يبدّل بين **الجلب من المستندات** و**الحفظ في المستندات**. تُعاد ضبط كل الإعدادات عند التبديل. | ### حقول وضع الجلب | الحقل | الوصف | |---|---| | زرا **ملف واحد / مجلد** | التبديل بين جلب ملف واحد والجلب على مستوى المجلد. | | زر **تصفح المستندات…** | يفتح متصفح الملفات لاختيار ملف محدد من المكتبة. يظهر عند اختيار ملف واحد. | | **معاينة الملف المحدد** | تعرض اسم الملف ونوع MIME وحجمه. يتيح رابط **تغيير** اختيار ملف آخر. | | رابط **تصفح…** | يفتح متصفح المجلدات لاختيار مجلد. يظهر عند اختيار مجلد. | | **حقل لصق المسار** | يقبل عنوان URL أو نص مسار للمستندات لملء معرّف الكيان ومعرّف المثيل واسم الحقل تلقائيًا. | | **معرّف الكيان** | معرّف كيان المستند في المستوى الأعلى، مثل `procurement` أو `hr`. | | **معرّف المثيل** | المثيل داخل الكيان، مثل معرّف عقد أو سجل موظف محدد. | | **اسم الحقل** | المجلد داخل المثيل، مثل `signed_documents` أو `attachments`. | | رابط **فتح في المستندات** | يفتح المجلد المحدد في علامة تبويب جديدة للتحقق، ويظهر بعد ملء المعرّفات الثلاثة. | | مفتاح **الضغط إلى ZIP** | يضغط كل ملفات المجلد في أرشيف ZIP واحد قبل إتاحتها للعُقد اللاحقة. | | مفتاح **الإصدارات الحالية فقط** | عند التفعيل الافتراضي، يجلب الإصدار الحالي من كل ملف فقط. وعند إيقافه، يضم الإصدارات السابقة. | | **التحويل إلى PDF** | يحول كل ملف مجلوب إلى PDF قبل تمريره إلى العُقد اللاحقة. | ### حقول وضع الحفظ | الحقل | الوصف | |---|---| | **متغير الملف المصدر** | قائمة بكل متغيرات نوع `_path` من العُقد السابقة. اختر المتغير الذي يحمل الملف المطلوب حفظه. | | مفتاح **الحفظ تلقائيًا في مجلد سير العمل** | مفعّل افتراضيًا. يحفظ الملف في مجلد سير العمل داخل المستندات ولا يتطلب مسار وجهة. أوقفه لاختيار وجهة محددة أدناه. | | قسم **من متغير** | قائمة بكل المتغيرات النصية. اختر متغيرًا ينتج مسار `/documents/direct/entity/instance/field` عند التشغيل. تكون له الأولوية على قسم المسار الثابت. | | **المسار الثابت — حقل اللصق** | يقبل عنوان مستندات لملء حقول الوجهة الثلاثة تلقائيًا. | | **المسار الثابت — معرّف الكيان ومعرّف المثيل واسم الحقل** | إدخال يدوي للمسار المكوّن من ثلاثة أجزاء. | | **اسم الملف المخصص** | اسم اختياري للملف المحفوظ. اتركه فارغًا للاحتفاظ بالاسم الأصلي. إذا وُجد ملف بالاسم نفسه، يُنشأ إصدار جديد. | | مفتاح **التحويل إلى PDF قبل الحفظ** | يحول ملف المصدر إلى PDF قبل تخزينه في المستندات. | ### عناصر تحكم متصفح الملفات | عنصر التحكم | الوصف | |---|---| | **حقل البحث** | يصفّي الشجرة بحسب اسم الملف أو معرّف الكيان أو المثيل أو اسم الحقل. | | **صفوف الكيان** | صفوف قابلة للتوسيع في المستوى الأعلى تعرض عدد المثيلات. انقر للتوسيع. | | **صفوف المثيل** | صفوف قابلة للتوسيع في المستوى الثاني تعرض عدد المجلدات. انقر للتوسيع. | | **صفوف الحقل أو المجلد** | صفوف المستوى الثالث تعرض اسم المجلد وعدد الملفات. في وضع المجلد، انقر **اختيار** لاختيار المجلد. | | **صفوف الملفات** | صفوف المستوى الأخير تعرض اسم الملف وحجمه. في وضع الملف، انقر صفًا لاختياره. | | زر **إلغاء (Cancel)** | يغلق المتصفح من دون اختيار شيء. | ## نصائح وأفضل الممارسات - **استخدم المتصفح بدلًا من كتابة المسارات يدويًا.** الأخطاء في معرّفات الكيانات أو أسماء الحقول هي أكثر أسباب أخطاء الإعداد شيوعًا، ويمنعها الاختيار المرئي. - **الصق عنوان المستندات للإدخال السريع للمسار في وضع الحفظ.** افتح المجلد الهدف في المستندات، وانسخ العنوان من شريط المتصفح، والصقه في الحقل ليُحلل تلقائيًا. - **صمّم عُقد الجلب قبل العُقد التي تستخدم إخراجها.** لا يتاح متغير الملف الناتج من جلب المستندات إلا للعُقد التي تأتي بعده في الرسم البياني. - **استخدم الضغط إلى ZIP لمرفقات البريد.** إذا احتاجت عقدة بريد لاحقة إلى تضمين المجلد كاملًا كمرفق واحد، ينتج الضغط ملفًا واحدًا يسهل إرفاقه. - **في عمليات الحفظ، تحقق من وجود المجلد بالنقر على فتح في المستندات.** إذا لم يكن موجودًا، ستنشئه العقدة تلقائيًا، لكن المعاينة تساعدك على تأكيد صحة المسار. - **ينبغي أن تتضمن أسماء الملفات المخصصة الامتداد.** استخدم `final_report.pdf` بدلًا من `final_report`؛ فالمنصة لا تضيف امتدادًا تلقائيًا. - **اجمع بين الجلب والحفظ لبناء مسارات تحويل مستندات.** اجلب قالبًا، ومرره إلى عقدة ذكاء اصطناعي أو برنامج نصي لتحسينه، ثم احفظ النتيجة؛ فتكتمل معالجة المستند من دون تدخل يدوي. - **الإصدارات الحالية فقط** مفعّل افتراضيًا وهو الخيار الصحيح لمعظم مسارات سير العمل. أوقفه فقط إذا كنت تحتاج تحديدًا إلى سجل الإصدارات الكامل لملف. ## الأسئلة الشائعة **س: ما أنواع الملفات التي تدعمها عقدة المستندات؟** أي نوع مخزن في المستندات. لا تعتمد العقدة على التنسيق، وتعمل مع PDF وWord وExcel والصور وأرشيفات ZIP وكل ما في المكتبة. **س: هل تسترد العقدة الملفات من المجلدات الفرعية في وضع المجلد؟** تسترد العقدة كل الملفات في مجلد مستوى الحقل المحدد. بنية المستندات هي كيان ← مثيل ← حقل ← ملفات، ولا يوجد تداخل مجلدات إضافي؛ لذلك تُعاد كل الملفات على مستوى الحقل. **س: ماذا يحدث إذا لم يكن المجلد الهدف موجودًا عند تشغيل عملية حفظ؟** تنشئ المنصة المجلد تلقائيًا وفق المسار المحدد. إذا لم يكن أي جزء من المسار، مثل الكيان أو المثيل أو الحقل، موجودًا، يُنشأ عند تشغيل العقدة. **س: هل يمكنني حفظ ملف من دون إعادة تسميته؟** نعم. اترك حقل **اسم الملف المخصص** فارغًا، وسيُحفظ الملف باسمه الأصلي من متغير المصدر. **س: هل يمكنني استخدام متغير سير عمل لبناء مسار الحفظ ديناميكيًا؟** نعم. استخدم **من متغير** في قسم الموقع الهدف. يجب أن يحتوي المتغير عند التشغيل نصًا بصيغة `/documents/direct/entity/instance/field`. يفيد ذلك عندما تعتمد الوجهة على السجل الجاري معالجته، مثل حفظ كل عقد موقّع في مجلد مثيله. **س: ما الفرق بين وضعي جلب ملف واحد وجلب مجلد؟** يسترد ملف واحد مستندًا محددًا تختاره بالنقر عليه في المتصفح، وينتج ملفًا واحدًا كمتغير. أما المجلد فيسترد كل ملف في المجلد المحدد، وينتج مصفوفة ملفات أو أرشيف ZIP عند تمكين الضغط. **س: ماذا يحدث إذا حُذف الملف الذي أحاول جلبه من المستندات؟** تفشل خطوة سير العمل بخطأ. راقب [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) وعرض تفاصيل سير العمل لاكتشاف حالات الخطأ، وتأكد من عدم حذف مستندات المصدر أثناء عمل المسارات. **س: هل يمكنني إضافة عقدتي مستندات إلى سير العمل نفسه؟** نعم. تعمل كل عقدة باستقلال. قد تجلب قالبًا في الخطوة 3 وتحفظ النتيجة المكتملة في الخطوة 8، مثلًا. سمِّ كل عقدة بوضوح في اللوحة ليظل التدفق مقروءًا. **س: قائمة متغير الملف المصدر فارغة. ماذا أفعل؟** لا تعرض القائمة إلا متغيرات نوع `_path` من العُقد السابقة. أضف قبل عقدة الحفظ عقدة تنتج ملفًا، مثل برنامج Python النصي أو جلب مستندات، وسيظهر متغير المسار الناتج في القائمة. ## أدلة ذات صلة - [استخدام متغيرات سير العمل وعلامات الدمج في البريد والشروط](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [عقدة البريد الإلكتروني: إنشاء إشعارات غنية بالمحرر المرئي](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [عقدة وكيل الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-14-ai-agent-node/) - [عقدة برنامج Python النصي للمشرفين](https://raptix.app/user-guide/ar/10-workflows/10-15-python-script-node/) - [عقدة استعلام قاعدة البيانات: قراءة بيانات مباشرة أثناء العملية](https://raptix.app/user-guide/ar/10-workflows/10-16-db-query-node/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-32-report-node/ # عقدة التقرير > **الوحدة:** منشئ التدفقات ← أساسي ← تقرير > > **الجمهور:** مصممو سير العمل الذين ينشئون تقارير من بيانات العملية > > **ستتعلم:** كيف تملأ قالب Word أو تستخدم محتوى يؤلفه الذكاء الاصطناعي، وتنتج ملف PDF أو DOCX، وتحفظ النتيجة اختياريًا في المستندات. ## إضافة العقدة وتسميتها اسحب **تقرير (Report)** من لوحة العناصر الأساسية، وصِلها بعد الخطوات التي تنتج بياناتها، ثم افتح خصائصها. أدخل **تسمية عقدة (Node label)** واضحة ووصفًا اختياريًا. ## اختيار كيفية إنشاء التقرير ### ملء قالب Word اختر **ملء قالب Word (Fill a Word template)**، ثم اختر مصدرًا بصيغة `.docx`: - **رفع ملف (Upload File)** — ارفع القالب من جهازك. - **من المستندات (From Documents)** — اختر قالبًا موجودًا في المستندات. يمكن أن تحتوي القوالب على عناصر نائبة بصيغة `{{variable}}` أو `<>`. تكتشف العقدة العناصر النائبة وتملؤها بقيم سير العمل عند التشغيل. استخدم لوحة المتغيرات لنسخ الأسماء الدقيقة. فعّل **الفشل عند غياب متغيرات القالب (Fail when template variables are missing)** عندما يجب أن يوقف التقرير غير المكتمل الخطوة. وعندما يكون هذا الخيار متوقفًا، تُترك القيم المفقودة فارغة. ### يكتبه الذكاء الاصطناعي اختر **يكتبه الذكاء الاصطناعي (AI writes it)** عندما ينبغي تأليف نص التقرير داخل منشئ التدفقات بدلًا من ملئه من ملف Word. اختر السمة المتاحة: - **professional** — احترافية - **minimal** — بسيطة - **branded** — بهوية العلامة استخدم منشئ الذكاء الاصطناعي لوصف التقرير وتأليفه، أو عدّل HTML الخاص بالتقرير مباشرة عندما يكون عنصر التحكم هذا متاحًا. راجع المحتوى المعروض وعناصر سير العمل النائبة فيه قبل الحفظ. ## الإخراج اختر **PDF** أو **DOCX** لتنسيق الإخراج. اضبط نمط اسم ملف الإخراج، وأدرج متغيرات سير العمل أو القيم المضمنة المتاحة مثل التاريخ والوقت واسم سير العمل. تتيح العقدة نتائج التقرير للخطوات اللاحقة، ومنها: - `report_path` - `file_name` - `document_id` - `download_url` استخدم لوحة المتغيرات للحصول على أسماء المتغيرات الدقيقة ضمن نطاق العقدة والتي ينتجها التصميم الحالي. ## الحفظ في المستندات فعّل **حفظ التقرير أيضًا في مجلد ضمن المستندات (Also save the report into a Documents folder)** عندما ينبغي أن يبقى الملف المولّد في مكتبة المستندات. - يحفظ الخيار التلقائي الملف في موقع التطبيقات الخاص بسير العمل الحالي ضمن **التقارير المولّدة (Generated Reports)**. - أوقف الموقع التلقائي لاختيار وجهة محددة في المستندات. إذا كان الخيار متوقفًا، يظل بإمكان سير العمل استخدام الإخراج المولّد من خلال متغيرات العقدة. ## قائمة التحقق من الصحة 1. تعمل عقدة التقرير بعد كل متغير تستخدمه. 2. قالب Word بصيغة `.docx` وعناصره النائبة تطابق لوحة المتغيرات. 3. تمت مراجعة المحتوى الذي ألّفه الذكاء الاصطناعي، لا توليده فحسب. 4. اسم الملف صالح وتنسيق الإخراج PDF أو DOCX الصحيح محدد. 5. سلوك المتغيرات المفقودة يطابق قاعدة العمل. 6. وجهة المستندات مناسبة ويمكن الوصول إليها. 7. يفتح التشغيل التجريبي الملف المتوقع أو ينزّله. ## أدلة ذات صلة - [منشئ الذكاء الاصطناعي](https://raptix.app/user-guide/ar/10-workflows/10-30-ai-builder/) - [عقدة المستندات](https://raptix.app/user-guide/ar/10-workflows/10-17-documents-node/) - [المتغيرات وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/ # تشغيل سير عمل ومراقبته > **الوحدة:** منشئ التدفقات والتطبيقات ← سير العمل > > **الجمهور:** مصممو سير العمل والمستخدمون المسؤولون عن متابعة عمليات التنفيذ > > **ستتعلم:** كيف ينشئ كل مُشغّل بداية حالي مثيلًا، وأين يمكنك مراقبته. ## قبل التشغيل تأكد مما يأتي: 1. تم حفظ سير العمل؛ 2. تم إعداد عقدة البداية؛ 3. كل عقدة ونتيجة مطلوبة متصلة؛ 4. المستلمون والمكلّفون وبيانات الاعتماد والمتغيرات ومواقع المستندات صحيحة؛ 5. حالة سير العمل **نشط (Active)**. يحفظ الحفظ تصميم سير العمل، لكنه لا ينشئ مثيلًا بحد ذاته. ## التشغيل اليدوي يمكن بدء سير العمل اليدوي من نموذجه اليدوي المنشور. افتح رابط المشاركة الخاص به أو نموذج سير العمل في الموقع الصحيح ضمن التطبيقات، وأكمل الحقول المطلوبة، ثم أرسل النموذج. يمكن للمصمم المخوّل أيضًا استخدام **تشغيل سير العمل (Run Workflow)** في منشئ التدفقات. يجب حفظ سير العمل، كما يجب إدخال أي معلومات مطلوبة للبداية اليدوية من خلال تجربة النموذج أو التشغيل الحالية. ## عند استدعاء Webhook يرسل التكامل الخارجي طلبًا إلى نقطة النهاية المطابقة تمامًا لما يظهر في خصائص البداية. استخدم المصادقة المعدّة ومحتوى الطلب المتوقع. بعد إجراء اختبار مضبوط، افتح **كل المثيلات (All Instances)** وتأكد من إنشاء مثيل جديد واحد، لا مجموعة مكررة. ## مُشغّل الجدول الزمني لا يبدأ أي شخص التشغيل المجدول يدويًا. احفظ توقيت المُشغّل وضوابط التنفيذ، واجعل سير العمل **نشطًا (Active)**، ثم راجع **كل المثيلات (All Instances)** بعد أول وقت تنفيذ متوقع. تحقق من المنطقة الزمنية إذا ظهر المثيل أبكر أو متأخرًا من المتوقع. ## عند استلام بريد إلكتروني ابدأ اشتراك البريد الإلكتروني المحفوظ، وتأكد من ظهور حالته **قيد التشغيل (Running)**، ثم أرسل رسالة تطابق قواعد صندوق البريد والمرسل والموضوع والمرفق وعامل التصفية والمنظمة والجدول الزمني وحد معدل الإرسال المعدّة. تنشئ الرسالة المطابقة المثيل؛ أما عقدة مُشغّل البريد الإلكتروني الموجودة في منتصف سير العمل فتُطلق الخطوة المنتظرة بدلًا من ذلك. ## تكامل Appsmith عبر HTTP استخدم إجراء صفحة منشئ التطبيقات المتصل والمعد من لوحة البداية. أرسل إجراء صفحة مضبوطًا، ثم تحقق من المثيل الناتج. تسمية المُشغّل الظاهرة حاليًا للمستخدم هي **Appsmith Integration (HTTP)**. ## مراقبة النتيجة 1. افتح **التطبيقات ← سير العمل ← كل المثيلات**. 2. اختر المثيل الجديد. 3. راجع **حالة سير العمل (Workflow Status)** و**حالة العملية (Process Status)** وخطوات الاعتماد والمهمة الحالية والخط الزمني والملفات. 4. إذا كان الإجراء مسندًا إليك، فاستخدم **فتح إجراء المهمة (Open task action)** أو **مهامي (My Tasks)**. ## استكشاف الأخطاء وإصلاحها | العَرَض | ما يجب التحقق منه | |---|---| | أداة التشغيل غير متاحة | وضع التحرير أو العرض، وحالة الحفظ، وإعداد البداية، والحالة النشطة، وصلاحية الوصول. | | لا يظهر أي مثيل | إعدادات الاشتراك أو نقطة النهاية أو الجدول أو النموذج الخاصة بالمُشغّل، ونطاق التطبيق الصحيح. | | يظهر مثيلان | تجنب الإرسال المزدوج وتحقق من سلوك إعادة المحاولة في التكامل الذي أجرى الاستدعاء. | | يتوقف المثيل عند مهمة | افتح **مهامي** بحساب المستخدم المكلّف وراجع إجراء المهمة. | | يفشل المثيل عند عقدة | افتح عرض تفاصيل سير العمل الخاص به، ثم راجع الإعداد أو سجلات قاعدة بيانات سير العمل. | ## أدلة ذات صلة - [مُشغّلات البداية](https://raptix.app/user-guide/ar/10-workflows/10-4-start-trigger-nodes/) - [مُشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [مُشغّل Webhook](https://raptix.app/user-guide/ar/10-workflows/10-28-webhook-trigger/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/ # سير العمل: كل المثيلات > **المسار:** `/applications?view=workflows` > > **الوحدة:** التطبيقات ← سير العمل ← كل المثيلات > > **الجمهور:** المستخدمون والمشرفون الذين يتابعون عمليات سير العمل > > **ستتعلم:** كيف تراقب كل مثيلات سير العمل المتاحة لك وتفتح عرض التفاصيل الحالي لأي منها. ## فتح كل المثيلات 1. افتح **التطبيقات (Applications)**. 2. اختر **سير العمل (Workflow)** في الرأس. 3. اختر **كل المثيلات (All Instances)** عندما تكون علامتا تبويب سير العمل متاحتين. ## ما الذي تعرضه القائمة؟ يحمّل عرض **كل المثيلات** عمليات تنفيذ سير العمل المتاحة لحسابك. وعند فتحه داخل مساحة عمل أو تطبيق أو صفحة معينة، يمكن تقييد العرض بالنطاق نفسه. تعرض الصفوف معلومات المثيل الحالية التي يدعمها الجدول المتجاوب، بما في ذلك هوية سير العمل أو المثيل، والحالة، والمنشئ، والتواريخ عندما تكون متاحة. وقد تشمل شارات الحالة: مكتمل، أو معلّق، أو قيد التقدم، أو مرفوض، أو ملغى، أو لم يبدأ، أو قيمة حالية أخرى يوفّرها محرك التنفيذ. تُحمّل القائمة السجلات على صفحات. استخدم ترقيم صفحات الجدول لطلب نتائج إضافية، واختر التحديث عندما تحتاج إلى تحميل أحدث البيانات. ## فتح مثيل اختر صف المثيل أو إجراء عرضه. يفتح المنتج المسار: `/workflow-detail-view?instance_id=` شاشة التفاصيل هي المرجع الأساسي لحالة العملية وخطوات المثيل وطوابعه الزمنية وملفاته ورابط مهمته الحالية. استخدم إجراء عرض سير العمل، عندما يكون متاحًا، لفتح التصميم المحفوظ في وضع العرض داخل منشئ التدفقات. يعرض ذلك القالب، وليس عملية تنفيذ منفصلة. ## الوصول تُمنح صلاحية الوصول الحالية إلى سير العمل من خلال إمكانية **سير عمل التطبيقات (Applications Workflow)**. وجّه المستخدمين إلى **التطبيقات ← سير العمل**. إذا كان أحد العرضين، **كل المثيلات** أو **مهامي**، متاحًا وحده، فقد يُخفى مبدّل علامات التبويب ويُفتح العرض المسموح به مباشرة. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | لا تظهر أي مثيلات | تأكد من النطاق العام أو نطاق التطبيق الصحيح، ومن أن سير العمل قد شُغّل فعلًا. | | تشغيل حديث غير ظاهر | حدّث القائمة وتحقق من الصفحة التالية إذا كانت القائمة كبيرة. | | يتعذر فتح أحد الصفوف | تأكد من وجود معرّف مثيل له ومن قدرة حسابك على الوصول إلى نطاقه. | | يظهر عرض مهامي بدلًا منه | اختر **كل المثيلات** أو أزل `wf=tasks` من عنوان URL الحالي للتطبيقات. | ## أدلة ذات صلة - [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [لوحة معلومات سير العمل في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/ # عرض تفاصيل سير العمل وحالة العملية > **المسار:** `/workflow-detail-view?instance_id=` > > **يُفتح من:** التطبيقات ← سير العمل ← كل المثيلات > > **الوحدة:** التطبيقات ← سير العمل ← تفاصيل المثيل > > **الجمهور:** المستخدمون والمشرفون الذين يتابعون تنفيذًا محددًا > > **ستتعلم:** كيف تقرأ عملية تنفيذ محددة، وتتابع خطوات اعتمادها، وتفتح العمل المطلوب، وتراجع سجلها وتصميمها، وتنزّل ملفاتها. ## فتح مثيل افتح **التطبيقات ← سير العمل ← كل المثيلات** واختر صفًا. يُحمّل عرض التفاصيل باستخدام معرّف المثيل. إذا كان المعرّف مفقودًا، فلن تتمكن الصفحة من تحديد عملية التنفيذ المطلوب عرضها. ## حالة سير العمل يعرّف رأس الحالة سير العمل والمثيل ويلخّص عملية التنفيذ. ويمكنه، حسب بيانات التشغيل المتاحة، عرض ما يأتي: - **حالة سير العمل (Workflow Status)** والحالة الحالية؛ - **معرّف المثيل (Instance ID)**؛ - نسبة التقدم؛ - عدد الخطوات المكتملة من إجمالي الخطوات؛ - الخطوة الحالية أو التالية والمكلّف بها؛ - وقت آخر تحديث. يعرض شريط **سير عمل الاعتماد (Approval Workflow)** الأفقي كل خطوة اعتماد وحالتها المبنية على الأدلة. ووسم سير العمل بأنه مكتمل لا يعني بالضرورة أن كل خطوة مصممة قد نُفّذت؛ فقد تبقى الفروع التي لم يُسلك مسارها في حالة لم تُشغّل، أو تبدو معلّقة في البيانات الأقدم. اقرأ حالات الخطوات والخط الزمني معًا. ## حالة العملية يوفّر قسم **حالة العملية (Process Status)** ملخص التنفيذ الذي يدعمه السجل الحالي، بما في ذلك: - الخطوة الحالية؛ - **قالب العملية (Process Template)** أو اسم سير العمل؛ - **الحالة الحالية (Current Status)**؛ - **تاريخ بدء العملية (Process Start Date)**؛ - خطوات سير العمل المرقمة وحالاتها. تأتي الحالة والتقدم من سجلات تشغيل مختلفة، وقد يتحدثان في أوقات متقاربة ولكن غير متطابقة. راجع **آخر تحديث (Last updated)** وأعد تحميل الصفحة إذا لم يظهر إجراء اكتمل للتو. ## إجراء مهمة مطلوب عندما تكون لدى المستخدم المسجّل دخوله مهمة معلّقة قابلة للتنفيذ، تعرض الصفحة بطاقة **إجراء مهمة مطلوب (Task action required)** والمكلّف ووقت الإنشاء وزر **فتح إجراء المهمة (Open task action)**. اختره لفتح **مدير مهام سير العمل** على `/manager-approval`. إذا لم تظهر هذه البطاقة، فقد يظل المثيل قيد التشغيل، لكن لا يوجد إجراء حالي متاح لهذا المستخدم من صفحة التفاصيل. ## تفاصيل المثيل يمكن أن تعرض بطاقة التفاصيل الحالية: - معرّف المثيل؛ - أنشأه؛ - الحالة؛ - وقت الإنشاء؛ - **المدة (Duration)** لعملية تشغيل منتهية، أو وقت **قيد التشغيل (Running)** لعملية نشطة. انسخ معرّف المثيل كاملًا عند الإبلاغ عن مشكلة؛ فهو أدق من اسم سير العمل وحده. ## سجل المحادثة عند وجود رسائل بين مستويات المهمة، يعرض **سجل المحادثة (Conversation history)** عدد الرسائل ويفتح نافذة للقراءة فقط. يفيد ذلك في مراجعة التعليقات السابقة من دون إعادة فتح كل مهمة اعتماد مكتملة. ## الخط الزمني والحالة يمكن أن يعرض هذا القسم **اسم سير العمل** و**آخر تحديث** و**اكتمل في** و**آخر نشاط**. وهو يميّز وقت الإنشاء عن أحدث نشاط ووقت الإكمال. ## عارض سير العمل وسّع **عارض سير العمل (Workflow viewer)** لاستخدام: - **عرض سير العمل (View workflow)** — فتح التصميم المرئي المحفوظ في وضع العرض داخل منشئ التدفقات؛ - **تنزيل الملفات (Download files)** — إعداد ملف ZIP للملفات المرتبطة بالمثيل عند وجود ملفات قابلة للتنزيل. التصميم المرئي هو قالب سير العمل، بينما تصف حالات خطوات التشغيل في هذه الصفحة هذا المثيل بعينه. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | لا تُحمّل أي بيانات | ارجع إلى **كل المثيلات** وافتح الصف مجددًا حتى يُضمّن معرّف المثيل الكامل. | | يبدو التقدم والحالة غير متوافقين | راجع **آخر تحديث**، وأعد التحميل، واعتمد على أدلة كل خطوة. | | زر فتح إجراء المهمة مفقود | تأكد من أن المهمة معلّقة ومسندة إلى حسابك أو متاحة له. | | تنزيل الملفات غير متاح أو فارغ | ربما لم ينشئ المثيل ملفات قابلة للتنزيل أو يرفقها. | | يفشل عرض سير العمل | تأكد من أن قالب سير العمل لا يزال موجودًا وأن لديك صلاحية العرض في منشئ التدفقات. | ## أدلة ذات صلة - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [تفاصيل سير العمل في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/ # سير العمل: مهامي > **المسار:** `/applications?view=workflows&wf=tasks` > > **الوحدة:** التطبيقات ← سير العمل ← مهامي > > **الجمهور:** المستخدمون الذين لديهم مهام سير عمل معلّقة، والمشرفون > > **ستتعلم:** كيف تعثر على عمل سير العمل المعلّق والمسند إليك، وتفتح إجراء المهمة الصحيح. ## فتح مهامي 1. افتح **التطبيقات (Applications)**. 2. اختر **سير العمل (Workflow)**. 3. اختر **مهامي (My Tasks)**. يؤدي جرس التنقل أيضًا إلى عرض **مهامي** عند توفر عمل معلّق. ## ما الذي يظهر؟ يطلب عرض **مهامي** المهام ذات الحالة المعلّقة. وللمستخدم العادي، يعيد الخادم العمل المتاح لذلك المستخدم. أما المشرف فقد يحصل على النتيجة الإدارية الأوسع التي يسمح بها الخادم. عند فتح القائمة داخل مساحة عمل أو تطبيق أو صفحة، يمكن تقييدها بذلك النطاق. ويحمّل ترقيم الصفحات مجموعات إضافية من المهام بدلًا من عرض كل السجلات دفعة واحدة. يمكن للجدول المتجاوب عرض سياق المهمة والطلب، مثل سير العمل أو العملية، والخطوة الحالية، ومعلومات المكلّف، والأولوية، والتواريخ، والإجراء المستخدم لفتح السجل. يقل عدد الأعمدة الظاهرة على الشاشات الأصغر. ## فتح مهمة وإكمالها 1. اعثر على السجل المعلّق. 2. اختر إجراء العرض أو الفتح الخاص به. 3. تُفتح المهمة على `/manager-approval` في **مدير مهام سير العمل (Workflow Task Manager)**. 4. اقرأ تفاصيل المهمة و**الإجراءات المسموح بها (Allowed Actions)** أو **إجراءات الاعتماد (Approval Actions)** والمستندات المرفقة أو المرتبطة و**التعليقات السابقة (Previous Comments)**. 5. إذا تضمنت المهمة ملف PDF، فاستخدم عارض المستند وأدوات الرسم أو التوقيع المتاحة حسب المطلوب. 6. أكمل أي حقول في **نموذج المهمة (Task form)**، ثم اختر إجراءً مسموحًا. في نماذج المهام، يكون هذا الإجراء زر الإرسال ومسار سير العمل. بعد نجاح الإجراء، يُفترض أن تغادر المهمة قائمة العناصر المعلّقة. حدّث **مهامي** إذا ظل الصف ظاهرًا لفترة قصيرة. تعرض بعض تفاصيل سير العمل أيضًا **إجراء مهمة مطلوب (Task action required)** و**فتح إجراء المهمة (Open task action)**. يؤدي هذا الزر إلى تجربة معالجة المهمة الحالية نفسها عندما يحق للمستخدم المسجّل دخوله تنفيذها. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | يعرض الجرس عملًا لكن القائمة فارغة | حدّث الصفحة، وتحقق من النطاق المحدد، وتأكد من أن المهمة لم تُنفذ بالفعل في مكان آخر. | | تُفتح المهمة للقراءة فقط | قد لا تكون مسندة إليك، أو لم تعد معلّقة، أو قد يسمح دورك بالعرض فقط. | | ملف PDF أو الملفات مفقودة | تأكد من أن خطوة سير العمل أرفقت المستندات أو ربطتها فعلًا، ثم أعد تحميل المهمة. | | يفشل إجراء | أبقِ الصفحة مفتوحة، واقرأ الخطأ المعروض، وتحقق من التعليقات أو الحقول المطلوبة، ثم أعد المحاولة مرة واحدة. | ## أدلة ذات صلة - [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [نماذج المهام](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) - [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [مهمة PDF ضمن سير العمل](https://raptix.app/user-guide/ar/20-documents/20-4-reviewing-approving-workflow-task/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/ # مدير مهام سير العمل: مراجعة مهمة مسندة ومعالجتها > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون النهائيون، بما فيهم المعتمدون والمديرون والمكلّفون بالمهام > > **ستتعلم:** كيف تقرأ المعلومات في مدير مهام سير العمل، وتراجع المستندات المقدمة، وتضيف التعليقات والملفات الداعمة، وتسجل قرارك ليتابع سير العمل تقدمه. ## ما هو؟ **مدير مهام سير العمل (Workflow Task Manager)** هو واجهة بملء الصفحة ينفذ فيها الشخص مهمة سير عمل مسندة إليه. تجمع الواجهة بيانات الطلب والمستندات المرتبطة والتعليقات والملفات المطلوب رفعها وإجراءات الاعتماد المخصصة التي أعدّها مصمم سير العمل. عندما يستخدم المصمم **نموذج مهمة (Task Form)**، تعرض الصفحة أيضًا حقولًا منظمة مثل النصوص والأرقام والتواريخ والاختيارات ومربعات التحديد ورفع الملفات. تحمل الأزرار تسمية **الإجراءات المسموح بها (Allowed Actions)**، لأن كل زر يرسل تلك القيم ويحدد مسار سير العمل؛ ولا يوجد زر إرسال منفصل لنموذج المهمة. يمكنك الوصول إليه من **مهامي (My Tasks)**، أو **فتح إجراء المهمة (Open task action)** في عرض تفاصيل سير العمل، أو رابط مهمة صالح في رسالة إشعار بالبريد الإلكتروني. ## أهميته وفوائده الرئيسية - **كل ما تحتاج إليه لاتخاذ القرار في شاشة واحدة** — بيانات الطلب والمستندات وسجل المحادثة وأزرار الإجراءات. لن تحتاج إلى التنقل بين البريد الإلكتروني أو أنظمة الملفات أو تطبيقات أخرى. - **قراءة ملفات PDF فورًا من دون تنزيل** — يعرض العارض المضمّن مستندات PDF متعددة الصفحات في المتصفح، مع التكبير والتنقل بين الصفحات. لا تغادر المستندات المنصة أثناء المراجعة. - **أزرار قرار مخصصة تطابق لغة عملك** — بدلًا من «اعتماد / رفض» العامين، قد ترى أزرارًا مثل «تأييد» أو «إرسال إلى الشؤون القانونية» أو «إرجاع للمراجعة»، حسب تصميم سير العمل. - **سلسلة المحادثة الكاملة** — يظهر كل تعليق من كل مستوى في سلسلة الاعتماد ضمن محادثة شبيهة بتطبيقات الرسائل، لتفهم السياق الكامل قبل اتخاذ القرار. - **رفع الملفات الداعمة مباشرة** — إذا طلب منك سير العمل إرفاق مستند، مثل خطاب تأييد موقّع، تظهر حقول رفع معنونة في الشاشة نفسها. - **تسجيل قرارك فورًا** — يؤدي النقر على زر الإجراء إلى تقدم محرك سير العمل مباشرة، وتحديث شارة **مهامي** في الشريط العلوي، وإعادتك إلى **كل المثيلات** حتى ترى تقدم سير العمل. ## قبل أن تبدأ - يجب أن تكون لديك مهمة معلّقة مسندة إلى حسابك. عند وجود مهام معلّقة، سترى شارة متحركة تحمل عددها على رمز الجرس في شريط التنقل العلوي. - يمكنك الوصول إلى مدير مهام سير العمل من **مهامي** عبر جرس الشريط العلوي ← **مهامي**، أو من رابط إجراء صالح في رسالة إشعار المهمة. - تحتاج إلى صلاحية عرض المهام وتنفيذ إجراءاتها. إذا عرضت الشاشة خطأ أو رسالة «تم رفض الوصول»، فتواصل مع المشرف. راجع [صلاحيات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-29-workflow-permissions/). ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — فتح المهمة **من مهامي:** 1. انقر رمز الجرس في شريط التنقل العلوي، أو انتقل إلى **مهامي** من القائمة الجانبية. 2. اعثر في الجدول على المهمة التي تريد تنفيذها. يعرض كل صف اسم سير العمل والخطوة الحالية والأولوية وتاريخ الاستحقاق والحالة. 3. انقر صف المهمة. يفتح مدير مهام سير العمل. **من رسالة إشعار:** 1. افتح رسالة الإشعار التي وصلتك عند إسناد المهمة إليك. 2. انقر رابط الإجراء في الرسالة، مثل **فتح المهمة (Open Task)** أو زر إجراء مباشر مثل **اعتماد (Approve)** في نص الرسالة. يفتح مدير مهام سير العمل في متصفحك، وإذا لم تكن مسجّل الدخول فستُطلب منك المصادقة أولًا. ### الخطوة 2 — مراجعة معلومات الطلب 4. أسفل الرأس، اعثر على بطاقة **معلومات الطلب (Request Information)** التي يميزها رمز قاعدة البيانات. تعرض كل البيانات التي أرسلها مقدم الطلب: حقول النموذج والاختيارات والتواريخ وأي معلومات أخرى التُقطت في بداية سير العمل. - تكون الحقول ذات البيانات المتداخلة، كالكائنات أو القوائم، مطوية افتراضيًا. انقر سهم التوسيع لإظهارها. - تعرض القيم النصية الطويلة **عرض المزيد (Show more)**؛ انقرها لقراءة النص كاملًا. - انقر رمز النسخ بجوار أي قيمة لنسخها إلى الحافظة. 5. راجع بطاقات البيانات الوصفية أعلى منطقة المحتوى. تتضمن عادة: - **مسند إلى (Assigned To)** — اسمك أو دورك. - **الأولوية (Priority)** — منخفضة أو متوسطة أو عالية أو عاجلة. - **تاريخ الاستحقاق (Due Date)** — الموعد المطلوب لإكمال المهمة. - **التصنيف (Category)** واسم **سير العمل (Workflow)**. إذا ظهر قسم **نموذج المهمة (Task form)**، فأكمل حقوله الظاهرة قبل اختيار إجراء. يتم التحقق من الحقول المطلوبة لكل إجراء. تستخدم الحقول المخفية غير المخصصة للملفات القيم الافتراضية التي أعدّها مصمم سير العمل، ولا تظهر في الصفحة. ### الخطوة 3 — قراءة المستند في عارض PDF 6. إذا كان هناك مستند مرفق بهذه المهمة، يظهر **عارض PDF المضمّن** في الجانب الأيسر على سطح المكتب أو أعلى لوحة الإجراءات على الهاتف. 7. استخدم عناصر تحكم عارض PDF: | عنصر التحكم | الإجراء | |---|---| | زرا **تكبير / تصغير (Zoom In / Zoom Out)**، برمزي العدسة | زيادة حجم عرض المستند أو تقليله. تظهر نسبة التكبير الحالية. | | زر **التدوير (Rotate)**، برمز السهم الدائري | تدوير عرض المستند 90 درجة مع اتجاه عقارب الساعة. | | سهما الصفحة **السابقة / التالية (Previous / Next)** | التنقل بين صفحات PDF متعدد الصفحات. يظهر رقم الصفحة الحالية وإجمالي الصفحات. | | زر **التنزيل (Download)**، برمز السهم المتجه لأسفل | حفظ نسخة محلية من المستند على جهازك. | | زر **عرض بملء الشاشة (View full screen)**، برمز التوسيع | فتح PDF في نافذة عرض مخصصة ذات مساحة أكبر. | > إذا لم يظهر عارض مستند، فإما أن المهمة لا تتضمن ملف PDF مرفقًا، أو أن سير العمل معدّ لاعتماد دفعة على مستوى الصفوف. في هذه الحالة، انتقل إلى الخطوة 8. ### الخطوة 4 — قراءة سلسلة المحادثة 8. اعثر على زر **المحادثة (Conversation)** ذي رمز فقاعة الدردشة، وانقره لتوسيع سلسلة المحادثة الكاملة. 9. تعرض السلسلة كل التعليقات التي تركها المعتمدون السابقون في مثيل سير العمل، على هيئة فقاعات ملونة منسوبة إلى كل شخص باسمه ومستوى الاعتماد والطابع الزمني. تظهر المستويات الفردية إلى اليسار والزوجية إلى اليمين، على غرار تطبيقات المراسلة. 10. راجع كل التعليقات قبل اتخاذ قرارك لتفهم أي ملاحظات أو تعليمات من المستويات السابقة. ### الخطوة 5 — إضافة تعليقك 11. اعثر على منطقة النص **التعليق / السبب (Comment / Reason)** في الجانب الأيمن من الشاشة، أسفل بطاقات البيانات الوصفية. 12. إذا كان الإجراء الذي ستنفذه يتطلب تعليقًا لأن مصمم سير العمل فعّل **يتطلب تعليقًا (Requires Comment)**، فيجب أن تكتب حرفًا واحدًا على الأقل. يظل زر الإجراء معطلًا حتى تفعل ذلك. 13. اكتب تعليقك: أي ملاحظات أو أسباب أو تعليمات ذات صلة للمستوى التالي أو لسجل التدقيق. > لا تحتاج إلى إضافة تعليق للإجراءات التي لا تتطلبه، مثل اعتماد روتيني. لكن إضافة السياق حتى عندما تكون اختيارية تحسّن سجل التدقيق وتساعد المعتمدين اللاحقين. ### الخطوة 6 — رفع المستندات المطلوبة عند الحاجة 14. إذا طلب منك سير العمل إرفاق ملفات داعمة، يظهر حقل واحد أو أكثر باسم **رفع مستند (Document Upload)** أسفل منطقة التعليق. 15. لكل حقل رفع: a. لاحظ تسمية الحقل، مثل «خطاب التأييد الموقّع» أو «نسخة الهوية المتحقق منها»، والحد الأقصى لحجم الملف الظاهر أسفله. b. انقر منطقة الرفع أو اسحب الملفات وأفلتها فيها. c. إذا حمل الحقل علامة **مطلوب (Required)**، فيجب إرفاق ملف واحد على الأقل قبل الإرسال. d. إذا فُعّل **طلب تعليق (Require Comment)** للحقل، فاكتب ملاحظة قصيرة في حقل التعليق الذي يظهر أسفله. 16. يمكنك متابعة حالة الرفع لكل حقل: يتحول الرمز إلى مؤشر تحميل أثناء الرفع ثم يعرض علامة اختيار خضراء عند النجاح. ### الخطوة 7 — اتخاذ القرار 17. سترى في لوحة الإجراءات أزرار الإجراءات المخصصة لهذه المهمة، مثل **إكمال (Complete)** أو **رفض (Reject)** أو **تعليق (Hold)** أو تسميات مؤسستك الخاصة. 18. انقر الزر الذي يمثل قرارك: - إذا كان الإجراء يتطلب تعليقًا وحقل التعليق فارغ، يظهر إشعار أحمر يطلب منك تعبئته. لا يُرسل الإجراء حتى تفعل ذلك. - إذا كانت حقول الرفع المطلوبة فارغة، تسرد رسالة خطأ الحقول الناقصة. لا يُرسل الإجراء حتى تُرفق كل الملفات المطلوبة. 19. بعد استيفاء كل المتطلبات، يؤدي النقر على الزر إلى: - رفع أي ملفات مستندات معلّقة؛ - إرسال تعليقك وقرارك إلى محرك سير العمل؛ - عرض إشعار نجاح أخضر: «تم تنفيذ الإجراء [اسم الإجراء] بنجاح!»؛ - إعادتك إلى منطقة سير العمل الحالية بعد استجابة النجاح حتى ترى الحالة المحدثة. ### الخطوة 8 — التعامل مع مهام اعتماد الدفعات على مستوى الصفوف إذا كانت هذه مهمة اعتماد دفعة وقد فعّل مصمم سير العمل **اعتماد لكل عنصر (Approval For Each)** في عقدة المهمة، فلن يظهر عارض PDF. وبدلًا منه سترى جدول بيانات يحتوي على صف لكل عنصر مطلوب مراجعته. لكل صف: 1. راجع أعمدة البيانات في ذلك الصف. 2. انقر زر الإجراء الخاص بالصف، مثل رمز الاعتماد الأخضر أو الرفض الأحمر. 3. اكتب اختياريًا تعليقًا خاصًا بالصف إذا كان مطلوبًا. 4. بعد تنفيذ إجراء على كل الصفوف، انقر زر **إرسال (Submit)** الرئيسي لإرسال جميع القرارات دفعة واحدة. راجع [شاشة قرارات الدفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/) للحصول على دليل كامل لمراجعة النتائج بعد الإرسال، و[الاعتمادات متعددة المستويات واعتمادات الدفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) لمعرفة كيفية إعداد اعتماد الدفعة. ## شرح الخيارات والإعدادات ### لوحة معلومات الطلب | العنصر | ما يعرضه | |---|---| | **رأس رمز قاعدة البيانات** | يشير إلى لوحة معلومات الطلب، ويعرض العنوان **معلومات الطلب** والعنوان الفرعي «تفاصيل هذا الطلب وسياقه». | | **حقول المستوى الجذري** | أزواج المفتاح والقيمة من النموذج المرسل عند تشغيل سير العمل. تُنسّق أسماء الحقول تلقائيًا؛ فمثلًا يتحول `department` إلى «Department». | | **الكائنات القابلة للتوسيع** | مجموعات حقول متداخلة. يظهر سهم نحو اليمين عند طي المجموعة، ونحو الأسفل عند توسيعها، مع عدد الخصائص. | | **المصفوفات القابلة للتوسيع** | قوائم عناصر. تعرض عدد العناصر وتتوسع لإظهار كل عنصر عند النقر. | | **عرض المزيد / عرض أقل (Show more / Show less)** | يظهر للقيم النصية التي تتجاوز 50 حرفًا. انقر للتبديل بين النص المختصر والكامل. | | **رمز النسخ** | ينسخ قيمة الحقل إلى الحافظة، ويظهر تأكيد قصير. | ### عناصر تحكم عارض PDF | عنصر التحكم | ما يفعله | |---|---| | **تكبير (Zoom In)**، عدسة مع `+` | يكبّر المستند في العارض. | | **تصغير (Zoom Out)**، عدسة مع `-` | يصغّر المستند في العارض. | | **تدوير (Rotate)**، سهم دائري | يدور بالمستند 90 درجة مع اتجاه عقارب الساعة. | | **الصفحة السابقة (Previous page)**، سهم يسار | ينتقل إلى الصفحة السابقة في PDF متعدد الصفحات. | | **الصفحة التالية (Next page)**، سهم يمين | ينتقل إلى الصفحة التالية في PDF متعدد الصفحات. | | **مؤشر الصفحة** | يعرض «الصفحة X من Y» لتعرف موضعك. | | **تنزيل (Download)**، سهم لأسفل | ينزّل المستند الحالي إلى جهازك. | | **توسيع (Expand)**، رمز التكبير | يفتح PDF في عارض مخصص أكبر. | ### أزرار الإجراءات | العنصر | ما يفعله | |---|---| | **أزرار الإجراءات ذات الأسماء المخصصة** | يرسل كل زر قرارًا محددًا إلى محرك سير العمل. يضبط مصمم سير العمل أسماء الأزرار وألوانها ومتطلبات التعليق. | | **حقل التعليق** | مساحة نص حر لملاحظاتك. تكون مطلوبة لبعض الإجراءات، ويبرز حد الحقل باللون الأحمر إذا حاولت الإرسال من دونها. | | **إرسال (Submit)** لمهام الدفعات | يرسل كل القرارات على مستوى الصفوف دفعة واحدة بعد تنفيذ إجراء على كل صف. | ### سلسلة المحادثة | العنصر | ما يفعله | |---|---| | **شارة المستوى (`L1` و`L2`...)** | توضح مستوى الاعتماد الذي صدر منه التعليق، بلون مخصص لكل مستوى. | | **اسم المرسل** | اسم المستخدم الذي ترك التعليق. | | **وسم الإجراء** | الإجراء الذي اتخذه المعلّق، مثل «تم الاعتماد» أو «مرفوض». | | **الطابع الزمني** | تاريخ إرسال التعليق ووقته. | | **فقاعة الدردشة** | نص التعليق. تكون فقاعات المستويات الزوجية إلى اليمين والفردية إلى اليسار. | ## نصائح وأفضل الممارسات - **اقرأ سلسلة المحادثة كاملة دائمًا قبل اتخاذ القرار.** ربما سجّل مستوى سابق ملاحظة أو شرطًا محددًا ينبغي أن يؤثر في قرارك. - **استخدم روابط عرض المزيد** في لوحة معلومات الطلب لأي حقول نصية طويلة، فقد تُخفي المعاينة المختصرة تفاصيل مهمة. - **أضف تعليقًا حتى عندما لا يكون مطلوبًا.** تمنح الملاحظة القصيرة التي تشرح قرارك سياقًا ثمينًا للتدقيق والتصعيد والرجوع مستقبلًا. - **تحقق من كل حقول الرفع المطلوبة قبل النقر على زر الإجراء.** تمنع الملفات المطلوبة الناقصة الإرسال وتعرض رسالة خطأ؛ وستحتاج إلى العثور عليها وإرفاقها قبل إعادة المحاولة. - **إذا احتجت إلى وقت إضافي، فاستخدم إجراء التعليق (Hold)** إن كان معدًّا، بدلًا من ترك المهمة معلّقة إلى أجل غير محدد. تُبقي نتيجة التعليق سير العمل قائمًا وتسجّل قصد قرارك، مع السماح لمقدم الطلب باتخاذ إجراء تصحيحي. - **لا تغادر الصفحة أثناء اتخاذ القرار.** إذا بدأت كتابة التعليقات أو رفع الملفات، فتجنب الانتقال إلى صفحة أخرى قبل الإرسال؛ إذ لا تُحفظ مدخلاتك الجارية تلقائيًا. - **لمستخدمي الهاتف:** ينتقل عارض PDF إلى وضع ملء الشاشة على الشاشات الصغيرة. اضغط زر الإغلاق `X` للعودة إلى بقية شاشة الاعتماد بعد مراجعة المستند. ## الأسئلة الشائعة **س: هل يمكنني رؤية كل المهام المسندة إلى فريقي، لا مهامي وحدها؟** يرى المستخدم العادي المهام المسندة إلى حسابه فقط، بينما يرى المشرف كل المهام. إذا احتجت إلى عرض على مستوى الفريق، فاطلب من المشرف منحك الوصول الإداري أو تشغيل تقرير من **كل المثيلات**. **س: يعرض عارض المستند رسالة «لم يُعثر على مستند». هل هذا خطأ؟** ليس بالضرورة. بعض المهام لا تتضمن مستندًا مرفقًا؛ بل بيانات معلومات الطلب فقط. إذا كنت تتوقع مستندًا ولم تره، فاطلب من مصمم سير العمل مراجعة الإعداد. ومن المحتمل أيضًا أن يكون المستند أُرسل في جزء مختلف من العملية. **س: نقرت زر الإجراء لكن لم يحدث شيء. ماذا أفعل؟** ابحث عن رسائل تحقق حمراء في الصفحة؛ فقد يكون تعليق أو حقل رفع مطلوب مفقودًا. إذا لم توجد أخطاء تحقق وظل الزر بلا استجابة، فحاول تحديث الصفحة. يُرجّح أن قرارك لم يُرسل. إذا استمرت المشكلة، فتواصل مع المشرف مع تفاصيل المهمة. **س: هل يمكنني تغيير قراري بعد النقر على زر الإجراء؟** لا. بمجرد إرسال الإجراء، يُسجّل فورًا ويتقدم سير العمل. تواصل مع مشغّل سير عمل مخوّل إذا احتجت إلى تصحيح العملية؛ فقد يتطلب ذلك تشغيلًا جديدًا أو عملية مدروسة بعناية في قاعدة بيانات سير العمل. **س: أنفذ مهمة بدل شخص غائب عن المكتب. هل أسجّل الدخول بحسابه؟** لا تسجّل الدخول أبدًا باسم شخص آخر. اطلب من المشرف إضافتك كمكلّف بالمهمة، أو استخدام ميزة التصعيد لإعادة توجيه المهام إليك. يُسجّل كل إجراء بهوية المستخدم المسجّل دخوله لأغراض التدقيق. **س: ما رابط معرّف الدفعة (Batch ID) الذي أراه أحيانًا في شاشة المهمة؟** عند معالجة المهمة كاعتماد دفعة باستخدام **اعتماد لكل عنصر**، يُنشأ معرّف دفعة لذلك الإرسال. يؤدي النقر على الرابط إلى **شاشة قرارات الدفعة** التي تعرض جدول القرارات الكامل على مستوى الصفوف. راجع [شاشة قرارات الدفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/). **س: هل يمكنني الوصول إلى هذه الشاشة من دون حساب RAPTIX بصفتي مستخدمًا خارجيًا؟** يستطيع المعتمدون الخارجيون، مثل الموردين والمتعاقدين الذين لا يملكون حسابًا على المنصة، اعتماد المهام عبر **بوابة المعتمد الخارجي** باستخدام رابط آمن لمرة واحدة يُرسل إلى بريدهم. راجع [بوابة المعتمد الخارجي](https://raptix.app/user-guide/ar/10-workflows/10-26-external-approver-portal/). ## أدلة ذات صلة - [مهامي: عرض المهام المسندة وتصفيتها وتنفيذها](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [شاشة قرارات الدفعة: الاعتمادات المجمعة على مستوى الصفوف وتصدير التدقيق](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/) - [الاعتمادات متعددة المستويات واعتمادات الدفعات: اعتماد لكل عنصر والقرارات على مستوى الصفوف](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) - [بوابة المعتمد الخارجي: اعتماد سير العمل من رابط بريد إلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-26-external-approver-portal/) - [تصميم خطوات المهمة: الإسناد والأولوية وأزرار الإجراءات ورفع المستندات](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) - [كل المثيلات: متابعة مثيلات سير العمل الجارية والمكتملة](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [عرض تفاصيل سير العمل: شفافية العملية والخط الزمني للاعتماد وسلسلة المحادثة](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/ # شاشة قرارات الدفعة: الاعتمادات المجمعة على مستوى الصفوف وتصدير التدقيق > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون النهائيون، بما فيهم المعتمدون والمديرون والمدققون ومالكو العمليات > > **ستتعلم:** كيف تقرأ شاشة قرارات الدفعة لفهم طريقة معالجة المكلّف لمجموعة بيانات اعتماد مجمعة، وتصفّي النتائج وترتبها، وتعرض محادثة كل صف، وتصدّر سجل القرارات الكامل للامتثال أو إعداد التقارير. ## ما هي؟ تعرض شاشة قرارات الدفعة السجل الكامل لعملية إرسال واحدة من اعتماد دفعة: كل صف بيانات قُدّم إلى المعتمد، والقرار الفردي الذي اتخذه بشأن كل صف، سواء اعتمادًا أو رفضًا أو تعليقًا أو إجراءً مخصصًا، وأي تعليق تركه لكل صف، والطابع الزمني لكل قرار. تصل إلى هذه الشاشة بعد أن يكمل المكلّف بالمهمة اعتماد دفعة على مستوى الصفوف في مدير مهام سير العمل. تتاح النتائج فورًا في جدول قابل للترتيب والتصفية، مع ملخص دائري يوضح توزيع القرارات. يمكنك البحث في جميع الأعمدة، والتصفية حسب نوع الإجراء، وإخفاء الأعمدة أو تثبيتها، وتصدير مجموعة البيانات كاملة إلى ملف CSV. هذه الشاشة للقراءة فقط؛ والغرض منها مراجعة نتائج إرسال دفعة مكتملة وتدقيقها، لا إعادة اتخاذ القرارات. ## أهميتها وفوائدها الرئيسية - **مساءلة كاملة لكل صف** — اعرف بالضبط أي عنصر اعتُمد أو رُفض أو عُلّق، ومن اتخذ القرار، مع طوابع زمنية يمكن الاستناد إليها قانونيًا في التدقيق. - **ملخص مرئي فوري** — يمنحك المخطط الدائري وبطاقات الإحصاءات أعلى الصفحة توزيعًا سريعًا للقرارات، مثل 150 معتمدًا و12 مرفوضًا و3 معلّقة، قبل الانتقال إلى بيانات الصفوف. - **التصفية حسب الإجراء** — انقر أي إجراء في مفتاح الرسم لتعرض في الجدول الصفوف المعتمدة وحدها أو المرفوضة وحدها وما إلى ذلك. - **البحث في كل الأعمدة** — اعثر على أي عنصر في مجموعة بيانات كبيرة خلال ثوان بكتابة قيمة في مربع البحث العام. - **محادثة لكل صف** — انقر أي تعليق في الجدول لفتح نافذة بأسلوب المحادثة تعرض التبادل الكامل للتعليقات عبر كل مستويات الاعتماد لذلك الصف. - **تصدير CSV بنقرة واحدة** — نزّل مجموعة البيانات المصفّاة أو الكاملة إلى ملف CSV لاستخدامها في جداول البيانات أو أنظمة الامتثال أو أرشيفات البيانات. - **تخطيط مرن للجدول** — غيّر أحجام الأعمدة، وثبّت المهمة منها إلى اليسار لتظل ظاهرة أثناء التمرير، وأخفِ الأعمدة التي لا تحتاج إليها. ## قبل أن تبدأ - تحتاج إلى الوصول إلى [كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) وإلى مثيل سير العمل المحدد الذي يتضمن اعتماد الدفعة المكتمل. - يجب أن يكون المكلّف قد أرسل الدفعة بالفعل. لا يُنشأ سجل قرار الدفعة إلا بعد نقره زر **إرسال (Submit)** النهائي في مدير مهام سير العمل. - قد تكون هذه الشاشة متاحة لكل من يستطيع عرض **كل المثيلات** أو مقصورة على المشرفين وأدوار محددة، بحسب صلاحيات مؤسستك. تواصل مع المشرف إذا تعذر عليك الوصول إليها. ## طريقة الاستخدام خطوة بخطوة ### الخطوة 1 — فتح شاشة قرارات الدفعة **من كل المثيلات:** 1. افتح **التطبيقات ← سير العمل ← كل المثيلات**. 2. اعثر على مثيل سير العمل الذي يحتوي على اعتماد الدفعة، باستخدام الجدول وترقيم صفحاته عند الحاجة. 3. انقر صف مثيل سير العمل لفتح **عرض تفاصيل سير العمل**؛ راجع [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/). 4. في الخط الزمني للاعتماد أو سجل الإجراءات في عرض التفاصيل، اعثر على خطوة اعتماد الدفعة وانقر **عرض قرار الدفعة (View Batch Decision)** أو رابط معرّف الدفعة. **من مدير مهام سير العمل مباشرة بعد الإرسال:** بعد أن يرسل المكلّف قرار دفعة، تعيد المنصة توجيهه إلى **كل المثيلات**. إذا ظهر رابط معرّف الدفعة في إشعار النجاح أو عرض تفاصيل سير العمل، فانقره للانتقال مباشرة إلى شاشة قرارات الدفعة لذلك الإرسال. ### الخطوة 2 — قراءة الرأس وبطاقات الملخص 5. يعرض الرأس أعلى الصفحة: - **معرّف الدفعة (Batch ID)** — المعرّف الفريد لإرسال هذه الدفعة، ويظهر على هيئة شريحة رمز. - **اسم سير العمل وعنوان المهمة** — لتحديد الخطوة التي تنتمي إليها الدفعة. - **عولجت بواسطة (Processed by)** — اسم الشخص الذي أرسل القرارات. - **عولجت في (Processed at)** — التاريخ والوقت الدقيقان لإرسال الدفعة. 6. تظهر أسفل الرأس أربع بطاقات ملخص إحصائية: | البطاقة | ما تعرضه | |---|---| | **إجمالي العناصر (Total Items)** | عدد الصفوف في هذه الدفعة. | | **نوع القرار (Decision Type)** | نوع القرار الأساسي، مثل «مختلط» إذا استُخدمت إجراءات عدة، أو «معتمد» إذا تلقت كل الصفوف الإجراء نفسه. | | **المخطط الدائري (Pie Chart)** | توزيع مرئي للقرارات بحسب الإجراء، مع قطاعات ملونة ومفتاح يعرض أسماء الإجراءات وأعدادها. | ### الخطوة 3 — تصفية النتائج والبحث فيها 7. يحتوي شريط **البحث وعوامل التصفية (Search & Filters)** على عنصرين: - **مربع البحث العام** — اكتب أي نص لتصفية الجدول فورًا إلى الصفوف التي يحتوي أي عمود فيها على ذلك النص. يفيد في العثور على اسم موظف أو معرّف أو قيمة محددة. - **قائمة الإجراء المنسدلة** — اختر إجراءً معينًا، مثل «مرفوض»، لعرض الصفوف التي تحمل ذلك القرار فقط. تسرد القائمة كل إجراء مع عدده. اختر **كل الإجراءات (All Actions)** لإزالة عامل التصفية. 8. يتحدث عدد الصفوف أثناء التصفية، وتظهر عبارة «عرض X من Y من العناصر» بجوار عناصر التحكم. > **النصيحة الاحترافية الظاهرة على الشاشة:** «اسحب حدود الأعمدة لتغيير الحجم • انقر الرؤوس للترتيب • ثبّت الأعمدة المهمة». ### الخطوة 4 — قراءة جدول البيانات 9. يعرض الجدول الرئيسي كل صفوف الدفعة مع الأعمدة المضمنة الآتية: | العمود | ما يعرضه | |---|---| | **#**، رقم الصف | رقم متسلسل للصف، مثبت إلى اليسار. | | **الإجراء (Action)** | القرار المتخذ لهذا الصف في شارة ملونة؛ أخضر للاعتماد، وأحمر للرفض، وأصفر للتعليق، وهكذا. | | **أعمدة البيانات الأصلية** | كل أعمدة البيانات من مجموعة المصدر، مثل اسم الموظف والقسم وتاريخ الحضور. تُنسّق أسماء الأعمدة تلقائيًا من البيانات. | | **التعليق (Comment)** | التعليق الذي تركه المعتمد لهذا الصف. إذا وجدت تعليقات عدة عبر مستويات الاعتماد، تعرض شارة فقاعة عددها. انقر خلية التعليق لعرض السلسلة كاملة. | | **أعمدة التاريخ** | تعرض قيم التاريخ رمز تقويم وتاريخًا ووقتًا منسقين. | 10. انقر رأس أي عمود لترتيب الجدول حسبه. انقر مرة أخرى لعكس اتجاه الترتيب. يشير رمز سهم إلى الترتيب النشط. 11. انقر صفًا لتمييزه، وهو أمر مفيد عند مقارنة صفوف متجاورة. انقره مرة أخرى لإلغاء التحديد. ### الخطوة 5 — إدارة الأعمدة 12. انقر رأس قسم **عناصر تحكم الأعمدة (Column Controls)** لتوسيع لوحة إدارة الأعمدة. يظهر كل عمود كوسم يتضمن: - مربع تحديد لإظهار العمود أو إخفائه؛ - رمز تثبيت لتثبيت العمود في الجانب الأيسر من الجدول أو إلغاء تثبيته. 13. **لإخفاء** عمود، أزل علامة مربع التحديد المجاور له. يختفي العمود فورًا من الجدول. 14. **لتثبيت** عمود، انقر رمز التثبيت المجاور له. تبقى الأعمدة المثبتة ثابتة إلى اليسار أثناء التمرير الأفقي. يتحول رمز التثبيت إلى الأزرق عند التثبيت. 15. **لإلغاء تثبيت** عمود، انقر رمز التثبيت الأزرق مرة أخرى. > يكون عمودا **#**، رقم الصف، و**الإجراء** مثبتين افتراضيًا. وقد تُثبّت أيضًا تلقائيًا الأعمدة التعريفية المهمة في بياناتك، إذا أمكن اكتشافها. ### الخطوة 6 — عرض محادثات التعليق لكل صف 16. إذا عرض صف في عمود **التعليق** رمز فقاعة دردشة زرقاء مع شارة رقم، مثل `3`، فهذا يعني أن للصف تعليقات عدة من مستويات اعتماد مختلفة. 17. انقر أي موضع في خلية التعليق لذلك الصف. تفتح نافذة حوار تعرض سلسلة التعليقات الكاملة للصف في شكل محادثة: - كل تعليق فقاعة منسوبة إلى المعتمد باسمه وشارة مستواه، مثل `L1` أو `L2`؛ - يظهر الإجراء المتخذ في ذلك المستوى كوسم صغير بجوار اسم المرسل؛ - تظهر تعليقات المستويات الفردية إلى اليسار والزوجية إلى اليمين؛ - تظهر الطوابع الزمنية أسفل كل فقاعة. 18. انقر **إغلاق (Close)** أو انقر خارج النافذة للعودة إلى الجدول. ### الخطوة 7 — التصدير إلى CSV 19. انقر زر **تصدير CSV (Export CSV)** في الركن العلوي الأيمن من منطقة الرأس. 20. ينشئ النظام ملف CSV يحتوي على كل الصفوف الظاهرة حاليًا، مع احترام أي عامل تصفية للإجراء أو بحث عام نشط. 21. يُنزّل الملف تلقائيًا إلى جهازك. يتبع اسم الملف النمط: `batch-decision-[batchId]-[date].csv`. > يُعطّل زر تصدير CSV ويظهر باللون الرمادي إذا لم توجد صفوف تطابق عامل التصفية الحالي. امسح عوامل التصفية لتمكينه. ## شرح الخيارات والإعدادات ### منطقة الرأس | العنصر | ما يعرضه أو يفعله | |---|---| | زر **العودة إلى لوحة المعلومات (Back to Dashboard)** | يعيدك إلى **كل المثيلات**. | | **شريحة رمز معرّف الدفعة** | المعرّف الفريد لإرسال الدفعة. انسخه عند التواصل مع الدعم أو للإحالات المتعلقة بالامتثال. | | **سير العمل والمهمة** | اسم سير العمل وعنوان المهمة اللذان تنتمي إليهما الدفعة. | | **عولجت بواسطة** | المستخدم الذي أرسل قرار الدفعة. | | **عولجت في** | تاريخ إرسال الدفعة ووقته. | | زر **تصدير CSV** | ينزّل الجدول المصفّى الحالي كملف CSV. | ### بطاقات الملخص | البطاقة | الوصف | |---|---| | **إجمالي العناصر** | عدد كل صفوف الدفعة بغض النظر عن عامل التصفية الحالي. | | **نوع القرار** | «مختلط» إذا استُخدمت أنواع إجراءات عدة؛ وإلا فاسم الإجراء الوحيد المطبق على كل الصفوف. | | **المخطط الدائري** | توزيع رسومي يوضح نسبة كل إجراء، مع تسمية كل قطاع باسم الإجراء والنسبة المئوية. | ### البحث وعوامل التصفية | عنصر التحكم | الوصف | |---|---| | **مربع البحث العام** | يبحث في كل الأعمدة الظاهرة في الوقت نفسه، ويحدّث الجدول آنيًا أثناء الكتابة. | | **قائمة عامل تصفية الإجراء** | تصفّي الجدول لعرض الصفوف ذات الإجراء المحدد فقط. تُملأ الخيارات من القرارات الفعلية في الدفعة، ويمسح **كل الإجراءات** عامل التصفية. | | **تسمية عدد الصفوف** | تعرض «عرض X من Y من العناصر» بناءً على عامل التصفية والبحث النشطين. | ### جدول البيانات | العنصر | الوصف | |---|---| | **رؤوس الأعمدة** | انقر للترتيب تصاعديًا أو تنازليًا. غيّر الحجم بسحب الحد الأيمن لأي رأس. | | **تمييز الصف** | انقر صفًا لتمييزه بالأزرق، ثم انقر مرة أخرى لإلغاء التحديد. | | **شارات الإجراءات** | شارة ملونة تعرض قرار كل صف. الأخضر للإكمال أو الاعتماد، والأحمر للرفض، والأصفر للتعليق، والأزرق للتعليق أو إجراء آخر. | | **خلية التعليق** | تعرض أحدث تعليق وإجمالي عدد التعليقات. انقر لفتح سلسلة المحادثة كاملة. | | **خلايا التاريخ** | تعرض رمز تقويم وتاريخًا ووقتًا محليين منسقين. | ### لوحة عناصر تحكم الأعمدة | عنصر التحكم | الوصف | |---|---| | **مربع تحديد العمود** | إظهار عمود أو إخفاؤه. | | **رمز التثبيت** | تثبيت العمود إلى الجانب الأيسر ليظل ظاهرًا أثناء التمرير الأفقي. الأزرق يعني أنه مثبت. | ### نافذة محادثة التعليقات | العنصر | الوصف | |---|---| | **شارة المستوى (`L1` و`L2`...)** | مستوى الاعتماد الذي ترك التعليق. | | **اسم المرسل** | الشخص الذي ترك التعليق. | | **وسم الإجراء** | الإجراء الذي اتخذه في ذلك المستوى، مثل «تم الاعتماد» أو «مرفوض». | | **الفقاعة** | نص التعليق. المحاذاة إلى اليسار للمستويات الفردية وإلى اليمين للزوجية. | | **الطابع الزمني** | وقت إرسال التعليق. | | **زر الإغلاق** | يعيدك إلى الجدول الرئيسي. | ## نصائح وأفضل الممارسات - **استخدم عامل تصفية الإجراء مباشرة** عندما تتلقى تقريرًا أو استفسارًا عن نوع قرار محدد. تعرض التصفية إلى «مرفوض» العناصر التي تحتاج إلى متابعة فقط. - **صدّر ملف CSV فور إكمال المستوى** واحفظه في نظام إدارة مستنداتك. إذا نشأ نزاع لاحقًا، يوفّر الملف سجلًا قابلًا للتقديم أمام القضاء لكل قرار. - **ثبّت أهم عمود تعريفي**، مثل «معرّف الموظف» أو «رقم الفاتورة»، بجانب عمود الإجراء حتى ترى المعرّف والقرار معًا دائمًا أثناء التمرير يمينًا. - **راجع محادثة كل صف** قبل تصعيد عنصر مرفوض. ربما شرح المعتمد السبب في تعليقه بالفعل، فلا تحتاج إلى طلب توضيح إضافي. - **استخدم تسمية عدد الصفوف** بعد التصفية للتحقق من عدد العناصر المرفوضة أو المعلّقة قبل التصعيد إلى الإدارة. تعني عبارة «عرض 12 من 165 عنصرًا» مع عامل تصفية المرفوض أن 12 عنصرًا من أصل 165 تحتاج إلى متابعة. - **رتّب حسب عمود الإجراء** لتجميع الاعتمادات والرفض، مما يسهّل المراجعة. - **عند تدقيق اعتماد متعدد المستويات،** افتح شاشة قرارات الدفعة لكل مستوى على حدة؛ إذ ينشئ كل مستوى معرّف دفعة مستقلًا، وقارن القرارات بين المستويات. ## الأسئلة الشائعة **س: هل يمكنني تغيير قرار أحد الصفوف من هذه الشاشة؟** لا. شاشة قرارات الدفعة للقراءة فقط. تُسجل القرارات وقت الإرسال ولا يمكن تعديلها هنا. إذا لزم تصحيح، فتواصل مع مشرف سير العمل؛ فقد يلزم تشغيل سير العمل مجددًا أو تصحيحه يدويًا. **س: لماذا يظهر زر تصدير CSV باللون الرمادي؟** يُعطل الزر عندما لا توجد صفوف تطابق عامل التصفية الحالي. فإذا اخترت مثلًا إجراء «تعليق» ولم يكن أي عنصر معلّقًا، فامسح عامل التصفية وحاول مجددًا. **س: أرى معرّف دفعة في عرض تفاصيل سير العمل، لكن النقر عليه يعرض خطأ. ما السبب؟** ربما لم يُحفظ سجل الدفعة بعد، كما لو كان الإرسال لا يزال قيد التنفيذ، أو ربما تلف معرّف الدفعة. حدّث الصفحة وحاول مجددًا. إذا استمر الخطأ، فتواصل مع المشرف وقدّم معرّف الدفعة للتحقق. **س: ما مدة الاحتفاظ بسجلات قرارات الدفعة؟** تُحفظ سجلات قرارات الدفعة في قاعدة بيانات سير العمل طوال مدة الاحتفاظ بمثيل سير العمل. لا تنتهي صلاحيتها تلقائيًا. ويتحكم المشرفون في الاحتفاظ بالبيانات على مستوى المؤسسة. **س: لا أرى كل أعمدة البيانات التي توقعتها. لماذا؟** يُخفي الجدول تلقائيًا الأعمدة التي: أ) تُعد معرّفات داخلية، أو ب) تنتمي إلى مستوى اعتماد مختلف عن المستوى المعروض، أو ج) أصبحت مكررة بعد التطبيع. افتح لوحة عناصر تحكم الأعمدة لمراجعة قائمة الأعمدة المخفية وإظهار ما يلزم لمراجعتك. **س: هل يمكنني مشاركة رابط هذه الشاشة مع زميل؟** نعم. يحتوي عنوان URL على معرّف الدفعة، ولذلك يتيح نسخ الرابط ومشاركته لأي زميل يملك صلاحيات كافية عرض الدفعة نفسها. وسيلزمه تسجيل الدخول إلى المنصة للوصول إليها. **س: كيف يُنشأ المخطط الدائري؟** يستخدم المخطط بيانات `actions_summary` التي تعيدها المنصة لهذه الدفعة؛ ويعرض عدد كل إجراء ونسبته باستخدام اللون المعدّ للإجراء. وإذا تلقت كل الصفوف الإجراء نفسه، يظهر المخطط دائرة كاملة بقطاع واحد. ## أدلة ذات صلة - [الاعتمادات متعددة المستويات واعتمادات الدفعات: اعتماد لكل عنصر والقرارات على مستوى الصفوف](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) - [مدير مهام سير العمل: مراجعة المستندات واتخاذ القرارات](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [كل المثيلات: متابعة مثيلات سير العمل الجارية والمكتملة](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [عرض تفاصيل سير العمل: شفافية العملية والخط الزمني للاعتماد وسلسلة المحادثة](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [تصميم خطوات المهمة: الإسناد والأولوية وأزرار الإجراءات ورفع المستندات](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-26-external-approver-portal/ # بوابة المعتمد الخارجي: اعتماد سير العمل من رابط بريد إلكتروني من دون تسجيل دخول > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون الخارجيون، مثل المتعاقدين والموردين وأي طرف ثالث يتلقى رسالة إجراء لسير العمل ولا يملك حساب RAPTIX > > **ستتعلم:** كيف تفهم الرابط الذي وصلك بالبريد وتستخدمه لمراجعة معلومات سير العمل والمستندات المرفقة، وإضافة تعليق ورفع ملفات اختياريًا، وتأكيد قرارك؛ وكل ذلك من دون إنشاء حساب أو تسجيل الدخول. ## ما هي؟ بوابة المعتمد الخارجي صفحة مستقلة خاصة تتيح لأي شخص من خارج مؤسستك المشاركة في قرار ضمن سير العمل. عندما يصل سير العمل إلى خطوة مهمة مسندة إلى طرف خارجي، كمتعاقد أو مورد أو مدقق أو عميل، يرسل النظام إليه تلقائيًا رسالة مخصصة تحتوي على رابط آمن. يؤدي النقر على الرابط إلى فتح البوابة مباشرة، من دون الحاجة إلى اسم مستخدم أو كلمة مرور أو حساب RAPTIX. تعرض البوابة تفاصيل المهمة وأي مستندات مرفقة بالطلب وحقلًا لإضافة تعليق والإجراء الذي يخوّل الرابط تنفيذه، مثل الاعتماد أو الرفض. ويمكن أن تتضمن المهمة أيضًا **نموذج مهمة (Task Form)** بحقوق نصية أو اختيارات أو مربعات تحديد أو تواريخ أو ملفات مطلوبة. في هذه الحالة، يؤدي تأكيد الإجراء المخوّل إلى التحقق من النموذج وإرساله وتوجيه سير العمل؛ ولا يوجد زر إرسال منفصل. ## أهميتها وفوائدها الرئيسية - **إشراك الشركاء الخارجيين في الاعتمادات من دون منحهم حسابًا في النظام** — يمكن للمتعاقدين والموردين والمدققين والعملاء المشاركة في قرارات منظمة من دون رؤية شاشة تسجيل الدخول إلى المنصة. - **الرابط هو كل ما يحتاجون إليه** — يعمل رابط الإجراء في أي متصفح وعلى أي جهاز، بما فيه الهاتف. لا يوجد تطبيق مطلوب تثبيته ولا حساب مطلوب إنشاؤه. - **مراجعة المستندات قبل القرار** — إذا أُرفقت بالطلب ملفات، مثل العقود أو المواصفات أو التقارير، تعرض البوابة عارض PDF كاملًا ومضمّنًا ليقرأ المعتمد الخارجي المستند من دون تنزيله. - **رابط آمن للاستخدام مرة واحدة** — كل رابط محمي بالتشفير وتنتهي صلاحيته بعد استخدامه، ولذلك لا يمكن لطرف غير مخوّل الاستفادة من رابط مسرّب أو معاد توجيهه بعد التنفيذ. - **حماية تلقائية من البرامج الآلية والنقرات العرضية** — يبدأ عد تنازلي لخمس ثوانٍ قبل تفعيل زر التأكيد، لمنع الإرسال العرضي أو الآلي. - **سجل تدقيق مقاوم للتلاعب** — يُسجّل القرار في مثيل سير العمل مع طابع زمني، ولا يمكن استخدام البوابة أكثر من مرة للإجراء نفسه. - **رفع اختياري للمستندات** — يستطيع مصمم سير العمل إعداد البوابة لقبول ملفات داعمة من المعتمد الخارجي، ليرسل نسخًا موقّعة أو أدلة كجزء من قراره. ## قبل أن تبدأ - لا تحتاج إلى حساب RAPTIX؛ فالرابط الموجود في رسالتك هو كل ما تحتاج إليه. - افتح الرابط في متصفح حديث، مثل Chrome أو Edge أو Firefox أو Safari، على حاسوب أو جهاز لوحي أو هاتف. - تأكد من اتصالك بالإنترنت. - الرابط شخصي؛ إذ أُنشئ خصيصًا لك ولهذه المهمة. لا تشاركه مع الآخرين، لأن استخدام شخص آخر له وإرسال إجراء سيُسجّل القرار باسمك. ## طريقة الاستخدام خطوة بخطوة ### استلام الرابط وفتحه 1. افتح الرسالة التي أرسلتها إليك المؤسسة التي تستخدم RAPTIX. تصف الرسالة المهمة وتتضمن تفاصيل أساسية عن الطلب وزرًا أو رابطًا بارزًا باسم الإجراء، مثل **اعتماد (Approve)** أو **مراجعة (Review)** أو **تأكيد (Confirm)**. 2. انقر الزر أو الرابط. يفتح متصفحك بوابة المعتمد الخارجي، من دون ظهور صفحة تسجيل دخول. ### العد التنازلي للأمان 3. يظهر عد تنازلي قصير مدته 5 ثوانٍ أسفل لوحة القرار، مع رسالة مثل **التحقق الأمني — يرجى الانتظار قبل التأكيد** ورقم تنازلي كبير بلون كهرماني. يمنع هذا العد البرامج الآلية والنقرات العرضية من إرسال الإجراء. انتظر حتى يصل العداد إلى الصفر. 4. عند انتهاء العد، تتحول اللوحة إلى شريط تأكيد أخضر يعرض **تم التحقق من الهوية — يمكنك المتابعة**، ويصبح زر الإجراء نشطًا بالكامل. ### قراءة معلومات المهمة 5. تعرض لوحة **المهمة (Task)** أعلى منطقة القرار: - **عنوان المهمة** — اسم خطوة الاعتماد، مثل «مراجعة عقد مورد» أو «اعتماد متعاقد». - **مسندة إلى** — عنوان البريد الإلكتروني الذي أُرسلت إليه المهمة، أي بريدك. 6. إذا احتوى نموذج الطلب على بيانات علّمها مصمم سير العمل لإظهارها خارجيًا، تظهر لوحة **بيانات سير العمل (Workflow Data)** القابلة للطي أسفل عنوان المهمة. تعرض كل حقل وقيمته من الإرسال الأصلي، مثل اسم المشروع والمبلغ والتواريخ واسم مقدم الطلب. انقر رأس **بيانات سير العمل** لتوسيعها، واستخدم مربع **البحث (Search)** داخلها للوصول سريعًا إلى حقل محدد. ### مراجعة المستندات المرفقة 7. إذا أُرفقت مستندات، مثل العقود أو الرسومات أو التقارير، تظهر تلقائيًا في **عارض PDF** في الجانب الأيسر من الشاشة على سطح المكتب، أو كطبقة بملء الشاشة على الهاتف. 8. إذا وُجد أكثر من مستند، تظهر أزرار علامات تبويب أعلى العارض تحمل أسماء الملفات. انقر كل علامة للتنقل بين المستندات. 9. استخدم عناصر التحكم المضمنة في عارض PDF من أجل: - التنقل بين الصفحات، باستخدام أزرار الأسهم أو إدخال رقم الصفحة؛ - التكبير والتصغير؛ - استخدام أدوات التعليق التوضيحي، مثل الأختام والنص والرسم الحر، إذا أردت وضع علامات على المستند. تُضمّن أي علامات تضيفها عند إرسال قرارك. ### إضافة تعليق مطلوب أو اختياري 10. إذا كانت خطوة سير العمل تتطلب تعليقًا قبل التأكيد، يظهر حقل **التعليق (Comment)** وعليه نجمة حمراء (**\***). اكتب ردك أو سببك أو ملاحظاتك في منطقة النص. إذا كان حقل التعليق موجودًا لكن غير معلّم بأنه مطلوب، فيمكنك ترك تعليق اختياريًا. يُنصح بذلك لزيادة الوضوح، خصوصًا في قرارات الرفض أو التعليق. ### رفع مستندات داعمة عند طلبها 11. إذا طلبت منك خطوة سير العمل رفع ملفات، يظهر قسم **المستندات المطلوبة (Required Documents)** ويسرد حقل رفع واحدًا أو أكثر، يحمل كل منها اسم مستند، مثل «الاتفاقية الموقّعة» أو «إثبات الامتثال». | المؤشر | المعنى | |---|---| | شارة **مطلوب (Required)** الحمراء | يجب رفع ملف إلى هذا الحقل قبل التأكيد. | | نص **الحد الأقصى N ميغابايت (Max N MB)** | أكبر حجم ملف مسموح به لهذا الحقل. | | منطقة **انقر لاختيار ملف أو ملفات (Click to select file(s))** | منطقة رفع ذات حد متقطع. انقرها لفتح منتقي الملفات. | 12. انقر منطقة الرفع لكل حقل، واختر الملف أو الملفات من جهازك. يعرض الحقل اسم الملف بعد اختياره. لإزالة ملف، انقر **×** بجوار اسمه. ### تأكيد قرارك 13. تحقق مما يأتي: - انتهى العد التنازلي للأمان، ويظهر شريط «تم التحقق من الهوية» الأخضر؛ - أضفت تعليقًا إذا كان مطلوبًا؛ - رفعت كل المستندات المطلوبة. 14. انقر زر **تأكيد [اسم الإجراء] (Confirm [Action Name])**. تتضمن تسمية الزر رمزًا تعبيريًا واسم الإجراء، مثل **✅ تأكيد الاعتماد** أو **❌ تأكيد الرفض**. 15. عند النجاح، تنتقل الصفحة إلى شاشة تأكيد بعلامة اختيار خضراء ورسالة **اكتمل الإجراء! تم تسجيل ردك بنجاح. ستُغلق هذه النافذة تلقائيًا.** يغلق المتصفح علامة التبويب تلقائيًا بعد بضع ثوانٍ. إذا لم تُغلق وحدها لأن بعض المتصفحات تمنع ذلك، فيمكنك إغلاقها يدويًا. ### إذا سبق استخدام الرابط إذا كنت أنت أو شخص آخر قد أرسل إجراءً بهذا الرابط، فإن فتحه مجددًا يعرض شاشة ذهبية برسالة **تمت المعالجة بالفعل — اكتملت هذه المهمة بإجراء سابق. لا يلزم رد إضافي.** هذا سلوك متوقع ويعني أن قرارك السابق سُجل بصورة صحيحة. لا يمكنك الإرسال مجددًا بالرابط نفسه. ### إذا انتهت صلاحية الرابط أو كان غير صالح إذا نُسخ الرابط بطريقة غير صحيحة، أو انتهت صلاحيته، أو احتوى على خطأ، تظهر شاشة حمراء: **خطأ في الرابط — ربما انتهت صلاحية هذا الرابط أو سبق استخدامه.** تواصل مع الشخص الذي أرسل الطلب للحصول على رابط جديد عند الحاجة. ## شرح الخيارات والإعدادات | العنصر | ما يفعله | |---|---| | لوحة معلومات **المهمة** | تعرض عنوان المهمة وعنوان البريد الذي أُرسل إليه الرابط. وهي للقراءة فقط. | | لوحة **بيانات سير العمل** القابلة للطي | تعرض حقول الإرسال الأصلي. انقر الرأس للتوسيع أو الطي، واستخدم مربع البحث لتصفية الحقول. | | **عارض PDF** عند وجود مستندات | يعرض المستندات المرفقة مع تنقل كامل بين الصفحات وتكبير وأدوات تعليق اختيارية. تظهر علامات تبويب عند وجود عدة ملفات. | | **علامات تبويب المستندات** | التنقل بين الملفات المرفقة. تبرز علامة التبويب النشطة باللون الأزرق. | | حقل **التعليق** | يكون مطلوبًا أو اختياريًا حسب إعداد سير العمل. أدخل ملاحظاتك أو سبب القرار. | | منطقة رفع **المستندات المطلوبة** | ارفع ملفًا أو أكثر لكل حقل مدرج. يجب أن يحتوي الحقل المطلوب على ملف قبل تفعيل زر التأكيد. | | **العد التنازلي للأمان** | مؤقت مدته 5 ثوانٍ يمنع الإرسال العرضي أو الآلي. يظل زر التأكيد معطلًا حتى ينتهي. | | شريط **تم التحقق من الهوية** | تأكيد أخضر على انتهاء العد وإمكانية المتابعة. | | زر **تأكيد [اسم الإجراء]** | يرسل قرارك. يكون معطلًا ورماديًا حتى استيفاء كل المتطلبات، وينشط بعد انتهاء العد وتعبئة التعليق المطلوب وإكمال الملفات المطلوبة. | | **رمز الإجراء التعبيري** | إشارة مرئية لنوع الإجراء: ✅ للاعتماد أو القبول أو الإكمال، و❌ للرفض، و⏸️ للتعليق أو الإيقاف المؤقت، و⬆️ للتصعيد. | ## نصائح وأفضل الممارسات - **اقرأ بيانات سير العمل بعناية** قبل النقر على التأكيد، خصوصًا لطلبات الاعتماد التي تتضمن مبالغ أو تواريخ أو كميات؛ فهذه البيانات آتية مباشرة من الإرسال الأصلي وهي ما تعتمده. - **استخدم أدوات التعليق في عارض PDF** إذا أردت وضع علامات على المستند، كالإشارة إلى بنود توافق عليها أو مواضع قلق. تُلتقط تعليقاتك وتُحفظ تلقائيًا عند الإرسال. - **لا تشارك رابطك**؛ فهو فريد لك. إذا استخدمه شخص آخر، سيسجّل القرار باسمك. إذا اعتقدت أن الرابط انكشف، فأبلغ المؤسسة الطالبة فورًا. - **اترك تعليقًا حتى عندما لا يكون مطلوبًا**؛ فالشرح المختصر يساعد المؤسسة الطالبة على فهم قرارك، خصوصًا للرفض أو التعليق. - **إذا احتجت إلى مراجعة المستندات على شاشة أكبر،** فانسخ الرابط من الرسالة وافتحه في متصفح سطح مكتب؛ إذ يكون التخطيط ثنائي الأعمدة وعراض PDF الكامل أسهل قراءة على شاشة كبيرة من الهاتف. - **إذا كان قرارك حساسًا للوقت،** فتحقق من وجود موعد نهائي مذكور في الرسالة. لا تعرض البوابة موعدًا نهائيًا، لكن ربما أعدّت المؤسسة الطالبة تصعيدًا أو انتهاء صلاحية تلقائيًا من طرفها. ## الأسئلة الشائعة **س: هل أحتاج إلى إنشاء حساب أو تثبيت أي شيء؟** لا. يعمل الرابط في أي متصفح حديث. لا تحتاج إلى حساب RAPTIX ولا إلى تثبيت تطبيق. **س: كيف أعرف أن الرابط شرعي وآمن؟** يأتي الرابط من نطاق البريد الإلكتروني للمؤسسة التي أرسلت الطلب، ويطابق عنوان البوابة نطاق تثبيت RAPTIX الخاص بها. إذا ساورك شك، فتواصل مع المؤسسة الطالبة عبر قناة مستقلة، كالهاتف أو عنوان بريد معروف، للتحقق قبل النقر. **س: انتهى العد التنازلي لكن زر التأكيد لا يزال رماديًا. لماذا؟** تحقق مما إذا كان هناك حقل تعليق مطلوب بعلامة نجمة حمراء لم تعبئه، أو حقل رفع مستندات مطلوب لا يزال بلا ملفات. يجب إكمال كل الحقول المطلوبة قبل أن ينشط الزر. **س: هل يمكنني حفظ تقدمي والعودة لاحقًا؟** لا. البوابة صفحة لإجراء واحد. يجب إكمال المراجعة وتأكيد الإجراء في جلسة واحدة. إذا أغلقت المتصفح قبل التأكيد، تبقى المهمة معلّقة ويمكنك استخدام الرابط نفسه مجددًا حتى يُستخدم أو تنتهي صلاحيته. **س: أكدت القرار الخطأ دون قصد. هل يمكنني التراجع؟** بعد التأكيد، يُسجل القرار في سير العمل ولا يمكن التراجع عنه عبر البوابة. تواصل فورًا مع المؤسسة التي أرسلت الرابط؛ فقد تتمكن من التدخل أو إعادة توجيه سير العمل من شاشة الإدارة. **س: تعرض الصفحة «تمت المعالجة بالفعل» رغم أنني لم أنفذ إجراءً. ماذا حدث؟** ربما استخدم شخص آخر الرابط نفسه، أو اكتملت المهمة بطريقة أخرى، كأن يكون لدى معتمد داخلي صلاحية وصول أيضًا ونفذ الإجراء أولًا. تواصل مع المؤسسة الطالبة للتوضيح. **س: هل يمكنني التعليق على PDF، وهل تُحفظ هذه التعليقات؟** نعم. إذا رسمت أو أضفت ختمًا أو كتبت على PDF في العارض، تُلتقط هذه التعليقات وتُحفظ كإصدار جديد من المستند عند إرسال قرارك. يبقى المستند الأصلي محفوظًا، وتصبح نسختك المشروحة ملفًا مستقلًا في سجل سير العمل. **س: ماذا يحدث بعد النقر على التأكيد؟** يُسجل قرارك في سير العمل، ويتقدم المحرك فورًا إلى الخطوة التالية؛ فقد يرسل رسالة إلى معتمد آخر، أو إشعارًا لمقدم الطلب، أو يكمل سير العمل بالكامل. سترى شاشة النجاح، ثم تُغلق علامة التبويب تلقائيًا. ## أدلة ذات صلة - [نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) - [مهامي: عرض المهام المسندة وتصفيتها وتنفيذها](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [مدير مهام سير العمل: مراجعة المستندات واتخاذ القرارات](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [عرض تفاصيل سير العمل: شفافية العملية والخط الزمني للاعتماد وسلسلة المحادثة](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [تصميم خطوات المهمة: الإسناد والأولوية وأزرار الإجراءات ورفع المستندات](https://raptix.app/user-guide/ar/10-workflows/10-5-task-steps/) - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-19-version-history-autosave/ # سجل الإصدارات والحفظ التلقائي: كيف تُحمى كل تغييراتك > **الوحدة:** مسارات سير العمل > > **الجمهور:** المستخدمون النهائيون ومصممو سير العمل > > **ستتعلم:** كيف تحفظ مسارات سير العمل عملك تلقائيًا أثناء التصميم، وكيف تفتح لوحة سجل الإصدارات، وتميز الحفظ التلقائي من اليدوي، وتعيد سير العمل إلى أي إصدار سابق بنقرة واحدة. ## ما هو؟ كلما عملت في المصمم المرئي لمسارات سير العمل، تحمي تغييراتك آليتان متكاملتان: **الحفظ التلقائي** و**الحفظ اليدوي**. يلتقط الحفظ التلقائي بصمت لقطة من اللوحة كل 30 ثانية عند وجود تغييرات غير محفوظة. وينشئ الحفظ اليدوي باستخدام **Ctrl+S** أو زر الحفظ نقطة استعادة تتحكم فيها، وهو مفيد لتحديد مرحلة مهمة. تُسجّل كل لقطة، تلقائية أو يدوية، كإصدار مرقم يحمل اسم المؤلف وطابعًا زمنيًا وتسمية للنوع. يمكنك عرض كل الإصدارات في لوحة **سجل الإصدارات (Version History)** واستعادة اللوحة إلى أي حالة سابقة بنقرة واحدة. ## أهميته وفوائده الرئيسية - **العمل باطمئنان:** لا تحتاج إلى تذكر الحفظ؛ تُلتقط التغييرات تلقائيًا لتتفرغ لتصميم العملية. - **التعافي من أي خطأ:** هل حذفت عقدة دون قصد أو مسحت اللوحة؟ عد إلى إصدار قبل 30 ثانية أو ساعتين أو أسبوعين؛ إذ يُحتفظ بكل إصدار. - **معرفة من غيّر وماذا ومتى:** يسجل كل إصدار المؤلف والطابع الزمني، مما يسهّل فهم تاريخ تصميم سير العمل. - **تمييز العمل الاستكشافي من المحطات المهمة:** تحمل عمليات الحفظ التلقائي تسمية واضحة، كما تحمل عمليات الحفظ المقصودة بـCtrl+S تسمية نقاط حفظ يدوية، لتجد الحالات المهمة سريعًا. - **التراجع والإعادة عبر لقطات محفوظة حقيقية:** يتنقل زرا التراجع والإعادة في قائمة الإصدارات، لذلك تنتقل دائمًا بين حالات حقيقية محفوظة على الخادم، لا سجل في الذاكرة يختفي بتحديث الصفحة. - **لا يُحذف أي إصدار:** يتراكم السجل الكامل بلا أجل محدد، ويمكنك العودة حتى بعد أشهر. ## قبل أن تبدأ - يجب أن تكون في وضع **التحرير**، لا العرض، داخل المصمم المرئي لاستخدام عناصر الحفظ. - يتوفر سجل الإصدارات لكل سير عمل من داخل المصمم، ويجب فتح سير العمل لرؤية سجله. - يتاح الحفظ التلقائي واليدوي لكل مستخدم يملك صلاحية تحرير مسارات سير العمل. تنشئ الاستعادة إصدارًا جديدًا، ولا تستبدل السجل. ## طريقة الاستخدام خطوة بخطوة ### التحقق من حالة الحفظ لوحة **الحفظ التلقائي (Auto-Save)** لوحة عائمة صغيرة في **الركن العلوي الأيمن** من لوحة المصمم، وتظل ظاهرة أثناء عملك على سير العمل. 1. انظر إلى الركن العلوي الأيمن من لوحة المصمم. تعرض لوحة الحالة إحدى الحالات الآتية: | مؤشر الحالة | معناه | |---|---| | نقطة برتقالية نابضة مع **تغييرات غير محفوظة (Unsaved changes)** | أجريت تغييرات منذ آخر حفظ. سيلتقطها الحفظ التلقائي خلال 30 ثانية. | | دائرة دوارة مع **جارٍ الحفظ… (Saving…)** | عملية حفظ، تلقائية أو يدوية، قيد التنفيذ. | | علامة اختيار خضراء مع **تم الحفظ! (Saved!)** | اكتمل أحدث حفظ بنجاح. تختفي بعد ثانيتين. | | علامة × حمراء مع **فشل الحفظ (Save failed)** | واجهت آخر محاولة حفظ خطأ. حاول الحفظ يدويًا باستخدام Ctrl+S. | | رمز ساعة مع **حُفظ منذ X (Saved X ago)** | لا توجد تغييرات غير محفوظة، ويعرض الزمن منذ آخر حفظ. | | رمز فرع مع **لا تغييرات (No changes)** | فُتح سير العمل للتو ولم يُجر أي تعديل بعد. | تظهر أيضًا شارة إصدار ذهبية، مثل `v7`، لتوضح رقم الإصدار الحالي. ### الحفظ يدويًا 2. للحفظ في أي وقت، اضغط **Ctrl+S** في Windows أو Linux، أو **Cmd+S** في Mac، أو انقر **الحفظ الآن (Save Now)** في لوحة الحفظ التلقائي. تعرض الحالة **جارٍ الحفظ…** للحظات، ثم تنتقل إلى **تم الحفظ!** مع علامة خضراء. ويزداد عداد الإصدار واحدًا. تُسجّل عمليات الحفظ اليدوي في سجل الإصدارات بنوع **manual** في شارة خضراء، لتتعرف عليها بسهولة كنقاط استعادة مقصودة. ### التحكم في الحفظ التلقائي 3. اعثر على مفتاح **الحفظ التلقائي (30 ثانية) (Auto-save 30s)** أسفل لوحة الحفظ التلقائي. - **أخضر، مفعّل:** الحفظ التلقائي نشط. إذا وجدت تغييرات غير محفوظة، تُلتقط لقطة كل 30 ثانية. - **رمادي، متوقف:** الحفظ التلقائي معطل، ولا تُلتقط إلا عمليات الحفظ اليدوية بـCtrl+S. 4. انقر المفتاح لتفعيل الحفظ التلقائي أو إيقافه. يسري تفضيلك على جلسة التصميم الحالية فقط، ويعود الحفظ التلقائي مفعّلًا في المرة التالية التي تفتح فيها المصمم. **التوصية:** اترك الحفظ التلقائي مفعّلًا؛ فهو الخيار الأكثر أمانًا ولا يؤثر في أداء التصميم. ### فتح سجل الإصدارات 5. انقر زر **السجل (History)**، رمز الساعة أو السجل مع سهم، في لوحة الحفظ التلقائي. تتوسع لوحة **سجل الإصدارات** أسفل لوحة الحالة، وتعرض قائمة قابلة للتمرير بكل الإصدارات المحفوظة لسير العمل. 6. يعرض كل إدخال إصدار في القائمة: | الحقل | ما يخبرك به | |---|---| | **رقم الإصدار** بالذهبي والعريض، مثل `v12` | الرقم المتسلسل للإصدار؛ الأرقام الأعلى أحدث. | | **شارة النوع** | `auto-save` رمادية للحفظ التلقائي، وخضراء للحفظ اليدوي. | | **شارة الحالي (Current)** الذهبية | تظهر فقط على الإصدار المحمّل حاليًا في اللوحة. | | **ملخص التغيير** | وصف قصير: **تغييرات محفوظة تلقائيًا (Auto-saved changes)** أو **حفظ يدوي (Manual save)**. | | **المؤلف (Author)** | اسم مستخدم الشخص الذي أطلق الحفظ. | | **المدة الماضية (Time ago)** | المدة منذ حفظ الإصدار، مثل `3m ago` أو `2h ago` أو `5d ago`. | | **زر الاستعادة (Revert)** | يظهر على كل إصدار عدا الحالي؛ انقره لاستعادة ذلك الإصدار. | 7. لإغلاق لوحة سجل الإصدارات، انقر زر السجل مجددًا؛ فيطويها السهم. ### الاستعادة إلى إصدار سابق 8. اعثر في لوحة سجل الإصدارات على الإصدار المراد استعادته. القائمة مرتبة من الأحدث إلى الأقدم. 9. انقر زر **استعادة (Revert)**، رمز سهم عكس عقارب الساعة، على الإصدار المطلوب. يظهر مربع تأكيد: > «هل أنت متأكد من أنك تريد الاستعادة إلى الإصدار [N]؟» 10. انقر **موافق (OK)** للتأكيد. تتحدث اللوحة فورًا لتعرض سير العمل كما كان في ذلك الإصدار. ويُنشأ إدخال إصدار جديد تلقائيًا، إذ تُسجّل عملية الاستعادة نفسها كإصدار جديد؛ وبذلك يظل السجل تراكميًا ولا يُحذف أي إصدار. ### التنقل بين الإصدارات بالتراجع والإعادة زرا **التراجع (Undo)** و**الإعادة (Redo)** في شريط الأدوات واعيان بالإصدارات؛ فهما يتنقلان في قائمة الإصدارات بدلًا من إجراءات بسيطة محفوظة في الذاكرة. 11. للرجوع عبر الإصدارات، انقر **التراجع**، رمز السهم عكس عقارب الساعة، أو اضغط **Ctrl+Z**. يحمّل ذلك الإصدار السابق مباشرة. تتحدث اللوحة وتنخفض شارة رقم الإصدار. 12. للتقدم مجددًا، انقر **الإعادة**، رمز السهم مع عقارب الساعة، أو اضغط **Ctrl+Shift+Z**. يحمّل ذلك الإصدار الأحدث التالي. يكون زر الإعادة معطلًا ورماديًا إذا كنت على أحدث إصدار. 13. يكون زر التراجع معطلًا عند أقدم إصدار متاح، والإعادة معطلة عند أحدث إصدار. لأن التراجع والإعادة يعملان على لقطات حقيقية محفوظة على الخادم، يواصلان العمل بصورة صحيحة حتى بعد إغلاق المتصفح وفتحه من جديد؛ ولا يمسحهما تحديث الصفحة. ## شرح الخيارات والإعدادات ### أنواع الإصدارات | النوع | نمط التسمية | أنشأه | الوصف | |---|---|---|---| | **حفظ تلقائي (Auto-save)** | شارة رمادية | النظام، كل 30 ثانية عند وجود تغييرات | حماية مستمرة؛ يحمل تسمية **تغييرات محفوظة تلقائيًا**. | | **حفظ يدوي (Manual save)** | شارة خضراء | المستخدم، عبر Ctrl+S أو الحفظ الآن | نقاط استعادة مقصودة؛ تحمل تسمية **حفظ يدوي**. | | **استعادة (Revert)** | شارة خضراء | المستخدم، عبر زر الاستعادة في السجل | تسجل تنفيذ استعادة؛ وتحمل تسمية بإجراء الاستعادة. | ### عناصر تحكم لوحة الحفظ التلقائي | عنصر التحكم | ما يفعله | |---|---| | **مؤشر الحالة** | يعرض حالة الحفظ الحالية: غير محفوظ، أو جارٍ الحفظ، أو محفوظ، أو خطأ، أو زمن آخر حفظ. | | **شارة الإصدار**، مثل `v7` | تعرض رقم الإصدار المحمّل حاليًا في اللوحة. | | **الحفظ الآن**، زر ذهبي مصمت | يطلق حفظًا يدويًا فوريًا. | | **مفتاح السجل**، رمز وسهم | يوسع لوحة سجل الإصدارات أسفل بطاقة الحالة أو يطويها. | | **مفتاح الحفظ التلقائي (30 ثانية)** | يمكّن دورة الحفظ التلقائي كل 30 ثانية أو يعطّلها. | | **زر الإغلاق**، `X` | يخفي لوحة الحفظ التلقائي كاملة من العرض. | ### عناصر تحكم لوحة سجل الإصدارات | عنصر التحكم | ما يفعله | |---|---| | **قائمة الإصدارات** | قائمة قابلة للتمرير مرتبة من الأحدث إلى الأقدم بكل الإصدارات المحفوظة. | | **شارة الحالي** | شارة زرقاء على الإصدار المحمّل حاليًا في اللوحة. | | **زر الاستعادة** | يعيد اللوحة إلى ذلك الإصدار ويسجل إصدارًا جديدًا في السجل. | | **لا يوجد سجل إصدارات بعد**، الحالة الفارغة | تظهر عندما لم يُحفظ سير العمل من قبل. | ## نصائح وأفضل الممارسات - **اضغط Ctrl+S عند المحطات المهمة.** يحميك الحفظ التلقائي، لكن الضغط بعد إكمال قسم منطقي، ككل عُقد المهام أو فروع الشروط، ينشئ نقطة **حفظ يدوي** خضراء يسهل التعرف عليها واستعادتها. - **اقرأ قائمة الإصدارات لفهم السجل.** إذا عدّل زميل سير العمل، يمكنك رؤية عمليات حفظه التلقائية واليدوية وفهم ما تغير ومتى. - **لا تعطل الحفظ التلقائي خلال جلسات التصميم الطويلة.** لا يكلّف أداءً ويحميك من تعطل المتصفح أو مغادرة الصفحة بالخطأ. - **تنشئ الاستعادة دائمًا إصدارًا جديدًا ولا تدمر القديم.** لا مخاطرة في تجربتها؛ فإذا لم تعجبك الحالة المستعادة، يمكنك استعادة الإصدار الذي كنت عليه، أو الضغط على Ctrl+S لحفظ إصدار جديد من الحالة المستعادة. - **يمكن إبقاء لوحة سجل الإصدارات مفتوحة أثناء التصميم.** تتحدث آنيًا عند وقوع عمليات الحفظ، فتستطيع مراقبة عداد الإصدارات أثناء العمل. ## الأسئلة الشائعة **س: يظهر الحفظ التلقائي «تغييرات محفوظة تلقائيًا» كل 30 ثانية. هل يمكن زيادة الفاصل؟** الفاصل الثابت 30 ثانية ولا يمكن تغييره من الواجهة. إذا وجدت الحفظ المتكرر مشتتًا، فيمكنك إيقافه من مفتاح اللوحة والاعتماد على Ctrl+S؛ لكن تذكر الحفظ بانتظام. **س: أغلقت المتصفح دون قصد أثناء التحرير. هل فقدت عملي؟** على الأرجح لا. إذا كان الحفظ التلقائي مفعّلًا افتراضيًا، فقد نُفّذ آخر حفظ خلال 30 ثانية. افتح سير العمل في وضع التحرير، وراجع سجل الإصدارات، وابحث عن أحدث إدخال؛ ستجد عملك هناك. **س: كم إصدارًا يحتفظ به النظام؟ وهل يحذف الإصدارات القديمة؟** يُحتفظ بكل إصدار إلى أجل غير محدد، بلا تنظيف تلقائي أو حد. تتراكم الإصدارات القديمة طوال عمر سير العمل. **س: هل يمكنني إضافة وصف إلى حفظ يدوي لأعرف محتوى نقطة الاستعادة؟** تحمل عمليات الحفظ اليدوي حاليًا تسمية **حفظ يدوي** فقط. لإضافة سياق، غيّر عنوان سير العمل ليعكس الحالة الحالية قبل الحفظ، أو دوّن رقم الإصدار في مستند للفريق. قد تضيف تحديثات مستقبلية حقلًا لوصف الحفظ. **س: استعاد زميل إصدارًا قديمًا بالخطأ. هل يمكننا التراجع عن ذلك؟** نعم. سُجلت الاستعادة كإصدار جديد أعلى قائمة السجل. افتح اللوحة، واعثر على الإصدار الذي كان قائمًا قبل الاستعادة، وسيظل موجودًا، ثم انقر زر **استعادة** الخاص به. **س: لماذا زر الحفظ الآن معطل؟** إذا كان رماديًا، فقد تكون عملية حفظ جارية. انتظر حتى تكتمل. وإذا كنت في وضع العرض، فسيظل معطلًا؛ إذ تحتاج إلى وضع التحرير للحفظ. **س: هل يمكنني مقارنة إصدارين جنبًا إلى جنب؟** لا توفر لوحة سجل الإصدارات الحالية عرض فروق أو مقارنة. للمقارنة، دوّن رقمي الإصدارين واستخدم زر الاستعادة لتحميل كل منهما تباعًا وملاحظة الاختلافات في اللوحة. ## أدلة ذات صلة - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) — المرجع الكامل للوحة وشريط الأدوات والاختصارات - [البدء السريع لمسارات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-1-quickstart-first-workflow/) — بناء أول سير عمل وحفظه - [شاشة إدارة سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) — العثور على مكتبة مساراتك وفتحها وإدارتها - [تشغيل سير عمل](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) — تشغيل سير العمل بعد تصميمه وحفظه - [مسرد مصطلحات RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/ # استخدام قاعدة بيانات سير العمل > **الوحدة:** التطبيقات ← منشئ التدفقات ← قاعدة بيانات سير العمل > > **الجمهور:** مشغّلو سير العمل المخوّلون والمشرفون > > **الوصول المطلوب:** صلاحية منشئ التدفقات؛ ويمكن أن تقيّد صلاحيات الخادم عمليات الإدارة الفردية أيضًا > > **ستتعلم:** كيف تستخدم لوحة المعلومات وعلامات تبويب السجلات السبع، وتتحقق من تنفيذ سير العمل، وتدير بأمان المثيلات والمهام والإجراءات والإشعارات والخطوات وقوالب التواصل والتذكيرات. ## ما الذي تتحكم فيه قاعدة بيانات سير العمل؟ **قاعدة بيانات سير العمل (Workflow Database)** هي وحدة التحكم في الإدارة التشغيلية على المسار `/workflow-database`. وهي مخصصة لسجلات التنفيذ المحفوظة واتصالات سير العمل، لا لترتيب العُقد في لوحة منشئ التدفقات. تحتوي الصفحة حاليًا على ثماني علامات تبويب: 1. **لوحة المعلومات (Dashboard)** 2. **المثيلات (Instances)** 3. **المهام (Tasks)** 4. **الإجراءات (Actions)** 5. **الإشعارات (Notifications)** 6. **الخطوات (Steps)** 7. **الاتصالات (Communications)** 8. **التذكيرات (Reminders)** لا توجد علامة تبويب مستقلة باسم **القوالب (Templates)**. تظهر **قوالب سير العمل (Workflow Templates)** كبطاقة في لوحة المعلومات، وتعيدك إلى إدارة سير العمل حيث تُنشأ تصميمات سير العمل وتُحرر. ## فتح قاعدة بيانات سير العمل 1. افتح **التطبيقات ← منشئ التدفقات**. 2. اختر **قاعدة بيانات سير العمل** من رأس إدارة سير العمل. يمكنك أيضًا فتح `/workflow-database` مباشرة. اختر **رجوع (Back)** للعودة إلى الموضع السابق في المتصفح. يستخدم المسار بوابة وصول منشئ التدفقات نفسها التي تستخدمها إدارة سير العمل. ولأن علامات تبويب عدة تستطيع تغيير السجلات التشغيلية أو حذفها نهائيًا، ينبغي للمؤسسات منح هذه الصلاحية للمشغّلين الموثوقين فقط. ## التحقق من حالة الاتصال تتحقق قاعدة بيانات سير العمل من واجهة Workflow API عند فتحها. - أثناء التحقق، تعرض أعداد لوحة المعلومات حالات تحميل. - عند الاتصال، تُحمّل الجداول وإجراءات الإدارة كالمعتاد. لا تحتفظ الصفحة الحالية بشريط أخضر دائم يقول إن API متصلة. - عند انقطاع الاتصال، توضح رسالة حمراء أن أعداد السجلات وإجراءات الإدارة غير متاحة. اختر **إعادة المحاولة (Retry)** بعد استعادة اتصال الخادم. - إذا فشل بعض طلبات الأعداد فقط، يظهر تحذير بينما تظل بقية وحدة التحكم متاحة. ## استخدام لوحة المعلومات علامة **لوحة المعلومات** الافتراضية هي نظرة عامة على مجموعات السجلات المتاحة. اختر بطاقة لفتح علامة التبويب المقابلة. | بطاقة لوحة المعلومات | ما تفتحه أو تفعله | |---|---| | **مثيلات سير العمل (Workflow Instances)** | تفتح المثيلات. | | **مهام سير العمل (Workflow Tasks)** | تفتح المهام. | | **إجراءات سير العمل (Workflow Actions)** | تفتح الإجراءات. | | **الإشعارات (Notifications)** | تفتح الإشعارات. | | **خطوات التنفيذ (Execution Steps)** | تفتح الخطوات. | | **قوالب التواصل (Communication Templates)** | تفتح الاتصالات. | | **مجدول التذكيرات (Reminder Scheduler)** | يفتح التذكيرات. | | **قوالب سير العمل (Workflow Templates)** | تفتح إدارة سير العمل بدلًا من علامة تبويب أخرى في قاعدة البيانات. | تُحمّل أعداد السجلات للمثيلات والمهام والإجراءات والإشعارات والخطوات والتذكيرات. ولا تعرض قوالب التواصل عددًا لسجلات قاعدة البيانات في لوحة المعلومات هذه. ## عناصر التحكم المشتركة في الجداول تستخدم معظم علامات تبويب السجلات شبكة بيانات. ويمكنك، حسب علامة التبويب: - تغيير حجم الصفحة بين 10 و25 و50 و100 صف؛ - التنقل بين الصفحات المحمّلة من الخادم؛ - ترتيب الأعمدة المدعومة؛ - استخدام شريط أدوات الشبكة للتصفية السريعة وعناصر الجدول الأخرى المتاحة؛ - تحديد الصفوف عندما تكون مربعات التحديد ممكّنة؛ - فتح إجراءات الصف من عمود الإجراءات. عوامل التصفية أعلى الجدول وعامل التصفية السريع داخل الشبكة منفصلان. امسحهما معًا عندما يبدو أن سجلًا مفقود. ## المثيلات تحتوي **مثيلات سير العمل** على سجلات التنفيذ المحفوظة لمسارات سير العمل. ### العثور على مثيل استخدم **البحث (Search)** و**الحالة (Status)** و**اسم سير العمل (Workflow Name)**، ثم اختر **مسح عوامل التصفية (Clear Filters)** عند الانتهاء. الحالات المتاحة هي: - معلّق `pending`؛ - قيد التشغيل `running`؛ - مكتمل `completed`؛ - فاشل `failed`؛ - ملغى `cancelled`؛ - موقوف مؤقتًا `suspended`؛ - مجدول `scheduled`. يتضمن الجدول: المعرّف، ومعرّف المثيل، واسم سير العمل، وملخص بيانات سير العمل، والحالة، وأنشأه، وتاريخ الإنشاء، والتحديث، والإجراءات. ### إجراءات المثيل | الإجراء | الغرض | |---|---| | شريحة بيانات سير العمل / **مصمم سير العمل (Workflow Designer)** | تفتح سير العمل المسمى في المصمم. قد تعرض الشريحة عدد العُقد، أو سجلًا من محرك سير العمل، أو عدد الخصائص، أو **سير عمل فارغ (Empty Workflow)**، أو **JSON غير صالح (Invalid JSON)**، أو **لا بيانات (No Data)**. | | **عرض التنفيذ (View Execution)** | يفتح عرض عمليات التنفيذ لسير العمل عند معرّف المثيل هذا في علامة تبويب جديدة. | | **عرض (View)** | يفتح كل تفاصيل المثيل المحفوظة في مربع حوار. | | **تحرير (Edit)** | يسمح بتغيير حقول المثيل القابلة للتحرير وحالته. | | **بدء (Start)** | يغيّر المثيل المعلّق أو الموقوف مؤقتًا إلى قيد التشغيل. | | **إلغاء (Cancel)** | يلغي مثيلًا قيد التشغيل بعد التأكيد. | | **إيقاف الجدول (Stop Schedule)** | يوقف مثيلًا مجدولًا بعد التأكيد. | | **حذف (Delete)** | يحذف مثيلًا نهائيًا بعد تحذير. | استخدم **إنشاء مثيل (Create Instance)** لسجل تشغيلي مقصود فقط. يتطلب معرّف مثيل واسم سير عمل وJSON لسير العمل وحالة ومعلومات المنشئ. أما **سير عمل جديد (New Workflow)** فيفتح منشئ التدفقات لإنشاء تصميم. يؤدي التحديد بمربعات الاختيار إلى تمكين **حذف المحدد (`N`) (Delete Selected)**. يحذّر الحذف المجمع من احتمال إزالة المهام والإشعارات والخطوات والمقاييس وسجل الإجراءات والإعداد ومراجع القوالب المرتبطة أيضًا. وتُوقف التحديدات قيد التشغيل أو المجدولة أولًا. تحقق من كل معرّف مثيل محدد قبل التأكيد. ## المهام تعرض **مهام سير العمل (Workflow Tasks)** سجلات المهام عبر مسارات سير العمل والمكلّفين. استخدم **البحث** و**الحالة** و**نوع المهمة (Task Type)** و**بريد المكلّف (Assignee Email)**، ثم اختر **تطبيق عوامل التصفية (Apply Filters)**. يزيل **مسح عوامل التصفية** تلك القيم. يعرض الجدول عنوان المهمة ونوعها والمكلّف واسم سير العمل ومعرّف المثيل والأولوية والحالة والإنشاء وتاريخ الاستحقاق والإكمال والإجراءات السريعة والإجراءات. الأولويات هي منخفضة ومتوسطة وعالية وعاجلة. ### إجراءات المهمة - يفتح **فتح بوابة المهمة (Open Task Portal)** عنوان بوابة المهمة في علامة تبويب جديدة عندما يكون موجودًا. - تفتح الإجراءات السريعة الملونة عنوان الإجراء الذي أعدّه سير العمل، مثل صفحة اعتماد أو رفض. - ينقل **بدء (Start)** المهمة المعلّقة إلى قيد التنفيذ. - يتوفر **إكمال (Complete)** و**إلغاء (Cancel)** للمهمة قيد التنفيذ. - يعرض **عرض (View)** بيانات المهمة المحفوظة كاملة. - يغيّر **تحرير (Edit)** حقول المهمة القابلة للتحرير. - يطلب **حذف (Delete)** تأكيدًا، ويغيّر حاليًا حالة المهمة إلى ملغاة؛ ولا يستدعي عملية حذف نهائي لسجل المهمة. - ينشئ **إنشاء مهمة (Create Task)** سجل مهمة يدويًا. إجراء **إعادة محاولة المهمة (Retry Task)** هدّام. يمكنه حذف سجل الإجراءات السابق وسجلات خطوات التنفيذ، وإعادة ضبط صفوف الاعتماد، وإرجاع المهمة إلى معلّقة، وإرسال إشعار جديد. يُمنع عندما يكون سير العمل الأب مكتملًا أو فاشلًا أو ملغى بالفعل. اقرأ التأكيد ولا تُعد المحاولة إلا إذا كانت إعادة تشغيل تلك المهمة هي الإصلاح المقصود. ## الإجراءات تحتوي **إدارة الإجراءات (Actions Management)** على سجلات إجراءات المستخدم والنظام، بما فيها الإنشاء والتحديث والحذف والاعتماد والرفض والإكمال والإسناد. تعرض بطاقات الملخص **إجمالي الإجراءات (Total Actions)** و**الأخيرة خلال 24 ساعة (Recent 24h)** و**الاعتمادات (Approvals)** و**الرفض (Rejections)**. يستخدم الإجمالي عدد الخادم، بينما تُحسب التقسيمات الأخرى من صفحة النتائج المحمّلة حاليًا. صفِّ حسب **نوع الإجراء (Action Type)** أو **بريد المستخدم (User Email)** أو **معرّف المثيل (Instance ID)**. يتضمن الجدول نوع الإجراء والمستخدم وسير العمل ومعرّف المثيل ومعرّف العقدة والطابع الزمني وعنوان IP والتعليقات وإجراءات الصف. علامة التبويب هذه ليست للقراءة فقط في المنتج الحالي: - ينشئ **إضافة إجراء (Add Action)** سجل إجراء تشغيليًا. - يفتح **عرض** السجل الكامل وبيانات النتيجة. - يغيّر **تحرير** النتيجة والتعليقات المحفوظة. - يزيل **حذف** سجل الإجراء نهائيًا. يؤدي حذف إجراء إلى إزالة دليل تدقيق. تأكد من متطلبات العمل والامتثال قبل تغيير أي شيء أو حذفه في علامة التبويب هذه. ## الإشعارات تتعقب **إدارة الإشعارات (Notifications Management)** سجلات إشعارات البريد الإلكتروني وSMS والإشعارات الفورية وWebhook. تعرض بطاقات الملخص **إجمالي الإشعارات (Total Notifications)** و**المرسلة (Sent)** و**الفاشلة (Failed)**. يستخدم الإجمالي عدد الخادم، بينما يُحسب توزيع الحالات من الصفوف المحمّلة. صفِّ حسب **النوع (Type)** أو **الحالة (Status)** أو **المستلم (Recipient)** أو **معرّف المثيل**. تشمل خيارات الحالة: معلّق، ومرسل، وفاشل، وتم التسليم. يعرض الجدول النوع والعنوان والمستلم والاسم والحالة واسم سير العمل ومعرّف المثيل ومحاولات التسليم والإنشاء ووقت الإرسال والإجراءات. اختر **عرض** لمراجعة نص الرسالة وتوقيت التسليم والمحاولات والبيانات الإضافية وأي خطأ. ينشئ **إضافة إشعار (Add Notification)** سجل إشعار مع وجهته ونوعه وعنوانه ورسالته وبيانات JSON اختيارية. يُبقي مربع حوار التحرير حقول التوجيه والمحتوى الأصلية مقفلة، وهو مخصص لبيانات التتبع القابلة للتحرير، بما فيها الحالة أو معلومات الخطأ الموجودة في بيانات JSON. يزيل **حذف** سجل الإشعار نهائيًا؛ لكنه لا يسترجع رسالة سبق تسليمها. ## الخطوات تعرض **إدارة خطوات التنفيذ (Execution Steps Management)** كيفية تشغيل كل عقدة داخل مثيلات سير العمل. يتضمن الجدول معرّف المثيل واسم سير العمل ومعرّف العقدة ونوع العقدة وتسميتها وترتيب الخطوة والحالة والمحاولات ووقت البدء ووقت الإكمال والإجراءات. - يعرض **عرض** بيانات الإدخال والإخراج والتوقيت وعدد المحاولات ورسالة الخطأ. - يحدّث **تحرير** حقول الخطوة المحفوظة. - ينشئ **إضافة خطوة (Add Step)** سجل خطوة تنفيذ يدويًا. - يعيد **تحديث (Refresh)** تحميل الجدول. لا يوجد حاليًا إجراء حذف لخطوة فردية في علامة التبويب هذه. استخدم عامل التصفية السريع للشبكة للعثور على قيمة سير عمل أو مثيل أو عقدة. ## الاتصالات تدير **قوالب التواصل (Communication Templates)** محتوى اتصالات سير العمل القابل لإعادة الاستخدام. هذه هي إدارة القوالب الكاملة في الواجهة الحالية؛ ولا توجد صفحة اتصالات منفصلة في التنقل الرئيسي. تعرض بطاقاتها الأربع **إجمالي القوالب (Total Templates)** و**القوالب النشطة (Active Templates)** و**مسودات القوالب (Draft Templates)** و**إجمالي الاستخدام (Total Usage)**. استخدم **البحث في القوالب (Search templates)** أو وسّع **عوامل التصفية (Filters)** لتقييد الجدول حسب **النوع** أو **التصنيف** أو **الحالة**. يعرض الجدول القالب والتصنيف والحالة والأولوية وعدد مرات الاستخدام وآخر تحديث والإجراءات. مربعات التحديد فيه هي تحديد قياسي للشبكة؛ ولا توفر الصفحة الحالية شريط إجراءات مجمعة. تعتمد إجراءات الصف الظاهرة على حالة القالب وصلاحيتك: | الإجراء | ما يفعله | |---|---| | **تحرير (Edit)** | يفتح محرر القالب بالقيم المحفوظة. | | **معاينة (Preview)** | يعرض المحتوى المحفوظ في مربع حوار للمعاينة. | | **نسخ (Copy)** | يفتح نسخة معبأة مسبقًا باسم يتضمن `(Copy)`، لتُراجع كمسودة مستقلة. | | **إرسال للاعتماد (Submit for Approval)** | يرسل مسودة تملكها إلى قائمة انتظار الاعتماد. | | **اعتماد / رفض (Approve / Reject)** | يتيح للمشرف اعتماد قالب معلّق أو إعادته إلى حالة المسودة. | | **تنشيط (Activate)** | يتيح للمشرف جعل قالب معتمد متاحًا للاستخدام المباشر. | | **حذف (Delete)** | يزيل القالب نهائيًا بعد التأكيد. | ### إنشاء قالب تواصل أو تحريره 1. اختر **إنشاء قالب (Create Template)**، أو اختر **تحرير** في صف قائم. 2. في **المعلومات الأساسية (Basic Information)**، أدخل **عنوان القالب (Template Title)**، واختر **نوع القالب (Template Type)** و**التصنيف (Category)** و**الأولوية (Priority)**، وحدد ما إذا كان **قالبًا عامًا (Public Template)**، وأضف وصفًا اختياريًا. 3. في **المحتوى (Content)**، أدخل الموضوع عندما يدعمه النوع المحدد، وأكمل **محتوى القالب (Template Content)**. يدعم محتوى البريد HTML. استخدم **معاينة** قبل الحفظ. 4. في **المتغيرات (Variables)**، اختر **إضافة متغير (Add Variable)** لكل قيمة قابلة لإعادة الاستخدام. أدخل اسمه، واختر نصًا أو رقمًا أو تاريخًا أو نعم/لا، وحدد ما إذا كان **مطلوبًا (Required)**، وأضف وصفًا. استخدمه في المحتوى بصيغة `{{variable_name}}`. 5. أضف **وسومًا (Tags)** مفصولة بفواصل عندما تكون مفيدة، ثم اختر **إنشاء القالب (Create Template)** أو **تحديث القالب (Update Template)**. يوفر المدير الحالي سبعة أنواع للقوالب: **البريد الإلكتروني (Email)** و**SMS** و**إشعار داخل التطبيق (In-App Notification)** و**إشعار فوري (Push Notification)** و**رسالة Slack (Slack Message)** و**Microsoft Teams** و**Webhook**. تشمل التصنيفات الحالية إشعارات سير العمل وتهيئة المستخدم وتنبيهات النظام والتسويق والمعاملات وطلبات الاعتماد وتحديثات الحالة والتذكيرات والتقارير ومخصص. تشمل حالات دورة الحياة: مسودة، ومعلّق للاعتماد، ومعتمد، ونشط، وغير نشط، ومؤرشف؛ والأولويات منخفضة ومتوسطة وعالية وعاجلة. يؤدي تحرير قالب لم يعد في حالة المسودة إلى إنشاء إصدار مسودة جديد يجب أن يمر بدورة الاعتماد مرة أخرى. تحتفظ عُقد سير العمل القائمة بالمحتوى الذي سبق أن حفظته إلى أن يعيد المصمم عمدًا تطبيق القالب الأحدث. لا يوفر المدير الحالي متصفحًا لسجل الإصدارات أو شريط إجراءات مجمعة أو عرضًا متعمقًا لتحليلات التسليم؛ ومؤشرا الاستخدام الظاهران فيه هما **مرات الاستخدام (Times Used)** و**إجمالي الاستخدام (Total Usage)**. يمكن أيضًا إنشاء قوالب البريد وتطبيقها أثناء إعداد عقدة بريد إلكتروني. راجع [إعادة استخدام قوالب البريد في منشئ التدفقات](https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/). ## التذكيرات يدير **مجدول التذكيرات (Reminder Scheduler)** تذكيرات البريد الإلكتروني المبنية على التاريخ. يعرض الملخص الإجمالي، إلى جانب قيم معلّق ومرسل وملغى وفاشل للصفوف المحمّلة حاليًا. تُعرض الأوقات بتوقيت القاهرة. صفِّ حسب **سير العمل** أو **الحالة** أو **البريد الإلكتروني** أو **البحث**. يتضمن الجدول سير العمل ومعرّف الصف والإزاحة والوقت المجدول والبريد والحالة ووقت الإرسال والمحاولات والخطأ والإجراءات. - يعرض **عرض** سجل التذكير كاملًا. - يغيّر **تحرير** التاريخ والوقت المجدولين والبريد، ولا يظهر إلا للتذكير المعلّق. - يغيّر **إلغاء** التذكير المعلّق إلى ملغى بعد التأكيد. - يزيل **حذف** سجل التذكير نهائيًا. - يعيد **تحديث** تحميل القائمة. يحتفظ الإلغاء بالسجل وحالته الملغاة، بينما يزيل الحذف السجل. لذلك اختر الإلغاء عندما ينبغي أن يبقى السجل ظاهرًا في المحفوظات. ## إرشادات الأمان - ابدأ بالعرض وعوامل التصفية قبل استخدام التحرير أو إعادة المحاولة أو الإلغاء أو الإيقاف أو الحذف. - طابق اسم سير العمل ومعرّف المثيل، لا اسم العرض وحده. - لا تنشئ سجلات تشغيلية يدويًا إلا إذا كنت تفهم بيانات محرك سير العمل التي يجب أن تشير إليها. - تعامل مع الإجراءات كبيانات تشغيلية قابلة للتحرير، لا كسجل تدقيق ثابت في الواجهة الحالية. - صدّر الأدلة المطلوبة أو سجّلها عبر عمليتك المعتمدة قبل الحذف النهائي. - بعد نجاح تغيير، حدّث علامة التبويب المتأثرة وتأكد من الحالة المتوقعة. ## استكشاف الأخطاء وإصلاحها | المشكلة | الحل | |---|---| | واجهة Workflow API غير متصلة | استعد اتصال الخادم، ثم اختر **إعادة المحاولة**. | | عدد في لوحة المعلومات مفقود | افتح علامة تبويب السجل مباشرة وحدّثها؛ فقد يكون طلب العدد فشل وحده. | | سجل مفقود | امسح عوامل تصفية علامة التبويب وعامل التصفية السريع للشبكة، وتأكد من رقم الصفحة، وابحث بمعرّف المثيل. | | يفشل إجراء إداري | تأكد من صلاحية الخادم لديك ومن أن السجل لا يزال في الحالة المتوقعة، ثم حدّث قبل إعادة المحاولة. | | تحرير أو إلغاء مفقود لتذكير | التذكيرات المعلّقة وحدها تعرض هذين الإجراءين. | | رُفضت إعادة محاولة المهمة | تأكد من أن سير العمل الأب لا يزال نشطًا وليس مكتملًا أو فاشلًا أو ملغى. | | قوالب سير العمل ليست علامة تبويب | افتح بطاقتها في لوحة المعلومات؛ فهي تعيدك عمدًا إلى إدارة سير العمل. | ## أدلة ذات صلة - [إدارة مسارات سير العمل في منشئ التدفقات](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) - [إنشاء سير عمل أو نسخه](https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/) - [نظرة عامة على المصمم المرئي](https://raptix.app/user-guide/ar/10-workflows/10-3-visual-designer-overview/) - [عرض تفاصيل سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-22-workflow-detail-view/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) - [إعادة استخدام قوالب البريد في منشئ التدفقات](https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/) --- URL: https://raptix.app/user-guide/ar/10-workflows/10-29-workflow-permissions/ # التحكم في الوصول إلى مسارات سير العمل > **الوحدة:** الإدارة ← إدارة المستخدمين ← الأدوار والوصول؛ التطبيقات ← الصلاحيات > > **الجمهور:** مشرفو مساحة العمل ومالكو مسارات سير العمل > > **ستتعلم:** أي شاشة وصول حالية تستخدمها عندما يتعذر على شخص فتح صفحات سير العمل، أو رؤية سير عمل ضمن نطاق تطبيق، أو تحرير سير عمل. ## استخدام الأدوار والوصول للسماح بفتح الصفحة افتح **الإدارة ← إدارة المستخدمين ← الأدوار والوصول**. تتحكم مصفوفة **الصفحات × الأدوار (Pages × Roles)** فيما إذا كان أعضاء دور معين يستطيعون فتح الصفحات المرتبطة بسير العمل. فعّل القسم الأب قبل صفحاته الفرعية. يُحفظ كل تغيير مباشرة. بعد تحديث الدور، ارجع إلى **إدارة المستخدمين ← الأعضاء** وتأكد من أن الشخص يحمل ذلك الدور. اختبر بالحساب المتأثر، لأن المشرف قد يرى صفحات لا يستطيع العضو العادي رؤيتها. ## استخدام صلاحيات التطبيقات للوصول إلى الموارد لا يؤدي فتح صفحة سير العمل تلقائيًا إلى إظهار كل مساحة عمل أو تطبيق أو صفحة أو نموذج سير عمل. افتح **التطبيقات ← المزيد ← الصلاحيات** لمراجعة منح الوصول إلى الموارد لمساحة العمل أو التطبيق أو الصفحة المطلوبة. طبّق أضيق نطاق يحل الطلب: - الوصول إلى مساحة العمل عندما يحتاج الدور إلى كل المحتوى المناسب فيها؛ - الوصول إلى التطبيق عندما يكون المطلوب تطبيقًا واحدًا فقط؛ أو - الوصول إلى الصفحة لصفحة واحدة محددة أو نموذج سير عمل قابل للتشغيل. استخدم منح الدور للوصول المعتاد للفريق، ومنح المستخدم فقط للاستثناء الحقيقي. تحقق من النتيجة بحساب العضو المتأثر بعد الحفظ. ## الفصل بين الاستخدام والمراقبة والبناء هذه احتياجات مختلفة: | الاحتياج | الوصول المطلوب مراجعته | |---|---| | فتح **التطبيقات ← سير العمل** | صلاحية صفحة سير العمل في **الأدوار والوصول**. | | رؤية سير عمل أو نموذج ضمن نطاق محدد | منح مورد التطبيقات المطابق. | | تنفيذ مهمة في **مهامي** | يجب أن تكون المهمة مسندة حاليًا إلى ذلك العضو. | | مراقبة **كل المثيلات** | صلاحية مراقبة سير العمل، إلى جانب إمكانية رؤية النطاق ذي الصلة. | | التحرير في **منشئ التدفقات** | صلاحية صفحة منشئ التدفقات وضوابط البناء أو التحرير الخاصة بسير العمل. | لا تمنح صلاحية المنشئ أو المشرف لمجرد تمكين شخص من اعتماد مهمة مسندة إليه. ## استكشاف الأخطاء وإصلاحها **زر سير العمل مفقود.** راجع دور العضو في **الأدوار والوصول**، ثم أعد تحميل التطبيقات. **يستطيع الشخص فتح سير العمل لكنه لا يجد عملية تشغيل معينة.** امسح البحث وعوامل التصفية، وتأكد من نطاق التطبيق، ثم راجع منح مورد التطبيقات ذي الصلة. **المهمة ظاهرة لكن يتعذر فتحها.** تأكد من أنها نشطة ومسندة إلى الحساب المسجّل دخوله. تبقى المهمة المكتملة أو المعاد إسنادها في السجل، لكن لا يمكن إكمالها مرة أخرى. **تغيير الدور لم يحل مشكلة رؤية المورد.** فتح الصفحة ومنح الموارد أمران منفصلان. راجع الشاشتين بدلًا من توسيع الدور إلى مشرف. ## أدلة ذات صلة - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) - [التحكم في الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [استخدام سير العمل: كل المثيلات ومهامي](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) - [مهامي](https://raptix.app/user-guide/ar/10-workflows/10-23-my-tasks/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/ # البدء مع المستندات > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** المستخدم النهائي > **العنوان الحالي:** `/applications?view=documents` ## ما المقصود بالمستندات؟ «المستندات» هي منطقة إدارة الملفات داخل **التطبيقات**. تجمع الملفات المرفوعة يدويًا وتلك التي تنشئها أو تجمعها التطبيقات ومسارات سير العمل. ويتوقف ما يمكنك رؤيته وتغييره على الوصول المسند إليك. ## فتح المستندات 1. افتح **التطبيقات (`Applications`)**. 2. اختر **المستندات (`Documents`)** من ترويسة التطبيقات. 3. إذا كنت داخل مساحة عمل أو تطبيق أو صفحة بالفعل، فاختر علامة **المستندات** التابعة لها لرؤية ملفات ذلك النطاق فقط. يمكن إذًا فتح المستندات في أربعة سياقات مفيدة: | السياق | ما يعرضه | |---|---| | المستندات العامة | الملفات في مساحات العمل التي تستطيع الوصول إليها. | | مساحة العمل | التطبيقات والملفات في مساحة عمل واحدة. | | التطبيق | الصفحات والملفات في تطبيق واحد. | | الصفحة | الملفات التابعة لصفحة واحدة. | ## فهم تسلسل المجلدات في وضع **المجلدات (`Folders`)**، تتبع المستندات هذه البنية: | المستوى | المعنى | |---|---| | مساحة العمل (`Workspace`) | منطقة المؤسسة المالكة للتطبيق. | | التطبيق (`Application`) | التطبيق الذي أنشأ الملف أو يخزنه. | | الصفحة (`Page`) | الصفحة أو نموذج سير العمل المرتبط بالملف. | | الكيان (`Entity`) | فئة سجل أو مجموعة مستندات أُنشئت يدويًا. | | المثيل (`Instance`) | سجل واحد أو مثيل عملية محدد. | | الحقل (`Field`) | حقل الرفع أو فئة المستند. | | الملف (`File`) | المستند الفعلي. | تظهر الملفات اليدوية غير المرتبطة بتطبيق تحت **الرفع المباشر (`Direct Uploads`)**، باستخدام التسلسل الأقصر «الكيان ← المثيل ← الحقل ← الملف». مساحة العمل والتطبيق والصفحة مجموعات للقراءة فقط في «المستندات». تبدأ المجلدات التي يديرها المستخدم عند الكيان والمثيل والحقل. ## العرض المسطح والمجلدات عند فتح «المستندات» داخل «التطبيقات»، استخدم مبدّل العرض أعلى النتائج: - **مسطح (`Flat`)** يعرض جميع ملفات نطاق مساحة العمل أو التطبيق أو الصفحة الحالية في قائمة واحدة، وهو الوضع الافتراضي. - **مجلدات (`Folders`)** يعرض تسلسل «الكيان ← المثيل ← الحقل»، ويتيح تصفح المجلدات وإدارتها. هذا المبدّل منفصل عن **شبكة / قائمة (`Grid / List`)**. يغير «مسطح/مجلدات» بنية المعلومات، بينما يغير «شبكة/قائمة» طريقة عرض العناصر نفسها فقط. ## التنقل ومعرفة موقعك - اختر مجلدًا لفتحه. - استخدم مسار التنقل للعودة إلى أي مستوى أب. - استخدم سهم الرجوع للصعود مستوى واحدًا. - يحتفظ شريط عنوان «التطبيقات» بمساحة العمل والتطبيق والصفحة ومسار المستند الداخلي المحدد في عنوان URL. - يظل الرابط المشارك خاضعًا لصلاحيات المستلم. ## عناصر التحكم الرئيسية | عنصر التحكم | وظيفته | |---|---| | البحث | يرشح النطاق أو المجلد الحالي. | | جديد (`New`) | يفتح **رفع ملف (`Upload File`)** و**إنشاء مجلد (`Create Folder`)**. | | تحديد الكل (`Select All`) | يحدد المجلدات في العرض الحالي؛ ولا يحدد الملفات الفردية. | | تنزيل (`Download`) | ينزل المجلدات المحددة في ملف ZIP. | | حذف (N) (`Delete (N)`) | يحذف المجلدات المحددة ومحتوياتها نهائيًا. | | الاسم / التاريخ / الحجم | يرتب النتائج الحالية ويعكس الاتجاه عند اختيار العنصر نفسه مرة أخرى. | | مسطح / مجلدات | يبدل بين قائمة ملفات واحدة وتسلسل المجلدات. | | شبكة / قائمة | يغير التخطيط المرئي. | في مجلد تطبيق أو صفحة مؤهل ضمن خطة Enterprise، يفتح **الفتح في منشئ التطبيقات (`Open in App Builder`)** المورد في منشئ التطبيقات المرئي. ولا يظهر الإجراء إلا عندما يدعم المورد ووصولك ذلك. ## قائمة «المزيد» لا تعرض قائمة **المزيد (`More`)** إلا الأدوات التي يستطيع دورك فتحها: - **الصلاحيات (`Permissions`)** — ضوابط الوصول العامة إلى التطبيقات والمستندات. - **السجلات (`Logs`)** — سجلات نشاط التطبيقات والمستندات. - **سلة المحذوفات (`Trash`)** — استعادة الملفات المحذوفة من المستكشف. - **معالجة المستندات (`Process Documents`)** — فتح مخزون إدارة المستندات. ## قاعدة حذف مهمة يرسل حذف ملف واحد من بطاقته إلى **سلة المحذوفات**. أما حذف مجلد، أو المجلدات المحددة من شريط الأدوات، فيحذف نهائيًا كل مستند بداخلها ولا يمكن التراجع عنه. اقرأ مربع التأكيد دائمًا قبل المتابعة. ## أدلة ذات صلة - [رفع الملفات وإنشاء المجلدات](https://raptix.app/user-guide/ar/20-documents/20-2-uploading-files-and-creating-folders/) - [معاينة الملفات والتعليق على ملفات PDF في سير العمل](https://raptix.app/user-guide/ar/20-documents/20-3-viewing-annotating-pdfs/) - [العثور على المستندات](https://raptix.app/user-guide/ar/20-documents/20-6-finding-documents-search-favorites-bookmarks/) - [تخصيص عرض المستندات](https://raptix.app/user-guide/ar/20-documents/20-8-customizing-document-view/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-2-uploading-files-and-creating-folders/ # رفع الملفات وإنشاء المجلدات > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** المستخدمون الذين يملكون وصول الكتابة إلى المستندات ## قبل أن تبدأ افتح **التطبيقات ← المستندات**. يمكنك بدء رفع من أي شاشة مستندات، ولا تحتاج إلى المرور بالتسلسل الكامل للمجلدات أولًا. ## رفع ملف واحد 1. اختر **جديد (`New`)**. 2. اختر **رفع ملف (`Upload File`)**. 3. راجع **الحفظ في (`Save in`)**. تختار «المستندات» تلقائيًا المجلد الذي تعرضه؛ ومن أي شاشة أخرى تختار **عمليات الرفع العامة (`General uploads`)**. 4. أبقِ الاختيار أو حدد مجلدًا متاحًا آخر من القائمة. 5. اختر ملفًا واحدًا من جهازك. 6. أدخل **تعليقات (`Comments`)** تصف الرفع، إن أردت. 7. اختر **رفع (`Upload`)**. 8. انتظر تأكيد **رُفع الملف بنجاح (`File uploaded successfully`)**. تحتفظ «المستندات» داخليًا بتسلسل تخزين منظم. يعني محدد **الحفظ في** أن المستخدم لا يحتاج إلى فهم ذلك التسلسل أو اجتيازه يدويًا قبل الرفع. يقبل مربع الرفع الحالي ملفًا واحدًا في كل عملية. كرر الإجراء لرفع ملفات أخرى. لا يضيف رفع مستند مخزن تلقائيًا إلى معرفة الذكاء الاصطناعي. تُضبط مصادر المعرفة والمزامنة بصورة منفصلة في قسم «المعرفة». ## إدارة ملف موجود تعرض بطاقات الملفات وصفوفها الإجراءات المتاحة لكل ملف: | الإجراء | النتيجة | |---|---| | عرض (`View`) | يفتح المعاينة المدعومة داخل المتصفح. | | تنزيل (`Download`) | يحفظ الملف عبر المتصفح. | | إعادة تسمية (`Rename`) | يفتح مربع اسم الملف ويحفظ الاسم الجديد. | | حذف (`Delete`) | يحذف الملف حذفًا مرنًا حتى يمكن استعادته من سلة المحذوفات. | | الصلاحيات (`Permissions`) | يفتح صفحة صلاحيات المستند للملف المحدد. | تعرض الأنواع غير المدعومة للمعاينة خيار التنزيل من دون عرض. ## إنشاء تسلسل المستندات اختر **جديد ← إنشاء مجلد**. يعتمد نوع المجلد التالي على موقعك الحالي: | الموقع الحالي | المجلد الذي يُنشأ | |---|---| | الصفحة أو جذر الرفع المباشر | كيان (`Entity`) | | الكيان | مثيل (`Instance`) | | المثيل | حقل (`Field`) | توفر «التطبيقات» مساحة العمل والتطبيق والصفحة، ولا تُنشأ من مربع مجلد «المستندات». 1. انتقل إلى الصفحة أو الكيان أو المثيل الذي ينتمي إليه المجلد الجديد. 2. اختر **جديد ← إنشاء مجلد**. 3. أدخل اسم المجلد. 4. اختر **لون المجلد (`Folder Color`)** إن أردت. 5. اختر **إنشاء مجلد (`Create Folder`)**. ## إعادة تسمية مجلد أو تغيير لونه مرر المؤشر فوق مجلد كيان أو مثيل أو حقل يديره المستخدم في عرض الشبكة، أو استخدم إجراءاته داخل الصف في عرض القائمة. - اختر **إعادة تسمية** لتغيير اسمه. - اختر زر لوحة الألوان لفتح **لون المجلد**. - اختر لونًا جديدًا أو **استعادة اللون الافتراضي (`Restore default color`)**. تحفظ المنصة ألوان المجلدات ويراها المستخدمون الآخرون القادرون على رؤية المجلد؛ وليست تفضيلات خاصة بالمتصفح. تُنشأ مجلدات المثيلات التي تبدأ أسماؤها بـ`run_` لتشغيلات سير العمل، ولا يمكن إعادة تسميتها أو حذفها من المستكشف. ## حذف الملفات والمجلدات يختلف سلوك إجرائي الحذف: | الإجراء | النتيجة | |---|---| | حذف ملف فردي | ينقله إلى سلة المحذوفات، ويمكن استعادته. | | حذف مجلد | يحذف نهائيًا جميع المستندات داخله، ولا يمكن التراجع. | | تحديد مجلدات واستخدام حذف (N) | يحذف نهائيًا محتويات جميع المجلدات المحددة، ولا يمكن التراجع. | ## إصدارات المستند عندما تسمح مهمة سير عمل باستبدال المستند، افتح عارض PDF واستخدم **رفع إصدار جديد (`Upload New Version`)**. راجع [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/). ## أدلة ذات صلة - [نظرة عامة على المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) - [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/) - [استعادة الملفات من سلة المحذوفات](https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-3-viewing-annotating-pdfs/ # معاينة الملفات والتعليق على ملفات PDF في سير العمل > **الوحدة:** التطبيقات ← المستندات، ومهام سير العمل > **الجمهور:** المستخدم النهائي يوفر RAPTIX تجربتي عرض مترابطتين لكن مختلفتين: المعاينة العامة في «المستندات»، وعارض PDF الخاص بسير العمل. ## معاينة ملف من المستندات 1. افتح **التطبيقات ← المستندات**. 2. اعثر على الملف في وضع «مسطح» أو «مجلدات». 3. اختر **عرض (`View`)**. لا تعرض الملفات التي لا تدعم المعاينة إلا **تنزيل (`Download`)**. 4. استخدم **تنزيل** في ترويسة المعاينة إذا احتجت إلى نسخة محلية. 5. أغلق النافذة بزر X أو مفتاح Escape أو الخلفية. ## المعاينات المدعومة | نوع الملف | السلوك الحالي | |---|---| | PDF | يُعرض في نافذة المعاينة. | | صورة | تُعرض مباشرة. | | نص | يُعرض كنص؛ وتعرض الملفات الكبيرة أول 512 كيلوبايت. | | فيديو | يُعرض بعناصر تشغيل المتصفح. | | ملفات Office | تُحوّل لمعاينة شبيهة بـPDF، وقد يستغرق التحويل لحظة. | | نوع غير مدعوم أو أرشيف | لا يوجد إجراء عرض؛ نزّل الملف بدلًا منه. | إذا فشل التحميل أو التحويل، فاختر **التنزيل بدلًا من ذلك (`Download instead`)**. ## فتح ملف PDF تابع لسير عمل تُدار تعليقات PDF وقرارات سير العمل في `/pdf-viewer-simple`، والذي يُفتح عادة من **مهامي (`My Tasks`)** أو **المهام المعلقة (`Pending Tasks`)** أو **مدير مهام سير العمل (`Workflow Task Manager`)**. وقد تتضمن شاشة المهمة: - ملف PDF وعناصر التحكم في الصفحات والتكبير. - معلومات إصدار المستند. - **رفع إصدار جديد (`Upload New Version`)** عندما يُسمح بالاستبدال. - **تفاصيل المهمة (`Task Details`)**. - **المستندات المطلوبة (`Required Documents`)** وتعليقًا لكل مستند. - **إجراءات المهمة (`Task Actions`)** الديناميكية، مثل الموافقة أو الرفض أو إجراءات مخصصة. - **التعليقات السابقة (`Previous Comments`)**. - **بيانات سير العمل (`Workflow Data`)** القابلة للبحث. تحدد مهمة سير العمل عناصر التحكم المتاحة؛ فلا تتوقع الإجراءات نفسها في كل مهمة. ## التعليق على ملف PDF في سير العمل عند تمكين التعليق، استخدم الأدوات المتاحة في عارض PDF المضمن لإضافة نص أو رسومات أو صور وأختام. أكمل إجراء سير العمل لحفظ النتيجة. وإذا حفظت المهمة مستندًا معلقًا عليه، فإنها تنشئ إصدارًا جديدًا وتبقي الإصدار السابق متاحًا. إذا كانت المهمة تتطلب تعليقًا أو مستندًا داعمًا، فلا يمكن إرسال الإجراء حتى تكتمل الحقول المطلوبة. ## فرق مهم يُستخدم فتح PDF من مستكشف «المستندات» العادي للمعاينة والتنزيل. أما التعليقات والملفات المطلوبة والتعليقات النصية وإجراءات الموافقة فتنتمي إلى عارض مهمة سير العمل. ## أدلة ذات صلة - [مراجعة مهمة مستند في سير العمل ومعالجتها](https://raptix.app/user-guide/ar/20-documents/20-4-reviewing-approving-workflow-task/) - [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/) - [نظرة عامة على المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-4-reviewing-approving-workflow-task/ # مراجعة مهمة مستند في سير العمل ومعالجتها > **الوحدة:** سير العمل ← مهامي / مدير مهام سير العمل > **الجمهور:** المستخدمون المسندة إليهم المهام ## فتح المهمة 1. افتح **سير العمل ← مهامي** أو اتبع **فتح إجراء المهمة (`Open task action`)** من تفاصيل سير العمل. 2. اختر المهمة المسندة. 3. إذا ارتبط بها ملف PDF، فافتحه في عارض PDF الخاص بسير العمل. تضبط مهمة سير العمل الشاشة. تسميات مثل «موافقة» أو «رفض» أو «تعليق» أو «موافقة المدير» أمثلة فقط؛ وقد تختلف **إجراءات المهمة (`Task Actions`)** الفعلية. ## مراجعة تفاصيل المهمة تحقق من المعلومات المتاحة تحت **تفاصيل المهمة (`Task Details`)**، ومنها سير العمل والخطوة والإسناد ووقت الإنشاء ومعلومات الاستحقاق وحالة المهمة عندما تكون متوفرة. ## مراجعة المستند الرئيسي - اقرأ PDF واستخدم عناصر الصفحات والتكبير. - تحقق من الإصدار المعروض ومعلومات الإصدار الحالي. - استخدم **رفع إصدار جديد (`Upload New Version`)** فقط عندما تسمح المهمة بالاستبدال. - أضف تعليقات مرئية عندما يعرض عارض PDF المضمن أدواتها. ## المستندات المطلوبة إذا ظهر قسم **المستندات المطلوبة (`Required Documents`)**: 1. اختر ملفًا لكل حقل مطلوب. 2. أضف تعليق حقل عندما يُطلب. 3. تأكد من عدم غياب أي ملف مطلوب قبل اختيار إجراء للمهمة. ## بيانات سير العمل استخدم **بيانات سير العمل (`Workflow Data`)** لمراجعة القيم التي جمعتها العملية. ابحث داخل القسم عندما يحتوي سير العمل حقولًا كثيرة. تعامل مع القيم كسياق داعم، وتحقق من المستند الرئيسي قبل اتخاذ القرار. ## التعليقات السابقة يعرض **التعليقات السابقة (`Previous Comments`)** مدخلات المحادثة المتاحة من نشاط المهام السابق. اقرأها قبل الإجراء، خصوصًا إذا انتقلت المهمة بين مستويات مراجعة. ## إرسال إجراء للمهمة 1. اختر الإجراء المقصود تحت **إجراءات المهمة**. 2. أدخل تعليقًا إذا كان الإجراء يتطلبه. 3. تأكد من الملفات وتعليقات الحقول المطلوبة. 4. أرسل الإجراء مرة واحدة. 5. انتظر نتيجة النجاح أو الخطأ قبل مغادرة الصفحة. عندما تُحفظ التعليقات المرئية مع الإجراء، قد تنشئ المهمة إصدار مستند جديدًا. كما يدفع الإجراء سير العمل في المسار المضبوط له. ## المهام المكتملة بعد الإكمال، قد تصبح عناصر الإجراءات للقراءة فقط أو تغادر المهمة «مهامي». راجع تفاصيل سير العمل أو **حالة العملية (`Process Status`)** لتأكيد الحالة الناتجة. ## أدلة ذات صلة - [معاينة الملفات والتعليق على ملفات PDF في سير العمل](https://raptix.app/user-guide/ar/20-documents/20-3-viewing-annotating-pdfs/) - [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/) - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/ # إصدارات المستند > **الوحدة:** المستندات وعارض PDF في سير العمل > **الجمهور:** المستخدم النهائي ## ما معنى الإصدار؟ يمكن أن تحتفظ «المستندات» بعدة مراجعات للمستند المنطقي نفسه. تتلقى كل مراجعة رقم إصدار مثل `v1` أو `v2` أو `v3`. ويكون أعلى رقم حالي هو المراجعة التي يستخدمها سير العمل النشط وتظهر على أنها الحالية في عروض إدارة المستندات. قد تُنشأ إصدارات جديدة عندما تقوم مهمة سير عمل بما يأتي: - استبدال مستندها الرئيسي باستخدام **رفع إصدار جديد (`Upload New Version`)**؛ - حفظ تعليقات PDF المرئية كجزء من إجراء؛ - حفظ ملف PDF وافقت عليه المهمة أو رفضته أو علقته. ## عرض معلومات الإصدار افتح المستند من مهمة سير العمل التابعة له. يمكن أن يعرض عارض PDF: - رقم الإصدار المفتوح؛ - ما إذا كان الإصدار الحالي؛ - أحدث رقم إصدار متاح؛ - معلومات رفع المستند وحالته. يعرض مستكشف «المستندات» العادي شارة إصدار عندما تكون للملف مراجعات سابقة. اختر **سجل الإصدارات (`Version history`)** لرؤية كل مراجعة مع رقمها وتاريخها ورافعها وحجمها وتعليقها، وأيها الحالي. اختر **تنزيل** بجوار أي صف لتنزيل تلك المراجعة بعينها. يتبع سجل الإصدارات المستند نفسه لا اسم الملف القابل للتغيير. لا تفصل إعادة تسمية الملف، أو إنتاج PDF من مصدر Office، السجل إلى قسمين، ولا تظهر الملفات غير المرتبطة في المجلد نفسه كإصدارات بعضها لبعض. ## رفع إصدار جديد لا يظهر زر **رفع إصدار جديد** إلا عندما تسمح مهمة سير العمل بالاستبدال. 1. افتح مستند المهمة في عارض PDF. 2. اختر **رفع إصدار جديد**. 3. اختر الملف البديل. 4. أدخل تعليقًا يشرح التغيير إن أردت. 5. أكد الرفع. 6. انتظر تحميل الإصدار الجديد في العارض. يبقى المستند السابق إصدارًا أقدم. أما الرفع من **جديد ← رفع ملف** في مستكشف «المستندات»، فهو رفع ملف عادي وليس إجراء الاستبدال الموضح هنا. ## التعليقات المرئية والإصدارات عندما يحفظ إجراء مهمة تعليقات PDF المرئية، تُخزن النتيجة كإصدار جديد. وإذا لم تتغير بيانات الملف، فقد تكتمل المهمة من دون إنشاء نسخة إصدار غير ضرورية. ## ممارسات جيدة - أضف تعليق استبدال مفيدًا، مثل «تصحيح الإجماليات» أو «النسخة النهائية الموقعة». - تأكد أنك تعمل على أحدث إصدار قبل اتخاذ إجراء. - استخدم **سجل الإصدارات ← تنزيل** عندما تحتاج إلى مراجعة سابقة بعينها؛ فإجراء **التنزيل** الرئيسي على البطاقة ينزّل الإصدار الحالي دائمًا. - لا تصف مستكشف «المستندات» الرئيسي بأنه يدعم «استبدال» أو «رفع إصدار جديد»؛ فهذه العناصر تنتمي إلى مهام سير العمل المؤهلة. ## أدلة ذات صلة - [معاينة الملفات والتعليق على ملفات PDF في سير العمل](https://raptix.app/user-guide/ar/20-documents/20-3-viewing-annotating-pdfs/) - [مراجعة مهمة سير عمل والموافقة عليها](https://raptix.app/user-guide/ar/20-documents/20-4-reviewing-approving-workflow-task/) - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-6-finding-documents-search-favorites-bookmarks/ # العثور على المستندات: البحث والمفضلة والروابط > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** المستخدم النهائي ## البحث في العرض الحالي 1. افتح **التطبيقات ← المستندات**. 2. اختر النطاق العام أو مساحة العمل أو التطبيق أو الصفحة المناسبة. 3. أدخل نصًا في **البحث في المستندات... (`Search documents...`)**. 4. امسح الحقل لاستعادة مجموعة النتائج كاملة. يرشح البحث نطاق «المستندات» أو المجلد الحالي. إنه مرشح نصي لا أداة أسئلة وأجوبة بالذكاء الاصطناعي. يُضبط بحث المعرفة ويُستخدم من منطقتي «المعرفة» و«وكلاء الذكاء الاصطناعي». ## استخدام العرض المسطح للبحث الواسع عندما تعرف مساحة العمل أو التطبيق أو الصفحة الحالية لكن لا تعرف المجلد الداخلي، بدّل إلى **مسطح (`Flat`)**. فهو يجمع كل ملفات النطاق في قائمة واحدة، ويكون عادة أسرع من تصفح «الكيان ← المثيل ← الحقل». بدّل إلى **مجلدات (`Folders`)** عندما يهم الموقع نفسه أو تحتاج إلى إدارة مجلد. ## إضافة عنصر إلى المفضلة اختر النجمة على ملف أو مجلد لإضافته إلى المفضلة. تعني النجمة الذهبية أنه محفوظ. اخترها مرة أخرى لإزالته. العناصر المفضلة: - تحفظها المنصة في حسابك؛ - تتبعك عبر الجلسات المسجلة والأجهزة؛ - شخصية ولا تغير ترتيب مستخدم آخر؛ - تظهر قبل العناصر غير المفضلة، مع تطبيق الترتيب النشط داخل كل مجموعة. ## مشاركة موقع أو حفظه في المفضلة تستخدم «المستندات» عنوان «التطبيقات» الحالي، مثل: ```text /applications?view=documents&... ``` تحدد قيم الاستعلام الإضافية مساحة العمل أو التطبيق أو الصفحة أو مسار المجلد أو المستند المستهدف. انسخ عنوان المتصفح كاملًا بعد الوصول إلى الموقع المطلوب. لا يفتح المستلم السياق نفسه إلا إذا سمح دوره ومنح مستنداته بذلك. ## مسارات التنقل - اختر جزءًا من مسار التنقل للقفز إلى ذلك المستوى الأب. - اختر سهم الرجوع للصعود مستوى واحدًا. - في علامات «المستندات» محددة النطاق، تمثل العناصر الأولى في المسار مساحة العمل والتطبيق والصفحة المحددة. ## أدلة ذات صلة - [نظرة عامة على المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) - [تخصيص عرض المستندات](https://raptix.app/user-guide/ar/20-documents/20-8-customizing-document-view/) - [تنزيل المستندات](https://raptix.app/user-guide/ar/20-documents/20-7-downloading-documents-zip/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-7-downloading-documents-zip/ # تنزيل المستندات وملفات ZIP للمجلدات > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** المستخدم النهائي ## تنزيل ملف واحد 1. اعثر على الملف في وضع «مسطح» أو «مجلدات». 2. اختر **تنزيل (`Download`)** على البطاقة أو الصف. 3. استخدم عناصر التنزيل في المتصفح لفتحه أو حفظه. إذا لم يكن للملف معاينة مدعومة، يكون التنزيل هو الإجراء الرئيسي المتاح. ## تنزيل المجلدات كملف ZIP ينطبق التحديد المجمع على المجلدات لا الملفات الفردية. 1. بدّل إلى **مجلدات** وانتقل حتى تظهر مجلدات الكيان أو المثيل أو الحقل المطلوبة. 2. فعّل مربع اختيار كل مجلد. 3. استخدم **تحديد الكل (`Select All`)** لاختيار كل مجلد في العرض الحالي عند الحاجة. 4. اختر **تنزيل** من شريط الأدوات. 5. انتظر إعداد ملف ZIP وتنزيله. اختر **إلغاء تحديد الكل (`Deselect All`)** لمسح التحديد الحالي. ## قواعد التحديد - لا تحصل الملفات على مربعات تحديد مجمعة. - يؤثر «تحديد الكل» في مجلدات العرض الحالي فقط. - يبين عداد شريط الأدوات عدد المجلدات المحددة. - يقتصر المحتوى المنزّل على ما يعيده الخادم للنطاق المحدد ووفق وصولك. لا يعد دليل المستخدم بأن كل إصدار تاريخي يُضمّن في ZIP. استخدم عارض سير العمل أو «إدارة المستندات» عندما يجب التحقق من إصدار بعينه. ## الحذر من زر الحذف يفعّل تحديد المجلدات نفسه زر **حذف (N) (`Delete (N)`)**. ليس هذا إجراء سلة محذوفات، بل يحذف مستندات المجلدات المحددة نهائيًا ولا يمكن التراجع. تأكد أنك اخترت «تنزيل» لا «حذف». ## أدلة ذات صلة - [نظرة عامة على المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) - [العثور على المستندات](https://raptix.app/user-guide/ar/20-documents/20-6-finding-documents-search-favorites-bookmarks/) - [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-8-customizing-document-view/ # تخصيص عرض المستندات > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** المستخدم النهائي توفر «المستندات» نوعين مختلفين من عناصر التحكم في العرض. يمنع فهم الفرق بينهما الالتباس. ## العرض المسطح والمجلدات يتاح هذا العنصر عندما يكون المستكشف مضمّنًا في «التطبيقات». | الوضع | استخدمه عندما | |---|---| | مسطح (`Flat`) | تريد كل ملفات مساحة العمل أو التطبيق أو الصفحة المحددة في قائمة واحدة. | | مجلدات (`Folders`) | تريد تصفح مجلدات «الكيان ← المثيل ← الحقل» أو إدارتها. | يتذكر المتصفح وضع «مسطح/مجلدات» المحدد لزيارتك التالية. ## الشبكة والقائمة لا يغير وضعا «الشبكة» و«القائمة» إلا التخطيط: - **الشبكة (`Grid`)** تستخدم بطاقات وتعرض أزرار الإجراءات كاملة على كل عنصر. - **القائمة (`List`)** تستخدم صفوفًا مدمجة وإجراءات رمزية، وهو مفيد للنتائج الطويلة. ## ترتيب النتائج افتح قائمة الترتيب واختر: - **الاسم (`Name`)**؛ - **التاريخ (`Date`)**؛ - **الحجم (`Size`)**. اختر الخيار النشط مرة أخرى لعكس الاتجاه بين التصاعدي والتنازلي. تبقى المفضلة أعلى العناصر الأخرى. ## تعيين لون للمجلد عند إنشائه 1. بدّل إلى **مجلدات**. 2. انتقل إلى موقع يسمح بإنشاء كيان أو مثيل أو حقل. 3. اختر **جديد ← إنشاء مجلد**. 4. أدخل اسم المجلد. 5. اختر لونًا متاحًا. 6. اختر **إنشاء مجلد**. ## تغيير لون مجلد موجود 1. مرر المؤشر فوق مجلد كيان أو مثيل أو حقل، أو اعثر على إجراء لوحة الألوان في عرض القائمة. 2. اختر زر لوحة الألوان. 3. اختر لونًا واحفظه. 4. لإزالة اللون المخصص، استخدم **استعادة اللون الافتراضي (`Restore default color`)**. تحفظ المنصة الألوان، ويراها كل من يستطيع رؤية المجلد. وليست تفضيلًا خاصًا بكل جهاز. لا تعرض مجلدات مثيلات تشغيل سير العمل التي تبدأ أسماؤها بـ`run_` إجراءات إعادة التسمية أو تغيير اللون أو الحذف. ## أدلة ذات صلة - [نظرة عامة على المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) - [رفع الملفات وإنشاء المجلدات](https://raptix.app/user-guide/ar/20-documents/20-2-uploading-files-and-creating-folders/) - [العثور على المستندات](https://raptix.app/user-guide/ar/20-documents/20-6-finding-documents-search-favorites-bookmarks/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-9-per-document-permissions/ # صلاحيات المستند > **المسار:** `/documents/permissions/{documentId}` > **الجمهور:** المستخدمون المخولون إدارة المستند المحدد تمنح «صلاحيات المستند» مستخدمًا أو دورًا مسمى وصولًا إلى ملف واحد. ولا تمنح الوصول إلى كل ملف في المجلد الذي يحتويه. ## فتح صلاحيات المستند 1. افتح **التطبيقات ← المستندات**. 2. اعثر على الملف في وضع «مسطح» أو «مجلدات». 3. في عرض الشبكة، مرر المؤشر فوق البطاقة واختر **الصلاحيات (`Permissions`)**. 4. في عرض القائمة، اختر رمز الدرع من إجراءات الملف داخل الصف. يعرض المستكشف الحالي هذه العناصر مباشرة على البطاقة أو الصف. ## منح الصلاحية 1. تحت **منح صلاحية (`Grant Permission`)**، اختر **مستخدم (`User`)** أو **دور (`Role`)**. 2. للمستخدم، ابحث باسم المستخدم أو البريد واختر النتيجة الصحيحة. 3. للدور، اختره من قائمة الأدوار. 4. فعّل المربعات المطلوبة: | الخيار | ما يسمح به | |---|---| | **يمكنه العرض (`Can View`)** | فتح الملف وتنزيله. | | **يمكنه إعادة التسمية (`Can Rename`)** | تغيير اسم الملف. | | **يمكنه الحذف (`Can Delete`)** | حذف الملف من المستكشف ونقله إلى سلة المحذوفات. | 5. اختر **حفظ الصلاحية (`Save Permission`)**. ## مراجعة الصلاحية أو إزالتها تسرد **الصلاحيات الحالية (`Current Permissions`)** كل منحة صريحة لمستخدم أو دور، ومن منحها، وقيم العرض وإعادة التسمية والحذف. اختر رمز السلة بجوار مدخل لإزالة تلك المنحة الصريحة. لا تلغي إزالة مدخل واحد وصولًا توفره عضوية دور أو مجلد أب أو منحة عامة. ## العودة إلى المستندات اختر **العودة إلى المستندات (`Back to Documents`)**. إذا فُتحت الصفحة من رابط مستند حالي في «التطبيقات»، يعيدك RAPTIX إلى سياق «المستندات» ذاك. ## أدلة ذات صلة - [صلاحيات المجلد](https://raptix.app/user-guide/ar/20-documents/20-10-folder-permissions/) - [منح الصلاحيات العامة](https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/) - [سلة المحذوفات](https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-10-folder-permissions/ # صلاحيات المجلد > **المسار:** `/documents/folder-permissions` > **الجمهور:** المستخدمون المخولون إدارة نطاق المجلد المحدد تطبق «صلاحيات المجلد» منحة صريحة لمستخدم أو دور على نطاق كيان أو مثيل أو حقل. ## نطاقات المجلد المدعومة | النطاق | المستندات المشمولة | |---|---| | الكيان (`Entity`) | المستندات التابعة للكيان المحدد. | | المثيل (`Instance`) | المستندات التابعة لمثيل واحد من الكيان. | | الحقل (`Field`) | المستندات التابعة لحقل واحد في المثيل المحدد. | مساحة العمل والتطبيق والصفحة مجموعات للقراءة فقط، ولا تعرض بطاقاتها صفحة الصلاحيات هذه. ## فتح صلاحيات المجلد 1. افتح **التطبيقات ← المستندات** وبدّل إلى **مجلدات**. 2. انتقل حتى يظهر مجلد الكيان أو المثيل أو الحقل. 3. في عرض الشبكة، مرر المؤشر فوقه واختر **الصلاحيات (`Permissions`)**. 4. في عرض القائمة، اختر رمز الدرع من الإجراءات داخل الصف. تعرض ترويسة الصفحة اسم المجلد ومعلومات المالك التي تعيدها المنصة. ## منح الصلاحية 1. تحت **منح صلاحية (`Grant Permission`)**، اختر **مستخدم** أو **دور**. 2. ابحث عن المستخدم أو اختر الدور. 3. اختر: - **يمكنه العرض (`Can View`)** — فتح المستندات وتنزيلها ضمن نطاق المجلد. - **يمكنه إعادة التسمية (`Can Rename`)** — إعادة تسمية المستندات المشمولة. - **يمكنه الحذف (`Can Delete`)** — حذف المستندات المشمولة من المستكشف. 4. اختر **حفظ الصلاحية (`Save Permission`)**. ## الصلاحيات الحالية تعرض القائمة صاحب الصلاحية ونوعه والمستخدم الذي منحها وشارات العرض وإعادة التسمية والحذف النشطة. اختر رمز السلة لإزالة مدخل. لا تعرض «صلاحيات المجلد» خيارات **كل الملفات / الملفات المستقبلية / الملفات الموجودة**؛ فهذه النطاقات الزمنية الثلاثة تنتمي إلى **صلاحيات الملفات العامة** فقط. ## تراكب الصلاحيات تضيف منح المجلد وصولًا ولا ترفض وصولًا ممنوحًا من موضع آخر. وقد يظل المستخدم قادرًا على الوصول إلى مستند عبر منحة عامة أو دور آخر أو «صلاحية مستند» مباشرة بعد إزالة مدخل المجلد. ## أدلة ذات صلة - [صلاحيات المستند](https://raptix.app/user-guide/ar/20-documents/20-9-per-document-permissions/) - [منح الصلاحيات العامة](https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/) - [نطاقات الصلاحية العامة](https://raptix.app/user-guide/ar/20-documents/20-12-permission-scopes/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/ # صلاحيات الملفات العامة > **المسار:** `/documents/permission` > **الجمهور:** المسؤولون ومديرو الوصول المخولون تمنح «صلاحيات الملفات العامة» مستخدمًا أو دورًا وصولًا إلى المستندات على مستوى المؤسسة. استخدمها بعناية لأن نطاقها أوسع من صلاحيات المجلد أو المستند. ## فتح نطاق الصلاحية الصحيح 1. افتح **التطبيقات ← المستندات ← المزيد ← الصلاحيات**. 2. استخدم مبدّل **التطبيقات / المستندات (`Applications / Documents`)**. 3. أبقِ **المستندات** محددة لإدارة وصول الملفات. يرى المستخدم الذي لا يستطيع فتح المسار شاشة **الوصول مقيّد (`Access Restricted`)**. ## إنشاء منحة عامة 1. تحت **منح صلاحية (`Grant Permission`)**، اختر **مستخدم (`User`)** أو **دور (`Role`)**. 2. ابحث عن المستخدم أو اختر الدور. 3. اختر الصلاحيات المطلوبة: | الصلاحية | ما تسمح به | |---|---| | العرض والتنزيل (`View & Download`) | فتح الملفات المشمولة وتنزيلها. | | إعادة التسمية (`Rename`) | إعادة تسمية الملفات المشمولة. | | الحذف (`Delete`) | حذف الملفات الفردية المشمولة من المستكشف. | | صفحة الصلاحيات (`Permission Page`) | فتح صفحات صلاحيات الملفات وإدارتها. | 4. لا تستخدم **السماح بالكل (`Allow All`)** إلا إذا كنت تقصد الصلاحيات الأربع جميعًا. 5. تحت **تنطبق على (`Applies to`)**، اختر **كل الملفات (`All files`)** أو **الملفات المستقبلية (`Future files`)** أو **الملفات الموجودة (`Existing files`)**. 6. اختر **حفظ الصلاحية (`Save Permission`)**. ## المنح العامة النشطة تعرض القائمة صاحب الصلاحية وشاراتها ونطاق الملفات المختار والمستخدم الذي منحها ومعلومات الوقت المتاحة لكل منحة. اختر رمز الإزالة لإلغاء ذلك المدخل العام. لا تزيل إزالة المنحة العامة «صلاحيات مجلد» أو «صلاحيات مستند» منفصلة يحملها المستخدم أو الدور نفسه. ## التنقل السريع استخدم **التنقل السريع إلى الصلاحيات (`Quick Navigate to Permissions`)** عندما تعرف معرّفات الهدف: - لصلاحيات المجلد، اختر كيانًا أو مثيلًا أو حقلًا وأدخل المعرّفات المطلوبة. - لصلاحيات الملف، أدخل معرّف المستند. - اختر **فتح صفحة الصلاحيات (`Open Permissions Page`)**. للتنقل العادي، من الأكثر أمانًا فتح الصلاحيات من المجلد أو الملف الظاهر كي يملأ المستكشف المعرّفات. ## أدلة ذات صلة - [نطاقات الصلاحية العامة](https://raptix.app/user-guide/ar/20-documents/20-12-permission-scopes/) - [صلاحيات المجلد](https://raptix.app/user-guide/ar/20-documents/20-10-folder-permissions/) - [صلاحيات المستند](https://raptix.app/user-guide/ar/20-documents/20-9-per-document-permissions/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-12-permission-scopes/ # نطاقات الصلاحية العامة > **المسار:** `/documents/permission` > **الجمهور:** المسؤولون ومديرو الوصول المخولون محدد **تنطبق على (`Applies to`)** جزء من «صلاحيات الملفات العامة»، ويتحكم في الملفات التي تغطيها المنحة العامة. ## النطاقات المتاحة | النطاق | الوصف الظاهر في المنتج | المعنى | |---|---|---| | كل الملفات (`All files`) | الملفات الموجودة والمستقبلية | يغطي الملفات الموجودة بالفعل وتلك التي تُرفع لاحقًا. | | الملفات المستقبلية (`Future files`) | الملفات المرفوعة بعد هذه المنحة | لا يغطي الملفات التي كانت موجودة قبل المنحة. | | الملفات الموجودة (`Existing files`) | الملفات المرفوعة عند وقت المنحة | لا يغطي تلقائيًا ما يُرفع لاحقًا. | ## اختيار نطاق - استخدم **كل الملفات** فقط عندما يحتاج المستخدم أو الدور إلى وصول مستمر على مستوى المؤسسة. - استخدم **الملفات المستقبلية** عندما يجب أن يبدأ الوصول مع عمليات الرفع الجديدة. - استخدم **الملفات الموجودة** لمجموعة الملفات المخزنة في لحظة زمنية محددة. لكل مدخل عام نطاق واحد. ولتغطية الملفات الموجودة والمستقبلية معًا، اختر **كل الملفات**. ## تغيير نطاق لا توفر الصفحة تعديلًا داخل الصف للمدخل النشط. أزل المنحة العامة الموجودة واحفظها من جديد بالصلاحيات والنطاق الجديدين. ## مواضع لا تظهر فيها هذه النطاقات - تستخدم **صلاحيات المجلد** الكيان أو المثيل أو الحقل كنطاق مكاني، ولا تحتوي محدد الكل أو المستقبلية أو الموجودة. - تستهدف **صلاحيات المستند** ملفًا واحدًا محددًا دائمًا. لا تصف النطاقات الزمنية العامة الثلاثة بأنها خيارات في «صلاحيات المجلد». ## أدلة ذات صلة - [منح الصلاحيات العامة](https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/) - [صلاحيات المجلد](https://raptix.app/user-guide/ar/20-documents/20-10-folder-permissions/) - [صلاحيات المستند](https://raptix.app/user-guide/ar/20-documents/20-9-per-document-permissions/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/ # سلة المحذوفات: استعادة الملفات المحذوفة > **المسار:** `/documents/trash` > **الجمهور:** المستخدمون الذين يستطيع دورهم فتح سلة محذوفات المستندات تسرد «سلة المحذوفات» الملفات الفردية التي حُذفت حذفًا مرنًا من مستكشف «المستندات». وهي تتيح الاستعادة لا الحذف النهائي. ## فتح سلة المحذوفات استخدم أحد هذين المسارين عندما يكون الخيار ظاهرًا لدورك: - **التطبيقات ← المستندات ← المزيد ← سلة المحذوفات**؛ - **إدارة المستندات ← سلة محذوفات المستندات (`Document trash`)**. يؤدي فتح المسار المباشر دون صلاحية الصفحة المطلوبة إلى **الوصول مقيّد (`Access Restricted`)**. يعتمد الظهور على الدور الحالي وصلاحيات الصفحات. ## العثور على ملف محذوف استخدم حقل البحث لمطابقة المعلومات المتاحة مثل: - اسم الملف؛ - اسم مساحة العمل أو التطبيق أو الصفحة؛ - معلومات الكيان أو المثيل أو الحقل أو خطوة سير العمل؛ - الشخص الذي رفع الملف. امسح حقل البحث لعرض نتائج سلة المحذوفات كاملة من جديد. ## استعادة ملف 1. تأكد من اسم الملف والموقع المعروض. 2. اختر **استعادة (`Restore`)**. 3. انتظر رسالة النجاح. 4. ارجع إلى «المستندات» وافتح موقعه الأصلي. لا توفر سلة المحذوفات استعادة مجمعة؛ استعد الملفات واحدًا واحدًا. ## ما لا تستطيع سلة المحذوفات استعادته لا تحتوي السلة عناصر أزيلت بالحذف النهائي. لا يمكن التراجع عن الإجراءات الآتية منها: - حذف مجلد كيان أو مثيل أو حقل من المستكشف؛ - حذف مجلدات محددة باستخدام **حذف (N) (`Delete (N)`)**؛ - استخدام **حذف نهائي (`Delete Permanently`)** في «إدارة المستندات». إذا لم تعد البنية الأصلية الأب موجودة، فقد تفشل الاستعادة وتعرض الصفحة الخطأ المعاد. ## ما لا توفره سلة المحذوفات لا تتضمن الصفحة الحالية زر حذف نهائيًا ولا عنصر تحكم موثقًا في مدة الاحتفاظ. لا تعد باحتفاظ غير محدود، ولا تقل إن المسؤول يستطيع مسح ملف نهائيًا من هذه الصفحة. ## أدلة ذات صلة - [رفع الملفات وإنشاء المجلدات](https://raptix.app/user-guide/ar/20-documents/20-2-uploading-files-and-creating-folders/) - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) - [إدارة المستندات وصلاحياتها وسلامتها](https://raptix.app/user-guide/ar/20-documents/20-17-admin-roles-permissions-security/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-14-audit-log/ # سجلات نشاط المستندات > **المسار:** `/documents/logs` > **الجمهور:** المستخدمون المخولون فتح سجلات المستندات تعرض «سجلات نشاط المستندات» أحداث المستندات المسجلة. وهي عرض تحقيق قابل للبحث؛ ولا تحدد الصفحة نفسها سياسة الاحتفاظ أو عدم القابلية للتغيير أو الامتثال التنظيمي في بيئة النشر ولا تعد بها. ## فتح سجلات المستندات 1. افتح **التطبيقات ← المستندات**. 2. اختر **المزيد ← السجلات (`More → Logs`)**. 3. في صفحة السجلات، أبقِ **المستندات** محددة في مبدّل **التطبيقات / المستندات**. إذا لم يستطع دورك فتح المسار، يعرض RAPTIX شاشة **الوصول مقيّد** مع إجرائي **رجوع (`Go Back`)** و**فتح الرئيسية (`Open Home`)**. ## الملخص تعرض الترويسة: - **إجمالي الأحداث (`Total Events`)** — عدد الأحداث المطابقة للاستعلام النشط؛ - **المرفوضة (`Denied`)** — الأحداث المطابقة التي تشير نتيجتها إلى رفض الوصول. ## البحث والمرشحات افتح **إظهار المرشحات (`Show Filters`)** لاستخدام العناصر التي توفرها الصفحة: - بحث نصي واسع؛ - اليوم، أو 7 أيام، أو 30 يومًا، أو هذا الشهر، أو نطاق «من/إلى» مخصص؛ - بريد المنفذ (`Actor Email`)؛ - اسم الدور (`Role Name`)؛ - الإجراء (`Action`)؛ - النتيجة (`Outcome`)؛ - معرّف الكيان (`Entity ID`)؛ - معرّف المثيل (`Instance ID`)؛ - اسم الحقل (`Field Name`)؛ - اسم الملف (`File Name`). استخدم **إعادة تعيين (`Reset`)** للعودة إلى حالة المرشحات الافتراضية. تعتمد خيارات الترشيح على القيم التي تعيدها خدمة السجل. ## قراءة الجدول قد يتضمن كل صف: | العمود | المعنى | |---|---| | الوقت (UTC) | وقت الحدث المسجل. | | الاسم / البريد / الأدوار | معلومات المنفذ المتاحة للحدث. | | التطبيق / القسم / الإجراء | موضع الحدث وما سُجل. | | الملف / المجلد | أكثر هدف مسجل صلة بالحدث. | | IP | عنوان الشبكة المسجل عند توفره. | | التفاصيل (`Details`) | تفتح درج الحدث الكامل. | استخدم «السابق» و«التالي» للتنقل بين صفحات النتائج. ## التفسير بحذر - الحدث المرفوض دليل مفيد على طلب حُظر، لكن ينبغي مراجعة سياقه في «التفاصيل». - غياب الحدث ليس دليلًا على أن الإجراء لم يقع؛ فتغطية التسجيل يحددها تنفيذ الخادم وإعداد النشر. - لا تحتوي الشاشة عنصر تصدير CSV. - أكد متطلبات الاحتفاظ والامتثال مع مؤسستك بدل التعامل مع الواجهة كبيان سياسة. ## أدلة ذات صلة - [تفاصيل سجل التدقيق](https://raptix.app/user-guide/ar/20-documents/20-15-audit-log-detail/) - [منح الصلاحيات العامة](https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/) - [إدارة المستندات وصلاحياتها وسلامتها](https://raptix.app/user-guide/ar/20-documents/20-17-admin-roles-permissions-security/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-15-audit-log-detail/ # تفاصيل سجل التدقيق > **المسار:** `/documents/logs` > **الجمهور:** المستخدمون المخولون فتح سجلات المستندات «تفاصيل سجل التدقيق» درج يُفتح من صف واحد في سجل المستندات. يعرض الحقول المسجلة لذلك الحدث، وقد تُحذف الحقول التي لا قيمة لها. ## فتح الدرج وإغلاقه 1. افتح «سجلات نشاط المستندات». 2. ابحث أو رشح حتى تجد الصف المطلوب. 3. اختر **التفاصيل (`Details`)**. 4. أغلق الدرج بزر X أو Escape أو الخلفية. تبقى مرشحات السجل متاحة بعد إغلاق الدرج. ## الحقول التي قد تراها | المجموعة | أمثلة | |---|---| | الهوية | معرّف السجل، ومعرّف الطلب، ووقت الحدوث. | | التصنيف | التطبيق، والقسم، والإجراء، والنتيجة. | | الطلب | طريقة HTTP، ونقطة النهاية، ورمز الحالة. | | المنفذ | الاسم، والبريد، والأدوار. | | المورد | نوع المورد ومساره، والكيان، والمثيل، والحقل، ومعرّف المستند، واسم الملف. | | هدف الصلاحية | نوع صاحب الصلاحية ومعرّفه واسمه. | | الشبكة أو الخطأ | عنوان IP ورسالة الخطأ. | | بيانات إضافية | ملخص التغيير والبيانات الوصفية عندما تكون مسجلة. | ## التحقيق في حدث مرفوض تحقق من المنفذ وأدواره والإجراء والمورد والنتيجة ورمز الحالة والوقت ومعلومات IP المتاحة. تعني النتيجة المرفوضة أن الطلب المسجل حُظر، لكنها لا تثبت وحدها وجود نية ضارة. ## التحقيق في حذف 1. رشح باسم الملف وإجراء متعلق بالحذف إن أمكن. 2. افتح «التفاصيل» وتأكد من المستند والمنفذ والوقت والنطاق. 3. إذا كان ملفًا فرديًا حُذف حذفًا مرنًا، فابحث عنه في سلة المحذوفات. 4. إذا كان حذف مجلد نهائيًا أو حذفًا من «إدارة المستندات»، فلا تستطيع السلة استعادته. ## استخدام المعرّفات عند طلب المساعدة سجل معرّف السجل ومعرّف الطلب عند توفرهما؛ فهما يساعدان الدعم على ربط حدث الواجهة بسجلات الخادم. لا يملك الدرج عنوانًا مخصصًا قابلًا للمشاركة ولا زر تصدير. لا يثبت وجود الحقول التقنية وحده معيار امتثال أو ضمان عدم التغيير أو مدة احتفاظ. ## أدلة ذات صلة - [سجلات نشاط المستندات](https://raptix.app/user-guide/ar/20-documents/20-14-audit-log/) - [سلة المحذوفات](https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/) - [إدارة المستندات وصلاحياتها وسلامتها](https://raptix.app/user-guide/ar/20-documents/20-17-admin-roles-permissions-security/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-16-document-management/ # إدارة المستندات > **المسار:** `/process-documents` > **الجمهور:** المستخدمون الذين يستطيع دورهم فتح «إدارة المستندات» «إدارة المستندات» هي المخزون التشغيلي للمستندات المخزنة. تدعم الترشيح والمعاينة والتنزيل والاستعادة والحذف النهائي المجمع. وليست شاشة فهرسة للذكاء الاصطناعي، ولا تحتوي إجراء «فهرسة المستندات». ## فتح إدارة المستندات افتح **التطبيقات ← المستندات ← المزيد ← معالجة المستندات (`Process Documents`)**. تعرض ترويسة الصفحة **إدارة المستندات (`Document Management`)** وعدد المستندات المعروضة. بحسب الدور والبيانات الحالية، قد تعرض الترويسة أيضًا: - **إعادة إسناد المستندات (`Reassign documents`)** — تظهر للمسؤول عندما توجد مجلدات مستندات غير مسندة؛ - **سلة محذوفات المستندات (`Document trash`)** — تفتح السلة عندما يُسمح بها؛ - **المرشحات (`Filters`)** — توسع لوحة الترشيح؛ - **تحديث (`Refresh`)** — يعيد تحميل المخزون؛ - **حذف (N) (`Delete (N)`)** — يظهر بعد تحديد صفوف. ## ترشيح المستندات | المرشح | الغرض | |---|---| | البحث | يطابق معلومات الملف والشخص والتعليق المتاحة. | | الحقل (`Field`) | يقصر النتائج على حقل مستند. | | خطوة سير العمل (`Workflow step`) | يقصر النتائج على تسمية عقدة أو خطوة. | | الحالة (`Status`) | الكل، أو نشط، أو محذوف، أو مؤرشف. | | التوقيع (`Signature`) | موافَق عليه، أو مرفوض، أو معلّق عليه، أو غير موقّع. | | رُفع بواسطة (`Uploaded by`) | يطابق معلومات من رفع الملف. | | من / إلى (`From / To`) | يقصر النتائج حسب تاريخ الرفع، ويبلغ عن النطاقات غير الصالحة. | | الإصدارات الحالية فقط (`Current versions only`) | يخفي المراجعات الأقدم عند تحديده. | اختر **مسح المرشحات (`Clear filters`)** لإعادة ضبط اللوحة. تُستنتج قيمة «التوقيع» من أسماء حقول المستند وتعليقاته. وهي إشارة إدارية لا سجل توقيع تشفيريًا. ## قراءة الجدول يتضمن الجدول: - الملف والمصدر؛ - خطوة سير العمل؛ - الإصدار وحالة الإصدار الحالي؛ - التوقيع؛ - معلومات الرفع؛ - الحالة؛ - الإجراءات. استخدم عناصر الصفحات أسفل الجدول للتنقل في مجموعات النتائج الكبيرة. ## المعاينة والتنزيل - اختر إجراء العين لمعاينة ملف مدعوم ومراجعة بياناته الوصفية. - اختر «تنزيل» لحفظ الملف. - توفر الأنواع غير المدعومة تنزيلًا كبديل. ## استعادة مستند محذوف 1. اضبط مرشح الحالة على **محذوف (`Deleted`)**. 2. اختر إجراء **استعادة (`Restore`)** في الصف. 3. أكد الإجراء. 4. انتظر تأكيد النجاح. يمكنك أيضًا استخدام **سلة محذوفات المستندات** للعرض المخصص. ## حذف المستندات نهائيًا 1. حدد صفوفًا منفردة أو جميع صفوف الصفحة الحالية. 2. اختر **حذف (N)**. 3. راجع كل اسم ملف في مربع التأكيد. 4. لا تختر **حذف نهائي (`Delete Permanently`)** إلا عندما يجب إزالة الملفات. يحذف هذا الإجراء سجلات قاعدة البيانات والملفات الفعلية. ولا يمكن التراجع أو الاستعادة من سلة المحذوفات. ## إعادة إسناد المستندات غير المسندة عندما يظهر **إعادة إسناد المستندات**، يفتح `/applications/reassign`. استخدم الشاشة لربط مجلدات المستندات القديمة بمساحة عمل وتطبيق وصفحة. راجع [إعادة إسناد المستندات](https://raptix.app/user-guide/ar/50-applications/50-32-reassign-documents/). ## توضيح الذكاء الاصطناعي والمعرفة لا تؤدي إعادة تحميل «إدارة المستندات» أو فتحها إلى فهرسة الملفات للذكاء الاصطناعي. تُضبط مستندات المعرفة وسياسات الوصول والمزامنة التلقائية في قسم «المعرفة». ## أدلة ذات صلة - [سلة المحذوفات](https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/) - [إصدارات المستند](https://raptix.app/user-guide/ar/20-documents/20-5-document-versions/) - [سجلات نشاط المستندات](https://raptix.app/user-guide/ar/20-documents/20-14-audit-log/) - [إعادة إسناد المستندات](https://raptix.app/user-guide/ar/50-applications/50-32-reassign-documents/) --- URL: https://raptix.app/user-guide/ar/20-documents/20-17-admin-roles-permissions-security/ # إدارة المستندات وصلاحياتها وسلامتها > **الوحدة:** التطبيقات ← المستندات > **الجمهور:** مسؤولو مساحة العمل ومديرو الوصول المخولون يلخص هذا الدليل واجهات الإدارة الظاهرة فعليًا في «المستندات». يتحدد الوصول الدقيق بدور المستخدم وصلاحية الصفحة ومنح المستندات في الخادم. ## أدوات المستندات افتح **التطبيقات ← المستندات ← المزيد**. لا تكشف القائمة إلا الأدوات المتاحة: | الأداة | المسار | الغرض | |---|---|---| | الصلاحيات (`Permissions`) | `/documents/permission` | منح الملفات العامة والتنقل السريع. | | السجلات (`Logs`) | `/documents/logs` | نشاط المستندات المسجل. | | سلة المحذوفات (`Trash`) | `/documents/trash` | استعادة الملفات الفردية المحذوفة حذفًا مرنًا. | | معالجة المستندات (`Process Documents`) | `/process-documents` | مخزون المستندات وإجراءات الإدارة النهائية. | تحتوي صفحتا «الصلاحيات» و«السجلات» مبدّل **التطبيقات / المستندات**. تأكد من الجانب الصحيح قبل تغيير الوصول أو مراجعة النشاط. ## مستويات الصلاحيات الثلاثة ### صلاحيات الملفات العامة تنطبق المنح العامة على مستوى المؤسسة بحسب نطاق **كل الملفات** أو **الملفات المستقبلية** أو **الملفات الموجودة** المحدد. الصلاحيات المتاحة هي: - العرض والتنزيل؛ - إعادة التسمية؛ - الحذف؛ - صفحة الصلاحيات. تسرد الصفحة «المنح العامة النشطة»، وتحتوي «تنقلًا سريعًا» لفتح صفحة صلاحيات مجلد أو ملف معروف. ### صلاحيات المجلد تستهدف منح المجلد كيانًا أو مثيلًا أو حقلًا واحدًا. تحتوي «يمكنه العرض» و«يمكنه إعادة التسمية» و«يمكنه الحذف»، ولا تحتوي محدد «الكل/المستقبلية/الموجودة» العام. ### صلاحيات المستند تستهدف منح المستند معرّف مستند واحدًا وتحتوي «يمكنه العرض» و«يمكنه إعادة التسمية» و«يمكنه الحذف». المنح تراكمية؛ فإزالة مدخل صريح واحد لا تتجاوز وصولًا يمنحه دور آخر أو منحة أوسع. ## نموذج سلامة الحذف | الإجراء | هل يمكن استعادته؟ | من أين؟ | |---|---|---| | حذف ملف واحد في المستندات | نعم | استعده من سلة المحذوفات أو إدارة المستندات. | | حذف مجلد | لا | يحذف المستندات التي يحتويها نهائيًا. | | حذف مجلدات محددة | لا | يحذف كل المستندات التي تحتويها نهائيًا. | | «حذف نهائي» في إدارة المستندات | لا | يحذف سجلات قاعدة البيانات والملفات الفعلية. | ميّز دائمًا بين الحذف المرن للملف والحذف النهائي للمجلد أو من جدول الإدارة. ## مجلدات سير العمل تُحمى مجلدات مثيلات تشغيل سير العمل التي تبدأ أسماؤها بـ`run_` من إجراءات إعادة التسمية والحذف في مستكشف «المستندات». يمنع ذلك إجراءات المجلد العادية من الإخلال بالبنية التي أنشأها سير العمل. ## الصفحات المقيّدة إذا افتقر مستخدم مسجل إلى صلاحية صفحة مطلوبة، يعرض RAPTIX **الوصول مقيّد (`Access Restricted`)**، ويحدد الصلاحية الإضافية، ويقدم **رجوع (`Go Back`)** و**فتح الرئيسية (`Open Home`)**. لا توثق إعادة توجيه تلقائية إلى الرئيسية. ## عبارات أمنية ينبغي تجنبها ينبغي أن يصف دليل المستخدم السلوك الملحوظ من دون وعود تنفيذية أو سياسية لا تثبتها الواجهة. لا تدّع، اعتمادًا على هذه الشاشات وحدها، أن: - كل عرض أو بحث أو إجراء ممكن يُسجل؛ - السجلات مقاومة للعبث أو محفوظة إلى الأبد؛ - الملفات لا يمكن أن تكشف مسار تخزين مطلقًا؛ - كل رفع مكرر يُزال تكراره تلقائيًا؛ - فتح «معالجة المستندات» يشغّل فهرسة الذكاء الاصطناعي. استخدم وثائق الأمان والاحتفاظ والامتثال الخاصة ببيئة النشر لمثل هذه الضمانات. ## أدلة ذات صلة - [منح الصلاحيات العامة](https://raptix.app/user-guide/ar/20-documents/20-11-global-permission-grants/) - [نطاقات الصلاحية العامة](https://raptix.app/user-guide/ar/20-documents/20-12-permission-scopes/) - [سلة المحذوفات](https://raptix.app/user-guide/ar/20-documents/20-13-trash-recover-deleted-files/) - [سجلات نشاط المستندات](https://raptix.app/user-guide/ar/20-documents/20-14-audit-log/) - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-1-getting-started-first-conversation/ # بدء أول محادثة مع وكلاء الذكاء الاصطناعي > **المنطقة:** وكلاء الذكاء الاصطناعي > > **الجمهور:** المستخدمون الذين يمكنهم الوصول إلى مساعد نشط واحد على الأقل ## بدء محادثة 1. افتح **وكلاء الذكاء الاصطناعي (`AI Agents`)** أو انتقل إلى `/ai-agents`. 2. استخدم **الكل (`All`)** أو **متصل (`Connected`)** أو **مستند (`Document`)** و**البحث عن مساعدين… (`Search assistants…`)** للعثور على مساعد. 3. اختر بطاقته. تفتح محادثة جديدة على `/ai-agents//new`. 4. أدخل سؤالًا. اضغط **Enter** للإرسال أو **Shift+Enter** لسطر جديد. 5. بعد حفظ الرسالة الأولى، يتغير العنوان إلى عنوان URL الفريد للمحادثة. استخدم مساعدًا من نوع **مستند** لإجابات تستند إلى المعرفة المضبوطة. ويرسل مساعد **متصل** الطلب إلى الخدمة الخارجية التي أعدها المسؤول. ## قراءة الإجابة قد تحتوي الإجابة نصًا منسقًا وجداول وروابط واقتراحات واستشهادات. افتح استشهادًا أو بطاقة تحت **المصادر (`Sources`)** قبل الاعتماد على معلومة مهمة. واستخدم زري الإعجاب وعدم الإعجاب للإبلاغ عن فائدة الإجابة. قد ترى أيضًا **شرائح أثر الأدوات** الصغيرة أسفل الإجابة، مثل `search_document_content · found 3 results`. يعمل المساعد الذكي بصورة وكيلة، وتوضح هذه الشرائح الأداة المضمنة التي استخدمها لبناء الإجابة، مثل البحث في مستنداتك أو البحث عن سير عمل أو مراجعة الويب. وهي معلومات توضيحية؛ وتعني شريحة تحمل رمز تحذير أن الخطوة لم تكتمل. راجع [إعداد مساعد ذكي](https://raptix.app/user-guide/ar/30-ai-agents/30-19-admin-smart-assistants/) للقائمة الكاملة للأدوات. لا تدخل كلمات مرور أو رموز وصول أو أسرارًا. إذا فشل الإرسال، فأبقِ السؤال وأعد المحاولة مرة واحدة، ثم تواصل مع الدعم إذا استمرت المشكلة. ## أدلة ذات صلة - [استخدام وكلاء الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-28-ai-agents-current/) - [الاستشهادات وبطاقات المصادر](https://raptix.app/user-guide/ar/30-ai-agents/30-5-citations-and-source-cards/) - [إدارة سجل المحادثات](https://raptix.app/user-guide/ar/30-ai-agents/30-11-managing-chat-history/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-2-ai-agents-hub-navigation/ # التنقل في مركز وكلاء الذكاء الاصطناعي افتح `/ai-agents` لرؤية المساعدين النشطين المتاحين لحسابك. يُرتب المساعدون أبجديًا، ولا يظهر غير النشط أو المقيّد. يحتوي المركز: - مرشحات **الكل** و**متصل** و**مستند** مع الأعداد؛ - **البحث عن مساعدين…** الذي يبحث في الاسم والوصف والنوع؛ - بطاقات المساعدين بالاسم والوصف والنوع؛ - روابط تراعي الصلاحيات إلى **إدارة المساعدين (`Manage assistants`)** و**قاعدة المعرفة (`Knowledge base`)** و**توثيق الذكاء الاصطناعي (`AI authentication`)** و**التحليلات (`Analytics`)**. يبدأ اختيار بطاقة محادثة جديدة. ولا تظهر الروابط الإدارية إلا عندما يملك حسابك الوصول المطابق. إذا رأيت **لا يوجد مساعدون بعد (`No assistants yet`)**، فاطلب من المسؤول تنشيط المساعد المطلوب أو مشاركته. وإذا رأيت **لم يُعثر على مساعدين (`No assistants found`)**، فامسح البحث أو المرشح. واستخدم **إعادة المحاولة (`Retry`)** بعد خطأ تحميل. ## أدلة ذات صلة - [البحث عن المساعدين وترشيحهم](https://raptix.app/user-guide/ar/30-ai-agents/30-3-searching-filtering-assistants/) - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-3-searching-filtering-assistants/ # البحث عن المساعدين وترشيحهم استخدم العناصر في `/ai-agents` لتقليص دليل المساعدين: | عنصر التحكم | النتيجة | |---|---| | **الكل (`All`)** | يعرض كل مساعد نشط متاح لك. | | **متصل (`Connected`)** | يعرض المساعدين المتصلين بخدمة خارجية. | | **مستند (`Document`)** | يعرض المساعدين الذين يجيبون من المعرفة المضبوطة. | | **البحث عن مساعدين… (`Search assistants…`)** | يطابق اسم المساعد أو وصفه أو نوعه. | يعمل البحث والمرشحات معًا. يبين الرقم على كل مرشح العدد المتاح لذلك النوع. ويظل المساعد مخفيًا إذا كان غير نشط أو كانت رؤيته تستبعد حسابك. استخدم **مسح المرشحات (`Clear filters`)** عندما لا تطابق نتيجة. وإذا رأى زميل مساعدًا لا تراه، فاطلب من مالكه مراجعة حالة **نشط (`Active`)** وإعداد **الرؤية (`Visibility`)**. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-28-ai-agents-current/ # استخدام وكلاء الذكاء الاصطناعي > **المنطقة:** وكلاء الذكاء الاصطناعي > > **الجمهور:** جميع المستخدمين الذين يملكون وصولًا إلى وكلاء الذكاء الاصطناعي > > **الوصول المطلوب:** الوصول إلى وكلاء الذكاء الاصطناعي وإلى مساعد نشط واحد على الأقل > > **ما ستتعلمه:** كيفية العثور على مساعد، وفهم روابط الإدارة المتاحة، وبدء محادثة، والتعامل مع جميع حالات الدليل. ## فتح وكلاء الذكاء الاصطناعي اختر **وكلاء الذكاء الاصطناعي (`AI Agents`)** من التنقل أو افتح `/ai-agents`. تعرض الصفحة المساعدين النشطين المتاحين لحسابك، ولا تعرض غير النشطين أو المقيّدين بأدوار أخرى. ## العثور على المساعد المناسب تعرض الصفحة المساعدين النشطين المسموحين لحسابك وترتبهم أبجديًا. استخدم الدليل من أجل: - اختيار **الكل (`All`)** أو **متصل (`Connected`)** أو **مستند (`Document`)** لترشيح المساعدين؛ - قراءة العدد على كل مرشح؛ - استخدام **البحث عن مساعدين (`Search assistants`)** للعثور عليهم بالاسم أو الوصف أو النوع؛ - فتح بطاقة مساعد لبدء محادثة. اختر مساعد «مستند» عندما تحتاج إجابات مستندة إلى معرفته المضبوطة. واختر مساعد «متصل» عندما تناسب خدمته الخارجية المهمة الموضحة في بطاقته. ## استخدام روابط الإدارة عندما تظهر قد يرى المستخدمون ذوو الوصول الإداري المناسب روابط سريعة أعلى الدليل: | الرابط | الغرض | |---|---| | **إدارة المساعدين (`Manage assistants`)** | إنشاء المساعدين وإعدادهم وتنشيطهم وتقييدهم أو حذفهم. | | **قاعدة المعرفة (`Knowledge base`)** | إضافة المستندات المستخدمة للإجابات المستندة إلى المصادر ومعالجتها. | | **توثيق الذكاء الاصطناعي (`AI authentication`)** | إعداد اتصالات المزود والنماذج وربط النموذج الافتراضي. | | **التحليلات (`Analytics`)** | مراجعة نشاط أسئلة الذكاء الاصطناعي وقاعدة المعرفة والأمان. | تراعي هذه الروابط الصلاحيات. يستطيع المستخدم العادي استخدام دليل المساعدين من دون رؤية روابط الإدارة. ## بدء محادثة ومتابعتها 1. افتح بطاقة المساعد. 2. اطرح سؤالًا واضحًا وأضف سياق العمل المناسب. 3. اقرأ الرد وأي استشهادات أو روابط مصادر ظاهرة. 4. تابع في المحادثة نفسها عندما يعتمد السؤال التالي على الإجابة السابقة. لا تدخل كلمات مرور أو رموز وصول أو أسرارًا أخرى في المحادثة. ## عندما يكون الدليل فارغًا تعني **لا يوجد مساعدون بعد (`No assistants yet`)** عدم وجود مساعد نشط متاح لدورك. تواصل مع المسؤول وحدد نوع المساعدة التي تحتاجها. وتعني **لم يُعثر على مساعدين (`No assistants found`)** أن البحث أو المرشح الحالي بلا تطابق؛ اختر **مسح المرشحات (`Clear filters`)** أو امسح البحث. وتعني حالة التحميل أن الدليل ما زال قيد الجلب. إذا فشل التحميل، فاستخدم **إعادة المحاولة (`Retry`)** قبل الإبلاغ. تشرح أدلة المحادثة أدناه الاستشهادات والرفع والتغذية الراجعة والسجل والمشاركة واللغة وإعدادات كل جلسة بمزيد من التفصيل. ## أدلة ذات صلة - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) - [إدارة مستندات المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [البدء بأول محادثة](https://raptix.app/user-guide/ar/30-ai-agents/30-1-getting-started-first-conversation/) - [الاستشهادات وبطاقات المصادر](https://raptix.app/user-guide/ar/30-ai-agents/30-5-citations-and-source-cards/) - [إدارة سجل المحادثات](https://raptix.app/user-guide/ar/30-ai-agents/30-11-managing-chat-history/) - [استخدام فقاعات المحادثة العائمة](https://raptix.app/user-guide/ar/30-ai-agents/30-31-floating-chat-bubbles/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-5-citations-and-source-cards/ # استخدام الاستشهادات وبطاقات المصادر قد تعرض الإجابات المستندة إلى المستندات شرائح استشهاد مرقمة في الرد وبطاقات تحت **المصادر (`Sources`)**. وقد يكون المصدر ملف PDF أو صورة أو عنوان ويب أو عنصرًا نصيًا. 1. اختر شريحة استشهاد لفتح مصدرها المطابق. 2. وسع بطاقة مصدر لقراءة المقتطف المتاح. 3. استخدم **فتح المصدر (`Open source`)** لفحص الأصل. وقد يظهر أيضًا إجراء تنزيل للمستندات المخزنة المدعومة. 4. قارن المقطع المستشهد به بالادعاء قبل استخدام الإجابة في قرار. يربط رقم المصدر الادعاء بالبطاقة المطابقة. الاستشهاد دليل داعم، وليس ضمانًا أن الإجابة فسّرته بصورة صحيحة. إذا لم يتوفر مصدر، فجرّب استشهادًا آخر وأبلغ عن الإجابة بتغذية **مصادر سيئة (`Bad sources`)** عند الحاجة. ## أدلة ذات صلة - [قراءة استشهاد PDF](https://raptix.app/user-guide/ar/30-ai-agents/30-6-pdf-viewer-highlighted-citations/) - [إرسال تغذية راجعة عن الإجابة](https://raptix.app/user-guide/ar/30-ai-agents/30-9-feedback-thumbs-up-down/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-6-pdf-viewer-highlighted-citations/ # قراءة استشهاد PDF اختر استشهاد PDF أو بطاقة مصدره لفتح عارض المستند. في الشاشة العريضة يفتح بجوار المحادثة، وفي الصغيرة يفتح داخل مربع حوار. يفتح العارض قرب الصفحة المستشهد بها ويحاول إبراز المقطع الداعم. يعتمد الإبراز على بيانات المصدر ونص PDF، لذلك راجع الصفحة حتى إذا لم يظهر تمييز. استخدم عناصر العارض من أجل: - الانتقال إلى الصفحة السابقة أو التالية؛ - رؤية الصفحة الحالية وإجمالي عدد الصفحات؛ - اختيار **حفظ الصفحة كصورة (`Save page as image`)** للصفحة الحالية؛ - إغلاق العارض والعودة إلى المحادثة. ينشئ حفظ الصفحة صورة لها ولا يغير ملف PDF المصدر. اتبع قواعد مؤسستك قبل تخزين محتوى المستند أو مشاركته. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-7-upload-document-to-chat/ # رفع ملف في محادثة مستند يتاح زر المرفقات في محادثة من نوع **مستند (`Document`)**، ولا يظهر مع مساعد **متصل (`Connected`)**. 1. افتح مساعد «مستند». 2. اختر مشبك الورق وحدد ملفًا واحدًا. 3. أبقِ المحادثة مفتوحة بينما يحلل RAPTIX الملف ويثريه ويضمّنه. 4. انتظر الرسالة التي تؤكد جاهزية الملف. 5. اسأل سؤالًا محددًا عن محتواه وافحص الاستشهادات المعادة. إذا كان في حقل الرسالة نص عند انتهاء المعالجة، يُرسل ذلك السؤال تلقائيًا. يستخدم المساعد إعداد معالجة المستندات المضبوط له إن وُجد. تتضمن رسالة الفشل خطأ المعالجة. أعد المحاولة بملف قابل للقراءة وغير تالف؛ وإذا استمر الخطأ فتواصل مع مسؤول المساعد. لا ترفع إلا محتوى مخولًا بمعالجته. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-8-image-lightbox/ # فحص صورة مصدر اختر صورة مصغرة في **المصادر (`Sources`)** لفتحها في عارض الصور. استخدم **تكبير (`Zoom in`)** و**تصغير (`Zoom out`)** لفحصها؛ ويقتصر التكبير على النطاق الذي يعرضه العارض. اختر **إغلاق (`Close`)** أو اضغط **Escape** للعودة إلى المحادثة. عارض الصور للفحص، ولا يوفر عنصر مشاركة أو حفظ مخصصًا. إذا قدمت بطاقة المصدر **فتح المصدر** أو تنزيلًا، فاستخدم ذلك الإجراء واتبع قواعد المعالجة في مؤسستك. إذا لم تفتح الصورة، فقد يكون عنوان المصدر انتهى أو لم يعد لحسابك وصول. حدّث المحادثة مرة واحدة ثم تواصل مع مالك المستند أو الدعم. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-9-feedback-thumbs-up-down/ # إرسال تغذية راجعة عن إجابة ذكاء اصطناعي استخدم زري الإعجاب وعدم الإعجاب أسفل إجابة المساعد. - **إعجاب:** اختر **إجابة رائعة (`Great answer`)** أو **أخرى (`Other`)**. - **عدم إعجاب:** اختر **إجابة خاطئة (`Wrong answer`)** أو **غير مكتملة (`Incomplete`)** أو **مصادر سيئة (`Bad sources`)** أو **حقائق مختلقة (`Made-up facts`)** أو **أخرى**. يمكنك إضافة تعليق اختياري لا يتجاوز 1,000 حرف. اختر **إرسال (`Submit`)** لإرسال السبب والتعليق، أو **تخطي (`Skip`)** لإرسال التقييم بلا تفاصيل. لا تعدّل التغذية الإجابة ولا تعيد إنشاءها. لا تضع أسرارًا أو معلومات شخصية غير ضرورية في التعليق. وللمشكلة الضارة أو العاجلة، تواصل أيضًا مع الدعم واذكر اسم المساعد ووقت الرد. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-4-conversation-urls/ # استخدام عناوين المحادثات بأمان تفتح المحادثة الجديدة على `/ai-agents//new`. وبعد إنشائها يصبح عنوانها `/ai-agents//`. - احفظ عنوان الجلسة في المفضلة للعودة إلى محادثتك. - استخدم **نسخ الرابط (`Copy link`)** من قائمة المحادثة لنسخ الرابط الحالي. - لا يمنح الرابط وصولًا. لا يستطيع شخص آخر فتحه إلا بعد أن يشارك المالك الجلسة مع ذلك المستخدم أو دور مسموح. - يؤدي فتح `/ai-agents/` من دون جلسة إلى بدء مسار محادثة جديدة. - تعيدك الجلسة غير الصالحة أو المحذوفة أو غير المتاحة إلى حالة محادثة آمنة ولا تكشف محتواها. للتعاون، استخدم **مشاركة (`Share`)** ثم انسخ الرابط؛ ولا تتعامل مع عنوان URL نفسه كصلاحية. ## أدلة ذات صلة - [مشاركة جلسة](https://raptix.app/user-guide/ar/30-ai-agents/30-12-sharing-sessions/) - [فهم الجلسات المشتركة](https://raptix.app/user-guide/ar/30-ai-agents/30-13-understanding-shared-sessions/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-10-download-chat-transcript/ # تنزيل نص محادثة افتح محادثة تحتوي رسالة واحدة على الأقل واختر **تنزيل (`Download`)** في الترويسة. ينزل RAPTIX ملفًا نصيًا يحتوي اسم المساعد ومعرّف الجلسة ووقت التصدير وعدد الرسائل ونص الرسائل الظاهر مع المرسل والوقت. النص سجل مقروء للمحادثة، ولا يعيد إنتاج بطاقات المصادر الكاملة أو المستندات المفتوحة أو الصور أو تفاصيل التغذية الراجعة. يقع المحتوى المنزّل خارج ضوابط الوصول الحية، لذلك خزنه وشاركه وفق سياسة مؤسستك. يتعطل **تنزيل** عندما لا تحتوي المحادثة رسائل. وإذا منع المتصفح الملف، فاسمح بالتنزيلات لمساحة العمل وحاول مجددًا. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-11-managing-chat-history/ # إدارة سجل محادثاتك يحتوي الشريط الجانبي للمحادثة **محادثاتي (`My Chats`)** و**المشتركة (`Shared`)**. اختر **محادثة جديدة (`New chat`)** لبدء محادثة مستقلة مع المساعد الحالي. للجلسة التي تملكها، افتح قائمتها من أجل: - **إعادة تسمية (`Rename`)** المحادثة؛ - **تلوين (`Color`)** المحادثة بالذهبي أو الفيروزي أو البنفسجي أو الوردي؛ - **مشاركتها (`Share`)** مع أشخاص أو أدوار؛ - **نسخ الرابط (`Copy link`)**؛ - **حذفها (`Delete`)**. تؤثر إعادة التسمية والتلوين في مظهر الجلسة بالشريط الجانبي. حذف المحادثة إجراء هدّام بلا تراجع؛ فتأكد من اختيار الجلسة الصحيحة. يعيدك حذف الجلسة المفتوحة إلى محادثة جديدة. تسرد علامة **المشتركة** محادثات شاركها معك أشخاص آخرون، ولا تقدم فيها إجراءات السجل الخاصة بالمالك. ## أدلة ذات صلة - [مشاركة جلسة](https://raptix.app/user-guide/ar/30-ai-agents/30-12-sharing-sessions/) - [فهم الجلسات المشتركة](https://raptix.app/user-guide/ar/30-ai-agents/30-13-understanding-shared-sessions/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-12-sharing-sessions/ # مشاركة جلسة محادثة مالك الجلسة وحده يدير وصولها. 1. في **محادثاتي (`My Chats`)**، افتح قائمة الجلسة واختر **مشاركة (`Share`)**. 2. في **مشاركة الجلسة (`Share Session`)**، ابحث عن الأشخاص بالاسم أو البريد، أو اختر دورًا أو أكثر. 3. راجع المستلمين المحددين واختر **مشاركة**. 4. راجع **الوصول الحالي (`Current access`)** الذي يسرد المالك والمستخدمين والأدوار القادرين على فتح الجلسة. 5. استخدم **نسخ الرابط (`Copy link`)** من قائمة الجلسة إذا احتجت أيضًا إلى إرسال عنوانها. أزل مستخدمًا أو دورًا من **الوصول الحالي** عندما لا يعود الوصول مطلوبًا. تمنح مشاركة الدور الوصول إلى كل عضو حالي فيه، لذلك فضّل أشخاصًا مسمين للتعاون الأضيق. لا تمنح مشاركة المحادثة تلقائيًا الوصول إلى كل مستند أصلي. قد يرى المستلم المحادثة ولا يستطيع فتح مصدر مقيّد. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-13-understanding-shared-sessions/ # العمل مع الجلسات المشتركة افتح **المشتركة (`Shared`)** في شريط المحادثة لترى الجلسات التي شاركها شخص معك مباشرة أو عبر أحد أدوارك. يحدد كل مدخل مالكه. اختر جلسة لقراءة المحادثة ومتابعتها عندما تسمح الواجهة. تصبح رسائلك الجديدة جزءًا من المحادثة المشتركة، وقد يراها جميع المشاركين الحاليين. بصفتك مستلمًا: - لا تستطيع إعادة تسمية جلسة المالك أو تلوينها أو حذفها أو تغيير مشاركتها؛ - تُخفى **إعدادات RAG (`RAG Settings`)** الخاصة بالجلسة لأن المالك يتحكم فيها؛ - يظل وصول المصدر خاضعًا لصلاحيات المستند الأصلي. إذا اختفى عنصر مشترك، فقد يكون المالك أزال وصولك أو حذفه أو غيّر دورًا. اسأل المالك بدل طلب رابط عام. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-31-floating-chat-bubbles/ # استخدام فقاعات المحادثة العائمة تبقي المحادثة العائمة مساعدين محددين متاحين أثناء انتقالك في RAPTIX. ولا يمكن إضافة إلا المساعدين الحواريين النشطين المتاحين لحسابك. ## إضافة فقاعة أو فتحها - يستطيع المسؤول استخدام **تعويم كفقاعة محادثة (`Float as a chat bubble`)** في `/ai-agents-assistants`. - عندما يكون شريط الفقاعات موجودًا، اختر زر **+**، وابحث إذا طالت القائمة، ثم اختر مساعدًا. - اختر فقاعة لتوسيع لوحة محادثتها أو تصغيرها. لا تتوسع إلا لوحة واحدة في الوقت نفسه. يدعم الشريط ما يصل إلى ثمانية مساعدين. تعني **بلغت الحد الأقصى للمحادثات المفتوحة (`Maximum chats open`)** أنه يجب إزالة واحد قبل إضافة آخر. تُستعاد الفقاعات وزاوية الشاشة المحددة للمستخدم المسجل نفسه في ذلك المتصفح. ## استخدام اللوحة تدعم اللوحة الرسائل العادية والاقتراحات وإعادة المحاولة والإجابات المنسقة والاستشهادات والتغذية الراجعة والاستدلال عندما يقدمه المساعد. ويعرض مساعد «مستند» عنصر المرفقات أيضًا. استخدم إجراءات الترويسة لبدء محادثة جديدة، أو العودة إلى المحادثة السابقة عند توفرها، أو **فتح الصفحة الكاملة (`Open full page`)**. الصفحة الكاملة مطلوبة لعارض مستندات PDF المتكامل. يبقي إغلاق اللوحة فقاعتها مثبتة؛ أزل الفقاعة من جدول الإدارة أو من عنصر الإزالة فيها عندما لا تعود بحاجة إليها. يمكنك سحب الشريط إلى زاوية أخرى وتغيير حجم اللوحة المفتوحة. يختفي الشريط في صفحة محادثة وكلاء الذكاء الاصطناعي الكاملة وفي لوحة منشئ التدفق حتى لا يغطي عناصر التحكم، مع الاحتفاظ بحالته. ## أدلة ذات صلة - [بدء أول محادثة](https://raptix.app/user-guide/ar/30-ai-agents/30-1-getting-started-first-conversation/) - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) - [قراءة استشهاد PDF](https://raptix.app/user-guide/ar/30-ai-agents/30-6-pdf-viewer-highlighted-citations/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-14-using-arabic-and-english/ # استخدام العربية والإنجليزية في وكلاء الذكاء الاصطناعي اكتب بصورة طبيعية بالعربية أو الإنجليزية. يكتشف حقل الرسالة وفقاعاتها اتجاه كل رسالة، فتُعرض العربية من اليمين إلى اليسار والإنجليزية من اليسار إلى اليمين. لنتائج أوضح: - حدد لغة الإجابة المطلوبة صراحة عندما تكون مهمة؛ - أبقِ الأسماء والمعرّفات ونصوص المصدر المقتبسة بصيغتها الأصلية؛ - اطلب الترجمة على نحو منفصل عن الإجابة الواقعية؛ - تحقق من التواريخ والأرقام والمصطلحات القانونية والأسماء المترجمة بمقارنتها بالمصدر المستشهد به. يمكن أن يضبط المسؤول للمساعد الذكي مطالبتين منفصلتين للنظام، إحداهما إنجليزية والأخرى عربية. ويعتمد سلوك لغة المساعد المتصل على خدمته الخارجية. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-15-reasoning-mode/ # فهم التفكير والاستدلال قد يعرض مساعد **متصل (`Connected`)** حالة **جارٍ التفكير… (`Thinking…`)** ونص الاستدلال عندما يضبط المسؤول **عنوان نقطة نهاية الاستدلال (`Reasoning Endpoint URL`)**. تعيد الخدمة المضبوطة هذا النص أثناء إعداد الرد النهائي. تعامل معه كمعلومة عن التقدم، لا كدليل متحقق أو سجل كامل للطريقة التي وصل بها النموذج إلى إجابته. أسس القرارات المهمة على الرد النهائي ومصادره. إذا لم يظهر الاستدلال، فقد لا يملك المساعد نقطة نهاية له، أو لم تعد الخدمة نصًا، أو فشل الطلب. وقد تصل الإجابة النهائية رغم ذلك. أبلغ مسؤول المساعد بالإخفاقات المتكررة مع اسم المساعد والوقت. ## دليل ذو صلة - [إعداد نقطة نهاية للاستدلال](https://raptix.app/user-guide/ar/30-ai-agents/30-22-setting-up-reasoning-endpoint/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-16-per-session-ai-settings/ # ضبط إعدادات الذكاء الاصطناعي لكل جلسة يستطيع مالك محادثة **مستند (`Document`)** فتح **إعدادات RAG (`RAG Settings`)** أعلى حقل الرسالة. ولا يرى مستلمو الجلسة المشتركة هذه العناصر. | الإعداد | التأثير | |---|---| | **درجة الإبداع (`Temperature`)** | قيمة من 0 إلى 1. تفضّل القيم المنخفضة الاتساق، وتسمح الأعلى بتنوع أكبر. | | **النموذج (`Model`)** | يستخدم **النموذج الافتراضي (`Default model`)** أو نموذج توليد نشط آخر أتاحه المسؤول. | تنطبق هذه الإعدادات على الجلسة الحالية وتُخزن لتلك المحادثة في المتصفح الحالي. ولا تغير الإعداد الافتراضي للمساعد أو الجلسات الأخرى. لا تؤدي زيادة درجة الإبداع إلى توسيع الوصول إلى المصادر أو ضمان الدقة. إذا كانت قائمة النماذج فارغة أو تعرض خطأ، فاستخدم **النموذج الافتراضي** واطلب من المسؤول مراجعة **توثيق الذكاء الاصطناعي**. ## أدلة ذات صلة - [إعداد توثيق الذكاء الاصطناعي](https://raptix.app/user-guide/ar/40-knowledge/40-28-ai-authentication-current/) - [إدارة مساعد ذكي](https://raptix.app/user-guide/ar/30-ai-agents/30-19-admin-smart-assistants/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/ # إدارة مساعدي الذكاء الاصطناعي > **المنطقة:** وكلاء الذكاء الاصطناعي ← المساعدون > > **الجمهور:** مسؤولو الذكاء الاصطناعي > > **الوصول المطلوب:** وصول إدارة المساعدين > > **ما ستتعلمه:** كيفية قراءة جدول المساعدين، وإنشاء مساعد وإعداده واختباره وتنشيطه وتقييده أو إزالته باستخدام الصفحة الحالية. ## من يستطيع استخدام هذه الصفحة؟ `/ai-agents-assistants` صفحة إدارية. يستخدم المستخدم العادي **وكلاء الذكاء الاصطناعي** لفتح المساعدين، ولا ينشئهم أو يضبطهم. ## استخدام جدول مساعدي المحادثة يعرض الجدول اسم كل مساعد ونوعه وحالته ورؤيته ومنشئه وتاريخ إنشائه. استخدم إجراءات الصف لتعويم فقاعة محادثة أو إزالتها، والتعديل والتنشيط أو التعطيل، وحذف المساعد. يفتح **مساعد جديد (`New Assistant`)** نموذج الإنشاء. ولا يمكن حذف المساعد الافتراضي من صفه. ## اختيار نوع المساعد تقدم شاشة الإنشاء الحالية: - **مساعد ذكي (`Smart Assistant`)** لمساعد يقوده نموذج ويستطيع استخدام المعرفة المضبوطة؛ - **اتصال خارجي (`External Connection`)** لمساعد يرسل الطلبات إلى نقطة نهاية خارجية. قد تعرض السجلات الموجودة أنواعًا قديمة أخرى مدعومة، لكن اختر أحد النوعين المعروضين في شاشة **مساعد جديد** الحالية. ## إعداد المساعد 1. تحت **أساسي (`Basic`)**، أدخل اسمًا مطلوبًا ووصفًا اختياريًا وحدد إن كان المساعد **نشطًا (`Active`)**. 2. تحت **المظهر (`Appearance`)**، اختر لونًا معدًا أو مخصصًا، ثم عرّف المساعد برمز تعبيري أو أيقونة أو علامة تجارية. 3. في **الاتصال الخارجي**، أدخل **عنوان نقطة النهاية (`Endpoint URL`)** المطلوب و**عنوان نقطة نهاية الاستدلال (`Reasoning Endpoint URL`)** الاختياري. 4. في **المساعد الذكي**، اختر نموذج التوليد ودرجة الإبداع ومطالبتي النظام الإنجليزية والعربية. لا تستخدم إعادة التعيين إلا لاستعادة المطالبة المقدمة. 5. اختر اختياريًا **إعداد معالجة المستندات المسبق (`Document processing preset`)**. **تلقائي (`Automatic`)** هو الافتراضي الموصى به؛ ولا يفيد الاختيار المخصص إلا عندما جهز المسؤول إعدادًا مناسبًا. 6. اضبط **نطاق المعرفة (`Knowledge scope`)** حسب مساحة العمل أو التطبيق أو الصفحة أو الملفات المحددة. يعني النطاق الفارغ كل المعرفة المسموح بها من نواحٍ أخرى، لا عدم وجود معرفة. 7. اضبط **الرؤية (`Visibility`)** واحفظ. قبل الحفظ، راجع المساعد من منظور المستخدم: يجب أن يشرح اسمه غرضه، وألا يُمنح مستندات أو صلاحيات لا يحتاجها. يتطلب النموذج اسمًا. كما يتطلب نقطة نهاية للاتصال الخارجي ونموذجًا للمساعد الذكي. تقبل درجة الإبداع قيمًا من 0 إلى 1؛ تفضّل المنخفضة الاتساق وتسمح الأعلى بتنوع أكبر. ## إتاحة المساعد يتحكم إعداد **نشط** في ظهور المساعد داخل «وكلاء الذكاء الاصطناعي». اختر خيار رؤية واحدًا: | الرؤية | من يستطيع العثور عليه؟ | |---|---| | **أنا فقط (`Only me`)** | مالك المساعد. | | **أشخاص محددون (`Specific people`)** | الأعضاء المطابقون **للأدوار المسموح بها** أو المستخدمون المسمون. | | **الجميع (`Everyone`)** | كل مستخدم يستطيع فتح وكلاء الذكاء الاصطناعي. | قيّد الوصول قبل تنشيط المساعد. احفظ التغييرات ثم اختبر بحساب يملك الوصول المقصود وآخر لا ينبغي أن يملكه. ## إزالة مساعد لا تستخدم **حذف المساعد (`Delete Assistant`)** إلا عندما لم يعد مطلوبًا. عطّله أولًا إذا أردت إزالته من المستخدمين مع إبقاء إعداده للمراجعة. ## أدلة ذات صلة - [استخدام وكلاء الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-28-ai-agents-current/) - [إدارة الذاكرة الشخصية وذاكرة مساحة العمل](https://raptix.app/user-guide/ar/30-ai-agents/30-30-memory-manager/) - [إدارة مستندات المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [إعداد توثيق الذكاء الاصطناعي](https://raptix.app/user-guide/ar/40-knowledge/40-28-ai-authentication-current/) - [استخدام فقاعات المحادثة العائمة](https://raptix.app/user-guide/ar/30-ai-agents/30-31-floating-chat-bubbles/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-17-admin-creating-assistant/ # إنشاء مساعد ذكاء اصطناعي > **المنطقة:** وكلاء الذكاء الاصطناعي ← إدارة المساعدين > > **الجمهور:** مسؤولو الذكاء الاصطناعي 1. افتح `/ai-agents-assistants` واختر **مساعد جديد (`New Assistant`)**. 2. اختر **مساعد ذكي (`Smart Assistant`)** أو **اتصال خارجي (`External Connection`)**. 3. أدخل **الاسم (`Name`)** المطلوب والوصف الاختياري وحالة **نشط (`Active`)** الأولية. 4. تحت **المظهر (`Appearance`)**، اختر لونًا ورمزًا تعبيريًا أو أيقونة أو علامة تجارية. 5. أكمل إعدادات النوع المحدد. 6. اختر **أنا فقط (`Only me`)** أو **أشخاص محددون (`Specific people`)** أو **الجميع (`Everyone`)** تحت **الرؤية (`Visibility`)**. 7. احفظ المساعد واختبره ثم نشّطه للجمهور المقصود. يتطلب المساعد الذكي نموذج توليد. ويتطلب الاتصال الخارجي **عنوان نقطة نهاية (`Endpoint URL`)**. لا يمكن حفظ النموذج قبل وجود القيم المطلوبة. يكون المساعد الجديد خاصًا افتراضيًا. أبقه مقيّدًا أثناء اختبار إجاباته ومصادره وسلوكه مع الأخطاء. ## أدلة ذات صلة - [إعداد مساعد ذكي](https://raptix.app/user-guide/ar/30-ai-agents/30-19-admin-smart-assistants/) - [إعداد اتصال خارجي](https://raptix.app/user-guide/ar/30-ai-agents/30-18-admin-external-connections/) - [التحكم في رؤية المساعد](https://raptix.app/user-guide/ar/30-ai-agents/30-24-controlling-access-roles-allowlists/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-19-admin-smart-assistants/ # إعداد مساعد ذكي اختر **مساعد ذكي (`Smart Assistant`)** للحصول على إجابات يولدها نموذج ويمكن أن تستخدم معرفة RAPTIX. 1. اختر **نموذج توليد (`Generator Model`)** نشطًا أُعد في **توثيق الذكاء الاصطناعي (`AI authentication`)**. 2. أبقِ **معالجة المستندات (`Document processing`)** على **تلقائي (`Automatic`)** إلا إذا كانت الملفات المرفوعة في المحادثة تحتاج إلى إعداد مسبق مُجهّز. 3. اضبط **نطاق المعرفة (`Knowledge scope`)**. يعني النطاق الفارغ كل المعرفة التي يُسمح للمساعد والمستخدم الطالب بالوصول إليها من نواحٍ أخرى. 4. اضبط **درجة الإبداع (`Temperature`)** بين 0 و1. 5. راجع حقلي **مطالبة النظام (`System Prompt`)** بالإنجليزية والعربية. يعيد **إعادة تعيين (`Reset`)** المطالبة المقدمة لتلك اللغة. 6. اضبط الرؤية، واحفظ، واختبر بأسئلة ممثلة للاستخدام. يتحكم نطاق المعرفة في موضع بحث المساعد، بينما تتحكم الرؤية في من يستطيع العثور عليه ومحادثته. يجب ضبط كليهما بصورة صحيحة. يرى المستخدم المساعد الذكي باسم **مستند (`Document`)** في المركز، ويمكنه تلقي استشهادات وإرفاق ملف واستخدام إعدادات كل جلسة الخاصة بالمالك. ## ما يستطيع المساعد الذكي فعله: أدوات وكيلة لا يسترجع المساعد الذكي النص ويقتبسه فقط، بل يعمل **بصورة وكيلة**، وهذا السلوك مفعّل دائمًا. يمكنه مع كل سؤال أن يقرر استدعاء أدوات مضمنة والتصرف وفق النتائج قبل الإجابة: - **المستندات (`Documents`)** — العثور على المستندات وسردها وعدّها وفتحها، وقراءة تفاصيل مستند، والبحث داخل محتواه. لذلك يستطيع المساعد الإجابة عن أسئلة وصفية مثل «كم مستندًا لديك؟» أو «اسرد العقود التي يمكنك رؤيتها»، لا مجرد اقتباس المقاطع. - **سير العمل (`Workflows`)** — البحث عن معلومات سير العمل والعمليات المتاحة للمساعد. - **الويب (`Web`)** — استرجاع معلومات حديثة من الويب عندما لا تكون الإجابة في معرفتك. يظل كل ما يصل إليه المساعد خاضعًا **لنطاق المعرفة** الخاص به ولصلاحيات المستخدم الطالب؛ توسع الأدوات *ما يستطيع فعله* لا *ما يُسمح له برؤيته*. عندما تعتمد الإجابة على أداة، يعرض النص **شريحة أثر أداة** صغيرة أسفل الرد، مثل `search_document_content · found 3 results`، حتى يرى القارئ الأداة التي عملت وما أعادته. تعني شريحة التحذير أن استدعاء الأداة لم يكتمل. الشرائح توضيحية، وتأتي الإجابة مع استشهاداتها أسفلها. ## أدلة ذات صلة - [تعيين نطاق المعرفة](https://raptix.app/user-guide/ar/30-ai-agents/30-20-admin-knowledge-scope/) - [ربط إعداد مسبق لمعالجة المستندات](https://raptix.app/user-guide/ar/30-ai-agents/30-27-linking-processing-preset/) - [كتابة مطالبات نظام فعالة](https://raptix.app/user-guide/ar/30-ai-agents/30-23-writing-effective-system-prompts/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-26-customizing-assistant-appearance/ # تخصيص مظهر المساعد في **المظهر (`Appearance`)**، اختر لونًا معدًا مسبقًا أو أدخل لونًا مخصصًا، ثم اختر نمط هوية واحدًا: - **رمز تعبيري (`Emoji`)**؛ - **أيقونة (`Icon`)**؛ - **علامة تجارية (`Brand`)**. تُستخدم المعاينة على بطاقات المساعد وترويسات المحادثة وفقاعات المحادثة العائمة حيثما دُعمت. اختر هوية مميزة عن المساعدين الآخرين وتظل مفهومة من دون الاعتماد على اللون وحده. لا يغير المظهر نموذج المساعد أو مصادره أو صلاحياته أو سلوكه. احفظ المساعد وراجعه في الوضعين الفاتح والداكن وفي شاشة ضيقة. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-25-activating-deactivating-assistants/ # تنشيط مساعد أو تعطيله تتحكم حالة **نشط (`Active`)** فيما إذا كان المستخدم المؤهل يستطيع العثور على المساعد وفتحه في `/ai-agents`. وتحدد **الرؤية (`Visibility`)** المستخدمين المؤهلين. من `/ai-agents-assistants`، استخدم إجراء الصف **تنشيط (`Activate`)** أو **تعطيل (`Deactivate`)**، أو عدّل المساعد وغيّر **نشط**. عطّل مساعدًا عندما تحتاج نقطة نهايته أو نموذجه أو مطالبته أو نطاقه أو صلاحياته إلى مراجعة. يزيله التعطيل من الدليل من دون حذف إعداده. ولا تغني البيانات الموجودة عن الاختبار بعد إعادة التنشيط. قبل التنشيط، تحقق من: - النوع والنموذج أو نقطة النهاية والمظهر الصحيح؛ - الرؤية ونطاق المعرفة؛ - نجاح الإجابات المتوقعة وسلوك الفشل الآمن؛ - الوصول باستخدام حساب اختبار مسموح وآخر مستبعد. لا تستخدم **حذف المساعد (`Delete Assistant`)** إلا عندما لم يعد الإعداد مطلوبًا. لا يمكن حذف المساعد الافتراضي من صفه. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-24-controlling-access-roles-allowlists/ # التحكم في رؤية المساعد لكل مساعد إعداد **رؤية (`Visibility`)** واحد: | الخيار | من يستطيع رؤيته في وكلاء الذكاء الاصطناعي؟ | |---|---| | **أنا فقط (`Only me`)** | المالك وحده. | | **أشخاص محددون (`Specific people`)** | أعضاء **الأدوار المسموح بها (`Allowed Roles`)** المحددة أو **المستخدمون المسموح بهم (`Allowed Users`)** المحددون. | | **الجميع (`Everyone`)** | كل مستخدم يستطيع فتح وكلاء الذكاء الاصطناعي. | في خيار **أشخاص محددون**، تكفي مطابقة أي من القائمتين. يستطيع المستخدم المسمى رؤية المساعد بصرف النظر عن دوره. تتحكم الرؤية في اكتشاف المساعد والوصول إلى المحادثة، ولا تتجاوز صلاحيات المعرفة أو المستندات. أبقِ المساعد الجديد على **أنا فقط** أثناء الاختبار. وعند تغيير الوصول، اختبر بحساب مسموح وآخر مستبعد. راجع الوصول المستند إلى الدور عندما تتغير عضوية الفريق. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-27-linking-processing-preset/ # ربط إعداد مسبق لمعالجة المستندات يمكن أن يستخدم المساعد الذكي **معالجة المستندات (`Document processing`)** للملفات المرفقة في محادثاته. 1. أنشئ الإعداد المطلوب واختبره في «المعرفة» عندما تحتاج إلى معالجة مخصصة. 2. عدّل المساعد الذكي. 3. تحت **معالجة المستندات**، أبقِ **تلقائي (`Automatic`)** أو اختر الإعداد المجهز. 4. احفظ وارفع ملفًا ممثلًا في محادثة اختبار. 5. تأكد من اكتمال المعالجة وإمكانية استخدام الاستشهادات المعادة. **تلقائي** هو الإعداد المضمن الافتراضي ويناسب الحالات التي لا يحتاج فيها نوع المستند إلى سلوك خاص للتحليل أو اللغة أو الاستخراج أو الجداول أو الإثراء أو التضمين. يؤثر تغيير الإعداد في عمليات رفع المحادثة المستقبلية، ولا يعيد معالجة الملفات المفهرسة بالفعل. ## أدلة ذات صلة - [إدارة إعدادات معالجة المعرفة المسبقة](https://raptix.app/user-guide/ar/40-knowledge/40-3-processing-preset/) - [رفع ملف في المحادثة](https://raptix.app/user-guide/ar/30-ai-agents/30-7-upload-document-to-chat/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-20-admin-knowledge-scope/ # تعيين نطاق معرفة المساعد يتاح **نطاق المعرفة (`Knowledge scope`)** للمساعد الذكي، ويستخدم تسلسل «مساحة العمل ← التطبيق ← الصفحة ← الملف». 1. افتح إعداد المساعد الذكي. 2. وسع مساحة العمل أو التطبيق أو الصفحة المطلوبة. 3. أضف الحاوية الواسعة أو اختر ملفات منفردة لنطاق أضيق. 4. راجع سلة الاختيارات وأزل ما لا يحتاج إليه المساعد. 5. احفظ واختبر بصفتك مستخدمًا ضمن مجموعة الرؤية المقصودة. يشمل اختيار المستوى الأب المعرفة تحته. يمنح اختيار ملفات منفردة تحكمًا أدق، لكنه قد يتطلب صيانة عند إضافة ملفات جديدة. يعني النطاق الفارغ كل المعرفة المسموح بها من نواحٍ أخرى، ولا يعني عدم وجود معرفة. لا يتجاوز النطاق صلاحيات المستندات. ويجب أن يكون المستخدم الطالب مخولًا استخدام المعرفة الأصلية. ## أدلة ذات صلة - [اختبار الإجابات المستندة إلى المصادر والوصول](https://raptix.app/user-guide/ar/30-ai-agents/30-21-testing-grounded-access/) - [إدارة مستندات المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-21-testing-grounded-access/ # اختبار الإجابات المستندة إلى المصادر والوصول بعد حفظ مساعد ذكي، تحقق من جودة الإجابات وحدود الوصول معًا. 1. نشّط المساعد لجمهور اختبار صغير فقط. 2. اسأل سؤالًا ينبغي الإجابة عنه من مصدر مشمول. 3. افتح الاستشهاد وتأكد أنه يدعم الإجابة. 4. اسأل عن محتوى خارج **نطاق المعرفة** المضبوط؛ يجب ألا يكشفه المساعد. 5. كرر الاختبار مع مستخدم مقصود وآخر لا ينبغي أن يرى المساعد أو المصدر. 6. اختبر ملفًا مرفوعًا إذا كانت عمليات الرفع في المحادثة جزءًا من الاستخدام. إذا لم يجد المساعد محتوى متوقعًا، فتأكد من انتهاء معالجة مستند المعرفة، وأن النطاق يشمل موقعه، وأن المستخدم يملك وصول المصدر. وإذا ظهر محتوى مقيّد، فعطّل المساعد فورًا وصحح النطاق والصلاحيات. ## أدلة ذات صلة - [تعيين نطاق المعرفة](https://raptix.app/user-guide/ar/30-ai-agents/30-20-admin-knowledge-scope/) - [مراجعة تحليلات المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-29-knowledge-analytics-current/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-23-writing-effective-system-prompts/ # كتابة مطالبات نظام فعالة للمساعد الذكي حقلان منفصلان لمطالبة النظام بالإنجليزية والعربية. تنطبق المطالبة على ذلك المساعد، لا على جميع وكلاء الذكاء الاصطناعي. ضمّن: - غرض المساعد وجمهوره المقصود؛ - لغة الإجابة المفضلة ونبرتها وبنيتها؛ - كيفية استخدام الاستشهادات وما يفعله عند غياب الدليل؛ - قواعد السلامة أو التصعيد؛ - تعليمات قصيرة قابلة للاختبار بدل متطلبات متعارضة. لا تضع كلمات مرور أو رموز وصول أو مفاتيح خاصة أو بيانات حساسة في مطالبة النظام. لا تمنح المطالبة وصولًا إلى المعرفة ولا تحل محل الصلاحيات. استخدم **إعادة تعيين (`Reset`)** فقط عندما تقصد استعادة المطالبة المقدمة لتلك اللغة. بعد الحفظ، اختبر العربية والإنجليزية وطلبًا غامضًا وسؤالًا بلا مصدر داعم وطلبًا ينبغي أن يرفضه المساعد أو يصعّده. --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-18-admin-external-connections/ # إعداد اتصال خارجي اختر **اتصال خارجي (`External Connection`)** عندما يجب أن يرسل المساعد طلبات المحادثة إلى خدمة خارجية. 1. أنشئ مساعدًا أو عدّله في `/ai-agents-assistants`. 2. اختر **اتصال خارجي**. 3. أدخل **عنوان نقطة النهاية (`Endpoint URL`)** المطلوب. 4. أدخل اختياريًا **عنوان نقطة نهاية الاستدلال (`Reasoning Endpoint URL`)** عندما تقدم الخدمة نص تقدم أو استدلال منفصلًا. 5. أكمل المظهر والرؤية والتنشيط ثم احفظ. يجب أن يستطيع RAPTIX الوصول إلى نقطة النهاية، وأن تعيد التنسيق المتوقع من التكامل. لا تضع بيانات اعتماد في عنوان URL. يجب الاتفاق مع مالك الخدمة قبل التنشيط على التوثيق وقائمة الشبكات المسموحة وعقود الطلب والاستجابة وقواعد الاحتفاظ بالبيانات. اختبر مدخلًا عاديًا، ومدخلًا عربيًا عند دعمه، وخطأً في الخدمة، وانتهاء المهلة. يرى المستخدم هذا النوع باسم **متصل** في مركز وكلاء الذكاء الاصطناعي. ## أدلة ذات صلة - [إعداد نقطة نهاية للاستدلال](https://raptix.app/user-guide/ar/30-ai-agents/30-22-setting-up-reasoning-endpoint/) - [تنشيط مساعد أو تعطيله](https://raptix.app/user-guide/ar/30-ai-agents/30-25-activating-deactivating-assistants/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-22-setting-up-reasoning-endpoint/ # إعداد نقطة نهاية للاستدلال يمكن أن يستخدم **الاتصال الخارجي (`External Connection`)** عنوان **نقطة نهاية للاستدلال (`Reasoning Endpoint URL`)** اختياريًا إلى جانب **عنوان نقطة النهاية (`Endpoint URL`)** المطلوب. 1. عدّل الاتصال الخارجي في `/ai-agents-assistants`. 2. أدخل عنوان خدمة الاستدلال المعتمد في **عنوان نقطة نهاية الاستدلال**. 3. احفظ وابدأ محادثة اختبار. 4. تأكد من ظهور نص التقدم أثناء إعداد نقطة النهاية النهائية للإجابة. 5. اختبر خدمة استدلال بطيئة أو غير متاحة، وتأكد أن مسار الإجابة النهائية يظل مفهومًا. يظهر نص الاستدلال للمستخدم، لذلك يجب ألا تعيد نقطة النهاية أسرارًا أو تعليمات داخلية أو بيانات اعتماد أو بيانات تصحيح لم تُراجع. أزل العنوان الاختياري عندما لا ينبغي عرض الخدمة بعد الآن. ## أدلة ذات صلة - [فهم التفكير والاستدلال](https://raptix.app/user-guide/ar/30-ai-agents/30-15-reasoning-mode/) - [إعداد اتصال خارجي](https://raptix.app/user-guide/ar/30-ai-agents/30-18-admin-external-connections/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-30-memory-manager/ # إدارة ذاكرة الذكاء الاصطناعي الدائمة > **المنطقة:** وكلاء الذكاء الاصطناعي ← مدير الذاكرة > > **الجمهور:** المسؤولون > > **الوصول المطلوب:** وصول المسؤول > > **ما ستتعلمه:** كيفية مراجعة حقائق ذاكرة الذكاء الاصطناعي الشخصية أو الخاصة بمساحة العمل، وترشيح ذاكرة المساحة حسب المستخدم، ونسيان حقيقة واحدة، ونسيان جميع الحقائق المطابقة في مساحة العمل نهائيًا. ## ما الذي يتحكم فيه مدير الذاكرة؟ يعرض «مدير الذاكرة» الحقائق الدائمة التي احتفظ بها وكلاء الذكاء الاصطناعي لمحادثات لاحقة. قد تتضمن الحقيقة نصها ونوعها ومصدرها وأهميتها والمستخدم ووقت الإنشاء. تدير هذه الصفحة حقائق الذاكرة الدائمة فقط؛ ولا تحذف نصوص المحادثات أو المستندات المصدرية أو المساعدين أو مستندات المعرفة. ## قبل أن تبدأ - تأكد أنك مسجل الدخول بصفتك مسؤولًا. - لذاكرة مساحة العمل، حدد مساحة العمل الصحيحة ومعرّف المستخدم الدقيق عند الحاجة. - تعامل مع كل إجراء **نسيان (`Forget`)** على أنه نهائي؛ فلا توجد استعادة أو تراجع. - استخدم أضيق حذف يحقق الطلب: حقيقة واحدة قبل جميع حقائق مستخدم أو مساحة عمل. ## فتح مدير الذاكرة انتقل إلى **الإدارة (`Admin`)** واختر صف **الذاكرة (`Memory`)**. يبين السطر الفرعي عدد الحقائق التي تتذكرها مساحة عملك حاليًا، لتعرف الحالة قبل فتح الصفحة. يمكنك أيضًا فتح `https://.raptix.app/memory-manager` مباشرة وأنت مسجل في مساحة العمل. تطلب الصفحة أولًا اختيار مساحة عمل أو **ذاكرتي الشخصية (المحادثة) (`My personal memory (chat)`)**. تجمع قائمة المساحات ما يتاح عبر «التطبيقات»، بما فيه مساحات العمل المخصصة للمستندات فقط. ## مراجعة ذاكرتك الشخصية 1. افتح محدد مساحة العمل. 2. اختر **ذاكرتي الشخصية (المحادثة)**. 3. انتظر تحميل الحقائق تلقائيًا. تُحدد الذاكرة الشخصية من حسابك المسجل. لا تدخل معرّف مستخدم. تعرض الصفحة الحقائق المحتفظ بها مع نوعها ومصدرها وأهميتها وتاريخ إنشائها. يتعطل **نسيان الكل (`Forget ALL`)** في وضع الذاكرة الشخصية، لكن يظل بإمكانك نسيان حقيقة فردية. ## مراجعة ذاكرة مساحة العمل 1. اختر مساحة عمل. 2. انتظر تحميل القائمة الأولية. 3. أدخل اختياريًا **معرّف مستخدم (`User ID`)** لقصر النتائج على ذلك المستخدم. 4. اختر **تحميل (`Load`)** أو **تحديث (`Refresh`)**. يمكن أن يعرض الجدول: | العمود | المعنى | |---|---| | **الحقيقة (`Fact`)** | النص المحتفظ به الذي تستخدمه ذاكرة الذكاء الاصطناعي. | | **النوع (`Type`)** | فئة الحقيقة عندما تكون مسجلة. | | **المصدر (`Source`)** | من أين جاءت الحقيقة، مثل المحادثة أو مصدر مدعوم آخر. | | **الأهمية (`Importance`)** | قيمة الأهمية المسجلة عند توفرها. | | **المستخدم (`User`)** | المستخدم المرتبط بالحقيقة. | | **أُنشئت (`Created`)** | وقت تخزين الحقيقة. | | **الإجراءات (`Actions`)** | خيار نسيان تلك الحقيقة. | يبين العدد أعلى الجدول الإجمالي المعاد للاختيار الحالي. وإذا لم توجد حقائق، تشرح الصفحة إن كانت الذاكرة الشخصية أو ذاكرة مساحة العمل المحددة فارغة. ## نسيان حقيقة واحدة 1. اعثر على الحقيقة في الجدول. 2. اختر إجراءها الأحمر **نسيان هذه الحقيقة (`Forget this fact`)**. 3. اقرأ الحقيقة في مربع التأكيد. 4. اختر **نسيان (`Forget`)**. يزيل RAPTIX الحقيقة نهائيًا ويحدث الجدول ويعرض رسالة تأكيد. اختر **إلغاء (`Cancel`)** أو أغلق المربع إذا لم تكن الحقيقة المحددة هي التي قصدت إزالتها. ## نسيان جميع حقائق مستخدم واحد في مساحة عمل 1. اختر مساحة العمل. 2. أدخل معرّف المستخدم الدقيق. 3. اختر **تحميل** وراجع الحقائق المطابقة. 4. اختر **نسيان الكل لهذا المستخدم (`Forget ALL for this user`)**. 5. تحقق من مساحة العمل ومعرّف المستخدم وعدد الحقائق الظاهر في التحذير. 6. أكد الحذف. لا تُستهدف إلا الحقائق الدائمة المطابقة لذلك المستخدم في مساحة العمل تلك. ## نسيان جميع الحقائق في مساحة عمل 1. اختر مساحة العمل. 2. امسح حقل معرّف المستخدم. 3. حمّل حقائق مساحة العمل وراجعها. 4. اختر **نسيان الكل لمساحة العمل هذه (`Forget ALL for this workspace`)**. 5. اقرأ تحذير **الحق في النسيان (`Right-To-Be-Forgotten`)** وتأكد من العدد المعروض. 6. لا تؤكد إلا إذا كان ينبغي إزالة كل حقيقة ذاكرة دائمة في المساحة نهائيًا. لا يمكن التراجع عن العملية، وهي أوسع من حذف محادثة واحدة أو حقائق مستخدم واحد. ## التحقق من مخزن الذاكرة يزيل نسيان الحقيقة أثرها من موضعين: السجل نفسه، وفهرس البحث الذي يقرأه المساعد. يؤكد **التحقق من المخزن (`Verify store`)** في ترويسة الصفحة عدم بقاء شيء في الفهرس، ويزيل أي بقايا يجدها. 1. اختر اختياريًا مساحة عمل لقصر الفحص عليها. 2. اختر **التحقق من المخزن**. 3. اقرأ النتيجة: إما فُحصت كل الذاكرة ولم تبقَ آثار، أو أُزيلت البقايا وأُحصيت. شغّل ذلك بعد عملية «حق في النسيان» كبيرة، أو كلما احتجت إلى تأكيد أن حقيقة زالت لا أنها غير متاحة فقط. لا يزيل التحقق حقيقة ما زالت مستخدمة، ولا يستطيع الوصول إلا إلى ذاكرة مساحة عملك. ## استكشاف المشكلات وحلها | المشكلة | الحل | |---|---| | مساحة عمل مفقودة | تأكد أنك تستطيع فتحها في «التطبيقات»، ثم حدّث «مدير الذاكرة». | | لا تظهر حقائق شخصية | ربما لم يخزن المساعد ذاكرة شخصية دائمة بعد. يختلف ذلك عن سجل المحادثة؛ يحتفظ المساعد بحقيقة عندما تذكر أمرًا دائمًا، كتفضيل أو دور أو قيد مستمر، لا من الأسئلة العادية. | | لا تظهر حقائق مساحة العمل | امسح مرشح معرّف المستخدم وأعد التحميل. تأكد من اختيار المساحة الصحيحة. | | **نسيان الكل** معطل | اختر مساحة عمل تحتوي حقائق. الحذف المجمع غير متاح عمدًا للذاكرة الشخصية. | | فشل التحميل أو الحذف | أبقِ الاختيار الحالي وأعد المحاولة مرة، ثم تواصل مع الدعم باسم مساحة العمل ووقت المحاولة. لا تضع نص حقيقة حساسًا في رسالة دعم عادية. | | حذفت الحقيقة الخطأ | الحذف نهائي. إذا كانت المعلومة ما تزال صحيحة، فيجب تعلمها أو إضافتها مجددًا عبر مسار وكيل الذكاء الاصطناعي المدعوم. | ## إرشادات الخصوصية والسلامة - تحقق من هوية مقدم الطلب قبل إكمال عملية «حق في النسيان». - لا تنسخ نص حقيقة حساسًا إلى تذكرة أو بريد أو محادثة إلا إذا طلبت عملية الدعم المعتمدة ذلك. - فضّل حذف حقيقة واحدة عندما يتعلق الطلب بعنصر خاطئ أو قديم واحد. - استخدم مرشح معرّف المستخدم قبل الحذف المجمع عندما يخص الطلب شخصًا واحدًا. ## أدلة ذات صلة - [استخدام وكلاء الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-28-ai-agents-current/) - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) - [إدارة سجل محادثاتك](https://raptix.app/user-guide/ar/30-ai-agents/30-11-managing-chat-history/) - [الحصول على المساعدة من الدعم](https://raptix.app/user-guide/ar/00-getting-started/00-19-getting-help-support/) --- URL: https://raptix.app/user-guide/ar/30-ai-agents/30-32-assistant-tools-and-workflow-commands/ # اطلب من مساعد RAPTIX العثور على المعلومات وتشغيل سير العمل > **الوحدة:** وكلاء الذكاء الاصطناعي > > **الجمهور:** المستخدمون الذين يمكنهم الوصول إلى مساعد RAPTIX وإلى المستندات أو البريد أو المهام أو مسارات سير العمل الأصلية > > **الوصول المطلوب:** لا يستخدم المساعد إلا الأدوات والمحتوى ومسارات سير العمل اليدوية المسموح بها لحسابك؛ وتتطلب بعض الأدوات أيضًا خدمة تابعة مضبوطة > > **ستتعلم:** ما الذي يستطيع المساعد العمل معه، وكيف تطلب منه البحث في المستندات والبريد، وتحليل المرفقات والجداول المدعومة، وبدء سير عمل مسموح، وتقديم المدخلات المطلوبة، وقراءة إيصال التنفيذ، والتحقق من الحالة بأمان. ## فهم حدود عمل المساعد يستطيع مساعد RAPTIX الجمع بين عدة مناطق عمل مسموحة في محادثة واحدة. وبحسب وصولك وإعداد مساحة العمل، يمكنه مساعدتك في: - العثور على المستندات بالمعنى أو الاسم أو الموقع أو الشخص الذي رفعها أو حالة الفهرسة؛ - قراءة ملف مسموح، وتلخيص مجلد، والتحقق من الإصدارات، والاستشهاد بالمصادر؛ - العثور على البريد بالمعنى أو الألفاظ، وتتبع سلسلة، وقراءة المرفقات المدعومة؛ - مقارنة عدة رسائل أو ملفات؛ - ترشيح صفوف محدودة من جدول بيانات مقروء أو تجميعها؛ - العثور على المهام ومثيلات سير العمل التي تستطيع رؤيتها؛ - اكتشاف مسارات سير العمل اليدوية المؤهلة وتشغيلها. يتوقف التوفر على السياق. لا يكتسب المساعد وصولًا لمجرد وجود أداة، ولا يكشف إجماليات مساحة العمل عندما لا يُسمح لك إلا برؤية جزء منها. ## طلب المعلومات بوضوح اذكر كائن العمل والفترة الزمنية والنتيجة المطلوبة، مثل: ```text اعثر على أحدث سياسة معتمدة للموردين، واستشهد بالصفحة التي تغطي تأخر التسليم. ``` ```text لخّص الرسائل التي أستطيع رؤيتها من شركة Northwind عن مشروع Delta هذا الشهر. ``` ```text من جدول البيانات المرفق، احسب إجمالي عمود Amount للصفوف التي تكون قيمة Status فيها Open. ``` ينبغي أن يسمي المساعد المصادر التي استخدمها أو يستشهد بها. افتح استشهادًا أو بطاقة مصدر عندما تؤثر الإجابة في قرار. وإذا لم تتوفر خدمة الاسترجاع أو OCR أو فهرسة البريد أو خدمة تابعة أخرى، فينبغي أن يصرح المساعد بالقيد بدل اختلاق دليل مفقود. ## العمل مع البريد والمرفقات اسأل بالعربية أو الإنجليزية؛ ويمكن للبحث بالمعنى العثور على مواد مسموحة في اللغتين عندما يكون فهرس البريد مضبوطًا. للملفات المرفقة بالبريد: - يمكن أن تساهم المستندات القابلة للقراءة بنصها المستخرج؛ - يمكن أن تدعم جداول البيانات ترشيحًا وتجميعًا وإجماليات محدودة على الصفوف المقروءة؛ - قد لا تكون الصفحة الممسوحة قابلة للقراءة عند غياب OCR؛ - يجب أن يجتاز الأصل المحتفظ به فحص سلامة المرفق قبل التنزيل؛ - إذا لم تحتفظ مساحة العمل بالأصول، فقد يوجد نص قابل للبحث بلا ملف قابل للتنزيل. استخدم طلبًا محدود النطاق للجداول الكبيرة؛ حدد مثلًا الورقة والأعمدة والمرشحات والحساب. واطلب عدد الصفوف المطابقة والافتراضات حتى تتحقق من النتيجة. ## طلب تشغيل سير عمل من المساعد استخدم تعليمة مباشرة تسمي النتيجة، لا عبارة عامة مثل «شغّل شيئًا». مثال: ```text ابدأ سير العمل المعتمد «مراجعة المورد الجديد» لشركة Northwind، مستخدمًا owner@example.com بصفته مقدم الطلب. ``` يتبع المساعد تسلسلًا قائمًا على التأكيد: 1. يبحث في مسارات سير العمل اليدوية المسموح لك ببدئها. 2. إذا طابقت عدة أسماء، يطلب منك الاختيار. 3. يجمع المدخلات المطلوبة ويشرح القيم المفقودة أو غير الصالحة. 4. يعرض ما سيبدأ ويطلب التأكيد عندما يتطلب الإجراء المؤثر ذلك. 5. يبدأ مثيلًا واحدًا بالضبط بعد تعليمتك الواضحة. 6. يعيد إيصال تنفيذ. يجب ألا ينشّط المساعد سير عمل غير مرتبط، أو يتجاوز متطلب نموذج عام أو خاص، أو يختلق قيمة مطلوبة، أو يكرر طلبًا فاشلًا من دون إخبارك. ## قراءة إيصال التنفيذ يحدد إيصال النجاح سير العمل والمثيل الجديد، ويعرض الحالة الحالية أو طريقة فتحه. أبقِ الإيصال في المحادثة إذا كنت ستطرح أسئلة متابعة مثل: ```text ما الحالة الحالية لمراجعة المورد تلك؟ ``` ```text من الشخص الذي تنتظره، ومتى تستحق المهمة؟ ``` تتبع إجابات الحالة وصولك إلى سير العمل. يثبت الإيصال قبول طلب البدء، ولا يعني نجاح كل خطوة لاحقة أو منح موافقة. إذا أبلغ المساعد عن نتيجة غامضة أو لم يعرض إيصالًا، فافتح **سير العمل ← كل المثيلات (`Workflow → All Instances`)** قبل أن تطلب منه المحاولة مجددًا. يمنع ذلك عمليات التشغيل المكررة عن طريق الخطأ. ## استخدام المحادثة العائمة أثناء العمل عند تمكين المحادثة العائمة، افتح مساعدًا مسموحًا من الفقاعات من دون مغادرة الصفحة الحالية. قد تساعدك الصفحة في وصف ما تراه، لكنها لا تمنح المساعد تلقائيًا وصولًا إلى بيانات مخفية. يمكنك إبقاء عدة مساعدين مسموحين متاحين حتى الحد الذي يعرضه المنتج، والتبديل بينهم. استخدم المساعد الذي يطابق وصفه المهمة وتناسب معرفته أو اتصاله المضبوط حاجتك. ## استكشاف المشكلات وحلها | المشكلة | ما ينبغي فعله | |---|---| | لا يعثر المساعد على مستند أو بريد | تأكد أنك تستطيع فتحه بنفسك، ثم أضف اسمًا أو شخصًا أو موقعًا أو نطاق تاريخ. وقد يكون الفهرس التابع غير متاح. | | لا يستطيع قراءة مرفق | قد يكون التنسيق غير مدعوم، أو OCR غير متاح، أو الملف لم يُحتفظ به، أو فحص سلامته ما زال جاريًا. | | إجابة جدول البيانات واسعة جدًا | سمّ الورقة والمرشحات والأعمدة والتجميع والحساب المطلوب، واطلب عدد الصفوف والافتراضات. | | لا يُعرض سير العمل | قد يكون غير نشط، أو لا يبدأ يدويًا، أو خارج وصولك، أو يتطلب نموذجًا أو شاشة مخصصة مختلفة. | | المدخلات المطلوبة ناقصة | قدم القيم المعروضة بالنوع المطلوب، ولا تطلب من المساعد التخمين. | | لم يظهر إيصال | افحص **كل المثيلات** قبل إعادة المحاولة. إذا لم يوجد مثيل، فأعد ذكر اسم سير العمل والمدخلات بدقة. | | تغفل الحالة مهمة أو شخصًا | قد تسمح صلاحيتك بالمثيل، لكن لا بكل مورد أو حقل تحته. | ## أدلة ذات صلة - [استخدام وكلاء الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-28-ai-agents-current/) - [استخدام الاستشهادات وبطاقات المصادر](https://raptix.app/user-guide/ar/30-ai-agents/30-5-citations-and-source-cards/) - [رفع مستند إلى محادثة](https://raptix.app/user-guide/ar/30-ai-agents/30-7-upload-document-to-chat/) - [استخدام فقاعات المحادثة العائمة](https://raptix.app/user-guide/ar/30-ai-agents/30-31-floating-chat-bubbles/) - [تشغيل سير عمل ومراقبته](https://raptix.app/user-guide/ar/10-workflows/10-20-running-a-workflow/) - [سير العمل: كل المثيلات](https://raptix.app/user-guide/ar/10-workflows/10-21-all-instances/) - [حفظ بريد سير العمل والعثور عليه وقراءته](https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-1-getting-started-first-document/ # إضافة أول مستند إلى قاعدة المعرفة > **الصفحة:** `/knowledge-documents` > > **الجمهور:** مشرفو قاعدة المعرفة ## إضافة المحتوى توفّر الصفحة الحالية طريقتين ظاهرتين: - **المستندات (Documents):** اختر **تصفح المستندات (Browse Documents)**، وابحث في ملفات PDF أو DOCX أو TXT أو MD أو HTML التي تستطيع الوصول إليها، واختر ملفًا، ثم اختر **استيراد (Import)**. - **Markdown:** أدخل **اسم ملف المصدر (Source filename)**، والصق Markdown أو استخدم **تحميل ملف ‎.md (Load .md)**، ثم اختر **تشغيل مسار المعالجة (Run Pipeline)**. العنصر الذي يحمل علامة **موجود في قاعدة المعرفة (In Knowledge)** لديه سجل مطابق بالفعل. يؤدي اختياره إلى تحميل ذلك السجل بدلًا من إنشاء نسخة أخرى. ## إعداده لوكلاء الذكاء الاصطناعي 1. اختر المستند الجديد من اللوحة اليسرى. 2. شغّل **تحليل Markdown (Markdown Parsing)** تحت **مراحل المعالجة (Pipeline Stages)**، وافحص النتيجة. 3. شغّل **العُقد البنيوية والتقسيم إلى مقاطع (Structural Nodes & Chunking)**. 4. شغّل **ملخصات الجداول (Table Summaries)** عندما يحتوي المستند على جداول. 5. شغّل **إثراء LLM (LLM Enrichment)** عندما تحتاج إلى ملخصات أو كيانات أو اكتشاف معلومات شخصية أو قواعد استخراج. 6. طبّق قواعد المستند أو الصفحة أو العقدة أو **التعيين الذكي (Smart Assign)** المطلوبة تحت **سياسة الوصول (Access Policy)**. 7. اختر النموذج والأبعاد تحت **التضمين (Embedding)**، ثم اختر **تضمين المستند (Embed Document)**. 8. استخدم **الاختبار (Testing)** لتشغيل اختبارات التشابه وأقرب العناصر المجاورة. يجعل التضمين المقاطع المعالجة قابلة للبحث. ويظل حصول المستخدم عليها معتمدًا على نطاق قاعدة المعرفة الخاص بالمساعد وسياسات وصول المصدر. ## أدلة ذات صلة - [إدارة مستندات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [مرجع استوديو مسار المعالجة](https://raptix.app/user-guide/ar/40-knowledge/40-2-pipeline-studio-reference/) - [إدارة سياسات الوصول](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/ # إدارة مستندات قاعدة المعرفة > **الوحدة:** وكلاء الذكاء الاصطناعي ← قاعدة المعرفة ← المستندات > > **الصفحة:** `/knowledge-documents` > > **الجمهور:** مشرفو قاعدة المعرفة > > **الوصول المطلوب:** صلاحية مستندات قاعدة المعرفة > > **ستتعلم:** كيف تستورد المحتوى وتعالجه في استوديو مسار المعالجة، وتطبق سياسات الوصول، وتضمّنه للبحث، وتختبر النتيجة، وتحافظ على إعدادات المعالجة المسبقة والإصدارات. ## الغرض من هذه الصفحة صفحة **المستندات (Documents)** هي مساحة الإدارة للمحتوى الذي يستخدمه وكلاء الذكاء الاصطناعي. وهي منفصلة عن مكتبة **المستندات** العادية؛ تخزن المكتبة ملفات العمل، بينما تجهز هذه الصفحة المحتوى المحدد للبحث في قاعدة المعرفة. لا يفتح المستخدمون العاديون هذه الصفحة عادة. فهم يستخدمون وكلاء الذكاء الاصطناعي ولا يتلقون إلا المحتوى المتاح عبر المساعد المحدد وقواعد وصوله. ## فهم تخطيط الصفحة للصفحة منطقتان رئيسيتان: - تحتوي اللوحة اليسرى على إدخال المحتوى والبحث في المستندات وقائمة المستندات وعنصر تحكم الإعداد المسبق و**إدارة السياسات (Manage Policies)** و**تحديث القائمة (Refresh list)** و**المزيد (More)**؛ - تفتح المنطقة الرئيسية **استوديو مسار المعالجة (Pipeline Studio)** للمستند المحدد. اختر مستندًا من اللوحة اليسرى قبل تغيير معالجته أو سياساته أو تضمينه أو اختباراته. ## إضافة محتوى توفر الصفحة الحالية طريقتي إدخال ظاهرتين: **المستندات** و**Markdown**. ### الاستيراد من المستندات 1. اختر **المستندات**. 2. انقر **تصفح المستندات (Browse Documents)**. 3. ابحث في الملفات المتوافقة داخل مربع **الاستيراد من المستندات (Import from Documents)**. 4. اختر ملفًا واحدًا، ثم انقر **استيراد (Import)**. تدعم قائمة الاستيراد محتوى PDF وDOCX وTXT وMD وHTML. الملف الذي يحمل علامة **موجود في قاعدة المعرفة (In Knowledge)** لديه مستند مطابق بالفعل؛ يؤدي اختياره إلى تحميل المستند القائم بدلًا من إنشاء نسخة أخرى. ### إضافة Markdown 1. اختر **Markdown**. 2. أدخل **اسم ملف المصدر (Source filename)**. 3. الصق Markdown، أو انقر **تحميل ‎.md (Load .md)** لتحميل ملف `.md` أو `.txt`. 4. انقر **تشغيل مسار المعالجة (Run Pipeline)**. يلزم اسم الملف ومحتوى Markdown معًا. ينشئ **تشغيل مسار المعالجة** المستند ويبدأ معالجته بالإعدادات الحالية. ## العثور على مستند واختياره استخدم **البحث في المستندات (Search documents)** لتصفية القائمة حسب اسم الملف. تعرض كل بطاقة اسم الملف ونوعه أو معلومات مصدره وحالة المعالجة الحالية وعنصر تحكم إعداد المعالجة المسبق. تشمل النتائج المحتملة للقائمة: - **لا توجد مستندات بعد (No documents yet)** — لم تُضف مستندات إلى قاعدة المعرفة؛ - **لم يُعثر على تطابق (No match found)** — لا يطابق نص البحث الحالي أي مستند؛ و - مؤشر تحميل أثناء تحديث القائمة. انقر **تحديث القائمة** بعد رفع خارجي أو مهمة مزامنة تلقائية إذا لم تظهر الحالة الجديدة بعد. ## استخدام إعدادات المعالجة المسبقة افتح عنصر تحكم إعداد المعالجة المسبق في بطاقة مستند لتوحيد الإعدادات المستخدمة في استوديو مسار المعالجة. يمكنك من هذه القائمة: - اختيار إعداد محفوظ وتطبيقه على المستند؛ - حفظ الإعدادات الحالية كإعداد جديد؛ - تحديث إعداد بالحفظ بالاسم نفسه؛ أو - حذف إعداد لم تعد تحتاج إليه. لا يؤدي حذف إعداد مسبق إلى حذف مستند. راجع قواعد المزامنة التلقائية قبل الحذف، لأن قاعدة قد تعتمد عليه. ## فهم استوديو مسار المعالجة ينظم الاستوديو العمل في أربع خطوات رئيسية: | الخطوة | الغرض | وقت فتحها | |---|---|---| | **مراحل المعالجة (Pipeline Stages)** | تحليل المحتوى وهيكلته وتلخيصه وإثراؤه. | متاحة فورًا. | | **سياسة الوصول (Access Policy)** | تطبيق قواعد الوصول إلى المستند أو الصفحة أو العقدة. | بعد اكتمال التحليل والتقسيم. هذه الخطوة اختيارية. | | **التضمين (Embedding)** | اختيار نموذج التضمين وأبعاده، ثم إضافة المستند إلى فهرس البحث. | بعد اكتمال التحليل والتقسيم. | | **الاختبار (Testing)** | فحص التشابه الدلالي وأقرب المقاطع المفهرسة. | بعد اكتمال التضمين. | توضح مؤشرات المراحل ما إذا كان العمل لم يبدأ أو قيد التنفيذ أو مكتملًا أو فاشلًا. قد يظل إجراء لاحق مقفلًا حتى تصبح النتيجة السابقة المطلوبة جاهزة. ## الخطوة 1: تشغيل مراحل المعالجة ### 1. تحليل Markdown اختر كيفية تحويل المصدر إلى Markdown منظم: - يقرأ **الاستخراج المباشر (Direct Extract)** ملفات PDF الرقمية والملفات النصية بسرعة. ولا يتعامل مع المستندات الممسوحة أو المبنية على الصور. - يدعم **المسار الكامل (Full Pipeline)** التعرف البصري على الحروف والملفات الممسوحة والتخطيطات المعقدة. عند اختيار **المسار الكامل**، قد تشمل **خيارات التحليل (Parse Options)**: - **مستوى التحليل (Parsing Tier)**؛ - **الصفحات المستهدفة (Target Pages)**؛ - **الحد الأقصى للصفحات (Max Pages)**؛ - **حجم الدفعة (Batch Size)**؛ - **حفظ الصور (Save Images)**؛ - **لغات (Languages)** المستند؛ و - **موجّه مخصص (Custom Prompt)** اختياري. انقر **تشغيل تحليل Markdown (Run Markdown Parse)**. بعد الاكتمال، استخدم **عرض / تحرير Markdown (View / Edit Markdown)** لمعاينته أو تحريره أو حفظه أو نسخه أو تنزيله أو عرضه بملء الشاشة. وإذا كان استخراج الصور مفعّلًا، فاستخدم **عرض الصور المستخرجة (View Extracted Images)**. ### 2. العُقد البنيوية والتقسيم إلى مقاطع تحول هذه المرحلة Markdown إلى عناصر دلالية ومقاطع جاهزة للاسترجاع. تأتي عادة بعد التحليل بإعدادات افتراضية مناسبة. وسّع **خيارات التقسيم (Chunking Options)** فقط عندما تحتاج إلى تغيير: - **الحد الأقصى لرموز المقطع (Max Chunk Tokens)** — أكبر حجم لكل مقطع؛ أو - **تداخل المقاطع (Chunk Overlap)** — مقدار السياق المشترك بين المقاطع المتجاورة. بعد الاكتمال، يمكنك استخدام **عرض / تحرير Chunk JSON (View / Edit Chunk JSON)** و**تصفح العُقد (Browse Nodes)** لفحص الإخراج. ### 3. ملخصات الجداول تنتج هذه المرحلة ملخصات بلغة طبيعية تجعل الجداول قابلة للبحث. تُتجاوز تلقائيًا عندما لا يحتوي المستند على جداول. اختر **نموذج التلخيص (Summary Model)**، وراجع **موجّه التلخيص (Summary Prompt)** أو عدّله، ثم انقر **تشغيل ملخصات الجداول (Run Table Summaries)**. استخدم **عرض ملخصات الجداول (View Table Summaries)** لفحص النتيجة. ### 4. إثراء LLM تضيف هذه المرحلة إلى كل مقطع ملخصات سياقية وكيانات مسماة واكتشاف معلومات حساسة ونتائج استخراج مخصصة اختيارية. الإعدادات الظاهرة هي: - **نموذج الإثراء (Enrichment Model)**؛ - **إضافة موجّه المستخدم (User Prompt Add-on)**؛ - **موجّه الإثراء الأساسي (Base Enrichment Prompt)**؛ و - **قواعد الاستخراج (JSON) (Extraction Rules)**. تمنع صيغة JSON غير الصالحة لقواعد الاستخراج تشغيل المرحلة. بعد الاكتمال، انقر **عرض نتائج الإثراء (View Enrichment Results)** لفحص المقاطع والكيانات وفئات المعلومات الحساسة والنتائج المخصصة. ## إدارة إصدارات المراحل يمكن لكل مرحلة مكتملة الاحتفاظ بإصدارات عدة. يتيح لك منتقي الإصدار: - اختيار النتيجة التي ستُمرر إلى المرحلة التالية؛ و - حذف إصدار متقادم للمرحلة. إذا حررت نتيجة سابقة أو اخترت إصدارًا مختلفًا، فأعد تشغيل المراحل اللاحقة التابعة حتى يعكس الفهرس النهائي المحتوى المقصود. ## الخطوة 2: تطبيق سياسات الوصول تعرض خطوة **سياسة الوصول** أولًا ملخص السياسات الحالي: - سياسة المستند؛ - استثناءات الصفحات؛ و - استثناءات العُقد. استخدم **تعيين سياسة (Assign Policy)** واختر إحدى علامات التبويب: | علامة التبويب | ما تغيّره | |---|---| | **المستند (Document)** | تطبق سياسة واحدة على المستند كاملًا. | | **استثناء الصفحة (Page Override)** | تستبدل سياسة المستند لصفحة واحدة. تبدأ أرقام الصفحات في عنصر التحكم هذا من `0`. | | **استثناء العقدة (Node Override)** | تبحث في المستند عن عُقد مطابقة وتطبق سياسة على المحدد منها فقط. | | **التعيين الذكي (Smart Assign)** | يستخدم نتائج المعلومات الحساسة أو الكيانات من **المرحلة 4: إثراء LLM** لتطبيق سياسة أو إزالتها بصورة مجمعة. | اختر السياسة وأكمل الحقول الخاصة بعلامة التبويب وطبّقها. ويمكنك أيضًا إزالة تعيينات المستند أو الصفحة أو العقدة القائمة من الملخص. تؤثر تغييرات السياسة في عمليات التضمين اللاحقة. إذا كان المستند مضمّنًا بالفعل، فانقر **مزامنة الوصول (Sync Access)** تحت **مزامنة الوصول إلى فهرس البحث (Sync Access to Search Index)** حتى تستخدم نتائج البحث الحالية أحدث بيانات السياسة الوصفية. استخدم **إدارة السياسات** أعلى قائمة المستندات لإنشاء تعريفات السياسات المتاحة أو تحريرها. راجع [إدارة سياسات الوصول إلى قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/). ## الخطوة 3: تضمين المستند يحول **التضمين المتجهي (Vector Embedding)** المقاطع المعالجة إلى تمثيل قابل للبحث. 1. اختر **نموذج تضمين (Embedding Model)**. 2. اختر **أبعاد تضمين (Embedding Dimensions)** يدعمها النموذج. 3. راجع ملخص النموذج والأبعاد. 4. انقر **تضمين المستند (Embed Document)**. تحذّر الصفحة عندما يؤدي تغيير الأبعاد إلى إعادة بناء فهرس البحث المشترك. وقد يزيل ذلك المستندات المضمّنة الأخرى من الفهرس إلى أن تُضمّن مجددًا. لا تغيّر الأبعاد من دون تنسيق عمل إعادة التضمين كاملًا. لا يحل التضمين محل نجاح التحليل والتقسيم. تأكد من المرحلتين أولًا. ## الخطوة 4: اختبار النتيجة ### اختبار التشابه أدخل: - **استعلامًا ذا صلة (Relevant Query)** ينبغي أن يطابق المستند المحدد؛ - **استعلامًا غير ذي صلة (Irrelevant Query)** ينبغي ألا يطابقه؛ و - **الحد الأدنى (Threshold)** المطلوب. انقر **تشغيل اختبار التشابه (Run Similarity Test)**. تعرض النتيجة الدرجتين وحكم **نجاح (PASS)** أو **فشل (FAIL)**. قد يعني الفشل أن الاستعلام ذا الصلة لا يصف المستند جيدًا، أو أن الحد صارم جدًا، أو أن المستند يحتاج إلى المعالجة والتضمين مجددًا. ### اختبار أقرب عنصر مجاور أدخل استعلامًا وانقر **تشغيل (Run)**. تعيد الصفحة أقرب ثلاثة مقاطع من المستند المحدد، بما فيها الدرجة وصفحة المصدر ومسار القسم عند توفره ومعاينة المحتوى. استخدم الاختبار للتأكد من استرجاع المقطع المتوقع، لا من ارتفاع الدرجة الرقمية فحسب. ## فتح صفحات الإدارة ذات الصلة افتح **المزيد** في رأس المستندات للوصول إلى: - **قواعد المزامنة التلقائية (Auto-Sync Rules)** — إنشاء قواعد المعالجة التلقائية وإدارتها؛ - **سجل المزامنة (Sync History)** — فتح المزامنة التلقائية مباشرة على **سجل المهام**؛ و - **إحصاءات المزامنة (Sync Stats)** — فتح المزامنة التلقائية مباشرة على **الإحصاءات**. راجع [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/). ## حذف مستند من قاعدة المعرفة اختر المستند، ثم انقر **حذف المستند (Delete document)** في رأسه. لا تؤكد إلا عندما ينبغي إزالة المستند من قاعدة المعرفة. هذا الإجراء منفصل عن حذف ملف المصدر من مكتبة المستندات العادية. إذا كانت قاعدة مزامنة تلقائية نشطة لا تزال تطابق المصدر، فقد يُعالج المحتوى مجددًا لاحقًا. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | ملف المصدر غير مدرج في **تصفح المستندات** | تأكد من أن نوعه متوافق ومن قدرتك على الوصول إليه في المستندات. | | **تشغيل مسار المعالجة** معطل لـMarkdown | أدخل **اسم ملف المصدر** ومحتوى Markdown معًا. | | تفشل مرحلة معالجة | افتح المرحلة، وصحح إدخالها أو إعداداتها، ثم أعد تشغيل المرحلة المتأثرة وأي مراحل لاحقة تابعة فقط. | | لا يتوفر نموذج لملخصات الجداول أو الإثراء | اطلب من المشرف إعداد النموذج المقابل في **مصادقة الذكاء الاصطناعي**. | | **التضمين** مقفل | أكمل التحليل والتقسيم أولًا. | | **الاختبار** مقفل | ضمّن المستند أولًا. | | لا تؤثر تغييرات السياسة في نتائج البحث الحالية | استخدم **مزامنة الوصول** بعد حفظ تعيين السياسة. | | لا يعيد اختبار أقرب عنصر مجاور نتيجة | تأكد من اكتمال التضمين، ثم جرّب استعلامًا أقرب إلى صياغة المستند. | ## أدلة ذات صلة - [إدارة سياسات الوصول إلى قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/) - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [اختيار إعداد معالجة مسبق وإعداده](https://raptix.app/user-guide/ar/40-knowledge/40-3-processing-preset/) - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) - [مراجعة تحليلات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-29-knowledge-analytics-current/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-4-documents-vs-markdown/ # إضافة محتوى من المستندات أو Markdown تعرض صفحة `/knowledge-documents` الحالية خياري **المستندات (Documents)** و**Markdown**. ## المستندات اختر **تصفح المستندات (Browse Documents)** لإعادة استخدام مصدر تستطيع الوصول إليه ومخزن بالفعل في مكتبة المستندات. يسرد مربع الحوار ملفات PDF وDOCX وTXT وMD وHTML المتوافقة. ابحث، واختر عنصرًا واحدًا، ثم اختر **استيراد (Import)**. استخدم هذه الطريقة عندما ينبغي أن يظل المصدر جزءًا من سير عمل مساحة العمل والتطبيق والصفحة والمجلد. وتعني **موجود في قاعدة المعرفة (In Knowledge)** وجود مستند مطابق بالفعل. ## Markdown أدخل اسم ملف مصدر مطلوبًا ومحتوى Markdown. يمكنك لصق النص أو استخدام **تحميل ‎.md (Load .md)** لملف `.md` أو `.txt`، ثم اختيار **تشغيل مسار المعالجة (Run Pipeline)**. استخدم هذه الطريقة للمحتوى النصي المُعد مسبقًا الذي لا يحتاج إلى اختياره من المستندات. اسم الملف والمحتوى مطلوبان. لا تعرض الصفحة حاليًا علامة مستقلة لرفع ملف مباشر. أضف الملفات العادية عبر المستندات، ثم استوردها إلى قاعدة المعرفة. ## أدلة ذات صلة - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) - [إدارة مستندات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-3-processing-preset/ # اختيار إعداد معالجة مسبق وإعداده يحفظ إعداد المعالجة المسبق قيم التحليل والتقسيم والنموذج والموجّه والإثراء والاستخراج والتضمين الحالية لإعادة استخدامها. ## إدارة الإعدادات المسبقة من مستندات قاعدة المعرفة افتح عنصر تحكم إعداد المعالجة المسبق في بطاقة مستند. يمكنك: - تطبيق إعداد مسبق قائم على المستند المحدد؛ - حفظ إعدادات المستند الحالية باسم جديد؛ - تحديث إعداد مسبق قائم بالحفظ بالاسم نفسه؛ أو - حذف إعداد مسبق لم تعد تحتاج إليه. يؤدي تطبيق إعداد مسبق إلى تغيير عناصر تحكم المعالجة؛ شغّل المراحل المطلوبة أو أعد تشغيلها حتى تؤثر الإعدادات في الإخراج. لا يؤدي حذف إعداد مسبق إلى حذف المستندات، لكن قد تظل قاعدة مزامنة تلقائية أو مساعد ذكي تشير إليه. ## استخدام الإعدادات المسبقة بأمان اختبر الإعداد المسبق على مستند ممثل قبل استخدامه في الأتمتة. استخدم **تلقائي (Automatic)** في المساعد الذكي إلا إذا كانت الملفات المرفوعة في المحادثة تحتاج إلى إعداد مُحضّر. تتطلب كل قاعدة في المزامنة التلقائية **إعدادًا مستهدفًا (Target Preset)**؛ ويمكن لعلامة **الإعدادات المسبقة (Presets)** أيضًا تعيين إعداد افتراضي عام. ## أدلة ذات صلة - [إدارة المزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [ربط إعداد مسبق بمساعد ذكي](https://raptix.app/user-guide/ar/30-ai-agents/30-27-linking-processing-preset/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-2-pipeline-studio-reference/ # مرجع استوديو مسار المعالجة يظهر استوديو مسار المعالجة بعد اختيار مستند في `/knowledge-documents`. خطواته الرئيسية هي: | الخطوة | الغرض | |---|---| | **مراحل المعالجة (Pipeline Stages)** | تحليل المحتوى وتقسيمه إلى مقاطع وتلخيص الجداول وإثراؤه. | | **سياسة الوصول (Access Policy)** | تطبيق قيود على المستند أو الصفحة أو العقدة أو الكيانات المكتشفة. | | **التضمين (Embedding)** | تحويل المقاطع المعالجة إلى فهرس البحث. | | **الاختبار (Testing)** | التحقق من التشابه وفحص أقرب المقاطع المطابقة. | ## مراحل المعالجة 1. **تحليل Markdown:** اختر **الاستخراج المباشر (Direct Extract)** للنص الرقمي، أو **المسار الكامل (Full Pipeline)** للتعرف البصري على الحروف والمسح الضوئي والتخطيطات المعقدة. يعرض المسار الكامل مستوى التحليل والصفحات وحجم الدفعة واستخراج الصور واللغات والموجّه المخصص. 2. **العُقد البنيوية والتقسيم إلى مقاطع:** ينشئ عُقدًا دلالية ومقاطع. الإعدادات الاختيارية هي **الحد الأقصى لرموز المقطع (Max Chunk Tokens)** و**تداخل المقاطع (Chunk Overlap)**. 3. **ملخصات الجداول:** تستخدم نموذج تلخيص وموجّهًا معدّين، وتتجاوز المرحلة إذا لم توجد جداول. 4. **إثراء LLM:** يضيف بيانات وصفية سياقية وكيانات وفئات معلومات شخصية ونتائج قواعد استخراج اختيارية. تعرض كل مرحلة حالتها، ويمكن أن تتيح إخراجها للمراجعة. لا يؤدي اختيار إخراج سابق أو تحريره تلقائيًا إلى إعادة بناء النتائج اللاحقة؛ أعد تشغيل المراحل التابعة والتضمين عند الحاجة. ## فتح الخطوات تتطلب سياسة الوصول والتضمين محتوى محللًا ومقسّمًا. ويتطلب الاختبار مستندًا مضمّنًا. قد تحسن المراحل الاختيارية الاسترجاع، لكنها لا تحل محل التحليل والتقسيم. ## أدلة ذات صلة - [تحرير Markdown المحلل](https://raptix.app/user-guide/ar/40-knowledge/40-5-editing-parsed-markdown/) - [إعداد تقسيم المقاطع](https://raptix.app/user-guide/ar/40-knowledge/40-6-stage2-chunking-settings/) - [التضمين والاختبار](https://raptix.app/user-guide/ar/40-knowledge/40-9-vector-embedding-and-testing/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-5-editing-parsed-markdown/ # مراجعة Markdown المحلل وتحريره بعد اكتمال **تحليل Markdown (Markdown Parsing)**، اختر **عرض / تحرير Markdown (View / Edit Markdown)**. يدعم العارض المعاينة وتحرير المصدر والنسخ وتنزيل `.md` والعرض بملء الشاشة. صحح العناوين والقوائم والجداول وأخطاء التعرف البصري أو السياق المفقود، ثم احفظ المحتوى المقصود. قد يكون لنتائج مرحلة المعالجة إصدارات عدة. استخدم منتقي إصدار المرحلة لاختيار النتيجة التي ستُمرر إلى المرحلة التالية، ولا تحذف إصدارًا متقادمًا إلا عندما تتأكد من عدم الحاجة إليه. بعد تغيير Markdown أو اختيار إصدار مختلف، أعد تشغيل **العُقد البنيوية والتقسيم إلى مقاطع** وأي مراحل تابعة لتلخيص الجداول أو الإثراء. أعد تضمين المستند حتى يستخدم البحث المحتوى المحدث. لا تضف معلومات غير موجودة في المصدر أو غير معتمدة له. طبّق سياسات الوصول قبل تضمين التصحيحات الحساسة. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-6-stage2-chunking-settings/ # إعداد العُقد البنيوية وتقسيم المقاطع تحول هذه المرحلة Markdown المحلل إلى عُقد دلالية ومقاطع جاهزة للاسترجاع. | الإعداد | الأثر | |---|---| | **الحد الأقصى لرموز المقطع (Max Chunk Tokens)** | أكبر حجم للمقطع. تكون المقاطع الأصغر أكثر تركيزًا، بينما تحفظ الأكبر قدرًا أوسع من السياق المحيط. | | **تداخل المقاطع (Chunk Overlap)** | سياق يتكرر بين المقاطع المتجاورة لتقليل فقدان المعنى عند الحدود. | ابدأ بالقيم الافتراضية الظاهرة إلا إذا كشف الاختبار مشكلة في الاسترجاع. بعد تشغيل المرحلة، استخدم **عرض / تحرير Chunk JSON (View / Edit Chunk JSON)** أو **تصفح العُقد (Browse Nodes)**. يمكن لـ**تصفح العُقد** التصفية بحسب **الكل (All)** أو **النص (Text)** أو **الجدول (Table)** أو **الملخص (Summary)**، والتصفية برقم الصفحة، والبحث في المحتوى أو القسم، وتوسيع العقدة لفحص نصها ومسار قسمها ونوعها وصفحتها وعدد رموزها. إذا أعدت تشغيل التقسيم، فراجع ملخصات الجداول والإثراء التابعة، وأعد التضمين قبل الاعتماد على الإخراج الجديد. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-7-stage3-table-summaries/ # إنشاء ملخصات الجداول ومراجعتها تحول مرحلة **ملخصات الجداول (Table Summaries)** الجداول إلى أوصاف بلغة طبيعية يمكنها تحسين الاسترجاع الدلالي. 1. أكمل التحليل والتقسيم إلى مقاطع. 2. اختر **نموذج تلخيص (Summary Model)** معدًّا. 3. راجع **موجّه التلخيص (Summary Prompt)**. تُستبدل عناصره النائبة المدعومة لكل جدول. 4. اختر **تشغيل ملخصات الجداول (Run Table Summaries)**. 5. افتح **عرض ملخصات الجداول (View Table Summaries)** للبحث والتصفية بحسب القسم وفحص الملخص وتحريره. تُتجاوز المرحلة عندما لا يحتوي المستند على جداول. إذا لم يظهر نموذج، فأعدّ نموذج **ملخص جدول (Table Summary)** نشطًا في مصادقة الذكاء الاصطناعي. بعد تحرير الملخصات أو إعادة توليدها، أعد تضمين المستند حتى يستخدم البحث الإصدار المقصود. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-8-stage4-ai-enrichment/ # تشغيل إثراء LLM يضيف **إثراء LLM (LLM Enrichment)** بيانات وصفية إلى المقاطع المعالجة لتحسين الاسترجاع وتعيين السياسات. أعدّ: - **نموذج الإثراء (Enrichment Model)**؛ - **إضافة موجّه المستخدم (User Prompt Add-on)** اختيارية؛ - **موجّه الإثراء الأساسي (Base Enrichment Prompt)**؛ و - **قواعد استخراج (JSON) (Extraction Rules)** اختيارية. تمنع صيغة JSON غير الصالحة في قواعد الاستخراج تشغيل المرحلة. بعد الاكتمال، افتح **عرض نتائج الإثراء (View Enrichment Results)** للبحث في المقاطع والتصفية بحسب القسم وتوسيع المحتوى وفحص الملخصات السياقية والكيانات وفئات المعلومات الشخصية ونتائج الاستخراج المخصصة. لا تحفظ إلا التغييرات التي راجعتها. يستخدم **التعيين الذكي (Smart Assign)** في **سياسة الوصول** المعلومات الشخصية ومجموعات الكيانات المكتشفة. إذا غيّرت إخراج الإثراء بعد التضمين، فراجع السياسات وأعد التضمين أو زامن الوصول حسب الحاجة. ## أدلة ذات صلة - [استخدام التعيين الذكي للسياسات](https://raptix.app/user-guide/ar/40-knowledge/40-12-smart-policy-assignment/) - [إعداد نموذج إثراء](https://raptix.app/user-guide/ar/40-knowledge/40-20-ai-models-catalog/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-9-vector-embedding-and-testing/ # تضمين مستند في قاعدة المعرفة واختباره افتح **التضمين (Embedding)** بعد اكتمال التحليل والتقسيم إلى مقاطع. 1. اختر **نموذج تضمين (Embedding Model)** نشطًا. 2. اختر قيمة مدعومة في **أبعاد التضمين (Embedding Dimensions)**. 3. راجع ملخص النموذج والأبعاد. 4. اختر **تضمين المستند (Embed Document)**. قد يؤدي تغيير الأبعاد إلى إعادة بناء فهرس البحث المشترك وإزالة مستندات أخرى مؤقتًا من الاسترجاع حتى تُضمّن من جديد. نسّق هذا التغيير قبل تأكيده. ## اختبار الاسترجاع افتح **الاختبار (Testing)** بعد التضمين. - **اختبار التشابه (Similarity Test):** أدخل استعلامًا ذا صلة وآخر غير ذي صلة وحدًا أدنى. راجع الدرجتين ونتيجة النجاح أو الفشل. - **اختبار أقرب عنصر مجاور (Nearest Neighbor Test):** أدخل استعلامًا واختر **تشغيل (Run)**. راجع أقرب ثلاثة مقاطع ودرجاتها وصفحة المصدر والقسم والمحتوى. يجعل التضمين الإخراج المحدد قابلًا للبحث؛ ولا يتجاوز نطاق قاعدة المعرفة أو سياسات الوصول. أعد التضمين بعد تغيير المحتوى المحلل أو المقاطع أو الملخصات أو الإثراء. استخدم **مزامنة الوصول (Sync Access)** بعد تغييرات السياسات فقط في مستند مفهرس بالفعل. ## أدلة ذات صلة - [إعداد ارتباطات النماذج الافتراضية](https://raptix.app/user-guide/ar/40-knowledge/40-21-default-model-bindings/) - [إدارة سياسات الوصول](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/ # إدارة سياسات الوصول إلى قاعدة المعرفة > **الوحدة:** وكلاء الذكاء الاصطناعي ← قاعدة المعرفة ← المستندات ← إدارة السياسات > > **الصفحة:** `/knowledge-policy` > > **الجمهور:** مشرفو قاعدة المعرفة > > **الوصول المطلوب:** صلاحية مستندات قاعدة المعرفة > > **ستتعلم:** كيف تنشئ تعريفات السياسات المستخدمة للتحكم في نتائج قاعدة المعرفة وتراجعها وتحررها وتحذفها. ## ما الذي تفعله سياسة الوصول؟ تحدد سياسة الوصول ما يحدث عندما لا يُسمح لدور المستخدم باستخدام محتوى محمي في قاعدة المعرفة. يمكن تعيين السياسة لمستند كامل أو صفحة واحدة أو عُقد محتوى محددة في استوديو مسار المعالجة. تدير هذه الصفحة تعريفات السياسات، ولا تعيّن السياسة للمحتوى. لإجراء التعيين، ارجع إلى خطوة **سياسة الوصول (Access Policy)** في المستند على `/knowledge-documents`. ## فتح الصفحة 1. افتح **مستندات قاعدة المعرفة (Knowledge Documents)**. 2. انقر **إدارة السياسات (Manage Policies)** في رأس المستندات. عنوان الصفحة هو **إدارة قاعدة المعرفة (Knowledge Administration)**، والقسم الرئيسي هو **سياسات الوصول (Access Policies)**. استخدم **رجوع (Back)** للعودة إلى الصفحة السابقة. إذا كانت خدمة قاعدة المعرفة معطلة، تعرض الصفحة تحذيرًا وتمنع إجراءات الإنشاء والتحرير والحذف إلى أن تتاح الخدمة مجددًا. ## قراءة جدول سياسات الوصول يعرض الجدول: | العمود | معناه | |---|---| | **الاسم (Name)** | اسم السياسة. تحدد شارة **افتراضية (Default)** سياسة الرجوع الاحتياطية. | | **التصنيف (Classification)** | تسمية حساسية مرتبطة بالسياسة. | | **إجراء المنع (Deny Action)** | ما يفعله النظام عندما لا يُسمح لدور المستخدم بالوصول. | | **الأدوار (Roles)** | الأدوار المسموح بها في السياسة. تعني **الكل (All)** عدم تحديد قيد لدور. | | **نشطة (Active)** | ما إذا كانت السياسة نشطة. تظهر الصفوف غير النشطة باهتة. | | **الإجراءات (Actions)** | عنصرا **تحرير (Edit)** و**حذف (Delete)**. | لا يحتوي مربع الإنشاء أو التحرير الحالي على عناصر تحكم في **نشطة** أو **افتراضية**. تظهر القيمتان في الجدول، لكن يديرهما النظام أو إعداده الإداري. ## فهم التصنيفات يوضح التصنيف حساسية المحتوى المحمي: | التصنيف | الوصف الظاهر في الصفحة | |---|---| | **عام (Public)** | متاح لكل المستخدمين. | | **داخلي (Internal)** | للموظفين فقط. | | **سري (Confidential)** | توزيعه مقيّد. | | **مقيّد (Restricted)** | على أساس الحاجة إلى المعرفة. | | **سري للغاية (Top Secret)** | أعلى مستوى حساسية. | التصنيف تسمية داخل السياسة. وتُفرض صلاحية الوصول من خلال **الأدوار المسموح بها (Allowed Roles)** و**إجراء المنع** المحدد. ## فهم إجراءات المنع | إجراء المنع | النتيجة عند عدم السماح بالوصول | |---|---| | **مخفي (Hidden)** | لا تظهر النتيجة المحمية. | | **منع مرن (Soft Deny)** | يُرفض الطلب مع رسالة. | | **محجوب جزئيًا (Masked)** | يُنقح المحتوى المحمي وفق **قواعد الحجب (JSON) (Masking Rules)**. | اختر **مخفي** عندما لا ينبغي كشف وجود النتيجة نفسه، و**منع مرن** عندما ينبغي أن يفهم المستخدم أن الوصول مقيّد، و**محجوب جزئيًا** فقط عندما تكون الصيغة المنقحة الآمنة مفيدة. ## إنشاء سياسة 1. انقر **إنشاء سياسة (Create Policy)**. 2. أدخل **اسم سياسة (Policy Name)** مطلوبًا. 3. اختر **التصنيف**. 4. اختر **إجراء المنع**. 5. اختر **الأدوار المسموح بها** المطلوبة. 6. إذا اخترت **محجوب جزئيًا**، فأدخل **قواعد حجب (JSON)** صالحة. 7. انقر **إنشاء (Create)**. ### اختيار الأدوار المسموح بها استخدم **البحث في الأدوار (Search roles)** لتصفية القائمة المتاحة. انقر دورًا لاختياره أو إزالته. تظهر الأدوار المحددة كشرائح أعلى القائمة. يوفر منتقي الأدوار أيضًا: - **تحديد الكل (Select all)**؛ - **إلغاء تحديد الكل (Deselect all)**؛ - زر إزالة في كل شريحة دور محدد؛ و - **مسح الكل (Clear all)**. يعني ترك **الأدوار المسموح بها** فارغة أن **كل الأدوار مسموح بها**، ولا يعني أن الوصول ممنوع على الجميع. أضف دائمًا دورًا واحدًا على الأقل عندما تهدف السياسة إلى تقييد المحتوى. ### إدخال قواعد الحجب لا يظهر **قواعد الحجب (JSON)** إلا عندما يكون **إجراء المنع** هو **محجوب جزئيًا**. أدخل كائن JSON صالحًا يحدد الحقول ونص الاستبدال. مثال: ```json { "email": "***@***", "phone": "***" } ``` تتحقق الصفحة من JSON أثناء الكتابة. يظل **إنشاء** أو **تحديث (Update)** معطلًا عندما تكون الصيغة غير صالحة. ## تحرير سياسة 1. اعثر على السياسة في الجدول. 2. انقر **تحرير**. 3. غيّر الاسم أو التصنيف أو إجراء المنع أو الأدوار أو قواعد الحجب. 4. انقر **تحديث**. يغيّر التحديث تعريف السياسة المشترك. يستخدم المحتوى المعيّن لها القاعدة المعدلة في المعالجة وعمليات البحث اللاحقة. إذا كان المحتوى المضمّن بالفعل يحتاج إلى بيانات وصول وصفية محدثة، فافتح كل مستند متأثر واستخدم **مزامنة الوصول (Sync Access)** في استوديو مسار المعالجة. ## حذف سياسة 1. انقر **حذف** للسياسة. 2. راجع تأكيد **حذف السياسة؟ (Delete Policy?)**. 3. انقر **حذف** للتأكيد. الحذف منطقي وليس نهائيًا. تعود المستندات التي تستخدم السياسة المحذوفة إلى السياسة التي تحمل علامة **افتراضية**. راجع السياسة الافتراضية قبل حذف سياسة مقيّدة حتى لا يحصل المحتوى على سلوك رجوع غير مقصود. ## تطبيق سياسة على محتوى ارجع إلى `/knowledge-documents`، واختر مستندًا، وافتح **سياسة الوصول**. يمكنك عندئذ تعيين السياسة على مستوى: - **المستند**؛ - **استثناء الصفحة (Page Override)**؛ - **استثناء العقدة (Node Override)**؛ أو - **التعيين الذكي (Smart Assign)** لمطابقات المعلومات الحساسة والكيانات التي تنتجها **المرحلة 4: إثراء LLM**. بعد تغيير الوصول في مستند مضمّن بالفعل، انقر **مزامنة الوصول** حتى يتلقى فهرس البحث الحالي البيانات الوصفية للسياسة الجديدة. ## ضمانات مهمة - اجعل أسماء السياسات قصيرة ومحددة، مثل `HR Confidential` أو `Internal Procedures`. - تعامل مع قائمة الأدوار الفارغة باعتبارها وصولًا واسعًا. - استخدم أصغر قائمة أدوار لازمة للمحتوى السري أو المقيّد. - تحقق من الحجب بأسئلة نموذجية حقيقية قبل الاعتماد عليه. - راجع سياسة الرجوع قبل حذف أي سياسة. - لا تفترض أن تسمية التصنيف وحدها تمنح دورًا أو تمنعه؛ راجع **الأدوار المسموح بها**. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب فعله | |---|---| | **إنشاء سياسة** أو إجراءات الصف معطلة | قد تكون خدمة قاعدة المعرفة غير متاحة. انتظر زوال التحذير أو تواصل مع مشرف. | | دور غير ظاهر | امسح **البحث في الأدوار** وتأكد من وجود الدور في مساحة العمل. | | **إنشاء** أو **تحديث** معطل لسياسة حجب | صحح صيغة JSON في **قواعد الحجب**. | | تعرض السياسة **الكل** في الأدوار | قائمة الأدوار المسموح بها فارغة، ولذلك يُسمح لكل الأدوار. حرر السياسة وأضف الأدوار المقصودة. | | للمحتوى المرتبط بسياسة محذوفة سلوك وصول غير متوقع | راجع السياسة ذات علامة **افتراضية**؛ فهي البديل الاحتياطي. | | لا يظهر سلوك السياسة المحدث في النتائج الحالية | افتح المستند المتأثر وانقر **مزامنة الوصول**. | ## أدلة ذات صلة - [إدارة مستندات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [تعيين السياسات على مستوى المستند والصفحة والعقدة](https://raptix.app/user-guide/ar/40-knowledge/40-11-assigning-policies-document-page-node/) - [التعيين الذكي للسياسات](https://raptix.app/user-guide/ar/40-knowledge/40-12-smart-policy-assignment/) - [إثراء LLM](https://raptix.app/user-guide/ar/40-knowledge/40-8-stage4-ai-enrichment/) - [تضمين مستند في قاعدة المعرفة واختباره](https://raptix.app/user-guide/ar/40-knowledge/40-9-vector-embedding-and-testing/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-11-assigning-policies-document-page-node/ # تعيين السياسات للمستندات والصفحات والعُقد أنشئ تعريفات السياسات في `/knowledge-policy`، ثم عيّنها من خطوة **سياسة الوصول (Access Policy)** في مستند على `/knowledge-documents`. ## مراجعة التعيينات الحالية يعرض ملخص السياسات سياسة المستند واستثناءات الصفحات والعُقد. لا تزل تعيينًا من هذا الملخص إلا عندما ينبغي أن يرث المحتوى سياسة أوسع. ## تعيين سياسة اختر **تعيين سياسة (Assign Policy)**، وحدد السياسة، ثم استخدم إحدى علامات التبويب: - **المستند (Document):** تطبق السياسة على المستند كاملًا. - **استثناء الصفحة (Page Override):** أدخل رقم صفحة واستبدل سياسة المستند لهذه الصفحة. يبدأ ترقيم الصفحات في عنصر التحكم هذا من `0`. - **استثناء العقدة (Node Override):** أدخل نص بحث، واختر العُقد المطابقة، ثم عيّن السياسة لها. - **التعيين الذكي (Smart Assign):** يعيّن السياسات بصورة مجمعة حسب المعلومات الشخصية أو مجموعات الكيانات المكتشفة خلال إثراء LLM. بعد تغيير السياسات في مستند مضمّن، اختر **مزامنة الوصول (Sync Access)** تحت **مزامنة الوصول إلى فهرس البحث (Sync Access to Search Index)**. اختبر بدور مسموح به وآخر مستبعد قبل الاعتماد على النتيجة. ## أدلة ذات صلة - [إدارة سياسات الوصول إلى قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/) - [استخدام التعيين الذكي للسياسات](https://raptix.app/user-guide/ar/40-knowledge/40-12-smart-policy-assignment/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-12-smart-policy-assignment/ # استخدام التعيين الذكي للسياسات يطبّق **التعيين الذكي (Smart Assign)** سياسات العُقد بصورة مجمعة باستخدام أنواع المعلومات الشخصية والكيانات التي ينتجها **إثراء LLM**. 1. شغّل التحليل والتقسيم وإثراء LLM على المستند المحدد. 2. افتح **سياسة الوصول ← تعيين سياسة ← التعيين الذكي**. 3. اختر السياسة المطلوب تطبيقها. 4. اختر **المعلومات الشخصية (PII)** أو **الكيانات (Entities)**. 5. راجع كل مجموعة وعدد عُقدها. 6. استخدم **تعيين (Assign)** لمجموعة واحدة أو **تعيين الكل (Assign All)** لكل المجموعات المكتشفة في علامة التبويب المحددة. عندما تكون مجموعة معيّنة بالفعل، استخدم **إزالة (Remove)** أو **إزالة الكل (Remove All)**. توضح النتيجة عدد العُقد التي تلقت السياسة. حدّث قائمة المحتوى عندما يتغير الإثراء. يعمل التعيين الذكي على مستند واحد في كل مرة. ويعني عدم وجود مجموعات مكتشفة أن إخراج الإثراء لا يتضمن معلومات شخصية أو كيانات مطابقة؛ استخدم المستند أو استثناء الصفحة أو استثناء العقدة عندما تحتاج إلى تحكم يدوي. بعد التعيين، راجع استثناءات العُقد واختر **مزامنة الوصول** إذا كان المستند مضمّنًا بالفعل. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/ # إدارة المزامنة التلقائية لقاعدة المعرفة > **الوحدة:** وكلاء الذكاء الاصطناعي ← قاعدة المعرفة ← المستندات ← المزيد ← قواعد المزامنة التلقائية > > **الصفحة:** `/knowledge-auto-sync` > > **الجمهور:** مشرفو قاعدة المعرفة > > **الوصول المطلوب:** صلاحية المزامنة التلقائية لقاعدة المعرفة > > **ستتعلم:** كيف تنشئ قواعد مزامنة، وتختبر نطاقها، وتعالج الملفات القائمة، وتراقب المهام والإحصاءات، وتدير إعدادات المعالجة المسبقة. ## ما الذي تفعله المزامنة التلقائية؟ تراقب المزامنة التلقائية الملفات المضافة عبر المستندات أو التطبيقات أو المستخدمين أو منشئ التدفقات، وتعالج الملفات المطابقة تلقائيًا لتصبح متاحة للبحث في قاعدة المعرفة. تجيب قاعدة المزامنة التلقائية عن أربعة أسئلة: 1. ما الملفات التي ينبغي أن تطابق القاعدة؟ 2. ما أنواع الملفات المسموح بها؟ 3. ما إعداد المعالجة المسبق المطلوب استخدامه؟ 4. متى ينبغي أن تبدأ المعالجة؟ افتح الصفحة من **مستندات قاعدة المعرفة ← المزيد ← قواعد المزامنة التلقائية**. استخدم **العودة إلى قاعدة المعرفة (Back to Knowledge)** للرجوع إلى `/knowledge-documents`، و**تحديث (Refresh)** لإعادة تحميل علامة التبويب النشطة. ## فهم علامات التبويب الأربع | علامة التبويب | ما يمكنك فعله | |---|---| | **القواعد (Rules)** | إنشاء قواعد المزامنة وتمكينها واختبارها وتشغيلها وتحريرها وحذفها. | | **سجل المهام (Job History)** | مراجعة كل مهمة معالجة، وإعادة محاولة الإخفاقات، وإلغاء المهام التي لم تبدأ. | | **الإحصاءات (Stats)** | مراجعة أعداد الحالات ومتوسط مدة المهام الناجحة والقواعد الأكثر نشاطًا خلال آخر 24 ساعة. | | **الإعدادات المسبقة (Presets)** | عرض إعدادات المعالجة المسبقة، وتعيين الافتراضي العام، وإعادة تسمية الإعدادات أو حذفها. | لا يظهر زر **قاعدة جديدة (New Rule)** إلا في علامة **القواعد**. ## قبل إنشاء قاعدة - أنشئ إعداد معالجة مسبقًا واحدًا على الأقل من قائمة **إعداد المعالجة المسبق (Processing Preset)** في مستندات قاعدة المعرفة. - حدّد ما إذا كانت القاعدة ستعالج الملفات الجديدة المطابقة فقط، أم الملفات القائمة أيضًا باستخدام **التشغيل الآن (Run Now)**. - حدّد أضيق نطاق مفيد. - إذا أمكن تداخل النطاقات، فأبقِ **تجاوز الملفات التي سبق معالجتها (Skip files that have already been processed)** مفعّلًا. ## إنشاء قاعدة مزامنة افتح **القواعد**، وانقر **قاعدة جديدة**، وأكمل المعالج ذي الخطوات الست. ### الخطوة 1: الهوية أعدّ: - **اسم القاعدة (Rule Name)** — مطلوب؛ - **الوصف (Description)** — سياق اختياري للمشرفين الآخرين؛ - **مفعّلة (Enabled)** — ما إذا كانت القاعدة تستطيع إنشاء مهام تلقائية جديدة بعد حفظها؛ و - **الأولوية (Priority)** — قيمة ترتيب القاعدة. استخدم اسمًا يوضح المصدر والغرض، مثل `HR policies to Knowledge`. يمكنك حفظ قاعدة معطلة، واختبار سلوك مطابقتها، ثم تمكينها لاحقًا. ### الخطوة 2: النطاق اختر مصدر الملفات المطابقة: | النطاق | ما يطابقه | عناصر التحكم الإضافية | |---|---|---| | **أي رفع (Any Upload)** | كل ملف يُرفع عبر النظام. | لا محدد أضيق. | | **مساحة العمل (Workspace)** | الملفات في مساحة عمل واحدة. | **مساحة عمل** مطلوبة. | | **التطبيق / الصفحة / الحقل (App / Page / Field)** | الملفات من تطبيق أو صفحة أو حقل نموذج محدد. | مساحة العمل ← التطبيق ← الصفحة، و**اسم حقل** اختياري، و**تضمين الملفات من المسارات الفرعية**. | | **المستخدم / الدور (User / Role)** | الملفات التي يرفعها المستخدمون أو الأدوار المحددة. | شرائح الأدوار وبحث المستخدم ومربعات تحديد المستخدمين. | | **سير عمل منشئ التدفقات (Flow Builder Workflow)** | الملفات المرفوعة في عملية سير عمل محددة. | سير عمل مطلوب و**تسمية عقدة** اختيارية. | في **التطبيق / الصفحة / الحقل**، يؤدي ترك التطبيق أو الصفحة أو الحقل فارغًا إلى إبقاء المطابقة أوسع عند ذلك المستوى. استخدم ملخص **النطاق** بأسلوب مسار التنقل للتحقق من الاختيار النهائي. في **المستخدم / الدور**، تتيح الصفحة جمع الأدوار والمستخدمين المحددين. امسح شريحة المستخدم أو انقر الدور المحدد مجددًا لإزالته. في **سير عمل منشئ التدفقات**، اترك **تسمية العقدة** فارغة لمطابقة كل عُقد الرفع في سير العمل. لا تدخل تسمية إلا عندما يجب أن تستهدف القاعدة خطوة رفع واحدة. ### الخطوة 3: عوامل تصفية الملفات اختر أي امتدادات مسموح بها: `pdf` و`docx` و`doc` و`md` و`xlsx` و`csv` و`pptx` و`txt` و`html`. اترك كل الامتدادات بلا تحديد للسماح بكل الأنواع المدعومة. عند اختيار `pdf`، يظهر **حد صفحات PDF (PDF Page Limit)**. اضبط **الحد الأقصى للصفحات (Max Pages)** على `0` لعدم فرض حد. تتجاوز القيمة الموجبة ملفات PDF التي يزيد عدد صفحاتها عليها. ### الخطوة 4: مسار المعالجة اختر **إعدادًا مستهدفًا (Target Preset)** واحدًا مطلوبًا. يحدد الإعداد المختار سلوك التحليل والتقسيم والإثراء والتضمين للملفات المطابقة. يقبل المعالج الحالي إعدادًا مستهدفًا واحدًا لكل قاعدة. إذا لم يتوفر أي إعداد، فأنشئ واحدًا من قائمة **إعداد المعالجة المسبق** في مستندات قاعدة المعرفة، ثم ارجع وحدّث الصفحة. ### الخطوة 5: المُشغّل اختر وقت معالجة الملفات المطابقة: - **فورًا (Immediately)** — يبدأ عند رفع الملف؛ - **بعد تأخير (After a delay)** — ينتظر عددًا محددًا من الدقائق أو الساعات؛ أو - **وفق جدول (On a schedule)** — يعالج بصورة متكررة كل ساعة أو يوم أو أسبوع. للجدولة، أعدّ فاصل التكرار واليوم للجدول الأسبوعي والوقت عند الحاجة و**المنطقة (Zone)**. راجع ملخص الجدول المقروء قبل المتابعة. أعدّ تحت **الاعتمادية (Reliability)**: - **محاولات الإعادة عند الفشل (Retry attempts if it fails)**؛ - **الانتظار بين المحاولات بالدقائق (Wait between retries)**؛ و - **تجاوز الملفات التي سبق معالجتها، موصى به**. يقارن الخيار الأخير محتوى الملف ويساعد على منع تكرار المعالجة عند تداخل عمليات الرفع أو القواعد. ### الخطوة 6: المراجعة تلخص خطوة **المراجعة (Review)**: - اسم القاعدة؛ - حالتها مفعّلة أو معطلة؛ - نطاق المطابقة؛ - توقيت المُشغّل؛ - الإعداد المستهدف؛ - الأولوية؛ و - التعامل مع التكرار. انقر **إنشاء القاعدة (Create Rule)**. يلزم اسم للقاعدة وإعداد مستهدف. وعند تحرير قاعدة قائمة، يكون الإجراء الأخير **حفظ التغييرات (Save Changes)**. ## قراءة بطاقات القواعد وإدارتها تعرض كل بطاقة اسم القاعدة ووصفها عند وجوده والمُشغّل والنطاق والأولوية والإعداد المستهدف. استخدم عناصر التحكم من أجل: - تمكين القاعدة أو تعطيلها؛ - **التشغيل التجريبي (Dry-run)**؛ - **التشغيل الآن، المعالجة اللاحقة (Run Now — backfill)**؛ - **تحرير (Edit)**؛ أو - **حذف (Delete)**. يوقف تعطيل القاعدة إنشاء مهام تلقائية جديدة، ولا يلغي العمل الذي بدأ بالفعل. يؤدي حذف القاعدة أيضًا إلى إزالة كل المهام المرتبطة بها. يختلف ذلك عن تعطيلها ويتطلب تأكيدًا. ## اختبار قاعدة بالتشغيل التجريبي انقر **التشغيل التجريبي** لتقييم القاعدة مقابل محتوى المستندات القائم من دون معالجة شيء أو تغييره. يعرض مربع الحوار: - عدد المستندات المطابقة؛ و - عينة تتضمن اسم الملف ونوع المحتوى والحجم عند توفره. إذا كان العدد أو العينة غير صحيح، فأغلق المربع وضيّق نطاق القاعدة أو عوامل تصفية الملفات قبل تمكينها. ## معالجة الملفات القائمة بالتشغيل الآن انقر **التشغيل الآن، المعالجة اللاحقة** لوضع الملفات المطابقة الموجودة في قائمة الانتظار. يوضح التأكيد عدد المستندات المطابقة وعدد المهام الموضوعة في القائمة. استخدم **سجل المهام** لمراقبة النتيجة. ينطبق التشغيل التلقائي المعتاد على عمليات الرفع اللاحقة؛ و**التشغيل الآن** هو الإجراء الصريح للمحتوى القائم. ## مراقبة سجل المهام يمكن أن يعرض كل صف مهمة: - حالة مقروءة؛ - اسم الملف أو رقم المستند؛ - معرّف الإعداد المستهدف؛ - عدد العناصر المفهرسة؛ - المدة؛ - وقت الإنشاء؛ و - خطأ مقروءًا عند فشل المعالجة. تشمل الحالات الحالية **ناجحة (Succeeded)** و**فاشلة (Failed)** و**قيد التشغيل (Running)** و**مجدولة (Scheduled)** و**معلّقة (Pending)** و**ملغاة (Cancelled)** و**تم تجاوزها، مكررة (Skipped — duplicate)**. تعتمد الإجراءات المتاحة على الحالة: - انقر **إعادة المحاولة (Retry)** لمهمة **فاشلة**؛ - انقر **إلغاء (Cancel)** لمهمة **مجدولة** أو **معلّقة**؛ و - انتظر أو حدّث لمهمة قيد التشغيل. إذا عرضت العلامة **لم تعمل أي مهام بعد (No jobs have run yet)**، فمكّن قاعدة وارفع ملفًا مطابقًا، أو استخدم **التشغيل الآن** للملفات القائمة. ## قراءة الإحصاءات تغطي **الإحصاءات** آخر 24 ساعة ويمكن أن تعرض: - عددًا لكل حالة مهمة؛ - **متوسط مدة مسار المعالجة للناجحة (Avg pipeline duration — succeeded)**؛ و - **أكثر القواعد نشاطًا خلال آخر 24 ساعة (Top Rules — last 24h)** مع عدد مهام كل قاعدة. يشمل المتوسط المهام الناجحة، لا كل المحاولات. وعندما لا يقع نشاط خلال النافذة، تعرض الصفحة رسالة حالة فارغة بدلًا من بطاقات مملوءة بأصفار. ## إدارة الإعدادات المسبقة افتح **الإعدادات المسبقة** لإدارة الإعدادات المستخدمة في المستندات وقواعد المزامنة. ### تعيين الإعداد الافتراضي تحدد لوحة **إعداد معالجة المستند (Document processing preset)** الإعداد الافتراضي العام المستخدم عندما تبدأ المعالجة من دون تحديد إعداد صراحة. - انقر النجمة بجوار إعداد لاختيار **تعيين كافتراضي (Set as default)**؛ - انقر النجمة المملوءة أو **مسح الإعداد الافتراضي (Clear default preset)** لإزالة الافتراضي؛ و - ابحث عن شارة **افتراضي (Default)** للتأكد من الاختيار الحالي. ### إعادة تسمية إعداد أو حذفه استخدم **إعادة تسمية الإعداد (Rename preset)** لتغيير اسم عرضه. ولا تستخدم **حذف الإعداد (Delete preset)** إلا بعد مراجعة المستندات وقواعد المزامنة التي قد تستخدمه؛ فلا يمكن التراجع عن الحذف. لا تنشئ علامة التبويب هذه إعدادات مسبقة. أنشئ واحدًا من قائمة **إعداد المعالجة المسبق** في مستندات قاعدة المعرفة. ## نمط الإعداد الموصى به 1. أنشئ إعداد معالجة مسبقًا واختبره على مستند ممثل. 2. أنشئ قاعدة مزامنة تلقائية ضيقة النطاق ومعطلة. 3. شغّل **التشغيل التجريبي** وراجع عينته. 4. صحح النطاق أو عوامل التصفية عند الحاجة. 5. مكّن القاعدة. 6. استخدم **التشغيل الآن** فقط إذا كان ينبغي تضمين الملفات المطابقة القائمة. 7. راجع **سجل المهام** و**الإحصاءات** بعد المعالجة الأولية. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | تقول الصفحة إنك لا تملك صلاحية | اطلب من المشرف صلاحية المزامنة التلقائية لقاعدة المعرفة. | | زر **التالي (Next)** معطل في الهوية | أدخل **اسم القاعدة**. | | **إنشاء القاعدة** معطل | أدخل اسمًا واختر **إعدادًا مستهدفًا** واحدًا. | | مساحة عمل أو تطبيق أو صفحة مفقودة | تأكد من وجودها ومن قدرة حسابك على الوصول إليها، ثم انقر **تحديث**. | | يطابق التشغيل التجريبي ملفات كثيرة | ضيّق النطاق، واختر الامتدادات، وحدد صفحة أو حقلًا، أو استخدم نطاق مستخدم أو دور أو سير عمل. | | لا تُعالج الملفات السابقة | انقر **التشغيل الآن**؛ فتمكين القاعدة وحده لا يعالج المحتوى القائم. | | تظل مهمة فاشلة | راجع الخطأ الظاهر، وصحح المصدر أو الإعداد، ثم انقر **إعادة المحاولة**. | | الملف **تم تجاوزه، مكرر** | اكتشفت القاعدة محتوى سبق معالجته بينما كان منع التكرار مفعّلًا. | | الإحصاءات فارغة | لم يقع نشاط لمهام المزامنة خلال آخر 24 ساعة. | | لا يظهر إعداد في المعالج | أنشئ إعدادًا في مستندات قاعدة المعرفة وحدّث المزامنة التلقائية. | ## أدلة ذات صلة - [إدارة مستندات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [اختيار إعداد معالجة مسبق وإعداده](https://raptix.app/user-guide/ar/40-knowledge/40-3-processing-preset/) - [نطاقات قواعد المزامنة](https://raptix.app/user-guide/ar/40-knowledge/40-14-sync-rule-scopes/) - [مُشغّلات قواعد المزامنة](https://raptix.app/user-guide/ar/40-knowledge/40-15-sync-rule-triggers/) - [التحقق من قاعدة بالتشغيل التجريبي](https://raptix.app/user-guide/ar/40-knowledge/40-16-dry-run-sync-rule/) - [إدارة مهام المزامنة](https://raptix.app/user-guide/ar/40-knowledge/40-17-managing-sync-jobs/) - [إحصاءات المزامنة](https://raptix.app/user-guide/ar/40-knowledge/40-18-sync-stats/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-14-sync-rule-scopes/ # اختيار نطاق قاعدة مزامنة تلقائية > **الوحدة:** المزامنة التلقائية لقاعدة المعرفة ← القواعد ← قاعدة جديدة ← النطاق > > **الصفحة:** `/knowledge-auto-sync` > > **الجمهور:** مشرفو قاعدة المعرفة ## ما الذي يتحكم فيه النطاق؟ يحدد **النطاق (Scope)** المواضع التي تبحث فيها قاعدة المزامنة التلقائية عن الملفات. يوفر المعالج الحالي خمسة أوضاع: | النطاق | استخدامه | |---|---| | **أي رفع (Any Upload)** | كل ملف يُرفع في النظام. | | **مساحة العمل (Workspace)** | الملفات في مساحة عمل واحدة. | | **التطبيق / الصفحة / الحقل (App / Page / Field)** | الملفات في مساحة عمل أو تطبيق أو صفحة أو حقل نموذج مسمى. | | **المستخدم / الدور (User / Role)** | الملفات التي رفعها مستخدمون محددون أو أعضاء أدوار محددة. | | **سير عمل منشئ التدفقات (Flow Builder Workflow)** | الملفات المرفوعة في سير عمل محدد، واختياريًا عند عقدة رفع واحدة. | ## أي رفع لا يتضمن **أي رفع** محددًا أضيق. استخدمه فقط عندما ينبغي النظر في كل عملية رفع مدعومة. لأنه الخيار الأوسع: - حدد امتدادات الملفات في **عوامل تصفية الملفات (File Filters)** متى أمكن؛ - استخدم **التشغيل التجريبي (Dry-run)** قبل تمكين القاعدة؛ و - أبقِ منع التكرار مفعّلًا عندما قد تتداخل قواعد أخرى. ## مساحة العمل اختر **مساحة العمل**، ثم اختر مساحة العمل المطلوبة. تطابق القاعدة الملفات المرتبطة بها. إذا كانت قائمة مساحات العمل فارغة، فتأكد من أن الحساب يستطيع عرض مساحة العمل المطلوبة، ثم حدّث الصفحة. ## التطبيق / الصفحة / الحقل يستخدم هذا النطاق تحديدًا متسلسلًا: 1. اختر **مساحة العمل**. 2. اختر **التطبيق (Application)** اختياريًا. 3. اختر **الصفحة (Page)** اختياريًا. 4. أدخل **اسم الحقل (Field Name)** اختياريًا. 5. حدد ما إذا كنت تريد **تضمين الملفات من المسارات الفرعية (Include files from sub-paths)**. يُبقي ترك مستوى أدنى فارغًا النطاق واسعًا عند آخر مستوى محدد. مثلًا، يؤدي اختيار مساحة عمل وتطبيق من دون صفحة إلى مطابقة كل صفحات ذلك التطبيق. **اسم الحقل** هو اسم حقل نموذج ظاهر، مثل `contract_attachment`. اتركه فارغًا لمطابقة كل حقول الملفات في الصفحة المحددة. راجع مسار **النطاق** الظاهر قبل المتابعة. ## المستخدم / الدور يوفر نطاق **المستخدم / الدور** محددين: - **الأدوار (Roles)** — انقر شرائح الأدوار لاختيارها أو إزالتها؛ - **المستخدمون (Users)** — ابحث باسم المستخدم أو البريد، ثم اختر المستخدمين من القائمة. يظهر المستخدمون المحددون كشرائح قابلة للإزالة. يمكنك جمع المستخدمين والأدوار في قاعدة واحدة؛ ويعرض ملخص **النطاق** المجموعتين. تُقيّم عضوية الدور عند عملية الرفع التي تطلق القاعدة. لا يؤدي تغيير دور المستخدم إلى إزالة الملفات التي سبق أن عالجتها قاعدة المعرفة. ## سير عمل منشئ التدفقات 1. اختر **سير عمل منشئ التدفقات**. 2. اختر سير العمل المطلوب. 3. أدخل **تسمية العقدة (Node Label)** اختياريًا. اترك تسمية العقدة فارغة لمطابقة عُقد الرفع في سير العمل المحدد جميعها. أدخل التسمية الدقيقة فقط عندما ينبغي أن تطابق القاعدة خطوة رفع معينة. إذا أمكن لقاعدة أخرى مطابقة الملف نفسه عبر نطاق مساحة العمل أو التطبيق، فأبقِ **تجاوز الملفات التي سبق معالجتها (Skip files that have already been processed)** مفعّلًا في **المُشغّل (Trigger)**. ## التحقق من النطاق المختار بعد حفظ القاعدة: 1. أبقها معطلة في البداية. 2. انقر **التشغيل التجريبي**. 3. قارن عدد المطابقات وعينة الملفات بالمصدر المقصود. 4. حرر القاعدة إذا كان النطاق أوسع أو أضيق من المطلوب. 5. لا تمكّنها إلا بعد صحة النتيجة. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | قائمة مساحات العمل فارغة | تأكد من صلاحية الوصول إلى التطبيقات ومن وجود مساحة عمل واحدة على الأقل. | | التطبيق معطل | اختر مساحة عمل أولًا. | | الصفحة معطلة | اختر تطبيقًا أولًا. | | يطابق ملف من صفحة خاطئة | اختر الصفحة صراحة أو أضف **اسم الحقل**. | | لا يعيد بحث المستخدم نتيجة | امسح البحث، ثم تحقق من اسم المستخدم أو البريد وإمكانية رؤية الحساب. | | قائمة مسارات سير العمل لا تحتوي المطلوب | تأكد من وجود سير العمل في منشئ التدفقات ومن قدرة الحساب على رؤيته. | | يُعالج الملف نفسه مرتين | فعّل منع التكرار وراجع القواعد المتداخلة. | ## أدلة ذات صلة - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [اختيار مُشغّل للمزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-15-sync-rule-triggers/) - [التحقق من قاعدة بالتشغيل التجريبي](https://raptix.app/user-guide/ar/40-knowledge/40-16-dry-run-sync-rule/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-15-sync-rule-triggers/ # اختيار مُشغّل للمزامنة التلقائية > **الوحدة:** المزامنة التلقائية لقاعدة المعرفة ← القواعد ← قاعدة جديدة ← المُشغّل > > **الصفحة:** `/knowledge-auto-sync` > > **الجمهور:** مشرفو قاعدة المعرفة ## ما الذي يتحكم فيه المُشغّل؟ تحدد خطوة **المُشغّل (Trigger)** وقت معالجة الملف المطابق وكيفية التعامل مع الإخفاق أو التكرار. الخيارات الحالية هي: | الخيار | السلوك | |---|---| | **فورًا (Immediately)** | يعالج الملف عند رفعه. | | **بعد تأخير (After a delay)** | ينتظر عددًا محددًا من الدقائق أو الساعات. | | **وفق جدول (On a schedule)** | يعالج بصورة متكررة كل ساعة أو يوم أو أسبوع. | ## فورًا اختر **فورًا** عندما ينبغي تحديث قاعدة المعرفة بمجرد وصول الملفات المطابقة. لا تظهر حقول توقيت إضافية. يناسب ذلك المحتوى النهائي الذي يحتاج إليه المستخدمون بعد الرفع بوقت قصير. استخدم التأخير أو الجدولة عندما تُستبدل الملفات كثيرًا، أو عندما ينبغي تشغيل المعالجة في وقت مضبوط. ## بعد تأخير اختر **بعد تأخير**، ثم أدخل: - قيمة تأخير موجبة؛ و - **دقائق بعد الرفع (minutes after upload)** أو **ساعات بعد الرفع (hours after upload)**. تعرض الصفحة ملخصًا مقروءًا للتوقيت. استخدم هذا الخيار عندما يُرجح استبدال الملف أو توقيعه أو إنهاؤه بعد وقت قصير من رفعه الأول. ## وفق جدول اختر **وفق جدول**، ثم حدد: - **كل ساعة (Every hour)**؛ - **كل يوم (Every day)**؛ أو - **كل أسبوع (Every week)**. للجدول الأسبوعي، اختر اليوم. ولليومي والأسبوعي، اختر الساعة وإحدى قيم الدقائق المتاحة: `:00` أو `:15` أو `:30` أو `:45`. ثم اختر **المنطقة (Zone)**. اقرأ ملخص التوقيت دائمًا قبل الحفظ، خصوصًا عندما تعمل مساحة العمل في منطقة زمنية تختلف عن منطقة المشرف. ## إعداد الاعتمادية تنطبق عناصر تحكم **الاعتمادية (Reliability)** نفسها على كل أنواع المُشغّلات: | الإعداد | ما يفعله | |---|---| | **محاولات الإعادة عند الفشل (Retry attempts if it fails)** | يحدد عدد محاولات الإعادة التلقائية المسموح بها، من `0` إلى `10`. | | **الانتظار بين المحاولات بالدقائق (Wait between retries)** | يحدد التأخير بالدقائق بين محاولات الإعادة. | | **تجاوز الملفات التي سبق معالجتها، موصى به** | يمنع معالجة محتوى الملف المطابق مرة أخرى. | أبقِ منع التكرار مفعّلًا عندما تستطيع عدة قواعد مطابقة المصدر نفسه، أو عندما يرفع المستخدمون الملف نفسه أكثر من مرة عادة. ## اختيار المُشغّل المناسب - استخدم **فورًا** للمحتوى الثابت المطلوب جعله قابلًا للبحث سريعًا. - استخدم **بعد تأخير** عندما قد يتغير الملف بعد رفعه بوقت قصير. - استخدم **وفق جدول** لمعالجة الدفعات المتوقعة أو العمل خارج أوقات الذروة. - استخدم **التشغيل الآن (Run Now)** بصورة منفصلة عندما يجب معالجة الملفات المطابقة الموجودة؛ فتغيير المُشغّل لا يعالج الملفات السابقة بحد ذاته. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | لم تبدأ مهمة مؤجلة | تحقق من قيمة التأخير ووحدته، ثم راجع **سجل المهام (Job History)**. | | تعمل مهمة مجدولة في وقت محلي خاطئ | حرر القاعدة وصحح **المنطقة** والساعة والدقيقة. | | لا تُعاد محاولة مهمة فاشلة | تأكد من أن عدد محاولات الإعادة أكبر من `0`. | | يُتجاوز المحتوى نفسه | اكتشف منع التكرار أن محتوى الملف سبق أن عولج. | | تظل الملفات القائمة بلا معالجة | انقر **التشغيل الآن** في بطاقة القاعدة. | ## أدلة ذات صلة - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [اختيار نطاق قاعدة مزامنة تلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-14-sync-rule-scopes/) - [إدارة مهام المزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-17-managing-sync-jobs/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-16-dry-run-sync-rule/ # التحقق من قاعدة مزامنة تلقائية بالتشغيل التجريبي > **الوحدة:** المزامنة التلقائية لقاعدة المعرفة ← القواعد > > **الصفحة:** `/knowledge-auto-sync` > > **الجمهور:** مشرفو قاعدة المعرفة ## ما الذي يفعله التشغيل التجريبي؟ يفحص **التشغيل التجريبي (Dry-run)** قاعدة قائمة مقابل محتوى المستندات الحالي من دون معالجة الملفات أو إنشاء مهام. وهو الطريقة الأكثر أمانًا للتأكد من النطاق وعوامل تصفية الملفات قبل تمكين الأتمتة أو استخدام **التشغيل الآن (Run Now)**. يعرض مربع الحوار: - إجمالي **المستندات المطابقة التي عُثر عليها (matching documents found)**؛ و - عينة من المستندات مع اسم الملف ونوع المحتوى والحجم عند توفرها. ## تشغيل اختبار تجريبي 1. افتح **القواعد (Rules)**. 2. اعثر على بطاقة القاعدة. 3. انقر **التشغيل التجريبي**. 4. انتظر مربع النتائج. 5. قارن عدد المطابقات والعينة بالمصدر المقصود. 6. انقر **إغلاق (Close)**. يمكن استخدام التشغيل التجريبي والقاعدة مفعّلة أو معطلة. لا يستهلك عمل معالجة مستندات لأنه يقيّم المطابقات فقط. ## تفسير النتيجة ### النتيجة صحيحة مكّن القاعدة لعمليات الرفع المطابقة مستقبلًا. وإذا كان ينبغي معالجة الملفات المطابقة الموجودة أيضًا، فانقر **التشغيل الآن** وراقب **سجل المهام**. ### عدد المستندات المطابقة كبير جدًا حرر القاعدة وضيّق واحدًا أو أكثر مما يأتي: - وضع النطاق؛ - مساحة العمل أو التطبيق أو الصفحة أو الحقل؛ - المستخدمون أو الأدوار المحددة؛ - سير عمل منشئ التدفقات أو تسمية العقدة؛ - الامتدادات المسموح بها؛ أو - حد صفحات PDF. شغّل الاختبار التجريبي مرة أخرى بعد كل تغيير جوهري. ### لا تطابق أي مستندات قد تكون النتيجة الصفرية صحيحة عندما تستهدف القاعدة عمليات رفع مستقبلية. وإلا فتحقق من: - وجود ملفات مطابقة بالفعل؛ - إشارة النطاق إلى المصدر الصحيح؛ - عدم استبعاد امتدادات الملفات النوع المتوقع؛ و - عدم استبعاد حد صفحات PDF الملف. ### فشل التشغيل التجريبي أغلق مربع الحوار، وحدّث **القواعد**، ثم أعد المحاولة. إذا استمر الفشل، فتأكد من توفر خدمة قاعدة المعرفة ومحتوى المصدر. ## مقارنة التشغيل التجريبي بالتشغيل الآن | الإجراء | يعالج الملفات | ينشئ مهامًا | يغيّر القاعدة | |---|---:|---:|---:| | **التشغيل التجريبي** | لا | لا | لا | | **التشغيل الآن** | نعم | نعم | لا | استخدم التشغيل التجريبي دائمًا قبل تنفيذ **التشغيل الآن** واسع النطاق. ## أدلة ذات صلة - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [اختيار نطاق قاعدة مزامنة تلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-14-sync-rule-scopes/) - [إدارة مهام المزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-17-managing-sync-jobs/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-17-managing-sync-jobs/ # إدارة مهام المزامنة التلقائية > **الوحدة:** المزامنة التلقائية لقاعدة المعرفة ← سجل المهام > > **الصفحة:** `/knowledge-auto-sync?tab=history` > > **الجمهور:** مشرفو قاعدة المعرفة ## ما الذي يعرضه سجل المهام؟ تظهر كل محاولة معالجة للمزامنة التلقائية كمهمة. يمكن أن يعرض الصف: - الحالة؛ - اسم الملف أو رقم المستند؛ - معرّف الإعداد المسبق؛ - عدد العناصر المفهرسة؛ - المدة؛ - وقت الإنشاء؛ و - أحدث خطأ مقروء عند وجوده. استخدم **تحديث (Refresh)** لتحميل أحدث حالة. ## فهم حالات المهمة | الحالة | المعنى | الإجراء المتاح | |---|---|---| | **نجحت (Succeeded)** | اكتملت المعالجة. | لا شيء. | | **فشلت (Failed)** | توقفت المعالجة بخطأ. | **إعادة المحاولة (Retry)**. | | **قيد التشغيل (Running)** | المعالجة جارية. | انتظر وحدّث. | | **مجدولة (Scheduled)** | تنتظر وقتها المجدول. | **إلغاء (Cancel)**. | | **معلّقة (Pending)** | في قائمة الانتظار ولم تبدأ بعد. | **إلغاء**. | | **ملغاة (Cancelled)** | أُلغيت قبل الاكتمال. | لا شيء. | | **تم تجاوزها، مكررة (Skipped — duplicate)** | سبق معالجة محتوى مطابق بينما كان منع التكرار مفعّلًا. | لا شيء. | ## إعادة محاولة مهمة فاشلة 1. اقرأ الخطأ أسفل الصف الفاشل. 2. صحح ملف المصدر أو القاعدة أو الإعداد المسبق أو توفر النموذج أو حالة الخدمة التي سببت الخطأ. 3. انقر **إعادة المحاولة**. 4. حدّث وتأكد من تقدم المهمة المعادة إلى قائمة الانتظار. تؤدي إعادة المحاولة من دون تصحيح مشكلة إعداد مستمرة عادة إلى الفشل نفسه. ## إلغاء مهمة منتظرة انقر **إلغاء** في مهمة **مجدولة** أو **معلّقة**. لا تعرض المهام قيد التشغيل هذا الإجراء في الصفحة الحالية. لا يؤدي إلغاء مهمة واحدة إلى تعطيل قاعدتها. عطّل القاعدة أو حررها أيضًا إذا كان ينبغي منع عمليات الرفع المطابقة الجديدة من إنشاء مهام. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | لا توجد مهام في القائمة | مكّن قاعدة وارفع ملفًا مطابقًا، أو استخدم **التشغيل الآن**. | | لا تظهر **إعادة المحاولة** | لا تتاح إلا للمهام **الفاشلة**. | | لا يظهر **إلغاء** | لا يتاح إلا للمهام **المجدولة** و**المعلّقة**. | | تُتجاوز مهام كثيرة باعتبارها مكررة | راجع تداخل القواعد وأبقِ التداخل المقصود فقط. | | تفشل إعادة المحاولة مجددًا | راجع الخطأ الظاهر واختبر المستند يدويًا في مستندات قاعدة المعرفة. | ## أدلة ذات صلة - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [التحقق من قاعدة بالتشغيل التجريبي](https://raptix.app/user-guide/ar/40-knowledge/40-16-dry-run-sync-rule/) - [قراءة إحصاءات المزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-18-sync-stats/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-18-sync-stats/ # قراءة إحصاءات المزامنة التلقائية > **الوحدة:** المزامنة التلقائية لقاعدة المعرفة ← الإحصاءات > > **الصفحة:** `/knowledge-auto-sync?tab=stats` > > **الجمهور:** مشرفو قاعدة المعرفة ## ما الذي تغطيه الإحصاءات؟ تلخّص علامة **الإحصاءات (Stats)** نشاط المزامنة التلقائية خلال آخر 24 ساعة. انقر **تحديث (Refresh)** لتحديث بيانات النافذة الحالية. يمكن أن تعرض الصفحة ثلاث مجموعات: | المجموعة | معناها | |---|---| | بطاقات الحالة | عدد المهام لكل حالة وقعت خلال النافذة. | | **متوسط مدة المسار للمهام الناجحة (Avg pipeline duration — succeeded)** | متوسط مدة المهام الناجحة بالثواني. | | **أكثر القواعد نشاطًا خلال آخر 24 ساعة (Top Rules — last 24h)** | القواعد ذات النشاط وعدد المهام المنسوبة إلى كل منها. | عندما لا يوجد نشاط، تعرض الصفحة **لا يوجد نشاط لمسار المعالجة خلال آخر 24 ساعة (No pipeline activity in the last 24 hours)** بدلًا من مقاييس فارغة. ## استخدام أعداد الحالات - يؤكد ارتفاع عدد **الناجحة** اكتمال المعالجة. - يعني عدد **الفاشلة** ضرورة مراجعة المهام الفردية في **سجل المهام**. - تشير أعداد **المعلّقة** أو **المجدولة** أو **قيد التشغيل** إلى عمل لم يكتمل. - تعكس **الملغاة** العمل الذي أُوقف قبل اكتماله. - تعكس **تم تجاوزها، مكررة** منع التكرار، لا فشل المعالجة. ## استخدام متوسط المدة يشمل المتوسط المهام الناجحة فقط. قارنه بخط الأساس المعتاد لمساحة العمل بدلًا من افتراض مدة واحدة جيدة للجميع؛ إذ يؤثر حجم الملف ووضع التحليل والإثراء واختيار النموذج في وقت المعالجة. إذا ارتفع المتوسط على نحو غير متوقع، فافتح **سجل المهام** وقارن مدد المهام الحديثة وأسماء ملفاتها وإعداداتها المسبقة. ## استخدام أكثر القواعد نشاطًا يساعد قسم **أكثر القواعد نشاطًا** على معرفة القواعد التي أنشأت أكبر قدر من العمل خلال نافذة الـ24 ساعة الحالية. قد يشير النشاط المرتفع بصورة غير متوقعة إلى نطاق واسع أو عمليات رفع متكررة. وقد يعني النشاط المنخفض بصورة غير متوقعة عدم مطابقة أي ملفات أو تعطيل القاعدة أو عدم حلول وقتها المجدول. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | الإحصاءات فارغة | لم تعمل أي مهام مزامنة تلقائية خلال آخر 24 ساعة. | | الإخفاقات تتزايد | افتح **سجل المهام**، واقرأ الأخطاء، وراجع الإعداد المسبق وملفات المصدر المتأثرة. | | لقاعدة نشاط مرتفع بصورة غير متوقعة | شغّل **التشغيل التجريبي**، وراجع تداخل النطاق وعوامل تصفية الملفات ومنع التكرار. | | قاعدة غائبة عن أكثر القواعد نشاطًا | ربما لم تنتج أي مهام خلال النافذة الحالية. | | متوسط المدة مفقود | ربما لا توجد مهمة ناجحة لها مدة في النافذة الحالية. | ## أدلة ذات صلة - [إدارة المزامنة التلقائية لقاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-13-setting-up-auto-sync/) - [إدارة مهام المزامنة التلقائية](https://raptix.app/user-guide/ar/40-knowledge/40-17-managing-sync-jobs/) - [التحقق من قاعدة بالتشغيل التجريبي](https://raptix.app/user-guide/ar/40-knowledge/40-16-dry-run-sync-rule/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-28-ai-authentication-current/ # إعداد مصادقة الذكاء الاصطناعي > **الوحدة:** مصادقة الذكاء الاصطناعي > > **الجمهور:** مشرفو الذكاء الاصطناعي > > **الوصول المطلوب:** صلاحية مصادقة الذكاء الاصطناعي > > **ستتعلم:** ما الذي تتحكم فيه كل علامة تبويب، وأي علامات تعتمد على مستوى المشرف، وكيف تتحقق من التغييرات بأمان. ## من يستطيع استخدام هذه الصفحة؟ المسار `/aiauthentication` مخصص للمشرفين الذين يديرون خدمات الذكاء الاصطناعي المستخدمة في وكلاء الذكاء الاصطناعي وقاعدة المعرفة. لا يحتاج المستخدمون العاديون إلى فتحه لاستخدام مساعد. ## ما الذي تتحكم فيه الصفحة؟ عنوان الصفحة هو **مصادقة الذكاء الاصطناعي وإعداد وقت التشغيل (AI Authentication & Runtime Config)**. يستطيع مشرفو الذكاء الاصطناعي في مساحة العمل رؤية **نماذج الذكاء الاصطناعي** و**الارتباطات الافتراضية**. ويستطيع مشرفو المنصة أيضًا رؤية **اتصالات المزوّدين** و**إعدادات وقت التشغيل**. | علامة التبويب | ما يمكنك فعله | |---|---| | **اتصالات المزوّدين (Provider Connections)** | إضافة اتصالات المزوّدين أو تحريرها أو تمكينها أو تعطيلها أو التحقق منها أو حذفها. تعرض البطاقات نوع المزوّد وعنوان URL الأساسي ووجود مفتاح وعدد النماذج. | | **نماذج الذكاء الاصطناعي (AI Models)** | البحث في شجرة النماذج المعدّة، وإضافة النماذج أو تحريرها بحسب دور الاستخدام، والتحقق منها، وإزالة الإدخالات المتقادمة. | | **الارتباطات الافتراضية (Default Bindings)** | اختيار النموذج الافتراضي النشط لكل دور متاح، واختيار أبعاد التضمين. | | **إعدادات وقت التشغيل (Runtime Settings)** | إضافة إعدادات وقت التشغيل على مستوى المنصة أو تحريرها أو حذفها أو تحديثها. | قد تشمل أنواع المزوّدين التي تعرضها الصفحة: **OpenAI Compatible** و**Anthropic** و**Cohere** و**DeepSeek** و**OpenRouter** و**Google Gemini** و**LlamaCloud** و**Custom**. يتيح بعض المزوّدين دليل نماذج للمساعدة على اختيار نموذج مدعوم. تغطي أدوار النماذج الوظائف الظاهرة في الصفحة، بما فيها التوليد والتضمين وتلخيص الجداول والإثراء. لا يؤدي ظهور نموذج في الدليل إلى تنشيطه حتى يُعدّ ويُختار في الارتباط المناسب. ## عملية تغيير آمنة 1. أكد المزوّد أو النموذج أو الدور أو إعداد وقت التشغيل المطلوب تغييره. 2. أضف أصغر عنصر مطلوب أو حرره، ثم استخدم **التحقق (Validate)** حيث يتوفر. 3. احفظ النموذج واختره تحت **الارتباطات الافتراضية** فقط عندما ينبغي أن يصبح افتراضي مساحة العمل. 4. إذا أدى تغيير نموذج التضمين أو أبعاده إلى إظهار **إعادة الفهرسة مطلوبة (Reindex Required)**، فاقرأ التحذير ولا تؤكد إلا عندما تكون مستعدًا لإعادة تضمين المستندات المتأثرة. 5. اختبر بمستند غير حساس أو محادثة مساعد. 6. راقب قاعدة المعرفة والاستخدام قبل إجراء تغيير واسع آخر. تُخفى أسرار المزوّدين بعد الحفظ. لا تلصق سر مزوّد أبدًا في طلب دعم أو مستند أو لقطة شاشة أو محادثة وكيل ذكاء اصطناعي. ## أدلة ذات صلة - [إدارة مساعدي الذكاء الاصطناعي](https://raptix.app/user-guide/ar/30-ai-agents/30-29-managing-ai-assistants-current/) - [مراجعة تحليلات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-29-knowledge-analytics-current/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-19-ai-authentication/ # ربط مزود ذكاء اصطناعي > **الصفحة:** `/aiauthentication` > > **الجمهور:** مشرفو المنصة تقتصر **اتصالات المزوّدين (Provider Connections)** على مشرف المنصة. يرى مشرفو الذكاء الاصطناعي في مساحة العمل **نماذج الذكاء الاصطناعي (AI Models)** و**الارتباطات الافتراضية (Default Bindings)**، لكنهم لا يستطيعون إدارة بيانات اعتماد المزوّدين. 1. افتح **اتصالات المزوّدين** وأضف مزوّدًا. 2. أدخل اسمًا واضحًا للاتصال، واختر نوع المزوّد، وقدّم عنوان URL الأساسي والسر المطلوب. 3. احفظ، ثم استخدم **التحقق من الاتصال (Validate connection)**. 4. أضف النماذج المدعومة تحت **نماذج الذكاء الاصطناعي** وتحقق من كل نموذج. 5. اختر القيم الافتراضية المطلوبة تحت **الارتباطات الافتراضية**. قد تشمل الخيارات التي يعرضها النموذج: مزوّدًا متوافقًا مع OpenAI، وAnthropic، وCohere، وDeepSeek، وOpenRouter، وGoogle Gemini، وLlamaCloud، واتصالات مخصصة. تدعم بعض الاتصالات **تصفح النماذج (Browse Models)**. تُخفى الأسرار بعد الحفظ. لا تضعها أبدًا في الوثائق أو لقطات الشاشة أو رسائل الدعم أو محادثات وكيل الذكاء الاصطناعي. عطّل الاتصال أو صححه قبل حذف اتصال لا تزال لديه نماذج مسجلة. ## دليل ذو صلة - [إعداد مصادقة الذكاء الاصطناعي](https://raptix.app/user-guide/ar/40-knowledge/40-28-ai-authentication-current/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-20-ai-models-catalog/ # إدارة دليل نماذج الذكاء الاصطناعي تجمع علامة **نماذج الذكاء الاصطناعي (AI Models)** النماذج المعدّة بحسب الدور الأساسي والمزوّد. ابحث باسم النموذج أو معرّفه أو المزوّد، ثم وسّع دورًا ومزوّدًا لفحص نماذجه. الأدوار الحالية هي: | الدور | الغرض | |---|---| | **المولّد (Generator)** | يكتب الإجابات وإكمالات المحادثة. | | **التضمين (Embedding)** | يرمّز النص إلى متجهات للاسترجاع. | | **إعادة الترتيب (Reranker)** | يعيد تقييم مقاطع المحتوى المستردة. | | **إعادة الصياغة (Rewriter)** | يعيد صياغة الاستعلام قبل الاسترجاع. | | **ملخص الجدول (Table Summary)** | يلخّص المحتوى الجدولي. | | **الإثراء (Enrichment)** | يضيف البيانات الوصفية والسياق. | | **التحليل (Parsing)** | يستخرج النص من المستندات والصور. | استخدم **إضافة نموذج (Add Model)** لاختيار المزوّد ومعرّف النموذج واسم العرض والدور الأساسي وحد الرموز وحالة التمكين. وقد يساعدك دليل المزوّد على اختيار نموذج مدعوم عندما يكون متاحًا. استخدم إجراءات صف النموذج للتحقق منه أو تحريره أو حذفه. لا تجعل إضافة النموذج إياه افتراضيًا؛ اختره في **الارتباطات الافتراضية**. ولا يظهر النموذج المعطل للارتباطات الجديدة. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-21-default-model-bindings/ # إعداد ارتباطات النماذج الافتراضية تحدد علامة **الارتباطات الافتراضية (Default Bindings)** النموذج الافتراضي النشط لكل من المولّد والتضمين وإعادة الترتيب وإعادة الصياغة وملخص الجدول والإثراء والتحليل. يعرض كل محدد النماذج الممكّنة والمسجلة لذلك الدور فقط. اختر النموذج الذي سيتولى العمل اللاحق في هذا الدور. ## تغيير التضمين بأمان يتضمن التضمين أيضًا محددًا للأبعاد. يؤدي تغيير نموذج تضمين قائم أو أبعاده إلى إظهار تحذير **إعادة الفهرسة مطلوبة (Reindex Required)**، لأن المتجهات الناتجة بإعدادات غير متوافقة لا يمكنها مشاركة الفهرس النشط نفسه. قبل التأكيد: 1. حدّد مستندات قاعدة المعرفة المتأثرة؛ 2. اختر نافذة صيانة إذا كان نطاق تغطية الاسترجاع قد يتغير؛ 3. تأكد من التحقق من المزوّد والنموذج؛ و 4. راقب إعادة الفهرسة واختبر الاسترجاع بعدها. تؤثر تغييرات الارتباط الأخرى في العمليات اللاحقة، لكنها لا تصلح تلقائيًا المحتوى الذي أُنتج سابقًا. أعد تشغيل مرحلة المستند المناسبة عندما يجب أن تستخدم المخرجات السابقة النموذج الجديد. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-22-runtime-settings/ # إدارة إعدادات وقت التشغيل > **الصفحة:** `/aiauthentication` ← **إعدادات وقت التشغيل (Runtime Settings)** > > **الجمهور:** مشرفو المنصة لا تظهر إعدادات وقت التشغيل لمشرفي مساحة العمل العاديين. فهي تدير بدائل المفتاح والقيمة على مستوى المنصة التي تستخدمها خدمات الذكاء الاصطناعي وقاعدة المعرفة. يعرض الجدول مفتاح كل إعداد وقيمته ووصفه وإجراءاته. استخدمه من أجل: - تحديث الإعدادات الحالية؛ - إضافة إعداد يتضمن **مفتاح الإعداد (Setting Key)** و**قيمة الإعداد (Setting Value)** ووصفًا اختياريًا؛ - تحرير إعداد قائم؛ أو - حذف قيمة بديلة حتى تُطبّق القيمة الافتراضية الأساسية. استخدم المفاتيح الموثقة وتنسيقات القيم الصالحة فقط. سجّل سبب التغيير وأثره المتوقع قبل تعديل عمق الاسترجاع أو الحدود أو المهل الزمنية أو أي سلوك تشغيلي آخر. اختبر تغييرًا واحدًا في كل مرة، ثم استعد القيمة أو احذفها إذا فشل التحقق. لا تخزن أسرار المزوّدين في إعدادات وقت التشغيل؛ استخدم **اتصالات المزوّدين**. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-29-knowledge-analytics-current/ # مراجعة تحليلات قاعدة المعرفة > **الوحدة:** قاعدة المعرفة ← التحليلات > > **الجمهور:** مشرفو قاعدة المعرفة > > **الوصول المطلوب:** صلاحية تحليلات قاعدة المعرفة > > **ستتعلم:** كيف تستخدم صفحات التحليلات الحالية لمراقبة استخدام قاعدة المعرفة من دون كشف محتوى المستخدم. ## فتح التحليلات افتح `/knowledge-analytics`. يستخدم التنقل الحالي **نظرة عامة (Overview)** و**الأسئلة (Questions)** و**قاعدة المعرفة (Knowledge Base)** و**الأمان (Security)**. تعتمد علامات تبويب البيانات والأمان الدقيقة على صلاحيتك. توفر كل العروض نطاق تاريخ **من/إلى** و**تحديث (Refresh)** ووقت آخر تحديث. ## استخدام العرض المناسب | العرض | استخدامه | |---|---| | **نظرة عامة** | قراءة ملخص النشاط والصحة العام لقاعدة المعرفة. | | **الأسئلة** | مراجعة وقت الاستجابة وتوقيت المسار واستخدام نماذج الذكاء الاصطناعي ولغة الاستعلام ومسار الاسترجاع واتجاهات معدل عدم الإجابة وبيانات الأسئلة التفصيلية. | | **قاعدة المعرفة** | مراجعة إجمالي المستندات والمقاطع والصور المستخرجة وأنواع الملفات والمقاطع وحالة المعالجة وأحجام المستندات والأكثر استخدامًا كمراجع وغير المستخدمة. | | **الأمان** | مراجعة قرارات الوصول وتصنيف السياسات وتغطيتها وأسباب الرفض والمستندات الممنوعة وسجلات التدقيق وبيانات السياسات. | استخدم عناصر البحث والتاريخ والجدول الظاهرة في العرض المحدد لتقييد النتائج. التحليلات مخصصة للتحقق؛ وهي لا تغيّر مساعدًا أو مستندًا أو وصول مستخدم بحد ذاتها. ## قراءة النظرة العامة ابدأ ببطاقات مؤشرات الأداء والاتجاهات لفهم الحجم والتغير خلال الفترة المحددة. تشمل النظرة العامة الأسئلة المجابة عبر الزمن ومعلومات النشاط المرتفع، مثل المستخدمين النشطين. يمكن لمؤشرات الأداء القابلة للنقر فتح درج تفاصيل يتضمن البحث والترتيب وترقيم الصفحات. ## مراجعة الأمان والتدقيق يحتوي الأمان على علامات التبويب الفرعية الآتية: - **لوحة المعلومات (Dashboard)** لمؤشرات الأداء وقرارات الوصول عبر الزمن وتصنيفات السياسات وأسباب الرفض والمستندات الأكثر منعًا وتغطية السياسات للمستندات والصفحات والعُقد؛ - **سجل التدقيق (Audit Log)** لسجلات الوصول القابلة للبحث والترتيب؛ - **الرفض (Rejections)** لقرارات الاسترجاع المرفوضة أو الفاشلة؛ و - **السياسات (Policies)**، وتظهر للمشرفين، لسجلات السياسات. استخدم بحث الجدول وترتيبه قبل تصدير نتيجة أو تصعيدها. قد يكون المنع قرار سياسة متوقعًا، لذلك تحقق من المستخدم والمورد والوقت والسياسة المنطبقة قبل معاملته كعيب. ## ممارسة جيدة ابدأ بالأنماط المجمعة. وعند التحقق من عنصر فردي، اتبع سياسة الخصوصية في مؤسستك واستخدم أقل قدر من الوصول تحتاج إليه. ## أدلة ذات صلة - [إدارة مستندات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) - [إعداد مصادقة الذكاء الاصطناعي](https://raptix.app/user-guide/ar/40-knowledge/40-28-ai-authentication-current/) --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-23-analytics-overview/ # قراءة نظرة عامة على تحليلات قاعدة المعرفة افتح `/knowledge-analytics`. اضبط تاريخي **من (From)** و**إلى (To)**، ثم اختر **تحديث (Refresh)**. تعرض الصفحة وقت آخر تحديث. ابدأ بمؤشرات الأداء الرئيسية ومؤشرات التغير لمراجعة حجم الأسئلة والملاحظات وسرعة الاستجابة وإشارات المخاطر. تشمل النظرة العامة أيضًا: - ملخصًا تنفيذيًا وقائمة مراقبة؛ - **الأسئلة المجابة عبر الزمن (Questions answered over time)**؛ - **اتجاه الملاحظات (Feedback trend)**؛ - **سرعة الاستجابة (Response speed)**؛ و - **المستخدمين الأكثر نشاطًا (Most active users)**. تظل المقاييس الداعمة مطوية إلى أن تحتاج إليها. اختر مؤشر أداء قابلًا للنقر لفتح درج التفاصيل، ثم استخدم البحث والترتيب وترقيم الصفحات لفحص السجلات الأساسية. تعكس التحليلات النطاق الزمني المحدد. تحقق من النطاق ووقت التحديث قبل مقارنة النتائج أو تصعيد أي تغير. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-24-document-analytics/ # مراجعة تحليلات قاعدة المعرفة افتح `/knowledge-analytics-docs` أو اختر **قاعدة المعرفة (Knowledge Base)** في التحليلات. يقدم هذا العرض تقارير عن: - إجمالي المستندات والمقاطع والصور المستخرجة؛ - **المستندات حسب نوع الملف (Documents by File Type)**؛ - **حالة المعالجة (Processing Status)**؛ - **أنواع مقاطع المحتوى (Content Chunk Types)**؛ - **توزيع أحجام المستندات (Document Size Distribution)**؛ - **المستندات الأكثر استخدامًا كمراجع (Most Referenced Documents)**؛ و - **المستندات غير المستخدمة (Unused Documents)**. استخدم المستندات غير المستخدمة للعثور على محتوى لم يُستشهد به خلال الفترة المحددة، لا لإثبات عدم قيمة المستند. تحقق من النطاق الزمني والجمهور المقصود ونطاق المساعد قبل إزالته. ينبغي التحقق من مشكلات حالة المعالجة في `/knowledge-documents` أو سجل مهام المزامنة التلقائية. لا تعيد التحليلات نفسها معالجة المحتوى أو حذفه. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-25-query-analytics/ # مراجعة تحليلات الأسئلة افتح `/knowledge-analytics-query` أو اختر **الأسئلة (Questions)** في التحليلات. استخدم هذا العرض للتحقق من: - **توقيت مراحل المسار، المتوسط اليومي (Pipeline Stage Timing — daily avg)**؛ - **النسب المئوية لوقت الاستجابة (Response Time Percentiles)**؛ - **استخدام نماذج الذكاء الاصطناعي (AI Model Usage)**؛ - **لغة الاستعلام (Query Language)**؛ - **مسار الاسترجاع، المتوسط (Retrieval Funnel — avg)**؛ و - **اتجاه معدل الأسئلة بلا إجابة (Unanswered Rate Trend)**. ابدأ بالنطاق الزمني والنسب المئوية. قد يوجد زمن استجابة مرتفع في الطرف الأعلى حتى عندما يبدو المتوسط اليومي مقبولًا. استخدم توقيت المسار لمعرفة ما إذا كان الاسترجاع أو الترتيب أو التوليد أو مرحلة مسجلة أخرى هي الأكثر إسهامًا. قد يشير انخفاض مسار الاسترجاع أو ارتفاع معدل عدم الإجابة إلى محتوى مفقود أو وصول مقيّد أو نطاق المساعد أو إعداد الاسترجاع. أكد السبب باستخدام عرضي قاعدة المعرفة والأمان قبل تغيير النماذج أو المحتوى. --- URL: https://raptix.app/user-guide/ar/40-knowledge/40-26-security-audit-analytics/ # مراجعة تحليلات الأمان والتدقيق افتح `/knowledge-analytics-security` أو اختر **الأمان (Security)** في التحليلات. توفّر الصفحة: - **لوحة المعلومات (Dashboard):** مؤشرات قرارات الوصول والاتجاهات والتصنيفات وأسباب الرفض والمستندات الممنوعة وتغطية السياسات؛ - **سجل التدقيق (Audit Log):** سجلات وصول قابلة للبحث؛ - **الرفض (Rejections):** قرارات الوصول المرفوضة أو الفاشلة؛ و - **السياسات (Policies):** سجلات السياسات، وتظهر للمشرفين فقط. استخدم النطاق الزمني المشترك و**تحديث**، ثم اختر علامة تبويب فرعية. ابحث في الجدول ورتبه قبل فتح التفاصيل أو تصديرها. قد يكون المنع سلوكًا متوقعًا للسياسة. تحقق من المستخدم والمورد والوقت والتصنيف والأدوار المسموح بها وإجراء المنع قبل التعامل معه كخطأ. وإذا أُتيح محتوى محمي بطريقة غير صحيحة، فقيّد أو عطّل المساعد أو وصول المستند المتأثر، وابدأ التحقق فورًا. ## أدلة ذات صلة - [إدارة سياسات الوصول إلى قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-10-access-policies/) - [مراجعة تحليلات قاعدة المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-29-knowledge-analytics-current/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/ # البدء باستخدام التطبيقات > **الوحدة:** التطبيقات > > **الجمهور:** الأعضاء والمنشئون والمسؤولون > > **الوصول المطلوب:** صلاحية الوصول إلى التطبيقات؛ وتحدد منح الموارد مساحات العمل والتطبيقات والصفحات التي يمكنك رؤيتها > > **ستتعلم:** كيفية تصفح التسلسل الهرمي للتطبيقات، والبحث في القائمة الحالية، وفهم جميع إجراءات الرأس، والتنقل بين الصفحات والمستندات وعمليات سير العمل وأدوات الإنشاء. تنظم «التطبيقات» الأدوات الداخلية التي توفرها مؤسستك في RAPTIX. يتبع التسلسل الأساسي **مساحات العمل ← التطبيقات ← الصفحات**. يمكن أن تكون الصفحة صفحة حية من منشئ التطبيقات أو نموذج سير عمل قابلًا للتشغيل، كما يمكن أن يحتوي التطبيق على مستندات وعمليات سير عمل مرتبطة به. ## قبل أن تبدأ - سجّل الدخول عبر `https://.raptix.app`. - افتح **التطبيقات** من شريط التنقل الرئيسي، أو انتقل إلى `/applications` على نطاق مساحة عملك. - تحتاج إلى صلاحية التطبيقات لتصفح مساحات العمل. وقد تحد منح منفصلة مساحات العمل والتطبيقات والصفحات التي تظهر لك. - يُعد إنشاء المحتوى وإدارته عبر منشئ التطبيقات من إمكانات Enterprise. يظل محتوى التطبيقات الآخر متاحًا وفق باقتك وصلاحياتك. ## تصفح مساحات العمل والتطبيقات والصفحات 1. افتح **التطبيقات**. يبدأ مسار التنقل الافتراضي عند **مساحات العمل**. 2. اختر بطاقة مساحة عمل لعرض تطبيقاتها. 3. اختر بطاقة تطبيق لفتح طريقة عرض **الصفحات**. 4. اختر **فتح** في الصفحة أو النموذج الذي تريد استخدامه. 5. استخدم مسار التنقل للعودة إلى التطبيق أو مساحة العمل أو جذر مساحات العمل. يتحدث شريط العنوان أثناء انتقالك في التسلسل، ولذلك يمكنك حفظ موقع مساحة عمل أو تطبيق كإشارة مرجعية على نطاق مساحة عمل RAPTIX. ## فهم رأس التطبيقات يعرّف الرأس المنطقة دائمًا باسم **التطبيقات**، ويعرض أعداد مساحات العمل والتطبيقات والصفحات المتاحة في التسلسل المحمّل. ووفق باقتك والصلاحيات المسندة إليك، قد يعرض أيضًا: | الإجراء | الغرض | |---|---| | **سير العمل** | يفتح مساحة سير العمل داخل التطبيقات. استخدم **كل المثيلات** لمراقبة عمليات التشغيل و**مهامي** لتنفيذ العمل المسند إليك. | | **المستندات** | يفتح مستكشف المستندات عبر مساحات العمل المتاحة لك. يمكنك منه تصفح الملفات والبحث فيها ومعاينتها ورفعها وتنظيمها وتنزيلها أو حذفها عندما تسمح صلاحياتك. | | **البريد الإلكتروني** | يفتح سجل الرسائل القابل للبحث التي استلمتها عمليات سير العمل أو أرسلتها. يؤدي اختيار رسالة إلى فتح مسارها المركز في علامة تبويب جديدة، حيث يمكنك قراءة البريد المتحقق منه والنص المقتبس وتنزيل الملفات المحتفظ بها بعد اجتياز فحص أمني سليم. | | **المزيد** | يفتح روابط الإدارة العامة للتطبيقات. وفق الصلاحيات، قد تشمل **الأذونات** و**السجلات** و**معالجة المستندات**. تختلف هذه القائمة عن قائمة **المزيد** داخل المستندات، التي قد تتضمن أيضًا **سلة المهملات**. | | **منشئ التطبيقات** | يفتح بيئة إنشاء الصفحات في Enterprise مع تسليم موثّق. استخدمه لإنشاء صفحات التطبيقات أو تحريرها عندما تشملها باقتك ودورك. | | **منشئ التدفق** | يفتح مصمم سير العمل المرئي. استخدمه لإنشاء خطوات سير العمل وربطها وضبطها واختبارها ونشرها عندما تملك صلاحية المنشئ. | | **جديد** | ينشئ مساحة عمل عند الجذر، أو تطبيقًا داخل مساحة عمل تدعم الإنشاء. | لا تظهر الإجراءات التي لا يمكنك استخدامها. وقد تعرض مساحات Enterprise شارة صغيرة لحالة خدمة البيانات عندما تتوفر المعلومة؛ لا تعتمد على غياب هذه الشارة وحده لتشخيص مشكلة اتصال. ## قراءة البطاقات ### بطاقات مساحات العمل قد تعرض بطاقة مساحة العمل اسمها وعدد التطبيقات وإجمالي عدد الصفحات وتاريخ آخر تعديل وعدد المهام المعلقة. اختر **عرض التطبيقات** أو البطاقة نفسها للمتابعة. لا تظهر عناصر إعادة التسمية والحذف إلا لمساحات العمل التي يُسمح لحسابك بإدارتها. ### بطاقات التطبيقات تعرض بطاقة التطبيق اسمه وعدد الصفحات وتاريخ آخر تعديل وأي عدد للمهام المعلقة. وقد تعرض تطبيقات منشئ التطبيقات أيضًا بيانات **مشترك** أو **خاص**. لا تحل هذه التسمية محل وصول موارد RAPTIX؛ إذ تظل القائمة مصفاة وفق المحتوى المتاح لك. اختر **عرض الصفحات** أو البطاقة نفسها لتصفح التطبيق. إذا احتوت البطاقة على زر فتح خارجي منفصل، فإنه يفتح طريقة العرض الحية للتطبيق. ### بطاقات الصفحات والنماذج قد تحتوي طريقة عرض **الصفحات** على مجموعتين: - **عمليات سير العمل القابلة للتشغيل** هي نماذج سير عمل منشورة. تعرض بطاقاتها اسم النموذج وبيانات التوفر وإجراء **فتح**. ولا يظهر **تحرير** إلا إذا كان بإمكانك تحرير سير العمل. - تعرض بطاقات صفحات منشئ التطبيقات اسم الصفحة وعلامة **الصفحة الافتراضية** عند انطباقها، وإجراء **فتح** عند توفر عنوان حي. ووفق الصلاحيات، قد تعرض أيضًا **المستندات** أو **عمليات سير العمل** أو **تحرير**. تظهر صفحات منشئ التطبيقات الافتراضية قبل الصفحات الأخرى. يؤدي اختيار **المستندات** أو **عمليات سير العمل** إلى البقاء داخل RAPTIX وفتح العرض المقيد بالمورد، بينما يفتح **فتح** النموذج القابل للتشغيل أو صفحة التطبيق الحية. ## إنشاء مساحة عمل أو تطبيق وإدارتهما لا يتوفر إجراء **جديد** إلا في المواقع التي يستطيع فيها حسابك إنشاء محتوى تديره RAPTIX. 1. عند **مساحات العمل**، اختر **جديد** لفتح **مساحة عمل جديدة**. 2. أدخل **اسم مساحة عمل** فريدًا، ثم اختر **إنشاء**. 3. افتح مساحة العمل واختر **جديد** لفتح **تطبيق جديد في اسم مساحة العمل**. 4. أدخل **اسم تطبيق** فريدًا، ثم اختر **إنشاء**. تحتوي مساحة العمل على تطبيقاتها ومستنداتها وعمليات سير العمل الخاصة بها. ويجمع التطبيق الصفحات والمستندات وعمليات سير العمل التي تنتمي معًا. يؤدي ضغط Enter أيضًا إلى إرسال أي من مربعي الإنشاء عندما يكون الاسم صالحًا. لا تظهر عناصر إعادة التسمية والحذف إلا لمساحات العمل والتطبيقات التي تديرها RAPTIX ويستطيع حسابك إدارتها. لا يمكنك حذف مساحة العمل الوحيدة، أو التطبيق الوحيد في مساحة عمل؛ أنشئ بديلًا أولًا. اقرأ التأكيد بعناية لأن حذف حاوية قد يؤثر في المحتوى المنظم تحتها. ## البحث في القائمة الحالية يظهر حقل البحث أثناء تصفح مساحات العمل أو التطبيقات أو علامة الصفحات. 1. أدخل جزءًا من الاسم في **البحث في مساحات العمل** أو **البحث في التطبيقات** أو **البحث في الصفحات**. 2. راجع العناصر المطابقة في طريقة العرض الحالية. 3. امسح الحقل لاستعادة القائمة الكاملة. يُطبق البحث على المستوى الظاهر فقط؛ ولا يبحث في جميع مساحات العمل والتطبيقات والصفحات المتداخلة دفعة واحدة. قد يبقى النص في الحقل عند انتقالك إلى المستوى التالي. إذا بدت مساحة عمل أو تطبيق محدد فارغًا على نحو غير متوقع، فامسح البحث قبل اعتبار النتيجة مشكلة وصول. للحصول على شرح مركز، راجع [البحث في طريقة عرض التطبيقات الحالية](https://raptix.app/user-guide/ar/50-applications/50-3-search-current-applications-view/). ## استخدام التطبيقات على الشاشات الصغيرة وفي الوضع الداكن على الشاشة الضيقة، تنتقل إجراءات الرأس إلى عدة صفوف، وتستخدم الأعداد تسميات أقصر، وتملأ البطاقات العرض المتاح. يحافظ الوضع الداكن وتخطيط الهاتف على تنقل مساحة العمل والتطبيق والصفحة والمستند وسير العمل نفسه. ## استخدام طرق العرض المقيدة بالتطبيق بعد فتح تطبيق، قد تشمل علامات التبويب المتاحة: - **الصفحات** لصفحات منشئ التطبيقات ونماذج سير العمل القابلة للتشغيل. - **المستندات** للملفات المقيدة بذلك التطبيق. - **عمليات سير العمل** للمثيلات والمهام المقيدة بذلك التطبيق. يمكن لإجرائي **المستندات** و**عمليات سير العمل** في بطاقة صفحة منشئ التطبيقات تضييق طريقتي العرض إلى الصفحة نفسها. لا تظهر علامات التبويب وإجراءات البطاقات إلا عندما يشمل دورك صلاحية المنتج ذات الصلة. ## الوجهات الحالية | الوجهة | المسار الحالي | |---|---| | التسلسل الهرمي للتطبيقات | `/applications` | | مستكشف المستندات العام | `/applications?view=documents` | | لوحة سير العمل العامة | `/applications?view=workflows` | | أرشيف البريد الإلكتروني | `/applications?view=email` | | رسالة بريد مركزة | `/applications?view=email&message_id=` | | أذونات التطبيقات | `/applications/permission` | | سجلات نشاط التطبيقات | `/applications/logs` | | مساحة معالجة المستندات | `/process-documents` | استخدم الأزرار وعلامات التبويب داخل التطبيقات للحفاظ على نطاق مساحة العمل أو التطبيق أو الصفحة أو المستند أو سير العمل الصحيح. تجنب الإشارات المرجعية القديمة عندما توفر الواجهة الحالية وجهة مناسبة. ## فهم حالات الفراغ والتحميل والوصول | الحالة | المعنى | الخطوة التالية | |---|---|---| | **جارٍ تحميل التطبيقات…** | تحمّل RAPTIX التسلسل وبيانات الوصول المرتبطة. | انتظر اكتمال التحميل. | | **لم يُعثر على مساحات عمل** | لا تطابق أي مساحة متاحة البحث الحالي أو الوصول. | امسح البحث؛ وإذا ظلت فارغة فاطلب من المسؤول مراجعة منحك. | | **لم يُعثر على تطبيقات** | لا يطابق أي تطبيق متاح في مساحة العمل المحددة. | امسح البحث أو عُد إلى مساحات العمل. | | **لم يُعثر على صفحات** | لا توجد صفحة مطابقة، أو لا يحتوي التطبيق على صفحات أو نماذج متاحة. | امسح البحث؛ وقد يظهر لمن يملك منشئ التدفق إجراء إنشاء أول سير عمل. | | **الوصول مقيّد** | لا يمكنك تصفح تسلسل مساحات العمل. | اطلب صلاحية التطبيقات وراجع دليل الاستكشاف أدناه. | | **تعذر تحميل التطبيقات** | لم تستطع RAPTIX إكمال تحميل بيانات التطبيقات. | اختر **إعادة المحاولة** واتبع دليل الاتصال إذا تكرر الأمر. | ## استكشاف الأخطاء وإصلاحها **أرى مساحة عمل لكن لا أرى تطبيقًا أو صفحة داخلها.** تستطيع RAPTIX منح الوصول على مستوى مساحة العمل أو التطبيق أو الصفحة. لا تظهر الموارد المخفية كبطاقات مقفلة. اطلب من المسؤول التحقق من العنصر الدقيق الذي تحتاج إليه. **يرى زميل زرًا في الرأس لا أراه.** تراعي إجراءات الرأس الأذونات والباقات. اطلب الإمكانية المحددة التي تحتاج إليها بدلًا من طلب وصول غير مقيد إلى التطبيقات. **يؤدي فتح صفحة إلى شاشة تسجيل دخول أو صفحة فارغة.** عُد إلى التطبيقات واختر **فتح** مجددًا. إذا استمرت المشكلة، فاتبع [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/). **تفشل المنطقة كلها في التحميل.** اختر **إعادة المحاولة** مرة واحدة. إذا عاد خطأ ملء الشاشة، فراجع [استكشاف أخطاء اتصال التطبيقات وإصلاحها](https://raptix.app/user-guide/ar/50-applications/50-24-troubleshooting-connection-errors/). ## أدلة ذات صلة - [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/) - [تحرير صفحة تطبيق في منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-4-editing-app-page/) - [التحكم في الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [سجلات نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [إنشاء سير عمل من تطبيق](https://raptix.app/user-guide/ar/50-applications/50-33-create-workflow-from-application/) - [استخدام سير العمل: كل المثيلات ومهامي](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) - [الاحتفاظ ببريد سير العمل والعثور عليه وقراءته](https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/) - [استكشاف أخطاء الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) - [مسرد RAPTIX](https://raptix.app/user-guide/ar/glossary/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/ # فتح صفحة تطبيق واستخدامها > **الوحدة:** التطبيقات > > **الجمهور:** الأعضاء والمنشئون والمسؤولون > > **الوصول المطلوب:** صلاحية التطبيقات وإذن عرض الصفحة أو النموذج المحدد > > **ستتعلم:** كيفية فتح صفحات منشئ التطبيقات الحية ونماذج سير العمل القابلة للتشغيل، وما المتوقع من تسليم تسجيل الدخول، وكيفية التعافي عندما لا يفتح عنصر بصورة صحيحة. قد تحتوي طريقة عرض **الصفحات** في التطبيقات على صفحات حية من منشئ التطبيقات ونماذج سير عمل قابلة للتشغيل. يستخدم كلاهما **فتح**، لكن سلوك الوصول يختلف: تسجّلك RAPTIX تلقائيًا في صفحة منشئ التطبيقات، بينما يتبع نموذج سير العمل إعداد الوصول العام أو الخاص به. ## قبل أن تبدأ - سجّل الدخول عبر `https://.raptix.app`. - افتح `/applications`، ثم اختر مساحة العمل والتطبيق اللذين يحتويان على العنصر. - تأكد من أن العنصر نشط ومن توفر إجراء **فتح**. - إذا عرضت منطقة التطبيقات كاملة خطأ أو قيدًا، فعالج تلك الحالة قبل استكشاف مشكلة صفحة منفردة. ## فتح صفحة من منشئ التطبيقات 1. ابحث عن بطاقة الصفحة في علامة **الصفحات** للتطبيق المحدد. 2. اختر **فتح**. 3. انتظر بينما تطلب RAPTIX تسليمًا موثّقًا لحسابك الحالي. 4. في المتصفح العادي، تفتح الصفحة الحية في علامة تبويب جديدة. وفي تطبيق RAPTIX المثبت، قد تفتح في النافذة نفسها. 5. استخدم الصفحة وفق التصميم الذي أعدته مؤسستك. قد تتضمن بطاقة الصفحة أيضًا هذه الإجراءات المنفصلة: - يفتح **المستندات** المستندات المقيدة بالصفحة داخل RAPTIX. - يفتح **عمليات سير العمل** العمليات المقيدة بالصفحة داخل RAPTIX. - يفتح **تحرير** منشئ التطبيقات في Enterprise بعد تأكيد التحرير الحي. لا تفتح هذه الإجراءات طريقة العرض الحية للمستخدم. استخدم **فتح** عندما تريد تشغيل صفحة التطبيق أو استخدامها. ## فتح نموذج سير عمل قابل للتشغيل تظهر النماذج القابلة للتشغيل ضمن مجموعة **عمليات سير العمل القابلة للتشغيل** في طريقة عرض الصفحات. 1. ابحث عن النموذج باسمه ووصفه. 2. تحقق من تسمية الوصول. تصف **عام** و**خاص** كيفية مشاركة النموذج نفسه. 3. اختر **فتح**. يفتح النموذج في علامة تبويب جديدة. 4. أكمل النموذج وأرسله وفق الحقول والتعليمات الظاهرة. لا تظهر كنماذج قابلة للتشغيل إلا عمليات سير العمل المُمكّنة والنشطة ذات رابط نموذج منشور. ولا يتوفر نموذج متوقف مؤقتًا أو معطل أو غير منشور في هذه المجموعة. ## ما الذي تفعله RAPTIX عند فتح عنصر؟ تطلب RAPTIX لصفحة منشئ التطبيقات بيانات اعتماد قصيرة الأجل للحساب المسجل، وتربطها بعنوان الصفحة المعتمد لإتمام التسليم. إذا فشل إنشاء بيانات الاعتماد، فقد تستمر RAPTIX في فتح العنوان الهدف، لكن الصفحة قد تطلب تسجيل الدخول. أما نموذج سير العمل القابل للتشغيل، فتفتح RAPTIX مسار النموذج المنشور. ثم يطبق النموذج قواعده العامة أو الخاصة. يُسجل فتح أي من النوعين كعنصر تطبيقات حديث. ما دام العنصر متاحًا، فقد يظهر ضمن **المستخدمة حديثًا في التطبيقات** على الصفحة الرئيسية. ## العودة إلى التطبيقات - في المتصفح العادي، أغلق علامة تبويب الصفحة أو النموذج للعودة إلى علامة التطبيقات. - في تطبيق RAPTIX المثبت، استخدم تنقل المتصفح أو النظام للعودة إذا استبدل العنصر النافذة الحالية. - يظل مسار تنقل التطبيقات وحالة البحث في علامة المتصفح الأصلية. ## ممارسات آمنة للروابط والإشارات المرجعية - احفظ موقع التطبيقات في RAPTIX عندما تريد العودة إلى كتالوج التطبيق. - يمكن مشاركة عنوان نموذج عام أو حفظه كإشارة وفق سياسة مؤسستك. - لا تنسخ أو تشارك عنوانًا مؤقتًا يحتوي على معامل مصادقة. - يجب على الزميل الذي يفتح عنصرًا خاصًا استخدام حساب RAPTIX الخاص به وامتلاك وصوله الخاص. ## استكشاف الأخطاء وإصلاحها **اختيار «فتح» لا يفعل شيئًا.** ربما حظر المتصفح علامة التبويب الجديدة بعد طلب المصادقة. اسمح بالنوافذ المنبثقة وإعادة التوجيه من `https://.raptix.app`، ثم اختر **فتح** مجددًا. إذا كنت تستخدم التطبيق المثبت، فتحقق مما إذا انتقل في النافذة نفسها. **تفتح الصفحة عند شاشة تسجيل الدخول.** أغلقها، وتأكد من استمرار جلسة RAPTIX، وافتح الصفحة مجددًا من التطبيقات. لا تستخدم بيانات اعتماد شخص آخر. إذا عاد الطلب، فأبلغ المسؤول باسم الصفحة ووقت المحاولة. **تفتح الصفحة فارغة أو تعرض خطأ في التطبيق.** أغلق الهدف وحاول مرة أخرى. إذا فتحت صفحات أخرى بصورة صحيحة، فالمشكلة على الأرجح خاصة بهذه الصفحة. أبلغ مالكها بأسماء مساحة العمل والتطبيق والصفحة. **النموذج مفقود من عمليات سير العمل القابلة للتشغيل.** قد يكون معطلًا أو متوقفًا مؤقتًا أو غير منشور أو خارج التطبيق المحدد أو غير متاح لحسابك. اطلب من مالك سير العمل التحقق من نشره ونطاقه. **يظهر «فتح»، لكن الهدف يقول إنني غير مخوّل.** قد يختلف كتالوج التطبيقات عن الهدف بعد تغيير الوصول أو الجلسة. أعد تحميل التطبيقات وحاول مجددًا. إذا لم تتغير النتيجة، فاطلب من المسؤول التحقق من وصول الصفحة أو النموذج المحدد. ## أدلة ذات صلة - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [تحرير صفحة تطبيق في منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-4-editing-app-page/) - [التحكم في الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [استكشاف أخطاء اتصال التطبيقات وإصلاحها](https://raptix.app/user-guide/ar/50-applications/50-24-troubleshooting-connection-errors/) - [استكشاف أخطاء الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-3-search-current-applications-view/ # البحث في طريقة عرض التطبيقات الحالية > **الوحدة:** التطبيقات > > **الجمهور:** الأعضاء والمنشئون والمسؤولون > > **الوصول المطلوب:** صلاحية الوصول إلى التطبيقات > > **ستتعلم:** كيفية عمل البحث على مستويات مساحة العمل والتطبيق والصفحة، وكيفية التعافي من نتيجة فارغة غير متوقعة. يصفّي بحث التطبيقات الحالي البطاقات الموجودة في المستوى الظاهر بالفعل. ولا يبحث في جميع مساحات العمل والتطبيقات والصفحات والمستندات وعمليات سير العمل المتداخلة دفعة واحدة. ## قبل أن تبدأ - افتح مسار التطبيقات الحالي `/applications`. - حدد ما إذا كنت تبحث في مساحات العمل أو التطبيقات أو الصفحات؛ إذ يطبق البحث على القائمة الظاهرة فقط. ## البحث في البطاقات 1. افتح `/applications` وانتقل إلى **مساحات العمل** أو **التطبيقات** داخل مساحة بعينها أو علامة **الصفحات** داخل تطبيق. 2. أدخل جزءًا من الاسم في **البحث في مساحات العمل…** أو **البحث في التطبيقات…** أو **البحث في الصفحات…**. 3. اختر بطاقة مطابقة للمتابعة. 4. امسح حقل البحث لاستعادة جميع البطاقات المتاحة في ذلك المستوى. قد يظل النص في الحقل بعد انتقالك إلى مستوى آخر. إذا بدت قائمة مساحة عمل أو تطبيق أو صفحة فارغة على نحو غير متوقع، فامسح الحقل قبل الإبلاغ عن مشكلة وصول. تستخدم المستندات وسير العمل عناصر البحث والتصفية والجداول الخاصة بهما. اختر **المستندات** أو **سير العمل** أولًا، ثم استخدم عناصر تلك الطريقة. ## أدلة ذات صلة - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [استكشاف أخطاء الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-4-editing-app-page/ # تحرير صفحة تطبيق في منشئ التطبيقات > **الوحدة:** التطبيقات / منشئ التطبيقات > > **الجمهور:** المستخدمون المتقدمون ومنشئو التطبيقات والمسؤولون > > **الوصول المطلوب:** مساحة عمل Enterprise ومنحة تحرير للصفحة أو أحد نطاقاتها الأعلى؛ يخضع الوصول العام إلى منشئ التطبيقات لعناصر تحكم إضافية > > **ستتعلم:** كيفية فتح صفحة محددة في منشئ التطبيقات الحي، وفهم خطوة التأكيد، وتشخيص غياب إجراء «تحرير» أو «منشئ التطبيقات». منشئ التطبيقات هو بيئة Enterprise لإنشاء صفحات التطبيقات. يستطيع المنشئ المخوّل فتح صفحة محددة للتحرير من التطبيقات، أو استخدام إجراء **منشئ التطبيقات** في الرأس للدخول إلى بيئة الإنشاء الأوسع. التحرير إجراء حي في بيئة الإنتاج. يحذرك تأكيد RAPTIX من أن التغييرات قد تسري على كل من يستخدم التطبيق، لذا نسّق واختبر وفق عملية الإصدار في مؤسستك. ## قبل أن تبدأ - سجّل الدخول عبر `https://.raptix.app` وافتح `/applications`. - تأكد من أن المؤسسة تستخدم باقة Enterprise. - تأكد من امتلاك منحة تحرير على النطاق العام أو مساحة العمل أو التطبيق أو الصفحة، وأنها تغطي الصفحة الهدف. - استخدم متصفح سطح مكتب مدعومًا، واحفظ أي عمل غير مرتبط قبل فتح المنشئ. - حدد مالك التطبيق ومسار التحقق المتوقع للتغيير. ## فتح صفحة محددة للتحرير 1. اختر مساحة العمل والتطبيق اللذين يحتويان على الصفحة. 2. ابقَ في علامة **الصفحات** للتطبيق. 3. ابحث عن بطاقة صفحة منشئ التطبيقات واختر **تحرير**. 4. راجع مربع الحوار **تحرير «اسم الصفحة» في المحرر الحي؟**. 5. اختر **نعم، تحرير التطبيق الحي** للمتابعة، أو **إلغاء** للعودة دون فتح المنشئ. 6. انتظر بينما تنشئ RAPTIX تسليمًا موثّقًا وتفتح عنوان تحرير الصفحة. 7. نفّذ التغيير المقصود وتحقق منه باستخدام عناصر التحكم الظاهرة في منشئ التطبيقات. تسجل RAPTIX إجراء تحرير الصفحة في نشاط التطبيقات. يتحكم إصدار المنشئ وعملية مؤسستك في سلوك الحفظ والمعاينة والنشر داخله؛ اتبع العناصر وقواعد الإصدار المعروضة هناك، ولا تفترض أن عرض المسودة آمن. ## فتح منشئ التطبيقات الكامل استخدم إجراء الرأس عندما تحتاج إلى العمل عبر عدة تطبيقات أو صفحات. 1. عُد إلى رأس التطبيقات الرئيسي. 2. اختر **منشئ التطبيقات**. 3. أثناء تجهيز RAPTIX للتسليم الموثّق، يتغير الزر إلى **جارٍ الفتح…**. 4. لا تنتقل داخل المنشئ إلا إلى الموارد المخوّل لك صيانتها. لا يظهر إجراء الرأس إلا بعد اجتياز جميع الشروط المنطبقة: أن تكون مساحة العمل Enterprise، وأن يكشف دورك منشئ التطبيقات، وأن تسمح منح التطبيقات بفتحه. وصول تحرير الصفحة المحددة والوصول العام إلى المنشئ مترابطان، لكنهما ليسا متطابقين. ## التمييز بين تحرير الصفحة وتحرير نموذج سير العمل قد تحتوي طريقة عرض **الصفحات** أيضًا على بطاقات ضمن **عمليات سير العمل القابلة للتشغيل**. يفتح إجراء **تحرير** فيها منشئ التدفق، لا منشئ التطبيقات. استخدم هذا الدليل لبطاقات صفحات منشئ التطبيقات، واستخدم أدلة بناء سير العمل للنماذج القابلة للتشغيل. ## سلوك الوصول | الإجراء | متى يظهر؟ | أين يفتح؟ | |---|---|---| | **فتح** | للصفحة عنوان عرض حي. | صفحة التطبيق الحية. | | **تحرير** في صفحة منشئ التطبيقات | مساحة العمل Enterprise، وللصفحة عنوان تحرير، وتشمل منحتك تحرير الصفحة أو نطاقًا أعلى. | الصفحة في منشئ التطبيقات الحي، بعد التأكيد. | | **تحرير** في سير عمل قابل للتشغيل | يشمل نطاق سير العمل لديك التحرير. | سير العمل في منشئ التدفق. | | **منشئ التطبيقات** في الرأس | باقة Enterprise، وصلاحية ميزة منشئ التطبيقات، ومنحة منطبقة لفتح المنشئ. | منطقة دخول منشئ التطبيقات. | تُخفى العناصر التي لا تجتاز فحوص الوصول أو الباقة بدلًا من ظهورها معطلة. ## ممارسات التحرير الآمن - نفّذ تغييرًا مركزًا واحدًا كل مرة، واختبر المسار المتأثر قبل الاستخدام الواسع. - تأكد من أنك تحرر مساحة العمل والتطبيق والصفحة المقصودة قبل تغيير أي شيء. - عامل استعلامات البيانات ومنطق JavaScript وإعدادات المصادقة والتكامل كتغييرات حساسة أمنيًا. - نسّق مع المنشئين الآخرين قبل تحرير الصفحة نفسها. - أبقِ الأسرار خارج خصائص الأدوات المرئية والبرامج النصية ولقطات الشاشة ورسائل الدعم. - عند فشل التحقق، توقف واستعد آخر إعداد معروف وسليم وفق عملية المنشئ في مؤسستك. ## استكشاف الأخطاء وإصلاحها **إجراء «تحرير» مفقود.** قد لا تكون مساحة العمل Enterprise، أو قد لا يكون للصفحة عنوان تحرير، أو قد لا تشمل منحتك الفعلية التحرير. اطلب من المسؤول التحقق من الصفحة ونطاقاتها الأعلى وباقة المؤسسة. **لا يعرض الرأس «منشئ التطبيقات».** يتطلب الوصول العام أكثر من القدرة على عرض التطبيقات. اطلب من المسؤول التحقق من مفتاح ميزة منشئ التطبيقات ومنحة فتح المنشئ الخاصة بك. قد يظل تحرير صفحة محددة متاحًا حتى إذا غاب الإجراء العام. **يفتح التأكيد لكن المنشئ لا يفتح.** اسمح بالنوافذ المنبثقة وإعادة التوجيه لمساحة RAPTIX، وتأكد من نشاط جلستك، ثم حاول مرة أخرى. إذا ظل يفشل، فأبلغ المسؤول باسم الصفحة والوقت. **يطلب المنشئ تسجيل الدخول.** عُد إلى RAPTIX وافتح الصفحة مجددًا ليطلب تسليمًا حديثًا. لا تعد استخدام عنوان موثّق مؤقت أو جلسة شخص آخر. **يمكنني فتح المنشئ لكن لا أستطيع تغيير الصفحة.** قد يفرض المنشئ قواعد تأليف إضافية بعد أن تفتحه RAPTIX. اطلب من مالك التطبيق أو المسؤول التحقق من وصولك داخل المنشئ؛ ولا تتجاوز القيد بحساب مشترك. ## أدلة ذات صلة - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/) - [التحكم في الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [سجلات نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [حوكمة أتمتة منشئ التطبيقات بأمان](https://raptix.app/user-guide/ar/50-applications/50-20-app-builder-automation-governance/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/ # إدارة الوصول إلى التطبيقات > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومديرو الوصول > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** كيفية منح الوصول إلى موارد التطبيقات ومراجعته وتحديثه وإزالته. يتحكم وصول التطبيقات في من يستطيع رؤية الموارد في مستكشف التطبيقات والعمل عليها. تربط المنحة مستخدمًا واحدًا أو دورًا واحدًا بنطاق مورد وإمكانية واحدة أو أكثر. افتح **التطبيقات** واختر **المزيد** ثم **الأذونات**. تفتح الصفحة مع تحديد **التطبيقات**. استخدم علامة **المستندات** عندما تحتاج إلى أذونات خاصة بالمستندات. ## قبل أن تبدأ - حدد ما إذا كان الوصول ينبغي أن يخص مستخدمًا واحدًا أم دورًا. - حدد أضيق نطاق مورد يغطي عمل الشخص. - قرر ما إذا كان الطرف يحتاج إلى **عرض** أو **تحرير** أو **فتح في المنشئ**. - تذكر أن إجراءات المنشئ قد تعتمد أيضًا على باقة مساحة العمل وأذونات ميزات التطبيقات الأخرى. لا تمكّن منحة ACL ميزة غير متاحة للمؤسسة. ## منح الوصول 1. في **منح الوصول**، اختر **مستخدم** أو **دور**. 2. اختر الطرف: - للمستخدم، اكتب حرفين على الأقل من اسم المستخدم أو البريد، ثم اختر نتيجة. - للدور، اختر دورًا واحدًا من القائمة. 3. اختر **نطاق المورد**: - **عام** لجميع موارد التطبيقات. - **مساحة العمل** لمساحات محددة ومحتوياتها. - **التطبيق** لتطبيقات محددة وصفحاتها. - **الصفحة** لصفحات محددة فقط. 4. في المنحة غير العامة، اختر الموارد المطلوبة. تظهر خيارات التطبيقات والصفحات بعد اختيار مواردها الأعلى. 5. اختر إمكانية واحدة على الأقل: | الإمكانية | الأثر | |---|---| | **عرض** | يجعل المورد المشمول متاحًا في مستكشف التطبيقات. | | **تحرير** | يسمح بفتح الصفحات المشمولة للتحرير عندما تملك المؤسسة باقة المنشئ وصلاحية الميزة المطلوبتين. | | **فتح في المنشئ** | يمنح وصول المنشئ للمورد المشمول. ويظل توفر المنشئ معتمدًا على الباقة وصلاحية الميزة. | 6. اختر **حفظ الإذن**. عند تحديد عدة موارد، تحفظ RAPTIX منحة لكل مورد. ويؤدي حفظ الطرف والنطاق والمورد نفسه مجددًا إلى تحديث المنحة بدلًا من إنشاء نسخة مكررة. بعد الحفظ الناجح، يعود النموذج إلى قيمه الافتراضية: مستخدم وعام وعرض. استخدم **السماح بالكل** لتحديد الإمكانات الثلاث. إذا كانت كلها محددة بالفعل، يمسحها العنصر نفسه؛ ويجب اختيار إمكانية واحدة على الأقل قبل الحفظ. ## مراجعة المنح النشطة تعرض لوحة **المنح النشطة** الطرف ونوعه والنطاق واسم المورد والإمكانات والمانح ووقت المنح لكل منحة حالية. - استخدم **الكل** و**عام** و**مساحة العمل** و**التطبيق** و**الصفحة** للتصفية حسب نطاق المورد. - استخدم **تحديث** لإعادة تحميل القائمة من الخادم. - لا تصفّي علامات النطاق حسب المستخدم أو الدور. - تعني العلامة الفارغة عدم وجود منح في ذلك النطاق. ## إزالة الوصول 1. ابحث عن المنحة في **المنح النشطة**. 2. اختر رمز الإزالة الخاص بها. 3. اختر **إزالة** في التأكيد المضمّن. تسري الإزالة فورًا على تلك المنحة. قد يظل الطرف قادرًا على الوصول من خلال منحة مباشرة أخرى أو منحة دور أو دور مسؤول أو نطاق أوسع. راجع جميع المنح المنطبقة قبل استنتاج سحب الوصول. ## سلوك الوصول وصول التطبيقات تراكمي: - تكشف منحة عرض عامة جميع مساحات العمل والتطبيقات والصفحات. - تغطي منحة مساحة العمل تطبيقاتها وصفحاتها. - تغطي منحة التطبيق صفحاته وتضيف مساحة العمل الأعلى للتنقل. - تكشف منحة الصفحة تلك الصفحة وتضيف تطبيقها ومساحة عملها للتنقل. - تُجمع المنح الموروثة من الأدوار مع منح المستخدم المباشرة. - لا تطرح منحة أضيق إمكانية توفرها منحة أوسع. استخدم منح الأدوار للوصول المستقر للفريق، ومنح المستخدمين للاستثناءات الفردية الحقيقية. وفضّل أضيق نطاق يفي بالحاجة. ## استكشاف الأخطاء وإصلاحها ### ظهور رفض الوصول تأكد من أن الحساب مسؤول أو يستطيع فتح أدوات **المزيد** في التطبيقات. لا تكفي القدرة على تصفح التطبيقات لإدارة المنح. ### عدم توفر مستخدم أو دور - أدخل حرفين على الأقل عند البحث عن مستخدم. - تأكد من وجود الحساب أو الدور في مساحة RAPTIX الحالية. - أعد تحميل الصفحة إذا تغيرت القائمة في جلسة إدارة أخرى. ### منتقي المورد فارغ انتظر اكتمال تحميل التسلسل، ثم تأكد من اختيار مساحة العمل أو التطبيق الأعلى. أعد تحميل الصفحة إذا تعذر تحميل بيانات تسلسل التطبيقات. ### ما زال المستخدم لا يرى المورد تأكد من تحديد **عرض** في منحة مباشرة أو منحة دور منطبقة. اطلب من المستخدم إعادة تحميل التطبيقات بعد حفظ المنحة. ### ما زال المستخدم يملك الوصول بعد الإزالة تحقق من وجود منحة دور أو منحة عامة أو منحة في نطاق أعلى. لا تؤدي إزالة صف واحد إلى إزالة المنح المنطبقة الأخرى. ## أدلة ذات صلة - [فهم نطاقات أذونات التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/) - [الاختيار بين منح المستخدم والدور](https://raptix.app/user-guide/ar/50-applications/50-7-granting-role-vs-user/) - [مراجعة المنح النشطة وإزالتها](https://raptix.app/user-guide/ar/50-applications/50-8-managing-active-grants/) - [مراجعة نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/ # فهم نطاقات أذونات التطبيقات > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومديرو الوصول > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** ما الذي تغطيه المنح العامة ومنح مساحة العمل والتطبيق والصفحة، وكيف تختار النطاق الأكثر أمانًا. تكوّن موارد التطبيقات تسلسلًا هرميًا: تحتوي مساحات العمل على تطبيقات، وتحتوي التطبيقات على صفحات. يحدد نطاق الإذن نقطة بدء المنحة والموارد التابعة التي تغطيها. ## قبل أن تبدأ - بعد إصلاح عدم تطابق الأذونات، افتح **التطبيقات ← المزيد ← الأذونات**. لا تستخدم مسارًا مباشرًا كحل بديل. - حدد مساحات العمل أو التطبيقات أو الصفحات الدقيقة التي يحتاج إليها الطرف. - راجع المنح الحالية، ومنها منح الأدوار، قبل إضافة منحة أخرى. ## التسلسل الهرمي للنطاق ```text عام └── مساحة العمل └── التطبيق └── الصفحة ``` | النطاق | التغطية | متى تستخدمه؟ | |---|---|---| | **عام** | كل مساحة عمل وتطبيق وصفحة حالية في التطبيقات | عندما يحتاج طرف موثوق إلى وصول عام للتطبيقات على مستوى المؤسسة. | | **مساحة العمل** | المساحة المحددة وجميع تطبيقاتها وكل صفحاتها | عندما يملك فريق مساحة عمل كاملة أو يستخدمها. | | **التطبيق** | التطبيق المحدد وجميع صفحاته؛ وتظل مساحة العمل الأعلى ظاهرة للتنقل | عندما يحتاج فريق إلى تطبيق كامل واحد. | | **الصفحة** | الصفحة المحددة؛ ويظل تطبيقها ومساحة عملها ظاهريْن للتنقل | عندما يحتاج شخص إلى صفحة بعينها. | لا توسع الحاويات الأعلى المضافة للتنقل منحة الصفحة إلى صفحات شقيقة، ولا منحة التطبيق إلى تطبيقات شقيقة. ## اختيار نطاق وحفظه 1. اختر المستخدم أو الدور في **منح الوصول**. 2. ضمن **نطاق المورد**، اختر **عام** أو **مساحة العمل** أو **التطبيق** أو **الصفحة**. 3. إذا لم يكن النطاق عامًا، فاختر المورد: - يعرض نطاق مساحة العمل منتقيًا متعددًا للمساحات. - يعرض نطاق التطبيق مساحات العمل أولًا، ثم التطبيقات داخل المساحات المحددة. - يعرض نطاق الصفحة مساحات العمل ثم التطبيقات ثم الصفحات. تحمل الصفحات الافتراضية علامة **(افتراضية)**. 4. اختر **عرض** و/أو **تحرير** و/أو **فتح في المنشئ**. 5. اختر **حفظ الإذن**. 6. تحقق من النتيجة في **المنح النشطة** باختيار علامة النطاق الموافقة. يمكنك تحديد عدة موارد في إرسال واحد. تنشئ RAPTIX منحة لكل مورد محدد أو تحدثها. ## كيفية عمل المنح المتداخلة تُجمع منح المستخدم المباشرة مع المنح الموروثة عبر الأدوار، وتكون الإمكانات المنطبقة تراكمية. على سبيل المثال: - تجعل منحة عرض لمساحة عمل مع منحة تحرير لصفحة مساحة العمل كلها ظاهرة، وتسمح بتحرير الصفحة المحددة، وفق الباقة وصلاحية الميزة. - توفر منحة العرض العامة رؤية في كل مكان أصلًا؛ ولا تضيقها منحة عرض إضافية لصفحة. - لا تؤدي إزالة منحة تطبيق إلى إزالة وصول توفره منحة مساحة عمل أو منحة دور. لا توجد منحة منع في هذه الشاشة. لا يستطيع صف أضيق تجاوز منحة أوسع لإزالة الوصول. ## اختيار النطاق الصحيح - اختر **الصفحة** لوصول منفرد إلى شاشة واحدة. - اختر **التطبيق** عندما تكون جميع صفحات تطبيق واحد مطلوبة. - اختر **مساحة العمل** عندما يحتاج الفريق فعلًا إلى كل تطبيق فيها. - احتفظ بالنطاق **العام** للأطراف الموثوقة ذات مسؤولية على مستوى المؤسسة. - فضّل منحة دور عندما ينبغي أن يتبع النطاق عضوية الفريق. راجع المنح العامة ومنح مساحات العمل بانتظام لأن لها الأثر الأوسع. ## استكشاف الأخطاء وإصلاحها ### لا يظهر منتقي التطبيق أو الصفحة اختر المورد الأعلى أولًا. لا تظهر التطبيقات إلا بعد اختيار مساحة عمل واحدة على الأقل، ولا تظهر الصفحات إلا بعد اختيار تطبيق واحد على الأقل. ### تظل الصفحة مخفية بعد منحة تحرير لا يحل التحرير محل العرض في المستكشف. أضف **عرض** في منحة منطبقة إذا كان لا بد من اكتشاف الصفحة. ### لم تؤد إزالة منحة ضيقة إلى إزالة الوصول راجع المنح المباشرة ومنح الأدوار في نطاقات عام ومساحة العمل والتطبيق. قد تبقي أي منحة عرض منطبقة المورد ظاهرًا. ### تظهر مساحة العمل الأعلى رغم منح صفحة واحدة فقط هذا متوقع. تكشف RAPTIX المسار الأعلى كي يستطيع المستخدم التنقل إلى الصفحة الممنوحة؛ وتظل الصفحات الشقيقة مقيّدة ما لم تغطها منحة أخرى. ## أدلة ذات صلة - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [الاختيار بين منح المستخدم والدور](https://raptix.app/user-guide/ar/50-applications/50-7-granting-role-vs-user/) - [مراجعة المنح النشطة وإزالتها](https://raptix.app/user-guide/ar/50-applications/50-8-managing-active-grants/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-7-granting-role-vs-user/ # الاختيار بين منح المستخدم والدور > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومديرو الوصول > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** متى تمنح الوصول إلى التطبيقات لمستخدم واحد ومتى تمنحه لدور. لكل منحة ACL في التطبيقات طرف مستفيد: إما مستخدم واحد أو دور واحد. تعمل نطاقات الموارد والإمكانات بالطريقة نفسها لكلا النوعين، لكن أثر الصيانة مختلف. ## قبل أن تبدأ - بعد إصلاح عدم تطابق الأذونات، افتح **التطبيقات ← المزيد ← الأذونات**. لا تستخدم مسارًا مباشرًا كحل بديل. - حدد ما إذا كان احتياج الوصول تابعًا لوظيفة أم لشخص واحد. - راجع أدوار الطرف الحالية ومنح التطبيقات الموجودة. ## مقارنة أنواع الأطراف | الطرف | من يتلقى الوصول؟ | الأنسب لـ | الصيانة المستمرة | |---|---|---|---| | **المستخدم** | حساب محدد واحد | الاستثناءات الفردية أو المهام قصيرة الأجل | يجب مراجعة المنحة وإزالتها مباشرة. | | **الدور** | كل عضو حالي في الدور المحدد | وصول مستقر لفريق أو وظيفة | يتبع الوصول عضوية الدور. | استخدم الأدوار لسياسة وصول قابلة للتكرار. ولا تستخدم منح المستخدم المباشرة إلا عندما ينبغي ألا ينطبق الوصول على جميع أعضاء دور موجود. ## منح الوصول إلى مستخدم 1. اختر **مستخدم** في **منح الوصول**. 2. أدخل حرفين على الأقل من اسم المستخدم أو البريد الإلكتروني. 3. اختر النتيجة الصحيحة. تعرض RAPTIX الحساب المحدد كشريحة. 4. اختر نطاق المورد والموارد. 5. اختر إمكانية واحدة أو أكثر. 6. اختر **حفظ الإذن**. يعيد البحث قائمة محدودة من الحسابات المطابقة. استخدم البريد لتمييز الحسابات ذات الأسماء المتشابهة. واختر عنصر الإزالة في شريحة المستخدم إذا حددت حسابًا خاطئًا. ## منح الوصول إلى دور 1. اختر **دور** في **منح الوصول**. 2. اختر دورًا واحدًا من **تحديد دور**. 3. اختر نطاق المورد والموارد. 4. اختر إمكانية واحدة أو أكثر. 5. اختر **حفظ الإذن**. لا يمكن لمنحة واحدة استهداف أكثر من دور. كرر العملية إذا احتاجت عدة أدوار إلى الوصول نفسه. يُقيّم وصول الدور وفق العضوية الحالية. تجعل إضافة مستخدم إلى الدور منح الدور منطبقة عليه، وتزيل إزالته من الدور ذلك المسار الموروث. وتستمر أي منح مباشرة أو منح من أدوار أخرى في الانطباق. ## مراجعة النتيجة تضع لوحة **المنح النشطة** علامة **مستخدم** أو **دور** على كل صف. تصفّي علاماتها حسب نطاق المورد، لا نوع الطرف. قبل إضافة منحة مستخدم مباشرة، تحقق مما إذا كان: - أحد أدوار المستخدم يغطي المورد بالفعل؛ - منحة أوسع في نطاق عام أو مساحة عمل أو تطبيق توفر الإمكانية بالفعل؛ أو - ينبغي إضافة الحاجة إلى دور فريق بدلًا من ذلك. يؤدي حفظ منحة أخرى لنوع الطرف والطرف ونوع المورد والمورد نفسه إلى تحديث الصف الموجود. ## السياسة الموصى بها - امنح وصول الفريق المعتاد عبر الأدوار. - اجعل نطاقات الأدوار متوافقة مع مسؤوليات العمل. - استخدم منح المستخدم المباشرة للاستثناءات الموثقة. - فضّل نطاق الصفحة أو التطبيق للاستثناءات بدلًا من وصول مساحة العمل أو الوصول العام الواسع. - راجع منح المستخدمين المباشرة أثناء الانتقالات وإنهاء الخدمة. - راجع عضوية الأدوار بصورة مستقلة عن قائمة ACL للتطبيقات؛ تعرض القائمة منحة الدور، لا صفًا منفصلًا لكل عضو فيه. ## استكشاف الأخطاء وإصلاحها ### لا يعيد بحث المستخدم نتائج أدخل حرفين على الأقل وجرّب البريد كاملًا. تأكد من وجود الحساب في مساحة RAPTIX الحالية. ### الدور المطلوب مفقود تأكد من وجود الدور وظهوره في إدارة الأدوار. أعد تحميل الصفحة بعد إنشاء دور أو إعادة تسميته. ### لم تؤد إزالة منحة دور إلى إزالة وصول مستخدم قد يملك المستخدم منحة مباشرة أو منحة دور أخرى أو دور مسؤول أو منحة أوسع منطبقة. راجع كل نطاق في **المنح النشطة** وعضويات أدوار المستخدم الحالية. ### لم تؤد إزالة مستخدم من دور إلى إزالة كل الوصول تؤثر عضوية الدور في المنح الموروثة من ذلك الدور فقط. تظل المنح المباشرة والمنح الموروثة من أدوار أخرى نشطة. ## أدلة ذات صلة - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [فهم نطاقات أذونات التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/) - [مراجعة المنح النشطة وإزالتها](https://raptix.app/user-guide/ar/50-applications/50-8-managing-active-grants/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-8-managing-active-grants/ # مراجعة المنح النشطة وإزالتها > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومديرو الوصول > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** كيفية تدقيق قائمة المنح النشطة وتحديثها وإزالة وصول التطبيقات بأمان. تسرد لوحة **المنح النشطة** في التحكم بوصول التطبيقات صفوف ACL المحفوظة لمساحة العمل الحالية. استخدمها للتأكد ممن تلقى المنحة وما تغطيه والإمكانات التي توفرها. ## قبل أن تبدأ - بعد إصلاح عدم تطابق الأذونات، افتح **التطبيقات ← المزيد ← الأذونات**. لا تستخدم مسارًا مباشرًا كحل بديل. - اعرف المستخدم أو الدور والمورد والإمكانية التي تراجعها. - تذكر أن شخصًا واحدًا قد يتلقى الوصول عبر منح مباشرة وعدة أدوار ونطاقات موارد أوسع. ## قراءة المنحة قد يحتوي كل صف على: | الحقل | المعنى | |---|---| | اسم الطرف | المستخدم أو الدور المحفوظ في المنحة. | | شارة **مستخدم** أو **دور** | نوع الطرف. | | شارة النطاق | عام أو مساحة العمل أو التطبيق أو الصفحة. | | اسم المورد | المورد المحدد للمنح غير العامة. | | شارات الإمكانات | عرض و/أو تحرير و/أو فتح في المنشئ. | | **بواسطة** | الحساب الذي حفظ المنحة آخر مرة. | | التاريخ والوقت | وقت إنشاء المنحة أول مرة. | العدد بجوار **المنح النشطة** هو إجمالي صفوف ACL الحالية. ## تصفية القائمة وتحديثها 1. اختر علامة نطاق: - يعرض **الكل** جميع المنح. - يعرض **عام** منح التطبيقات على مستوى المؤسسة. - يعرض **مساحة العمل** منح المساحات. - يعرض **التطبيق** منح التطبيقات. - يعرض **الصفحة** منح الصفحات. 2. راجع العدد في كل علامة. 3. اختر **تحديث** لإعادة تحميل القائمة من الخادم. تصفّي هذه العلامات حسب نطاق المورد فقط. لا توفر الصفحة بحثًا باسم الطرف أو مرشح مستخدم/دور، لذا راجع جميع الصفوف في النطاق المحدد. ## تحديث منحة موجودة لا يوجد عنصر تحرير في صف المنحة. لتغيير إمكاناتها: 1. اختر نوع الطرف والطرف نفسيهما في **منح الوصول**. 2. اختر نطاق المورد والمورد نفسيهما. 3. اختر الإمكانات المطلوبة. 4. اختر **حفظ الإذن**. تحدث RAPTIX صف ACL المطابق. ويكون الصف مطابقًا عندما يتطابق نوع الطرف والطرف ونوع المورد ومعرّف المورد. ## إزالة منحة 1. حدد الصف الدقيق في **المنح النشطة**. 2. اختر رمز الإزالة في ذلك الصف. 3. راجع الصف مرة أخرى، ثم اختر **إزالة** في التأكيد المضمّن. اختر إلغاء للاحتفاظ به. 4. انتظر رسالة النجاح وتحديث القائمة. تحذف الإزالة صف ACL هذا فقط. لا تزيل المستخدم من دور، ولا تغير المنح الأخرى، ولا تلغي وصول المسؤول. ## قائمة تحقق للتدقيق في مراجعة الوصول الدورية: 1. راجع المنح **العامة** أولًا. 2. راجع منح **مساحات العمل** الواسعة. 3. تأكد من أن منح الأدوار ما زالت تطابق مسؤوليات العمل الحالية. 4. ابحث عن منح مستخدم مباشرة ينبغي أن يوفرها دور الآن. 5. تأكد من قصر التحرير وفتح المنشئ على من يحتاج وصول الإنشاء. 6. أزل الصفوف القديمة وحدّث القائمة. 7. اطلب من المستخدمين المتأثرين إعادة تحميل التطبيقات والتحقق من النتيجة. لا تحتوي منح التطبيقات على حقل انتهاء. استخدم عملية المراجعة وإنهاء الخدمة في مؤسستك لإزالة الوصول القديم. ## استكشاف الأخطاء وإصلاحها ### لا تظهر منحة حُفظت حديثًا اختر **الكل** ثم **تحديث**. تأكد من أنك لا تعرض علامة نطاق مختلفة. ### لم تؤد إزالة صف إلى إزالة الوصول تحقق من: - منحة مباشرة في نطاق آخر؛ - منحة لأي من أدوار المستخدم؛ - منحة أوسع في نطاق عام أو مساحة العمل أو التطبيق؛ أو - وصول المسؤول. الإمكانات تراكمية، ولذلك قد تحافظ أي منحة منطبقة على الوصول. ### تفشل عملية الإزالة أعد تحميل القائمة وحاول مجددًا. ربما أُزيل الصف في جلسة أخرى بالفعل. إذا أبلغت الصفحة عن خطأ وصول، فتأكد من أنك مسؤول أو تستطيع فتح أدوات **المزيد** في التطبيقات. ### تعرض المنحة وقت إنشاء قديمًا بعد التحديث يؤدي تحديث منحة مطابقة إلى تغيير إمكاناتها في موضعها. التاريخ الظاهر هو وقت المنحة الأصلي، لذا استخدم شارات الإمكانات الحالية للتحقق من الحالة المحفوظة. ## أدلة ذات صلة - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [فهم نطاقات أذونات التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/) - [الاختيار بين منح المستخدم والدور](https://raptix.app/user-guide/ar/50-applications/50-7-granting-role-vs-user/) - [مراجعة نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/ # مراجعة نشاط التطبيقات > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومراجعو التشغيل > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** كيفية مراجعة أحداث التطبيقات وفحص تفاصيل الحدث وفرز النتائج وتصدير النشاط المصفى إلى CSV. توفر سجلات نشاط التطبيقات سجلًا على مستوى مساحة RAPTIX للتفاعلات المدعومة في تجربة التطبيقات. تجمع الصفحة ملخصات مؤشرات الأداء وعوامل التصفية وجدول أحداث مقسمًا إلى صفحات ولوحة تفاصيل الحدث. افتح **التطبيقات** واختر **المزيد** ثم **السجلات**، أو افتح `https://.raptix.app/applications/logs`. تبدأ طريقة العرض بالأحدث وتستخدم نافذة 30 يومًا على الخادم. تفتح الصفحة مع تحديد **التطبيقات**؛ استخدم علامة **المستندات** لنشاط المستندات. ## قبل أن تبدأ - تأكد من أن حسابك مسؤول أو يستطيع فتح أدوات **المزيد** في التطبيقات. - حدد المستخدم والمورد والإجراء والفترة الزمنية المطلوب التحقيق فيها. - عامل الصفحة كسجل لأحداث الواجهة المدعومة، لا كضمان لوجود كل حدث خلفي أو أمني. تسجيل أحداث الواجهة على أساس أفضل جهد. ## فهم الصفحة تحتوي الصفحة على أربع مناطق رئيسية: 1. تلخص ست بطاقات مؤشرات النتيجة المصفاة الحالية. 2. يفتح **إظهار عوامل التصفية** عناصر البحث والتاريخ والتصفية الموجهة. 3. يعرض جدول النشاط 50 حدثًا في كل صفحة. 4. يفتح **التفاصيل** السياق الكامل المتاح لحدث واحد. تشمل تسميات إجراءات التطبيقات المعروفة حاليًا: | التسمية | مفتاح الإجراء | المعنى | |---|---|---| | فُتحت مساحة العمل | `workspace.open` | فُتحت مساحة عمل. | | فُتح التطبيق | `application.open` | فُتح تطبيق. | | عُرضت الصفحة | `page.view` | فُتحت صفحة في وضع العرض. | | حُررت الصفحة | `page.edit` | فُتحت صفحة للتحرير. | | فُتح المنشئ | `builder.open` | فُتحت نقطة دخول منشئ التطبيقات. | | فُتحت الأذونات | `permissions.open` | فُتح التحكم بوصول التطبيقات. | | فُتحت السجلات | `activity-log.open` | فُتحت سجلات نشاط التطبيقات. | قد تظهر مشاهدات النماذج القابلة للتشغيل أيضًا بالمفتاح `form.view`. ## مراجعة الأحداث وفرزها يعرض كل صف في الجدول: - الوقت؛ - المستخدم والبريد الإلكتروني؛ - الإجراء؛ - النتيجة؛ - نوع المورد واسمه؛ - المورد الأعلى؛ و - إجراء **التفاصيل**. الفرز الافتراضي حسب **الوقت** تنازليًا. اختر رأسًا قابلًا للفرز حسب **الوقت** أو **البريد الإلكتروني** أو **الإجراء** أو **النتيجة** أو **المورد**. اختر الرأس النشط مرة أخرى لعكس الاتجاه. لا يمكن فرز المستخدم والمورد الأعلى. استخدم **السابق** و**التالي** عندما تمتد النتيجة إلى أكثر من صفحة من 50 صفًا. يعرض التذييل إجمالي النتائج والصفحة الحالية. ## فحص حدث 1. اختر **التفاصيل** في صف. 2. راجع الحقول المقروءة أولًا: الإجراء والنتيجة والوقت والمنفذ وأدواره والمورد والمورد الأعلى ووكيل المستخدم. 3. ضمن **معرّفات النظام**، استخدم مفتاح الإجراء ومعرّف الطلب ومعرّف المورد عند ربط الحدث بسجلات تقنية. 4. راجع **البيانات الوصفية** عند وجودها. 5. أغلق اللوحة بعنصر الإغلاق أو بالنقر خارجها أو بضغط Escape. لا تعرض اللوحة عنوان IP للمستخدم. لا تستنتج موقع شبكة المستخدم من هذه الصفحة. ## تصدير النشاط المصفى 1. طبّق عوامل التصفية وترتيب الفرز المطلوبين. 2. اختر **تصدير**. 3. أبقِ الصفحة مفتوحة بينما يعرض الزر **جارٍ التصدير…**. يحتوي CSV على النتيجة المصفاة كاملة، لا صفحة الجدول الظاهرة فقط، بحد أقصى 20,000 صف. يحافظ على الفرز المحدد ويتضمن: - الوقت - المستخدم - البريد الإلكتروني - الإجراء - النتيجة - نوع المورد - المورد - المورد الأعلى - مفتاح الإجراء - معرّف الطلب إذا طابق أكثر من 20,000 صف، تصدر RAPTIX أول 20,000 وتعرض تحذيرًا. ضيّق نطاق التاريخ أو عوامل أخرى ثم صدّر مجددًا للحصول على نتيجة محدودة كاملة. ## النتائج وحدود التدقيق قد تمثل الصفوف نتائج **نجاح** أو **مرفوض** أو **خطأ** عندما توجد في بيانات النشاط المخزنة. يسجل مسجل واجهة التطبيقات المدعوم التفاعلات الناجحة على أساس أفضل جهد؛ وغياب صف لا يثبت عدم محاولة الإجراء. لا يمكن تحرير صفوف النشاط أو حذفها من هذه الواجهة. يعتمد السجل المتاح على البيانات المحتفظ بها لمساحة RAPTIX الحالية. ## حالات التحميل والفراغ والأخطاء - تظهر صفوف تحميل أثناء جلب الصفحة الحالية. - تعني **لم يُعثر على إدخالات في سجل النشاط** أن لا شيء يطابق النطاق الحالي. - يعرض نطاق التاريخ المعكوس رسالة خاصة؛ بدّل «من» و«إلى». - إذا لم تستطع الصفحة تحميل النتائج، فاستخدم **إعادة المحاولة**. وإذا استمرت المشكلة، فتحقق من الاتصال ووصول التطبيقات. - إذا فشل التصدير، فأبقِ عوامل التصفية واختر **تصدير** مجددًا. ## استكشاف الأخطاء وإصلاحها ### صفحة السجل غير متاحة تأكد من أن الحساب مسؤول أو يستطيع فتح أدوات **المزيد** في التطبيقات. لا يكفي الإذن العام بتصفح التطبيقات لفتح السجلات. ### الأحداث المتوقعة مفقودة تحقق من عدد عوامل التصفية النشطة ونطاق التاريخ ومفتاح الإجراء وبريد المنفذ. اختر **إعادة ضبط** للعودة إلى طريقة العرض الأولية، ثم أضف العوامل واحدًا تلو الآخر. وتذكر أن تسجيل أحداث الواجهة المدعومة قائم على أفضل جهد. ### يصعب العثور على أحداث المنشئ افتح **إظهار عوامل التصفية** واختر مفتاح الإجراء `builder.open`. يعرض الجدول هذه الصفوف باسم **فُتح المنشئ**. ### يعرض تحذير التصدير 20,000 صف للملف حد مقصود. أضف نطاق تاريخ صريحًا، وعند الحاجة صدّر فترات منفصلة لا تتداخل. ## أدلة ذات صلة - [تصفية نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-10-filtering-activity-log/) - [فهم بطاقات مؤشرات النشاط](https://raptix.app/user-guide/ar/50-applications/50-11-activity-log-kpi-cards/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-10-filtering-activity-log/ # تصفية نشاط التطبيقات > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومراجعو التشغيل > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** كيفية الجمع بين البحث والتاريخ والمنفذ والإجراء والنتيجة وعوامل المورد في سجلات نشاط التطبيقات. تضيّق عوامل التصفية جدول الأحداث وبطاقات المؤشرات وتصدير CSV معًا. تُطبق التغييرات تلقائيًا؛ ولا يوجد زر «تطبيق». ## قبل أن تبدأ - افتح `https://.raptix.app/applications/logs`. - اختر **إظهار عوامل التصفية**. - للتقارير القابلة للتكرار، حدد تاريخي «من» و«إلى» صراحة قبل إضافة عوامل أخرى. لا تعرض الطريقة الأولية قيم تصفية ظاهرة، لكن الخادم يقصرها على آخر 30 يومًا. يعيد **إعادة الضبط** إلى الحالة الأولية نفسها. ## البحث في النشاط أدخل نصًا في **البحث** لمطابقة أي من الحقول التالية: - بريد المنفذ؛ - اسم المورد؛ أو - مفتاح الإجراء. لا يراعي البحث حالة الأحرف ويُطبق بعد تأخير قصير أثناء الكتابة. ويُجمع مع كل عامل نشط آخر. استخدم مفاتيح مثل `builder.open` في البحث. يحول الجدول المفاتيح المعروفة إلى تسميات مثل **فُتح المنشئ**. ## ضبط نطاق تاريخ استخدم أحد الإعدادات المسبقة: | الإعداد | قيم التاريخ | |---|---| | **اليوم** | من اليوم إلى اليوم. | | **7 أيام** | اليوم والأيام الستة التقويمية السابقة. | | **30 يومًا** | اليوم والأيام التسعة والعشرون السابقة. | | **هذا الشهر** | من أول يوم في الشهر الحالي إلى اليوم. | | **مسح** | يزيل القيم من «من» و«إلى». | يمكنك أيضًا اختيار تواريخ دقيقة في **من** و**إلى**. تشمل التواريخ اليوم المحدد كاملًا. إذا كان «من» بعد «إلى»، تعرض RAPTIX خطأ ولا تتطابق أي نتيجة حتى تصحيح التاريخين. لا يعني مسح حقلي التاريخ دائمًا النطاق الزمني نفسه. عند غياب عامل ذي معنى، يطبق الخادم نافذته الافتراضية ذات 30 يومًا؛ وقد تشمل عوامل المنفذ أو الإجراء أو البحث من دون تواريخ صريحة سجلات مطابقة أقدم. اضبط «من» و«إلى» دائمًا للمراجعات والتصديرات المحدودة. ## استخدام عوامل موجهة | العامل | ما الذي يطابقه؟ | |---|---| | **بريد المنفذ** | أحداث بريد منفذ مخزن واحد. | | **الإجراء** | مفتاح إجراء خام واحد، مثل `page.view` أو `builder.open`. | | **النتيجة** | نتيجة مخزنة واحدة، مثل نجاح أو مرفوض أو خطأ. | | **نوع المورد** | نوع مخزن واحد، مثل مساحة عمل أو تطبيق أو صفحة أو نموذج. | | **اسم المورد** | اسم مورد مخزن واحد. | يدعم كل منتقٍ قيمة واحدة في الوقت نفسه. اختر خيار **الكل…** لمسح ذلك العامل. تُنشأ خيارات العوامل من النشاط المخزن. تحترم كل قائمة العوامل النشطة الأخرى، مع إبقاء حقلها الحالي متاحًا للاستبدال. يظهر مؤشر **جارٍ تحديث الخيارات…** أثناء إعادة حساب القيم. ## جمع عوامل التصفية تستخدم العوامل منطق AND. على سبيل المثال، تعرض القيم التالية: - بريد المنفذ: `alex@example.com` - الإجراء: `page.edit` - «من» و«إلى»: الشهر الحالي أحداث تحرير الصفحات المطابقة لذلك المنفذ في الفترة المحددة فقط. تعرض الشارة على **إظهار عوامل التصفية** أو **إخفاء عوامل التصفية** عدد الحقول النشطة. يؤدي إخفاء اللوحة إلى إبقاء جميع العوامل نشطة. ## إعادة ضبط الصفحة اختر **إعادة ضبط** من أجل: - مسح البحث؛ - مسح «من» و«إلى»؛ - إعادة كل منتقٍ إلى خيار **الكل…**؛ - العودة إلى الصفحة 1؛ و - إعادة تحميل طريقة الخادم الافتراضية ذات 30 يومًا. أعد الضبط بين التحقيقات حتى لا يضيّق شرط سابق النتيجة التالية بصمت. ## مؤشرات الأداء المصفاة والتصدير تتحدث بطاقات المؤشرات الست من مجموعة العوامل المطبقة نفسها على الجدول. يغير الفرز ترتيب الصفوف لا إجماليات المؤشرات. ينزّل **تصدير** النتيجة المصفاة المطبقة بترتيب الفرز المحدد، حتى 20,000 صف. إذا كنت تحتاج إلى تصدير كامل، فاضبط دائمًا نطاق تاريخ صريحًا وتحقق من إجمالي الجدول قبل التصدير. ## استكشاف الأخطاء وإصلاحها ### المنتقي فارغ أو معطل انتظر انتهاء **جارٍ تحديث الخيارات…**. إذا ظل فارغًا، فوسّع نطاق التاريخ أو امسح عاملًا آخر؛ لا توجد قيم مخزنة تطابق المجموعة الحالية. ### لا توجد نتائج في الجدول تحقق من نطاق تاريخ معكوس، ثم راجع عدد العوامل النشطة. اختر **إعادة ضبط** وأعد تطبيق شرط واحد كل مرة. ### يظهر الإجراء كمفتاح يستخدم منتقي الإجراء مفاتيح الإجراءات المخزنة. تستخدم الصفوف المعروفة تسميات مقروءة في الجدول؛ فمثلًا يظهر `builder.open` باسم **فُتح المنشئ**. ### تمتد النتائج إلى زمن أقدم من المتوقع اضبط تاريخي «من» و«إلى» صراحة. قد يبحث عامل منفذ أو إجراء أو بحث مع تواريخ فارغة إلى ما قبل نافذة 30 يومًا الأولية. ### لم يؤد إخفاء العوامل إلى مسحها هذا متوقع. اختر **إعادة ضبط** لمسح العوامل النشطة؛ لا يفعل **إخفاء عوامل التصفية** سوى طي العناصر. ## أدلة ذات صلة - [مراجعة نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [فهم بطاقات مؤشرات النشاط](https://raptix.app/user-guide/ar/50-applications/50-11-activity-log-kpi-cards/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-11-activity-log-kpi-cards/ # فهم بطاقات مؤشرات أداء نشاط التطبيقات > - **الوحدة:** التطبيقات > - **الجمهور:** المسؤولون ومراجعو التشغيل > - **الوصول المطلوب:** حساب مسؤول أو صلاحية أدوات **المزيد** في التطبيقات > - **ستتعلم:** ما الذي يحسبه كل مؤشر في سجلات نشاط التطبيقات، وكيف تؤثر عوامل التصفية في البطاقات. تلخص ست بطاقات مؤشرات مجموعة الأحداث المحددة بعوامل النشاط الحالية. استخدمها للتوجيه العام، ثم استخدم الجدول ولوحة تفاصيل الحدث للتحقيق في الأحداث الفردية. ## قبل أن تبدأ - افتح `https://.raptix.app/applications/logs`. - اسمح بتحميل الملخص الأولي. - اضبط نطاق تاريخ صريحًا عند مقارنة الفترات أو تصدير تقرير. تستخدم الطريقة الأولية غير المصفاة نافذة الخادم الافتراضية ذات 30 يومًا. ## قراءة البطاقات الست | البطاقة | ما الذي تحسبه؟ | |---|---| | **إجمالي الأحداث** | كل الأحداث المخزنة المطابقة للعوامل الحالية. | | **المستخدمون الفريدون** | عناوين بريد المنفذين غير الفارغة والمتميزة في الأحداث المطابقة. | | **الصفحات المعروضة** | أحداث `page.view` المطابقة. | | **مرات فتح التحرير** | أحداث `page.edit` المطابقة. | | **مرات فتح المنشئ** | أحداث `builder.open` المطابقة. | | **مساحات العمل المفتوحة** | أحداث `workspace.open` المطابقة. | تساهم مرات فتح التطبيقات ومشاهدات النماذج وفتح الأذونات والسجلات في **إجمالي الأحداث**، لكنها لا تملك بطاقات مخصصة. لذلك لا يُتوقع أن يكون مجموع قيم بطاقات الإجراءات مساويًا لإجمالي الأحداث. **المستخدمون الفريدون** عدد متميز لا عدد أحداث، ولذلك لا ينبغي إضافته إلى بطاقات الإجراءات. ## تطبيق عوامل التصفية على المؤشرات 1. اختر **إظهار عوامل التصفية**. 2. اضبط نطاق تاريخ أو عاملًا آخر. 3. انتظر حتى تعرض البطاقات القيم المحدثة. 4. راجع الجدول أسفلها لرؤية الأحداث وراء الإجماليات. تستخدم البطاقات الست عوامل البحث والتاريخ والمنفذ والإجراء والنتيجة ونوع المورد واسمه المطبقة نفسها على الجدول. أثناء التحديث تعرض القيم علامة حذف. أمثلة: - يجعل ضبط الإجراء على `builder.open` قيمة **مرات فتح المنشئ** مساوية لـ**إجمالي الأحداث**؛ وينبغي أن تكون بطاقات الإجراءات الأخرى صفرًا. - يعرض عامل بريد المنفذ النشاط الناتج عن البريد المخزن فقط. - يقصر عامل النتيجة جميع البطاقات على أحداث النتيجة المخزنة. - لا يغير فرز عمود في الجدول البطاقات، لأن الفرز يغير الترتيب لا العضوية. ## تفسير البطاقات بعناية - استخدم **إجمالي الأحداث** لفهم حجم التفاعل المسجل إجمالًا، لا حجم نتائج العمل. - استخدم **المستخدمين الفريدين** كمقياس إرشادي للتبني. لا تُحسب الحسابات التي لا تملك حدثًا مسجلًا في النطاق المحدد. - استخدم **الصفحات المعروضة** و**مرات فتح التحرير** لمقارنة الاستهلاك بنشاط التحرير لدى المنشئين. - استخدم **مرات فتح المنشئ** لتحديد الفترات التي تستحق مراجعة أدق لوصول المنشئ. - استخدم **مساحات العمل المفتوحة** لفهم تنقل المستكشف على المستوى الأعلى. تلخص المؤشرات سجلات نشاط الواجهة المسجلة على أساس أفضل جهد. تفيد في المراجعة التشغيلية، لكن لا ينبغي اعتبارها تدقيقًا أمنيًا كاملًا أو دليلًا على عدم وقوع إجراء غير مسجل. ## مقارنة الفترات 1. طبّق تاريخي «من» و«إلى» صريحين. 2. سجّل القيم الست أو صدّر الأحداث الأساسية. 3. انتقل إلى فترة مقارنة غير متداخلة وبالطول نفسه. 4. قارن الإجماليات والمستخدمين الفريدين، ثم افحص صفوف الجدول لفهم السياق. لا تعرض الصفحة نسب المقارنة بين الفترات، ولا تصدر البطاقات كملخص مستقل. استخدم **تصدير** لتنزيل صفوف الأحداث المصفاة، بحد 20,000، واحسب المؤشرات الإضافية خارج RAPTIX. ## استكشاف الأخطاء وإصلاحها ### لا تظهر البطاقات ربما فشل طلب الملخص. أعد تحميل الصفحة وتحقق من الاتصال ووصول التطبيقات. يُحمّل الجدول والملخص بطلبين منفصلين، ولذلك قد يفشل أحدهما ويعمل الآخر. ### تعرض البطاقات علامة حذف الملخص قيد التحديث. انتظر اكتمال طلب التصفية الحالي. ### إجمالي الأحداث أكبر من الصفحة الظاهرة يعرض الجدول 50 صفًا في الصفحة. تلخص بطاقات المؤشرات النتيجة المصفاة كاملة، لا الصفحة الحالية فقط. ### لا يساوي إجمالي الأحداث مجموع بطاقات الإجراءات هذا متوقع عندما تشمل النتيجة إجراءات من دون بطاقات مخصصة، مثل فتح التطبيق أو مشاهدة النموذج أو فتح الأذونات أو السجلات. ### المستخدمون الفريدون أقل من عدد الحسابات المرخصة يحسب المؤشر عناوين بريد المنفذين المتميزة ذات النشاط المخزن المطابق فقط، لا كل حساب في مساحة العمل. ### يظهر نشاط المنشئ باسم مختلف في مواد أقدم تسمية البطاقة والجدول الحالية هي **فُتح المنشئ**، ومفتاح الإجراء `builder.open`. ## أدلة ذات صلة - [مراجعة نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [تصفية نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-10-filtering-activity-log/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-12-choose-workflow-form-or-app-builder/ # اختيار نموذج سير عمل أو صفحة من منشئ التطبيقات > **الوحدة:** التطبيقات / منشئ التدفق / منشئ التطبيقات > > **الجمهور:** مالكو عمليات سير العمل ومنشئو التطبيقات > > **الوصول المطلوب:** صلاحية تحرير سير العمل؛ ولا يلزم وصول Enterprise إلى منشئ التطبيقات إلا لصفحة تطبيق مخصصة > > **ستتعلم:** تجربة النموذج الموجهة للمستخدم التي ينبغي اختيارها، والموضع الذي تُضبط فيه كل تجربة. توفر RAPTIX طريقتين حاليتين لجمع معلومات لسير العمل. اختر واحدة قبل تصميم خطوة البدء. | التجربة | اخترها عندما | أين يفتحها المستخدمون؟ | |---|---|---| | **نموذج سير عمل أصلي** | تحتاج إلى نموذج يُبنى ويُنشر مباشرة من منشئ التدفق. | مجموعة **عمليات سير العمل القابلة للتشغيل** في التطبيقات أو رابطه المنشور. | | **صفحة منشئ التطبيقات** | تحتاج إلى صفحة تطبيق مخصصة بتخطيط وسلوك أدوات خاصين بها. | بطاقة الصفحة في التطبيقات. | لا يوجد منتج أو صفحة منفصلة لجمع النماذج في الواجهة الحالية. ## استخدام نموذج سير عمل أصلي 1. افتح سير العمل في **منشئ التدفق**. 2. افتح خطوة **البدء** واختر خيار النموذج اليدوي. 3. أضف الحقول التي يجب على المستخدمين إكمالها ورتبها. 4. اختر وصولًا **عامًا** أو **خاصًا**. 5. احفظ النموذج وانشره. 6. عُد إلى علامة **الصفحات** للتطبيق وافتحه ضمن **عمليات سير العمل القابلة للتشغيل**. استخدم [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/) للاطلاع على العملية كاملة. ## استخدام صفحة منشئ التطبيقات 1. جهّز الصفحة الهدف وأدوات إدخال البيانات في **منشئ التطبيقات**. 2. افتح خطوة **البدء** لسير العمل في **منشئ التدفق**. 3. اختر تكامل منشئ التطبيقات الظاهر في إعدادات البدء. 4. اختر مساحة العمل والتطبيق والصفحة والأدوات المطلوبة. 5. احفظ إعدادات البدء، وراجع نتيجة النشر، واختبر الصفحة. استخدم [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) للإعداد الكامل وفحوص السلامة. ## أدلة ذات صلة - [اختيار الوصول الخاص أو العام لنموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [رفع المستندات من نموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/ # ربط صفحة منشئ التطبيقات بسير عمل > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو التطبيقات ومسؤولو عمليات سير العمل > > **الوصول المطلوب:** باقة Enterprise ووصول موثّق إلى التطبيقات؛ لا تستخدمه إلا بصلاحية معتمدة لتغيير صفحة منشئ التطبيقات الهدف > > **ستتعلم:** كيفية ربط عقدة البدء بصفحة منشئ التطبيقات، ونشر الموصل الذي ينشئه النظام بأمان، واختباره أو إعادة نشره. ## ما الذي يفعله هذا التكامل؟ تستطيع RAPTIX ربط صفحة منشئ التطبيقات بسير عمل من عقدة البدء. عندما تحفظ التكامل، تفحص RAPTIX أدوات إدخال البيانات المدعومة في الصفحة، وتنشئ موصل سير عمل فيها أو تحدثه. كما تربط زر إرسال موجودًا أو تنشئ واحدًا عند الحاجة. يستطيع الموصل المنشور: - جمع القيم من أدوات إدخال البيانات المدعومة في الصفحة؛ - إضافة قيمة الكيان وسياق الملف المضبوطين؛ - بدء سير العمل المضبوط؛ - رفع الملفات المحددة بعد إنشاء مثيل سير العمل؛ و - عرض رسالة نجاح أو فشل في الصفحة. تغير هذه الميزة صفحة في منشئ التطبيقات، ولا تتوفر إلا لمؤسسات Enterprise. > **ملاحظة انتقالية:** ما زالت بعض شاشات منشئ التدفق تعرض التسمية التقنية **تكامل Appsmith عبر HTTP** (`Appsmith Integration (HTTP)`). يسمي هذا الدليل الخيار **تكامل منشئ التطبيقات**. وهو ليس ميزة نموذج سير العمل الأصلي `/f/:token`. ## قبل أن تبدأ تأكد مما يلي: - تملك مؤسستك وصول Enterprise؛ - تستطيع تحرير سير العمل في منشئ التدفق، ولديك صلاحية تغيير معتمدة للصفحة الهدف؛ - لا تحتوي الصفحة الهدف إلا على أدوات إدخال البيانات التي يُسمح للموصل بإرسالها؛ - أسماء الأدوات ثابتة وفريدة؛ و - ضبط مشغل المنصة سر تكامل منشئ التطبيقات. استخدم صفحة اختبار أو نسخة قبل النشر إلى تطبيق حي. يحدث النشر اتصال الصفحة وقد ينشر تعديلات معلقة غير مرتبطة. راجع أو امسح كل تغيير غير منشور لا يرتبط بالمهمة قبل النشر. > **مهم:** اختيار صفحة ليس موافقة على تغييرها. لا تستخدم النشر إلا ضمن عملية تغيير الصفحات المعتمدة في مؤسستك. ## ربط الصفحة 1. افتح **التطبيقات**، وحدد سير العمل، وافتحه في **منشئ التدفق**. 2. افتح عقدة **البدء** لسير العمل. 3. اختر خيار بدء **تكامل منشئ التطبيقات**. يحمل هذا الخيار في المنتج الحالي تسمية **تكامل Appsmith عبر HTTP**؛ اختره. 4. اختر **اتصال**، ثم حدد مساحة عمل منشئ التطبيقات والتطبيق والصفحة. 5. راجع مخزون الصفحة. يفحص النشر الحالي أدوات إدخال البيانات المدعومة فيها؛ لذا تأكد من أنها لا تحتوي إلا على الحقول المقصودة لسير العمل. 6. حدد أداة **الكيان** اختياريًا. تصبح قيمتها معرّف سجل العمل للتشغيل. 7. إذا عرضت الواجهة اختيار **المستند الرئيسي**، فسجله في تصميم سير العمل، لكن لا تعتمد عليه للحد من العناصر التي يفحصها الموصل المُنشأ حاليًا. 8. فعّل إنشاء متغيرات سير العمل إذا احتاجت العُقد اللاحقة إلى قيم مسماة من الصفحة. 9. اختر ما إذا كانت واجهة الصفحة تتطلب مستخدمًا مسجلًا. يُعد **طلب المصادقة** فحصًا في جهة العميل داخل الموصل المُنشأ، وليس حد تفويض كاملًا في الخادم. لا تعرض التكامل لمستخدمين غير موثوقين؛ استخدم نموذجًا أصليًا خاصًا للمدخلات الحساسة. 10. اختر **حفظ خصائص البدء**. تعرض RAPTIX ما إذا كان الموصل قد أُنشئ أو حُدث، وما إذا كان زر الإرسال أُنشئ أو رُبط. افتح الصفحة في منشئ التطبيقات وحدّثها قبل الاختبار. ## اختبار التكامل 1. تأكد من أن النشر حدث الصفحة المقصودة، ومن عدم نشر تغيير غير مرتبط. 2. أدخل قيم اختبار مميزة في كل أداة إدخال بيانات مدعومة في الصفحة. 3. أضف ملف اختبار صغيرًا إذا كانت الصفحة تحتوي على أداة ملفات. 4. اختر زر الإرسال المنشور مرة واحدة. 5. تأكد من أن استجابة النجاح تتضمن معرّف مثيل سير العمل. 6. افتح تشغيل سير العمل في RAPTIX وتحقق من القيم المرسلة وسياق البادئ ومعرّف الكيان والمستندات. اختبر سلوك المستخدم المسجل والجمهور المقصود للصفحة. وللمدخلات الحساسة أو الخارجية، فضّل نموذج سير عمل أصليًا بإعداد **خاص** أو **عام** مناسب. ## ما الذي يحدث عند إعادة النشر؟ يؤدي حفظ التكامل نفسه مجددًا إلى استبدال بيانات الموصل المنشأة أو تحديثها، بدلًا من طلب إعداد يدوي ثانٍ. قد ينشر كل إعادة نشر الصفحة غير المنشورة كاملة. أعد النشر عندما: - تضيف أداة إدخال بيانات مدعومة أو تزيلها أو تعيد تسميتها؛ - تغير أداة الكيان أو تصميم معالجة الملفات؛ - تغير اسم سير العمل أو إعداد البدء؛ - تغير إعداد المصادقة؛ أو - تدوّر سر تكامل منشئ التطبيقات. حدّث صفحة منشئ التطبيقات بعد كل نشر. لا تفترض أن صفحة مفتوحة بالفعل في علامة أخرى حمّلت الإعداد الجديد. ## الأمان وسر التكامل يستخدم اتصال منشئ التطبيقات بيانات اعتماد يضبطها مسؤول المنصة. عامل الصفحة المتصلة كنشر موثوق، ولا تنسخ بيانات الاعتماد مطلقًا إلى وثائق أو لقطات شاشة أو تذاكر أو سجلات أو إعدادات صفحة تُصان يدويًا. لا تنشر الصفحة المتصلة لجمهور غير معتمد. للمدخلات الخارجية أو الحساسة، استخدم نموذج سير عمل أصليًا خاصًا أو عامًا خضع للمراجعة لهذا الغرض. ترفض نقطة نهاية التكامل الطلبات: - إذا لم يُضبط السر، تُرفض استدعاءات تكامل منشئ التطبيقات بوصفها غير متاحة؛ - إذا كان السر مفقودًا أو غير صحيح، تُرفض الاستدعاءات بوصفها ممنوعة؛ و - بعد تغيير السر، يجب إعادة نشر كل صفحة متأثرة كي يستخدم موصلها المنشأ القيمة الجديدة. لا يحل التحقق من بيانات الاعتماد محل وصول المستخدم والصفحة. **طلب المصادقة** جزء واحد من سلوك الصفحة المنشأ، ولذلك أبقِ أذونات التطبيقات وضوابط الوصول المؤسسية المعتادة مفعّلة. استخدم نطاق مساحة RAPTIX الحالية والعناوين التي تنشئها المنصة. لا تثبت نطاق منتج متقاعدًا في برامج الصفحة النصية. تستخدم نماذج سير العمل الأصلية في `/f/:token` نموذج أمان مختلفًا. تتطلب النماذج الخاصة عضو RAPTIX مسجلًا؛ وتستخدم النماذج العامة رمز مشاركة مبهمًا وتحققًا لمكافحة الروبوتات وحدود معدل وفحوص سلامة في الخادم. ولا تعتمد على سر تكامل منشئ التطبيقات. راجع [نماذج سير العمل الخاصة والعامة](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/). ## استكشاف الأخطاء وإصلاحها **لا تظهر مساحات عمل أو صفحات** تأكد من استحقاق Enterprise والوصول إلى منشئ التطبيقات. لا تصبح مساحة التطبيقات الأصلية مساحة منشئ تطبيقات تلقائيًا. **يُحفظ التكامل لكن الصفحة لم تتغير** حدّث منشئ التطبيقات، وتأكد من اختيار الصفحة الصحيحة، وانشر مجددًا. تحقق من ملخص النجاح لمعرفة حالة الموصل وزر الإرسال. **زر الإرسال غير مربوط** تأكد من احتواء الصفحة على زر صالح ومن عدم تغيير أسماء الأدوات. أعد النشر بعد تصحيح الصفحة. **يعيد الإرسال «غير متاح» أو «ممنوع»** اطلب من مشغل المنصة التحقق من سر تكامل منشئ التطبيقات. إذا ضُبط أو دُوّر حديثًا، فأعد نشر الصفحة. **يبدأ سير العمل من دون القيم المتوقعة** عُد إلى عقدة البدء، واحصر كل أداة إدخال بيانات مدعومة في الصفحة، وراجع المتغيرات المنشأة، واحفظ مجددًا، ثم اختبر بقيم جديدة. ## أدلة ذات صلة - [نماذج سير العمل الخاصة والعامة](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [رفع المستندات من نموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/) - [حوكمة أتمتة منشئ التطبيقات بأمان](https://raptix.app/user-guide/ar/50-applications/50-20-app-builder-automation-governance/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/ # اختيار الوصول الخاص أو العام لنموذج سير عمل > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو عمليات سير العمل والمسؤولون > > **الوصول المطلوب:** إذن تحرير عقدة البدء؛ كما تتطلب النماذج العامة إعداد أمان النماذج العامة في المنصة > > **ستتعلم:** كيفية نشر نموذج سير عمل خاص أو عام، واختبار وصوله، وإلغاء رابطه بأمان. ## ما الذي يتحكم فيه إعداد الوصول؟ يمكن عرض سير عمل ذي عقدة بدء يدوي كنموذج في التطبيقات. تنشئ RAPTIX رابط مشاركة مبهمًا ونِسبيًا لمساحة العمل بهذه الصيغة: ```text /f/:token ``` تختار أحد وضعي الوصول: - **خاص — للأعضاء المسجلين فقط:** لا يستطيع عرض النموذج وإرساله إلا عضو مسجل في مؤسسة RAPTIX نفسها. - **عام — لأي شخص يملك الرابط:** يستطيع الزائر العرض والإرسال من دون حساب، وفق فحوص مكافحة الروبوتات وحدود المعدل وقواعد سلامة سير العمل. الوضع الخاص هو الافتراضي والأنسب للطلبات الداخلية وعمليات الموظفين والنماذج التي تحتوي على بيانات عمل حساسة. ## قبل أن تبدأ - تأكد مما إذا كان كل مرسل ينتمي إلى مؤسسة RAPTIX. - استخدم **خاص** للمدخلات الداخلية أو الحساسة ما لم يكن الوصول المجهول مطلبًا صريحًا. - للنموذج العام، تأكد من أن سير العمل لا يحتوي على سلوك مجهول عالي المخاطر ومن ضبط Turnstile. - جهّز حساب اختبار في المؤسسة الصحيحة وجلسة متصفح لم تسجل الدخول. ## ضبط النموذج 1. افتح سير العمل في **منشئ التدفق**. 2. افتح عقدة **البدء** واختر **تشغيل يدوي**. 3. ضمن **حقول النموذج اليدوي**، أضف القيم التي يحتاجها سير العمل. 4. امنح كل حقل **اسم متغير** ثابتًا وتسمية واضحة للمستخدم. 5. اضبط الظهور والحالة المطلوبة والخيارات وربط الكيان وربط المستند حسب الحاجة. 6. فعّل **العرض كتطبيق**. 7. ضمن **من يستطيع فتح هذا النموذج؟**، اختر **خاص** أو **عام**. 8. اضبط اختياريًا اسم التطبيق ورابط الشعار ولون التمييز ورسالة النجاح ورابط إعادة التوجيه ومربع الموافقة. 9. اختر **حفظ خصائص البدء**. يحفظ الإجراء أحدث إعدادات البدء وينشئ رابط المشاركة أو يحدّثه. انسخ الرابط أو افتحه من مربع الحوار نفسه. تسري تغييرات الحقول أو وضع الوصول عند الحفظ التالي. ## النماذج الخاصة عندما يفتح زائر غير مسجل رابطًا خاصًا، ترسله RAPTIX إلى تسجيل الدخول قبل كشف حقول النموذج. وبعد تسجيل ناجح يعود الزائر إلى رابط `/f/:token` نفسه. يتحقق الخادم أيضًا من عضوية المؤسسة. لا يستطيع مستخدم مسجل من مؤسسة أخرى استخدام الرابط. اختبر النموذج الخاص في جلسة متصفح غير مسجلة: 1. افتح رابط المشاركة. 2. تأكد من أن RAPTIX تطلب تسجيل الدخول قبل عرض أي حقل. 3. سجّل الدخول بعضو من المؤسسة الصحيحة. 4. أرسل النموذج وتحقق من تشغيل سير العمل الناتج. ## النماذج العامة الروابط العامة مخصصة لمدخلات خارجية مضبوطة. لا يُقبل الإرسال العام إلا إذا كانت البيئة معدة للنماذج العامة واجتاز سير العمل فحوص سلامة الاستخدام المجهول. تحمي RAPTIX النماذج العامة بواسطة: - رمز مشاركة مبهم؛ - تحقق Cloudflare Turnstile؛ - مصائد للروبوتات وحدود معدل لكل عنوان IP؛ - حدود يومية للإرسال؛ - قائمة سماح للحقول وتحويل أنواع في الخادم؛ و - قيود على سلوك سير العمل عالي المخاطر. لا يمكن نشر سير عمل يحتوي على عقدة استعلام قاعدة بيانات أو برنامج Python نصي كعامة. وقد ترفض RAPTIX أيضًا أنماط مستلمي البريد غير الآمنة التي تسمح للزائر بتوجيه الرسائل إلى عناوين عشوائية. استخدم نموذجًا خاصًا عندما يحتاج سير العمل إلى هذه الإمكانات. تُعطل الإرسالات العامة إذا لم يتوفر إعداد مكافحة الروبوتات المطلوب. لا تتحايل على الحماية باستخدام تكامل قديم غير موثّق. ## تغيير الوصول أو إلغاؤه للتبديل بين خاص وعام، غيّر وضع الوصول واختر **حفظ خصائص البدء** مجددًا. يُحدّث الرابط الحالي بقاعدة الوصول الجديدة في الخادم. لإزالة الوصول تمامًا، اختر **إلغاء الرابط**. يصبح عنوان `/f/:token` القديم غير متاح ولا يظهر سير العمل كنموذج قابل للتشغيل في التطبيقات. ## تمييز مهم لصفحات منشئ التطبيقات يختلف مفتاح **طلب المصادقة** المستخدم في تكامل Enterprise لمنشئ التطبيقات عن إعداد الخاص/العام هنا. يستخدم التكامل موصل صفحة منشأ، بينما تستخدم النماذج الأصلية `/f/:token` وحقولًا تعرضها واجهة النموذج من مخطط يقدمه الخادم. لصفحات منشئ التطبيقات، اتبع [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/). وللتدفق الأصلي الكامل، راجع [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/). ## استكشاف الأخطاء وإصلاحها **يعود النموذج الخاص باستمرار إلى تسجيل الدخول.** تأكد من أن الحساب ينتمي إلى مؤسسة RAPTIX نفسها وأن جلسته نشطة، ثم افتح رابط المشاركة الحالي مجددًا. **لا يمكن تمكين نموذج عام.** راجع رسالة منشئ التدفق بحثًا عن عقدة محظورة أو نمط مستلم غير آمن. إذا كان سير العمل مؤهلًا، فاطلب من مشغل المنصة التحقق من إعداد النماذج العامة وTurnstile. **ما زال الرابط الملغى يظهر في إشارة مرجعية.** لا تُحذف الإشارات تلقائيًا. يرفض الخادم الرمز الملغى؛ احذف الإشارة القديمة ولا تنسخ رابطًا جديدًا إلا بعد إعادة النشر. ## أدلة ذات صلة - [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/) - [رفع المستندات من نموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/) - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/ # ربط مهمة سير عمل بصفحة منشئ التطبيقات > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو التطبيقات ومسؤولو عمليات سير العمل > > **الوصول المطلوب:** باقة Enterprise ووصول موثّق إلى التطبيقات؛ لا تستخدمه إلا بصلاحية معتمدة لتغيير صفحة منشئ التطبيقات الهدف > > **ستتعلم:** كيفية ربط عقدة مهمة بصفحة منشئ التطبيقات، ونشر إجراءات المهمة، واختبار الصفحة بمهمة مسندة حقيقية. ## ما الذي يفعله تكامل المهمة؟ تستطيع عقدة مهمة في سير عمل Enterprise نشر منطق معالجة المهمة إلى صفحة منشئ التطبيقات. يحذف النشر كل كائن JavaScript يحمل الاسم `TaskActions` أو `TaskData` أو يبدأ بأي منهما، بما في ذلك الكائنات المنشأة يدويًا. ثم ينشئ كائن `TaskActions` جديدًا واحدًا يحتوي على دوال مساعدة لإجراءات المهمة وبياناتها. يضيع أي كود يدوي في الكائنات المحذوفة. استخدم التكامل عندما تحتاج المهمة إلى واجهة مخصصة في منشئ التطبيقات. أما تجربة الموافقة القياسية في RAPTIX، فاستخدم شاشة موافقة المدير. > **ملاحظة انتقالية:** قد تستمر شاشة خصائص المهمة الحالية في عرض الفئة والتسمية التقنية **Appsmith**. هذا هو تكامل مهمة منشئ التطبيقات الموصوف هنا. ## قبل أن تبدأ تحتاج إلى: - وصول Enterprise؛ - إذن تحرير سير العمل واستخدام منشئ التطبيقات؛ - صفحة موجودة في منشئ التطبيقات للمهمة؛ - عقدة مهمة عُرّف المسند إليه وإجراءاتها المسموحة؛ و - تشغيل اختباري يستطيع إنشاء مهمة مسندة حقيقية. إذا كانت صفحة المهمة ترفع مرفقات، فيجب ضبط بيانات اعتماد تكامل منشئ التطبيقات قبل النشر. لا تستخدم الصفحة إلا في سياق موثوق واتبع [حماية تكامل سير العمل مع منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-23-app-builder-integration-security/). انسخ صفحة الإنتاج أو خذ نسخة احتياطية قبل النشر. قد يحدث التكامل روابط الأدوات وإعداد منتقي الملفات وسلوك تحميل الصفحة. كما ينسخ الصفحة غير المنشورة كاملة إلى المنشورة، لذا قد تصبح تعديلات معلقة غير مرتبطة حية. > **حد التفويض الحالي:** تتطلب واجهة Enterprise مستخدمًا موثّقًا يملك وصولًا عامًا إلى التطبيقات، لكنها لا تفرض ACL التطبيقات على الصفحة الهدف. لا تستخدم النشر إلا ضمن عملية تغيير صفحة معتمدة. ## ضبط صفحة المهمة ونشرها 1. افتح سير العمل في **منشئ التدفق** وافتح عقدة **المهمة** المعنية. 2. اضبط عنوان المهمة ووصفها والمسند إليه وقواعد الإكمال. 3. أضف ضمن **الإجراءات** ما يستطيع المسند إليه تنفيذه. استخدم معرّفات ثابتة بأحرف صغيرة وأسماء موجهة للمستخدم، وعلّم الإجراءات التي تتطلب تعليقًا. 4. اختر فئة **منشئ التطبيقات** في إعدادات نموذج المهمة. إذا كانت الشاشة ما زالت تعرض **Appsmith**، فاختر تلك الفئة. 5. اختر **اتصال**، ثم حدد مساحة العمل والتطبيق والصفحة. 6. احفظ خصائص المهمة. يرسل النشر الحالي معرّف الصفحة المحددة؛ ولا تتحكم اختيارات الأداة أو الكيان أو المستند الرئيسي في النشر المنشأ للمهمة. 7. عند ظهور مربع نجاح النشر، راجع الصفحة والحالة، ثم اختر **متابعة** لإنهاء حفظ المهمة. 8. افتح الصفحة في منشئ التطبيقات وراجع كل رابط منشأ قبل الاختبار. تزيل RAPTIX كل كائن `TaskActions*` و`TaskData*` مطابق، وتنشئ كائن `TaskActions` بديلًا بمعرّف جديد، وتنشر الصفحة غير المنشورة الحالية، وتسجل نتيجة النشر مع عقدة المهمة. حدّث صفحة منشئ التطبيقات قبل الاختبار. ## ما الذي يمكن أن يغيره النشر؟ وفق الصفحة، يستطيع النشر: - استبدال كل كائنات المهمة المطابقة بكائن `TaskActions` موحد؛ - ربط الأدوات المطابقة ببيانات المهمة؛ - ضبط أدوات FilePicker لمرفقات المهمة، إذ تستخدم دالة الرفع المساعدة بيانات اعتماد التكامل المضمنة؛ - ضبط حاوية لتحميل بيانات المهمة؛ و - كشف إجراءات عقدة المهمة المسموحة عبر `TaskActions`. راجع النتيجة المنشأة في منشئ التطبيقات. لا تحرر اتصالات المهمة المنشأة يدويًا لأن النشر التالي قد يستبدلها. إذا أعدت تسمية أداة مرتبطة، فانشر مجددًا وتأكد من أن الاسم الجديد ما زال يطابق بيانات المهمة المفروض عرضها. ## ربط أزرار إجراءات المهمة لا ينشئ النشر أزرار الإجراءات ولا يربطها تلقائيًا، لأن كل سير عمل قد يكشف مجموعة مختلفة. 1. أنشئ أو اختر في منشئ التطبيقات زرًا لكل إجراء في عقدة المهمة ينبغي للصفحة عرضه. 2. اضبط رابط `onClick` للزر على معرّف الإجراء الثابت المطابق. مثال: ```text {{TaskActions.executeWorkflowAction('approve', Input_Comments.text)}} ``` 3. استخدم وسيطًا ثانيًا فارغًا عندما لا يجمع الإجراء تعليقًا. 4. راجع الروابط وانشرها عبر عملية تغيير منشئ التطبيقات المعتمدة. ## الاختبار بمهمة مسندة لا تتحقق من الصفحة بفتح عنوان خام فقط. تتطلب إجراءات المهمة سياق مهمة مسندة. 1. ابدأ تشغيلًا اختباريًا لسير العمل. 2. تأكد من إسناد المهمة إلى مستخدم الاختبار. 3. افتح المهمة من **المهام المعلقة** أو صفحة تفاصيل سير العمل. 4. تأكد من أن الصفحة تعرض السجل وبيانات المهمة الصحيحين. 5. نفّذ كل إجراء مسموح، بما فيه التحقق من التعليق المطلوب. 6. تأكد من أن المهمة تكتمل أو تغير حالتها مرة واحدة، وأن سير العمل يتابع بصورة صحيحة. 7. تحقق من أي مستند مرفوع من طريقتي سير العمل والمستندات. ## استكشاف الأخطاء وإصلاحها **تنتهي مهلة النشر** قد تُحفظ المهمة من دون نشر ناجح للصفحة. أعد فتحها، وتأكد من الصفحة المحددة، وانشر مجددًا قبل الاختبار. **تفتح الصفحة من دون بيانات المهمة** افتحها من مهمة مسندة، لا من إشارة مرجعية. ثم تأكد من الصفحة وروابط الأدوات وأعد النشر. **إجراء مفقود أو زره لا يعمل** تحقق من قائمة **الإجراءات** في خطوة المهمة ومعرّف الإجراء الثابت، ثم راجع رابط الزر في منشئ التطبيقات. احفظ وانشر مجددًا عندما يصبح الاتصال المنشأ قديمًا؛ فالنشر لا يربط هذه الأزرار تلقائيًا. **أداة أعيدت تسميتها لم تعد تتحدث** راجع الاسم الحالي وانشر مجددًا. تفحص الروابط المنشأة أسماء الأدوات الحالية؛ ولا يتحكم اختيار أداة في إعدادات المهمة بهذا النشر. ## أدلة ذات صلة - [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) - [الموافقات متعددة المستويات والدُفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) - [حوكمة أتمتة منشئ التطبيقات بأمان](https://raptix.app/user-guide/ar/50-applications/50-20-app-builder-automation-governance/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/ # رفع المستندات من نموذج سير عمل > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو عمليات سير العمل ومستخدمو النماذج > > **الوصول المطلوب:** صلاحية تحرير سير العمل لضبط الحقل، ووصول إلى النموذج لرفع ملف وإرساله > > **ستتعلم:** كيفية إضافة حقل ملف، وإرسال مرفق مدعوم، والعثور على المستند المحفوظ ضمن سياق سير العمل. ## قبل أن تبدأ - حدد حقل الملف الذي يمثل **المستند الرئيسي**، إن وجد. - استخدم اسم متغير ثابتًا تستطيع العُقد اللاحقة الرجوع إليه. - جهّز ملف اختبار غير حساس ضمن حدود الرفع الحالية. - في النموذج العام، تأكد من أن نوع الملف تسمح به سياسته الأكثر صرامة. ## ما الذي يحدث للملف المرفوع؟ يستطيع نموذج RAPTIX الأصلي جمع الملفات من حقل بدء يدوي. تتحقق RAPTIX من المرفقات المقبولة وتحفظها في سياق سير العمل المقصود قبل أن تطلب من المحرك بدء التشغيل. ولا يعرض النموذج النجاح إلا بعد قبول المحرك ذلك التشغيل. يرتبط المستند المحفوظ بـ: - مثيل سير العمل؛ - اسم حقل النموذج؛ - معرّف الكيان؛ - نطاق مساحة العمل والتطبيق والصفحة في التطبيقات عند توفره؛ و - العضو المرسل أو سياق النموذج العام. إذا لم يتضمن النموذج حقل كيان صالحًا، تنشئ RAPTIX معرّفًا ثابتًا للتشغيل كي لا يبقى المستند بلا مجموعة. ## إضافة حقل ملف إلى نموذج 1. افتح سير العمل في **منشئ التدفق**. 2. افتح عقدة **البدء** واختر **تشغيل يدوي**. 3. ضمن **حقول النموذج اليدوي**، اختر **إضافة حقل**. 4. أدخل اسم متغير ثابتًا وتسمية موجهة للمستخدم. 5. اضبط **نوع الحقل** على **رفع ملف**. 6. أبقِ **إظهار في النموذج** مفعّلًا. 7. فعّل **مطلوب** إذا كان يجب ألا يبدأ سير العمل من دون الملف. 8. فعّل اختياريًا **المستند الرئيسي** للملف الأساسي الذي تستخدمه العملية. 9. فعّل **العرض كتطبيق**، واختر الوصول الخاص أو العام، ثم **حفظ خصائص البدء**. يتوفر النموذج في رابط `/f/:token` النسبي الذي أنشأته مساحة العمل، ويظهر ضمن **عمليات سير العمل القابلة للتشغيل** في نطاق تطبيقاته. تستطيع عقدة برنامج Python النصي قراءة حقل ملف ظاهر عبر `input_files["fieldName"]`. تستخدم أنواع العُقد الأخرى ربط بياناتها الخاص. فمثلًا، اضبط حقل مرفقات عقدة البريد على مفتاح إدخال سير العمل المطابق؛ ولا تفترض أن كل عقدة تكشف مساحة أسماء `input_files` عامة. ## إرسال ملف 1. افتح النموذج القابل للتشغيل من التطبيقات أو رابط المشاركة. 2. اختر ملفًا لكل حقل مطلوب. 3. أكمل الحقول المطلوبة الأخرى وخيار الموافقة إن وجد. 4. في النموذج العام، أكمل تحدي التحقق. 5. اختر **إرسال** مرة واحدة وانتظر رسالة النجاح أو إعادة التوجيه المضبوطة. تعني الاستجابة الناجحة أن محرك سير العمل قبل التشغيل. افتح تفاصيل سير العمل وطريقة عرض المستندات للتحقق من المرفق المحفوظ. ## حدود الرفع يفرض مشغّل النموذج الأصلي الحالي الحدود التالية: - 8 ميغابايت لكل ملف؛ - 20 ميغابايت لإجمالي بيانات الملفات في الإرسال؛ و - ما لا يزيد على 5 ملفات في الإرسال كله. تقيد النماذج العامة أنواع الملفات أيضًا. تُقبل صيغ PDF ومستندات Office والصور والنص العادي وCSV الشائعة. تُرفض الأرشيفات والملفات التنفيذية وHTML وSVG وحوامل أخرى غير آمنة. لا تتجاوز لاحقة الملف وحدها تحقق الخادم. ## المستند الرئيسي وحقل الكيان ينبغي تحديد حقل رفع ملف ظاهر واحد فقط بوصفه **المستند الرئيسي**. استخدم العلامة للمستند الذي يمثل سجل العملية، مثل الفاتورة المطلوب اعتمادها. يجب أن يكون حقل الكيان حقلًا مفردًا، مثل نص أو رقم أو تاريخ أو اختيار واحد. لا تصلح الملفات ومجموعات مربعات الاختيار كحقول كيان. تستخدم RAPTIX قيمة الكيان لتجميع المستندات ونشاط سير العمل حول سجل العمل نفسه. ## استكشاف الأخطاء وإصلاحها **يرفض النموذج الملف قبل الإرسال** تحقق من حجمه. وفي النموذج العام، تأكد أيضًا من دعم نوعه ومن مطابقة محتوى الملف الفعلي للنوع المعلن. **يبدأ سير العمل لكن الملف ليس في المكان المتوقع** تأكد من أن حقل الملف ظاهر وله اسم متغير ثابت وينتمي إلى نموذج عقدة البدء المنشور. تحقق من مثيل سير العمل ومعرّف الكيان عند البحث في المستندات. **لم يعد النموذج يظهر في التطبيقات** تأكد من تفعيل **العرض كتطبيق**، وعدم إلغاء رابط المشاركة، وأن سير العمل نشط. **هذه صفحة منشئ تطبيقات وليست نموذجًا أصليًا** تستخدم أدوات ملفات منشئ التطبيقات نشر موصل Enterprise. اتبع [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/)، وأعد النشر بعد تغيير أدوات الملفات. ## أدلة ذات صلة - [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/) - [اختيار الوصول الخاص أو العام لنموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/) - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-21-app-builder-widget-configuration/ # ضبط أدوات منشئ التطبيقات لسير عمل > **الوحدة:** التطبيقات / منشئ التدفق / منشئ التطبيقات > > **الجمهور:** منشئو التطبيقات ومالكو عمليات سير العمل > > **الوصول المطلوب:** وصول Enterprise إلى منشئ التطبيقات وصلاحية تحرير سير العمل > > **ستتعلم:** كيفية تأثير اختيارات الأدوات في بيانات سير العمل، ومتى تعيد نشر اتصال الصفحة. يقرأ تكامل منشئ التطبيقات أدوات إدخال البيانات المدعومة من الصفحة المحددة. اضبطها في منشئ التطبيقات، ثم اختر الصفحة واربطها من إعدادات البدء أو المهمة في سير العمل. ## تجهيز الصفحة 1. افتح صفحة التطبيق الصحيحة في **منشئ التطبيقات**. 2. امنح الأدوات المشاركة أسماء واضحة وثابتة وفريدة. 3. تأكد من أن أدوات الإدخال والاختيار والتاريخ والملفات لا تجمع إلا البيانات التي يحتاجها سير العمل. 4. جهّز أزرار الإرسال أو إجراءات المهمة التي سيختارها المستخدمون. 5. احفظ الصفحة، ثم عُد إلى **منشئ التدفق**. ## ربط الأدوات واختبارها 1. افتح خطوة **البدء** أو **المهمة** لسير العمل. 2. اختر مساحة عمل منشئ التطبيقات والتطبيق والصفحة. 3. راجع الأدوات الموجودة في الصفحة واختر الخيارات الظاهرة في لوحة التكامل. 4. احفظ الخطوة وراجع نتيجة النشر. 5. حدّث منشئ التطبيقات وتحقق من اتصالات الصفحة واختبر بتشغيل اختباري حقيقي. أعد النشر بعد إعادة تسمية أداة مشاركة أو إضافتها أو إزالتها أو تغيير غرضها. في صفحة المهمة، افتحها من مهمة مسندة كي تتلقى الصفحة سياق المهمة الصحيح. ## أدلة ذات صلة - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [حوكمة أتمتة منشئ التطبيقات بأمان](https://raptix.app/user-guide/ar/50-applications/50-20-app-builder-automation-governance/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/ # نشر نموذج سير عمل وتشغيله من التطبيقات > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو عمليات سير العمل ومستخدمو النماذج > > **الوصول المطلوب:** صلاحية تحرير سير العمل للنشر، وصلاحية التطبيقات أو رابط المشاركة لتشغيل النموذج > > **ستتعلم:** كيفية بناء نموذج سير عمل أصلي ونشره والعثور عليه وإرساله وتعطيله وإلغاء رابطه. ## نظرة عامة تستطيع RAPTIX نشر سير عمل ذي بدء يدوي كنموذج أصلي. يتلقى النموذج رابط مشاركة نسبيًا لمساحة العمل بهذه الصيغة: ```text /f/:token ``` تظهر النماذج المنشورة المُمكّنة وغير المعطلة ضمن **عمليات سير العمل القابلة للتشغيل** في طريقة صفحات التطبيقات المناسبة. توضح البطاقة ما إذا كان النموذج **عامًا** أو **خاصًا**، وتحمل علامة **نشط**. هذه هي التجربة المفضلة عندما يحتاج سير العمل إلى نموذج إدخال مباشر. لا تتطلب صفحة Enterprise في منشئ التطبيقات ولا JavaScript مخصصًا للصفحة. ## قبل أن تبدأ - ضع سير العمل في نطاق مساحة عمل RAPTIX والتطبيق المقصودين. - حدد ما إذا كان النموذج خاصًا أم عامًا، وراجع الآثار الأمنية. - عرّف أسماء متغيرات ثابتة لكل حقل تستخدمه عُقد لاحقة. - جهّز قيم وملفات اختبار غير حساسة لأول إرسال. ## بناء النموذج ونشره 1. افتح في **التطبيقات** مساحة العمل والتطبيق اللذين ينتمي إليهما النموذج. 2. أنشئ سير العمل أو افتحه في **منشئ التدفق**. 3. افتح عقدة **البدء** واختر **تشغيل يدوي**. 4. أضف حقول النموذج اليدوي. استخدم أسماء متغيرات ثابتة لأن العُقد اللاحقة تقرأها. 5. اضبط الحقول المطلوبة وخيارات الاختيار وترتيب العرض وحقل الكيان والمستند الرئيسي حسب الحاجة. 6. فعّل **العرض كتطبيق**. 7. اختر **خاص** لأعضاء المؤسسة المسجلين أو **عام** للمدخلات المجهولة المعتمدة. 8. اضبط اختياريًا الهوية ورسالة النجاح وإعادة التوجيه والموافقة. 9. اختر **حفظ خصائص البدء**. تحفظ RAPTIX إعدادات سير العمل وتنشئ رابط `/f/:token` أو تحدّثه في الإجراء نفسه. للاختلافات الأمنية بين أوضاع الوصول، راجع [اختيار الوصول الخاص أو العام لنموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/). ## العثور على النموذج في التطبيقات عُد إلى **التطبيقات** وافتح مساحة العمل والتطبيق نفسيهما. يظهر النموذج في قسم **عمليات سير العمل القابلة للتشغيل** ضمن علامة **الصفحات** عند تحقق جميع الشروط التالية: - أُنشئ رمز مشاركة؛ - سير العمل مُمكّن؛ - سير العمل ليس غير نشط؛ و - سير العمل مسند إلى نطاق مساحة العمل والتطبيق الحالي. اختر **فتح** لتشغيل النموذج في علامة تبويب جديدة. ويستطيع المستخدمون ذوو صلاحية منشئ التدفق ومنحة تحرير منطبقة اختيار **تحرير** للعودة إليه. ## إرسال النموذج 1. افتح النموذج من التطبيقات أو رابط المشاركة. 2. أكمل كل حقل مطلوب. 3. أضف الملفات واقبل إشعار الموافقة عندما يطلبهما النموذج. 4. إذا كان النموذج عامًا، فأكمل تحدي التحقق. 5. اختر **إرسال** مرة واحدة. تتحقق RAPTIX من الحقول التي يعلنها سير العمل فقط، وتبدأ العملية، وتعيد نتيجة نجاح محدودة. ثم يعرض النموذج رسالة النجاح المضبوطة أو يتبع إعادة التوجيه. في النموذج الخاص، يُرسل الزائر غير المسجل إلى تسجيل الدخول ثم يعود إلى الرابط نفسه. وفي النموذج العام، يُسجل المرسل كسياق نموذج عام لا كعضو مسجل. ## تحديث النموذج أو تعطيله أو إلغاء رابطه - لتغيير الحقول أو الوصول أو الهوية أو الموافقة أو سلوك النجاح، حرر عقدة البدء واحفظ مجددًا. - لإيقاف عمليات التشغيل الجديدة، عطّل سير العمل أو اضبطه على غير نشط. تُزال البطاقة من **عمليات سير العمل القابلة للتشغيل** في الواجهة الحالية. - لإبطال رابط المشاركة، افتح عقدة البدء واختر **إلغاء الرابط**. يصبح الرابط القديم غير متاح وتختفي البطاقة. لا تعد استخدام رمز ملغى في الوثائق أو الإشارات المرجعية. انسخ الرابط الحالي من إعدادات عقدة البدء بعد إعادة النشر. ## استكشاف الأخطاء وإصلاحها **قسم عمليات سير العمل القابلة للتشغيل مفقود** تأكد من عرض النموذج وحفظه، وأن سير العمل نشط، وأن نطاق مساحة العمل والتطبيق يطابق العرض المفتوح. **يعيد النموذج التوجيه إلى تسجيل الدخول** إنه خاص. سجّل الدخول كعضو في مؤسسة RAPTIX نفسها، أو اطلب من المنشئ مراجعة وضع الوصول. **لا يمكن نشر نموذج عام** اتبع رسالة منشئ التدفق. لا يمكن أن تحتوي النماذج العامة على سلوك مجهول عالي المخاطر، مثل عُقد استعلام قاعدة البيانات أو برنامج Python النصي، كما تُرفض أنماط مستلمي البريد غير الآمنة. استخدم الوصول الخاص إذا احتاج سير العمل إلى هذه الخطوات. **يقول الإرسال العام إنه غير مُمكّن** إعداد مكافحة الروبوتات في المنصة غير متاح. اطلب من مشغل المنصة تمكين النماذج العامة؛ ولا تستبدل النموذج بنقطة نهاية غير محمية. **يرفض النموذج مرفقًا** تحقق من الحجم وإجمالي عدد الملفات والنوع المدعوم. راجع [رفع المستندات من نموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/). ## متى تستخدم منشئ التطبيقات بدلًا منه؟ استخدم صفحة Enterprise في منشئ التطبيقات عندما يتطلب النموذج واجهة عالية التخصيص أو سلوك أدوات معقدًا أو تطبيقًا منخفض الكود موجودًا. اتبع [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/). ## أدلة ذات صلة - [اختيار الوصول الخاص أو العام لنموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/) - [رفع المستندات من نموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-16-uploading-documents-from-applications/) - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-17-approval-tables/ # استخدام جداول الموافقات في مهام سير العمل > **الوحدة:** التطبيقات ← سير العمل / منشئ التدفق > > **الجمهور:** منشئو عمليات سير العمل والموافقون > > **الوصول المطلوب:** صلاحية تحرير سير العمل لضبط الموافقات، أو مهمة مسندة لاتخاذ القرارات > > **ستتعلم:** أين تُضبط جداول الموافقات وأين يستخدمها الموافقون. تنتمي جداول الموافقات إلى تجربة المهمة والموافقة في سير العمل. ولا تُنشأ من شبكة بطاقات التطبيقات. ## لمنشئي عمليات سير العمل افتح سير العمل في **منشئ التدفق**، واختر خطوة **المهمة** المعنية، واضبط **الموافقة لكل عنصر**. اختر مصدر بيانات الصفوف ومستويات الموافقة والقرارات المسموحة وأي متطلبات للتعليقات. اتبع [الموافقات متعددة المستويات والدُفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/). ## للموافقين 1. افتح **التطبيقات ← سير العمل ← مهامي**. 2. افتح مهمة الموافقة المسندة. 3. اختر **فتح إجراء المهمة**. 4. راجع الصفوف وأي مستندات مرتبطة في **مدير مهام سير العمل**. 5. أكمل إجراءات الموافقة المسموحة والتعليقات المطلوبة. استخدم [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) للمراجعة الفردية و[شاشة قرارات الدُفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/) عندما توفر المهمة قرارات مجمعة. --- URL: https://raptix.app/user-guide/ar/50-applications/50-18-multi-level-approval-tables/ # ضبط مهام الموافقة متعددة المستويات > **الوحدة:** التطبيقات / منشئ التدفق > > **الجمهور:** منشئو عمليات سير العمل والمسؤولون > > **الوصول المطلوب:** إذن تحرير سير العمل وخطوة المهمة الخاصة به > > **ستتعلم:** أين تضبط مستويات المراجعة المتتابعة وكيف يصل المستخدمون إلى المستوى المسند إليهم. تُضبط الموافقة على الصفوف متعددة المستويات في إعدادات **الموافقة لكل عنصر** لخطوة **مهمة** في سير العمل. 1. افتح سير العمل في **منشئ التدفق**. 2. افتح خطوة مهمة الموافقة. 3. اختر مصدر بيانات الصفوف واضبط كل مستوى موافقة بالترتيب. 4. حدد المسند إليه والقرارات والتعليقات وسلوك الإكمال لكل مستوى. 5. احفظ واختبر بمستخدمين مسندين إلى مستويات مختلفة. يفتح الموافقون عملهم من **التطبيقات ← سير العمل ← مهامي**. لا يظهر المستوى اللاحق إلا عندما يصل إليه سير العمل. لإجراء المنشئ الكامل، راجع [الموافقات متعددة المستويات والدُفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/). وللاستخدام وقت التشغيل، راجع [مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) و[شاشة قرارات الدُفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/). --- URL: https://raptix.app/user-guide/ar/50-applications/50-19-submitting-batch-approval-decisions/ # إرسال قرارات الموافقة بالدُفعات > **الوحدة:** التطبيقات ← سير العمل ← مهامي > > **الجمهور:** الموافقون ومسؤولو عمليات سير العمل > > **الوصول المطلوب:** مهمة موافقة مجمعة مسندة أو وصول إداري إلى التشغيل المعني > > **ستتعلم:** كيفية الوصول إلى شاشة قرارات الدُفعة وإكمال قرارات الصفوف بأمان. 1. افتح **التطبيقات** واختر **سير العمل** ثم **مهامي**. 2. افتح مهمة الموافقة المجمعة واختر **فتح إجراء المهمة**. 3. راجع ملخص الدُفعة وكل صف يتطلب قرارًا. 4. أدخل القرار المسموح وأي تعليق مطلوب لكل صف. 5. راجع الإجماليات قبل إرسال الدُفعة. 6. أرسل مرة واحدة، ثم تحقق من حالة النجاح وتقدم سير العمل. استخدم تصدير CSV في الشاشة عندما تحتاج إلى نسخة مراجعة غير متصلة. لا يؤدي التصدير إلى إرسال القرارات أو تغييرها. إذا كان صف أو تعليق مطلوب غير مكتمل، فأكمله قبل المحاولة مجددًا. راجع [شاشة قرارات الدُفعة](https://raptix.app/user-guide/ar/10-workflows/10-25-batch-decision-screen/) لجميع العناصر والحالات، و[مدير مهام سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-24-workflow-task-manager/) لطريقة المهمة السابقة، و[الموافقات متعددة المستويات والدُفعات](https://raptix.app/user-guide/ar/10-workflows/10-6-multilevel-batch-approvals/) لإعداد المنشئ. --- URL: https://raptix.app/user-guide/ar/50-applications/50-28-completing-approval-tasks/ # إكمال مهمة موافقة ومراجعة ملف PDF الخاص بها > **الوحدة:** التطبيقات ← سير العمل ← مهامي > > **الجمهور:** الموافقون ومالكو المهام المسندة > > **الوصول المطلوب:** مهمة مسندة إلى حسابك > > **ستتعلم:** كيفية فتح مهمة مسندة، ومراجعة ملفاتها، واستخدام إجراءات الموافقة، وقراءة التعليقات السابقة. ## فتح المهمة المسندة 1. انتقل إلى **التطبيقات ← سير العمل ← مهامي**. 2. افتح المهمة التي تتطلب إجراء منك. 3. اختر **فتح إجراء المهمة** في صفحة تفاصيل سير العمل. يفتح ذلك **مدير مهام سير العمل**، وهو صفحة تنفيذ المهمة المسندة لا مجرد مراقبتها. ## المراجعة قبل اتخاذ الإجراء استخدم تفاصيل المهمة للتأكد من اسم سير العمل و**معرّف المثيل** والحالة الحالية والمستندات المرتبطة. اختر مستندًا لفتح عارض PDF عند إرفاق ملف PDF. اقرأ المستند في العارض قبل القرار. ووفق إعداد المهمة، قد يفتح **فتح عارض PDF بأدوات التوقيع** المسار `/pdf-viewer-simple?...` مع عناصر التعليق والتوقيع المرئي. وقد تعرض صفحة المهمة أيضًا **التعليقات السابقة** و**بيانات سير العمل**. توفر التعليقات السياق لكنها لا تستبدل إجراء الموافقة. ## إرسال إجراء موافقة 1. راجع تعليمات المهمة ومستنداتها. 2. افتح **إجراءات الموافقة**. 3. اختر إجراءً مما ضُبط للمهمة. تعتمد التسميات على سير العمل وقد لا تقتصر على موافقة ورفض. 4. أكمل أي تعليق أو حقل رفع مستند مطلوب. تعلّم الصفحة الحقول المطلوبة وتمنع الإرسال حتى اكتمالها. 5. راجع التأكيد وأرسل الإجراء. بعد الإرسال يتقدم سير العمل وفق العملية المضبوطة. لا يمكنك استخدام صفحة مهمة مستخدم آخر للتصرف نيابة عنه. ## فهم التعليقات السابقة تسرد **التعليقات السابقة** الرسائل المتبادلة بين مستويات المهمة. اقرأ الكاتب والوقت والرسالة قبل التصرف. إذا نقصت المعلومات، فاستخدم عملية الاتصال المعتمدة في مؤسستك بدلًا من إضافة تحديث حالة غير مرتبط. ## مراجعة ملف PDF أو إضافة علامات اختر **فتح عارض PDF بأدوات التوقيع** عند ظهوره. قد يوفر العارض تعليقات نصية ورسومًا حرة وتوقيعًا مرئيًا تضعه على الملف. وقد تسمح المهمة أيضًا بـ**رفع إصدار جديد** عند ضرورة استبدال المستند. قد ينشئ الحفظ أو الإرسال من المهمة إصدارًا جديدًا للمستند، فتظل النسخة الأصلية في سجل الإصدارات. هذه علامات مراجعة مرئية؛ لا تصفها كتوقيع رقمي تشفيري أو قائم على شهادة إلا إذا كانت مؤسستك قد ضبطت تلك الإمكانية وتحققت منها مستقلًا. لجميع عناصر العارض، راجع [استخدام عارض PDF وأدوات الرسم والتوقيع](https://raptix.app/user-guide/ar/50-applications/50-31-pdf-viewer-signature-tools/). ## استكشاف الأخطاء وإصلاحها **فتح إجراء المهمة مفقود.** قد تكون المهمة مكتملة أو مسندة إلى حساب آخر أو غير نشطة بعد. تحقق من **مهامي** وحالة العملية. **لا يفتح ملف PDF.** عُد إلى المهمة وحدّث وحاول المستند مجددًا. إذا ظل يفشل، فسجل معرّف المثيل واسم الملف للدعم. ## أدلة ذات صلة - [مراجعة مثيل سير عمل وحالة عمليته](https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/) - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) - [استخدام عارض PDF وأدوات الرسم والتوقيع](https://raptix.app/user-guide/ar/50-applications/50-31-pdf-viewer-signature-tools/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-20-app-builder-automation-governance/ # حوكمة أتمتة منشئ التطبيقات بأمان > **الوحدة:** التطبيقات / منشئ التطبيقات > > **الجمهور:** منشئو التطبيقات ومسؤولو عمليات سير العمل ومسؤولو المنصة > > **الوصول المطلوب:** وصول Enterprise إلى منشئ التطبيقات وصلاحية تغيير الصفحة الهدف > > **ستتعلم:** الأتمتة المدعومة من أدوات الإنشاء الظاهرة، ومتى يجب أن يتولى المسؤول المهمة. لا يحتاج المستخدمون العاديون إلى تحرير كود الصفحة أو استدعاء API لربط صفحة تطبيق بسير عمل. استخدم عناصر التكامل الظاهرة في **منشئ التدفق** وراجع النتيجة في **منشئ التطبيقات**. ## استخدام المسار المرئي المدعوم - لنموذج بدء سير العمل، اضبط خطوة **البدء** واختر صفحة منشئ التطبيقات الهدف. - لمهمة مسندة، اضبط خطوة **المهمة** واختر الصفحة المستخدمة لإكمالها. - بعد الحفظ، حدّث الصفحة في منشئ التطبيقات، وراجع الاتصالات المنشأة، واختبر ببيانات غير إنتاجية. - أعد نشر الاتصال بعد إعادة تسمية أداة مشاركة في سير العمل أو إضافتها أو إزالتها. ## حماية الصفحات الحية - تأكد من مساحة العمل والتطبيق والصفحة قبل حفظ الاتصال. - استخدم صفحة اختبار أو نسخة عند تغيير تطبيق إنتاجي. - راجع تغييرات الصفحة غير المنشورة وغير المرتبطة أولًا، لأن النشر قد ينشرها مع التكامل. - نسّق مع المنشئين الآخرين، وأبقِ بيانات اعتماد التكامل خارج لقطات الشاشة والتذاكر والوثائق. - لا تحذف كائنات الصفحة أو روابطها المنشأة يدويًا؛ فقد يستبدلها نشر مستقبلي. ## الأتمتة التي يديرها المسؤول يُعد الفحص أو التعديل المباشر لإعداد منشئ التطبيقات مهمة إدارية متقدمة، وليس ميزة معروضة في واجهة التطبيقات. إذا لم يستطع التكامل المرئي تنفيذ تغيير مطلوب، فتوقف واطلب من مسؤول المنصة استخدام المرجع التقني الحالي وعملية ضبط التغيير. لا تنسخ أمثلة نقاط نهاية أو برامج نصية قديمة إلى مساحة عمل حية. ## أدلة ذات صلة - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [ضبط أدوات منشئ التطبيقات لسير عمل](https://raptix.app/user-guide/ar/50-applications/50-21-app-builder-widget-configuration/) - [حماية تكامل سير العمل مع منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-23-app-builder-integration-security/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-23-app-builder-integration-security/ # حماية تكامل سير العمل مع منشئ التطبيقات > **الوحدة:** التطبيقات / أمان منشئ التطبيقات > > **الجمهور:** منشئو التطبيقات ومسؤولو عمليات سير العمل ومسؤولو المنصة > > **الوصول المطلوب:** وصول Enterprise إلى منشئ التطبيقات؛ ويدير مسؤول المنصة إعداد بيانات الاعتماد > > **ستتعلم:** كيفية استخدام صفحة متصلة بأمان، وما يجب فعله بعد تغيير بيانات اعتماد التكامل. يدير مسؤول المنصة بيانات الاعتماد التي يستخدمها اتصال سير العمل مع منشئ التطبيقات. لا تُضبط من التطبيقات، ولا تستخدمها نماذج سير العمل الأصلية. ## قواعد السلامة - لا تضع بيانات اعتماد التكامل أبدًا في وثائق أو لقطات شاشة أو تذاكر أو سجلات أو تعليمات الصفحة. - استخدم صفحات منشئ التطبيقات المتصلة ضمن الجمهور الذي اعتمدته مؤسستك فقط. - استخدم نموذجًا أصليًا **خاصًا** لمدخلات الأعضاء الحساسة، أو نموذجًا **عامًا** خضع للمراجعة عندما يكون الوصول الخارجي مقصودًا. - لا تعامل خيار **طلب المصادقة** في اتصال صفحة منشأ كبديل لضوابط الوصول إلى مساحة العمل والصفحة. - راجع الصفحة بعد كل نشر لأن التغييرات المعلقة في منشئ التطبيقات قد تُنشر مع الاتصال. ## بعد تغيير بيانات الاعتماد 1. يحدد مسؤول المنصة كل صفحة في منشئ التطبيقات تستخدم اتصال سير عمل أو مهمة. 2. يفتح المنشئ كل خطوة بدء أو مهمة متأثرة ويحفظ اتصال الصفحة مجددًا. 3. حدّث الصفحة في منشئ التطبيقات. 4. اختبر النموذج أو المهمة ببيانات غير إنتاجية. 5. تأكد من بدء سير العمل أو اكتمال إجراء المهمة بنجاح. إذا أبلغت صفحة متصلة أن التكامل غير متاح أو ممنوع، فلا تلصق بيانات الاعتماد فيها. اطلب من مسؤول المنصة التحقق من الإعداد المُدار في الخادم، ثم أعد نشر الاتصال المتأثر. ## أدلة ذات صلة - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [اختيار الوصول الخاص أو العام لنموذج سير عمل](https://raptix.app/user-guide/ar/50-applications/50-14-configuring-auth-requirements/) - [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-24-troubleshooting-connection-errors/ # استكشاف أخطاء اتصال التطبيقات وإصلاحها > **الوحدة:** التطبيقات > > **الجمهور:** الأعضاء والمسؤولون > > **الوصول المطلوب:** حساب RAPTIX مسجل؛ ويلزم وصول المسؤول للتحقيق على مستوى الخدمة > > **ستتعلم:** كيفية التعافي من خطأ تحميل التطبيقات بملء الصفحة، وتمييزه عن قيود الوصول وأعطال الصفحات الفردية، والإبلاغ عن تفاصيل تشخيصية مفيدة. عندما لا تستطيع RAPTIX إكمال تحميل بيانات التطبيقات، تستبدل الواجهة المعتادة برسالة **تعذر تحميل التطبيقات** وزر **إعادة المحاولة**. قد تنتج الحالة عن انقطاع الشبكة أو انتهاء الجلسة أو عدم توفر إحدى تبعيات التطبيقات. وهي تختلف عن رسالة **الوصول مقيّد**. ## قبل أن تبدأ - أبقِ علامة التبويب التي تفشل مفتوحة حتى تسجل الوقت والحالة التي رأيتها. - لا تمسح جميع بيانات المتصفح كخطوة أولى؛ فقد يزيل ذلك سياق جلسة مفيدًا من دون إصلاح تعطل الخدمة. - إذا كانت الرسالة **الوصول مقيّد**، فاستخدم [استكشاف أخطاء الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) بدلًا من ذلك. ## التعافي من «تعذر تحميل التطبيقات» 1. اختر **إعادة المحاولة** مرة واحدة. يعيد ذلك تشغيل تحميل التطبيقات من دون مغادرة الصفحة. 2. إذا ظهر الرأس ومحتوى مساحة العمل المعتادان، فتابع العمل. 3. إذا عاد خطأ ملء الصفحة، فافتح منطقة أخرى مثل الصفحة الرئيسية في علامة منفصلة. 4. إذا فشلت مناطق RAPTIX الأخرى أيضًا أو أرسلتك إلى تسجيل الدخول، فأعد اتصالك وسجّل الدخول مجددًا. 5. إذا عملت المناطق الأخرى، فأعد تحميل علامة التطبيقات مرة واحدة. 6. إذا استمرت المشكلة، فسجّل الخروج ثم الدخول وافتح `/applications` مجددًا. 7. أبلغ المسؤول عن الفشل المتكرر مع: - الوقت التقريبي بالتوقيت العالمي أو المحلي. - اسم مساحة عمل RAPTIX. - ما إذا كانت الصفحة الرئيسية والمناطق الأخرى تعمل. - ما إذا غيرت **إعادة المحاولة** أو إعادة التحميل أو جلسة جديدة النتيجة. - نوع المتصفح والجهاز. لا تضمّن معاملات مصادقة أو كلمات مرور أو أسرار تكامل أو لقطات تحتوي على بيانات تطبيق حساسة. ## تمييز فشل الصفحة الكاملة عن المشكلات الأخرى | ما الذي تراه؟ | التصنيف | الخطوة التالية | |---|---|---| | **تعذر تحميل التطبيقات** مع **إعادة المحاولة** | فشل تحميل بيانات التطبيقات | اتبع خطوات التعافي أعلاه. | | **الوصول مقيّد** ولا توجد شبكة مساحات | وصول مستكشف التطبيقات مفقود | اتبع دليل الوصول. | | رأس التطبيقات طبيعي لكن لا توجد بطاقات مطابقة | نتيجة بحث فارغة أو مشكلة وصول مورد | امسح البحث، ثم اطلب من المسؤول مراجعة العنصر. | | تُحمّل بطاقات المساحة والصفحة لكن صفحة واحدة تفتح فارغة | مشكلة في الصفحة الهدف أو التسليم الموثّق | أعد فتح الصفحة واتبع دليل فتح الصفحات. | | تفتح صفحة عند تسجيل الدخول | مشكلة جلسة RAPTIX أو تسليم منشئ التطبيقات | تأكد من جلسة RAPTIX وافتحها مجددًا من التطبيقات. | ## عن شارة حالة الرأس قد تعرض مساحة Enterprise شارة لحالة خدمة البيانات بعد تحميل التطبيقات بنجاح. تعكس الشارة استجابة الخدمة الخلفية أثناء ذلك التحميل. - تؤكد الشارة السليمة الظاهرة نجاح الفحص في التحميل الحالي. - لا يثبت غيابها وجود عطل؛ فهي غير متاحة لكل باقة أو حالة. - عند فشل التحميل الأولي، تعرض RAPTIX خطأ ملء الصفحة بدلًا من شارة خطأ في الرأس. استخدم **إعادة المحاولة** ومراقبة الخدمة كدليل أساسي؛ ولا تشخّص الفشل من غياب الشارة وحده. ## تحقيق المسؤول 1. أعد إنتاج المشكلة مع مساحة العمل المتأثرة، ومع مستخدم ذي وصول مماثل عندما يكون ذلك آمنًا. 2. حدد نطاق الأثر: مستخدم واحد أو متصفح أو مساحة عمل أو باقة أو جميع مستخدمي التطبيقات. 3. تأكد من إمكانية الوصول إلى تطبيق RAPTIX وواجهات التطبيقات من البيئة المتأثرة. 4. تحقق من استجابات المصادقة والتفويض للجلسة. يتطلب فشل الجلسة وفشل تبعية التطبيقات إصلاحين مختلفين. 5. لمساحات Enterprise، تأكد من سلامة خدمة بيانات منشئ التطبيقات والعنوان الأساسي المضبوط وإمكانية وصول RAPTIX إليهما. 6. تحقق من تغييرات النشر والشهادة وDNS والوكيل والإعداد قرب أول وقت مبلغ عنه. 7. راجع مراقبة الخادم وسجلاته باستخدام وقت الطلب ومساحة العمل. قد تعرض سجلات نشاط التطبيقات آخر إجراءات ناجحة، لكنها لا تستبدل سجلات الخدمة. 8. بعد الإصلاح، استخدم **إعادة المحاولة** من الحساب المتأثر، وتأكد من تحميل المساحات والتطبيقات والصفحات وإجراءات الرأس المسموحة. ## صفحة فردية لا تفتح إذا كانت التطبيقات نفسها تُحمّل طبيعيًا لكن **فتح** ينتج صفحة فارغة أو طلب تسجيل أو خطأ هدف: 1. أغلق علامة الهدف أو نافذته. 2. تأكد من أن علامة التطبيقات ما زالت تملك جلسة نشطة. 3. اختر **فتح** مجددًا. 4. اسمح بالنوافذ المنبثقة وإعادة التوجيه لـ`https://.raptix.app` إذا حظرها المتصفح. 5. جرّب صفحة أخرى متاحة. إذا فشلت واحدة فقط، فأبلغ مالك التطبيق بأسماء مساحة العمل والتطبيق والصفحة. 6. إذا فشلت كل صفحات منشئ التطبيقات بينما تعمل نماذج RAPTIX القابلة للتشغيل، فأبلغ المسؤول بهذا الفرق. راجع [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/) لتدفق فتح الصفحة كاملًا. ## الأسئلة الشائعة **س: هل ينبغي أن أواصل اختيار «إعادة المحاولة»؟** لا. جرّب مرة واحدة، ثم تحقق من منطقة RAPTIX أخرى وأعد التحميل أو جدد جلستك. لا تضيف المحاولات السريعة المتكررة معلومات تشخيصية مفيدة. **س: يستطيع زميلي فتح التطبيقات. هل الخدمة سليمة؟** يضيّق ذلك نطاق المشكلة، لكنه لا يثبت سلامة كل مساحة أو مسار وصول أو جلسة متصفح. ضمّن المقارنة في تقريرك. **س: هل تستطيع سجلات النشاط إخباري بسبب فشل تحميل التطبيقات؟** ليس بصورة موثوقة. تسجل تفاعلات التطبيقات. استخدم سجلات المنصة والخدمة لمعرفة الفشل الأساسي. **س: هل ينبغي استخدام عنوان التطبيقات القديم؟** لا. استخدم المسار الأساسي `/applications` على نطاق مساحة عمل RAPTIX. ## أدلة ذات صلة - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [فتح صفحة تطبيق واستخدامها](https://raptix.app/user-guide/ar/50-applications/50-2-opening-viewing-app-page/) - [سجلات نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) - [استكشاف أخطاء الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/) - [إرشادات RAPTIX العامة للوصول المقيّد](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-25-troubleshooting-access-restricted/ # استكشاف أخطاء الوصول إلى التطبيقات وإصلاحها > **الوحدة:** التطبيقات > > **الجمهور:** الأعضاء والمسؤولون > > **الوصول المطلوب:** حساب RAPTIX مسجل؛ ويحتاج المسؤول إلى امتيازات إدارة وصول التطبيقات لتغيير المنح > > **ستتعلم:** كيفية التمييز بين فقدان وصول التطبيقات ومجموعة منح فارغة ومورد مخفي وحد باقة وإذن خاص بميزة. تستخدم التطبيقات طبقتي وصول. تتحكم الأولى في قدرتك على تصفح مستكشف التطبيقات، بينما تصفّي الثانية مساحات العمل والتطبيقات والصفحات والإجراءات المتاحة داخله. تُخفى معظم الموارد غير المتاحة بدلًا من عرضها كبطاقات مقفلة. ## قبل أن تبدأ - افتح المسار الأساسي `/applications` على `https://.raptix.app`. - امسح حقل البحث قبل استنتاج عدم توفر عنصر. - سجل مساحة العمل والتطبيق والصفحة والإجراء المطلوب بدقة. - إذا قالت الصفحة **تعذر تحميل التطبيقات**، فاتبع دليل الاتصال بدلًا من ذلك. ## يحل «الوصول مقيّد» محل مستكشف مساحات العمل **ما تراه:** يفتح غلاف التطبيقات، لكن منطقة المحتوى تعرض **الوصول مقيّد** و**لا تملك إذن عرض مساحات العمل**. **ما يعنيه:** يستطيع حسابك الوصول إلى الغلاف المشترك عبر إمكانية أخرى، لكنه لا يملك وصول مستكشف التطبيقات المطلوب لتصفح المساحات. **إجراء العضو:** اطلب من المسؤول وصول التطبيقات. ضمّن مساحة العمل أو التطبيق الذي تحتاجه في النهاية كي ينشئ المسؤول منحة المورد الصحيحة أيضًا. **فحص المسؤول:** تأكد من أن دور المستخدم الفعلي يشمل وصول التطبيقات، ثم راجع منح التطبيقات. لا تحل المشكلة بمشاركة حساب آخر أو رابط موثّق. ## تُحمّل التطبيقات لكن لا تظهر مساحات عمل **ما تراه:** يظهر رأس التطبيقات الطبيعي، لكن المحتوى يقول **لم يُعثر على مساحات عمل** أو **لا توجد مساحات عمل متاحة**. **ما قد يعنيه:** - البحث الحالي لا يطابق مساحة متاحة. - يملك المستخدم وصول المستكشف لكن لا منحة عرض تكشف مساحة أو تطبيقًا أو صفحة. - لا تملك المؤسسة محتوى مساحة متاحًا لهذا الحساب. **إجراء العضو:** امسح البحث. إذا ظلت القائمة فارغة، فاطلب عرض المورد المطلوب. **فحص المسؤول:** راجع منح المستخدم المباشرة ومنح الأدوار. ينبغي أن تكشف منحة تطبيق أو صفحة مسارها الأعلى للتنقل؛ ولا يحتاج المستخدم إلى منحة عامة غير مقيدة للوصول إلى عنصر واحد. ## مساحة عمل أو تطبيق أو صفحة مفقودة لا ترسم RAPTIX عناصر نائبة للموارد التي لا يستطيع المستخدم عرضها. طابق العنصر المفقود مع أضيق طلب مفيد: | العنصر المفقود | الطلب | فحص المسؤول | |---|---|---| | مساحة العمل | عرض المساحة أو مورد تابع داخلها | منح المساحة والموارد التابعة | | تطبيق داخل مساحة ظاهرة | عرض التطبيق أو صفحة داخله | منح التطبيق والصفحات | | صفحة داخل تطبيق ظاهر | عرض الصفحة | منحة الصفحة وربط المورد الأعلى | | نموذج سير عمل قابل للتشغيل | وصول إلى تطبيق النموذج مع نموذج نشط ومنشور | نشر سير العمل ونطاقه ووصوله | تتوسع منحة العرض في نطاق أعلى إلى موارده التابعة. وينبغي أن تكشف منحة الصفحة فقط المسار الأعلى المطلوب للوصول إليها، لا كل الصفحات الشقيقة. ## إجراء مفقود تخضع إجراءات التطبيقات لبوابات مستقلة. لا تعني رؤية المورد القدرة على تنفيذ كل إجراء عليه. | الإجراء المفقود | السبب الشائع | |---|---| | **تحرير** في صفحة منشئ التطبيقات | لا منحة تحرير فعلية، أو الباقة ليست Enterprise، أو لا عنوان تحرير للصفحة | | **تحرير** في سير عمل قابل للتشغيل | لا منحة تحرير تغطي نطاق سير العمل | | **منشئ التطبيقات** | الباقة ليست Enterprise، أو وصول الميزة متوقف، أو لا منحة منطبقة لفتح المنشئ | | **منشئ التدفق** | لم تُسند صلاحية منشئ التدفق | | **سير العمل** | لم تُسند صلاحية لوحة سير العمل | | **المستندات** | لم تُسند صلاحية المستندات | | **جديد** | لم تُسند صلاحية الإنشاء، أو لا يدعم المستوى الحالي الإنشاء | | **المزيد** | لم تُسند إجراءات إدارة التطبيقات | | رموز إعادة التسمية أو الحذف | لا يدير المستخدم مساحة العمل أو التطبيق، أو الحساب الحالي ليس مديره | اطلب الإمكانية المحددة المطلوبة للمهمة. تجنب طلب وصول المسؤول أو الوصول العام عندما تكفي منحة مقيدة. ## لا تحل تسميات «مشترك» و«خاص» محل منح RAPTIX قد تعرض بطاقة تطبيق منشئ التطبيقات **مشترك** أو **خاص**. هذه بيانات وصفية للتطبيق، وليست وعدًا بقدرة كل مستخدم RAPTIX على تصفحه أو تحريره. تظل RAPTIX تطبق منح المستكشف والموارد قبل عرض المساحات والتطبيقات والصفحات. لنماذج سير العمل القابلة للتشغيل إعداد **عام** أو **خاص** مستقل. يتحكم في رابط النموذج، بينما يظل التحرير والظهور في الكتالوج إمكانيتين منفصلتين. ## بعد تغييرات الوصول 1. عُد إلى `/applications` أو أعد تحميل علامة التطبيقات. 2. امسح أي نص بحث. 3. انتقل من مساحات العمل إلى العنصر الهدف مجددًا. 4. إذا تغير إسناد دور وبقيت الحالة القديمة، فسجّل الخروج والدخول لتحديث الجلسة. 5. إذا ظل العنصر غير متاح، فاطلب من المسؤول التحقق من المنحة والطرف والنطاق والإمكانية المحفوظة بدلًا من إنشاء منح مكررة عشوائيًا. ## الأسئلة الشائعة **س: لماذا أرى المورد الأعلى لكن لا أرى كل موارده التابعة؟** تكشف منحة مورد تابع قدرًا كافيًا من التسلسل الأعلى للتنقل من دون منح الموارد الشقيقة. هذا متوقع في وصول أقل الامتيازات. **س: لماذا اختفى «تحرير» بعد أن كان يعمل؟** قد تكون منحة التحرير أو استحقاق الباقة أو عنوان تحرير الصفحة أو إسناد الدور تغير. اطلب من المسؤول فحص العناصر الأربعة لا وصول العرض وحده. **س: لماذا أستطيع فتح سير العمل داخل التطبيقات لكن لا أستطيع فتح مساحات العمل؟** سير العمل ومستكشف التطبيقات إمكانيتان منفصلتان داخل الغلاف المشترك. اطلب وصول المستكشف إذا كنت تحتاج أيضًا إلى تسلسل المساحات. **س: هل يستطيع المسؤول إرسال عنوان صفحته إليّ؟** يمكنه إرسال موقع مورد أساسي، لكن RAPTIX تقيّم جلستك ومنحك أنت. لا تعد استخدام عنوان موثّق أو حساب شخص آخر. ## أدلة ذات صلة - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) - [التحكم في الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [شرح نطاقات الأذونات](https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/) - [منح الوصول إلى دور أو مستخدم](https://raptix.app/user-guide/ar/50-applications/50-7-granting-role-vs-user/) - [إدارة المنح النشطة](https://raptix.app/user-guide/ar/50-applications/50-8-managing-active-grants/) - [استكشاف أخطاء اتصال التطبيقات وإصلاحها](https://raptix.app/user-guide/ar/50-applications/50-24-troubleshooting-connection-errors/) - [إرشادات RAPTIX العامة للوصول المقيّد](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/ # استخدام سير العمل: كل المثيلات ومهامي > **الوحدة:** التطبيقات ← **سير العمل** > > **الجمهور:** الأعضاء والمديرون ومالكو عمليات سير العمل > > **الوصول المطلوب:** صلاحية سير العمل في التطبيقات. تعتمد علامات التبويب الظاهرة على دورك. > > **ستتعلم:** كيفية العثور على كل تشغيل لسير العمل، والانتقال إلى المهام التي تحتاج إلى إجراء منك، وفتح شاشة التفاصيل الصحيحة. ## ما الغرض من «سير العمل»؟ افتح **التطبيقات** ثم اختر **سير العمل**. هذه هي مساحة سير العمل الحالية، وتحتوي على طريقتي عرض: | طريقة العرض | ما الذي تعرضه؟ | متى تستخدمها؟ | |---|---|---| | **كل المثيلات** | عمليات تشغيل سير العمل المسموح لك بمراقبتها | عندما تحتاج إلى التحقق من التقدم أو الحالة أو التواريخ أو تشغيل مكتمل. | | **مهامي** | المهام المسندة إليك حاليًا | عندما تحتاج إلى مراجعة عمل أو الموافقة عليه أو رفضه أو إكماله. | **المثيل** هو تشغيل واحد لسير العمل. لذلك يمكن أن يكون لقالب واحد عدة مثيلات. ## قبل أن تبدأ - افتح `/applications?view=workflows`. - إذا رأيت علامة واحدة فقط، فحسابك يملك الوصول إلى تلك الطريقة وحدها. - استخدم اسم سير العمل أو مقدم الطلب أو **معرّف المثيل** عندما تحتاج إلى تحديد تشغيل بعينه. ## مراقبة سير العمل في «كل المثيلات» 1. اختر **كل المثيلات**. 2. استخدم البحث والعوامل المتاحة لتضييق القائمة. 3. تحقق من اسم سير العمل وحالته الحالية وتقدمه ووقت آخر تحديث. 4. افتح المثيل المطلوب. تفتح **كل المثيلات** صفحة المراقبة في `/workflow-detail-view?...`. استخدم **كل المثيلات** للمراقبة. ولا يعني ذلك أن كل إجراء في سير العمل مسند إليك. ## تنفيذ العمل في «مهامي» 1. اختر **مهامي**. 2. ابحث عن مهمة بحالة تتطلب إجراء منك. 3. افتح المهمة أو مثيل سير العمل الخاص بها. 4. تفتح صفحة التفاصيل الموجهة للمهمة في `/workflow-detail?...`، وتعرض **سير عمل الموافقة** و**حالة العملية**. 5. اختر **فتح إجراء المهمة** عند توفره. 6. أكمل الإجراء في **مدير مهام سير العمل**. تظل المهام المكتملة جزءًا من سجل سير العمل، لكنها لا تتطلب إجراء منك بعد الآن. ## لا تخلط بين صفحتي التفاصيل | موضع الفتح | الصفحة | الغرض الرئيسي | |---|---|---| | **كل المثيلات** | `/workflow-detail-view?...` | مراقبة التشغيل كاملًا وتقدمه وسجله وملفاته وتصميم سير العمل. | | **مهامي** | `/workflow-detail?...` | فهم مسار الموافقة وفتح الإجراء المسند إليك. | قد يظهر معرّف المثيل نفسه في الصفحتين، لكن العناصر تختلف لأن إحداهما للمراقبة والأخرى لإكمال العمل. ## أدلة ذات صلة - [مراجعة مثيل سير عمل وحالة عمليته](https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/) - [إكمال مهمة موافقة ومراجعة ملف PDF](https://raptix.app/user-guide/ar/50-applications/50-28-completing-approval-tasks/) - [البدء باستخدام التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-1-getting-started-applications/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/ # مراجعة مثيل سير عمل وحالة عمليته > **الوحدة:** التطبيقات ← سير العمل > > **الجمهور:** الأعضاء والمديرون ومالكو عمليات سير العمل > > **الوصول المطلوب:** الوصول إلى مثيل سير العمل المحدد > > **ستتعلم:** كيفية قراءة طريقة التفاصيل من دون الخلط بين حالة سير العمل وحالة المهمة وخطوات العملية. ## فتح صفحة التفاصيل الصحيحة توجد صفحتا تفاصيل مترابطتان: - تفتح طريقة المراقبة من **كل المثيلات** في `/workflow-detail-view?...`. - تفتح الطريقة الموجهة للمهمة من **مهامي** في `/workflow-detail?...`. لا تحرر المعرّف في شريط العنوان. افتح المثيل أو المهمة من قائمته كي تحمل RAPTIX السياق وفحوص الوصول الصحيحة. ## قراءة ملخص الحالة يعرض أعلى الصفحة اسم سير العمل و**حالة سير العمل** و**معرّف المثيل** والتقدم وأحدث تحديث. تصف هذه القيم التشغيل كاملًا. | العنصر | المعنى | |---|---| | **حالة سير العمل** | الحالة العامة، مثل قيد الانتظار أو قيد التقدم أو مكتمل أو مرفوض أو ملغى. | | **معرّف المثيل** | معرّف فريد لهذا التشغيل، مثل `wf_e65f1e24891f`. شاركه مع المسؤول عند الإبلاغ عن مشكلة. | | **التقدم** | خطوات سير العمل المكتملة مقارنة بإجمالي الخطوات. | | **حالة العملية** | الخطوة الحالية والتالية المتوقعة والمسند إليه الحالي عند انطباقه. | | **آخر تحديث** | أحدث نشاط مسجل للمثيل. | لا تعتمد على اللون وحده؛ اقرأ كلمة الحالة ومعلومات الخطوة. ## استخدام «سير عمل الموافقة» و«حالة العملية» في تفاصيل المهمة تفصل صفحة `/workflow-detail?...` بين علامتين مفيدتين: - تعرض **سير عمل الموافقة** مسار الموافقة وحالة كل خطوة. - تعرض **حالة العملية** الخطوات الحالية والمكتملة، ومنها تسلسل مرقم مثل **1 من خطوتين** والمسند إليه التالي إن وجد. يعني اكتمال الخطوة الأولى وانتظار الثانية أن العملية ما زالت تملك عملًا، حتى إذا بدا ملخص قديم في موضع آخر مكتملًا. حدّث مرة واحدة واستخدم الخطوات المرقمة والمسند إليه الحالي كطريقة التشغيل الفورية؛ وأبلغ عن القيم المتناقضة مع معرّف المثيل. ## فحص تفاصيل المثيل وسجله في `/workflow-detail-view?...`، راجع **تفاصيل المثيل** لمعرفة المنشئ ووقت الإنشاء والمدة والحالة. استخدم **سجل المحادثة** للرسائل بين مستويات المهمة و**الخط الزمني والحالة** لاسم سير العمل وآخر تحديث ووقت الإكمال وآخر نشاط. هذه الأقسام سجل تدقيق ولا تغير سير العمل. قد يعرض ملخص المراقبة أيضًا إجمالي الخطوات والمكتملة ونسبة التقدم والخطوة الحالية والمسند إليه التالي. يظهر قسم أخطاء عندما يسجل التشغيل فشل معالجة. يوفر قسم **عارض سير العمل**: - **عرض سير العمل** لفتح التصميم المرئي كمرجع عندما تملك الوصول. - **تنزيل الملفات** لتنزيل الملفات المرتبطة بالمثيل. ## اتخاذ إجراء عند الحاجة في `/workflow-detail?...`، يحدد **إجراء مهمة مطلوب** المسند إليه ويوفر **فتح إجراء المهمة**. لا تستخدمه إلا لمهمة مسندة إليك. إذا كان المسند إليه شخصًا آخر، فاستخدم صفحة التفاصيل لفهم التقدم فقط. ## استكشاف الأخطاء وإصلاحها **لم يُعثر على معرّف المثيل.** عُد إلى **كل المثيلات** وامسح العوامل وافتحه من القائمة. تأكد من نسخ المعرّف كاملًا. **تبدو الخطوة التالية غير متسقة مع «مكتمل».** حدّث التفاصيل. إذا استمرت، فأبلغ مالك سير العمل بالمعرّف وأسماء الخطوات الظاهرة. ## أدلة ذات صلة - [استخدام سير العمل: كل المثيلات ومهامي](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) - [إكمال مهمة موافقة ومراجعة ملف PDF](https://raptix.app/user-guide/ar/50-applications/50-28-completing-approval-tasks/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-33-create-workflow-from-application/ # إنشاء سير عمل من تطبيق > **الوحدة:** التطبيقات ← التطبيق ← الصفحات > > **الجمهور:** منشئو عمليات سير العمل > > **الوصول المطلوب:** وصول منشئ التدفق لمساحة العمل والتطبيق المحددين > > **ستتعلم:** كيفية إنشاء أول سير عمل في تطبيق، أو بنائه من وصف، أو المتابعة عبر نموذج التفاصيل. عندما لا تحتوي علامة **الصفحات** في تطبيق على صفحات أو عمليات سير عمل، تعرض التطبيقات **إنشاء أول سير عمل لك**. يوضع سير العمل الجديد تلقائيًا في مساحة العمل والتطبيق اللذين تعرضهما. ## البناء من وصف 1. افتح **التطبيقات** ثم اختر مساحة العمل والتطبيق. 2. اختر **إنشاء أول سير عمل لك** في علامة **الصفحات** الفارغة. 3. صف النتيجة بجملة واحدة في **ماذا ينبغي أن يفعل سير العمل هذا؟**. يمكنك اختيار مثال وتحريره. 4. راجع **الاسم** المنشأ وغيّره عند الحاجة. 5. اختر **أنشئه**، أو اضغط Ctrl+Enter على Windows/Linux أو Command+Enter على macOS. 6. يفتح منشئ التدفق سير العمل الجديد النشط ويستخدم وصفك كأول تعليمات بناء. 7. راجع كل خطوة مقترحة، واضبط الإسنادات والاتصالات، واختبر سير العمل واحفظه قبل نشر نموذج. يبدأ سير العمل عند الإصدار 1.0 في التطبيق المحدد. إذا كان الاسم مستخدمًا أو فشل الإنشاء، يحتفظ مربع الحوار بالوصف ويعرض خطأ كي تختار اسمًا آخر وتحاول مجددًا. ## البدء من الصفر اختر **البدء من الصفر** عندما تريد إدخال بيانات سير العمل بنفسك. تفتح RAPTIX `/workflow-metadata?mode=create` مع تحديد مساحة العمل والتطبيق الحاليين مسبقًا. يمكنك هناك ضبط الاسم والوصف والحالة قبل الانتقال إلى منشئ التدفق. يجب أن تكون أسماء عمليات سير العمل فريدة في نطاقها. لإجراء البيانات والنسخ الكامل، راجع [إنشاء سير عمل ونسخه](https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/). ## بعد الإنشاء - استخدم **منشئ التدفق** لتصميم سير العمل وضبطه. - استخدم **سير العمل ← كل المثيلات** لمراقبة عمليات التشغيل. - استخدم **سير العمل ← مهامي** للعمل المسند إليك. - استخدم علامة **عمليات سير العمل** للتطبيق لإبقاء اللوحة مقيدة به. - استخدم **المستندات** عندما ينشئ نموذج أو مهمة ملفات أو يرفعها. ## أدلة ذات صلة - [استخدام سير العمل: كل المثيلات ومهامي](https://raptix.app/user-guide/ar/50-applications/50-26-workflow-dashboard/) - [نشر نموذج سير عمل وتشغيله من التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-22-triggering-workflows-from-applications/) - [استخدام شاشة إدارة عمليات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-2-workflow-management-screen/) - [استخدام قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [إنشاء سير عمل ونسخه](https://raptix.app/user-guide/ar/10-workflows/10-31-create-duplicate-workflow/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/ # إدارة المستندات في التطبيقات > **الوحدة:** التطبيقات ← المستندات > > **الجمهور:** الأعضاء القادرون على عرض المستندات أو إدارتها > > **الوصول المطلوب:** صلاحية المستندات في التطبيقات؛ وتعتمد عناصر الرفع والمجلد والتنزيل والحذف على أذوناتك. > > **ستتعلم:** كيفية تصفح مساحات المستندات والبحث في الملفات وفرزها وتبديل طرق العرض ومعاينة العناصر وتنظيمها واستخدام الإجراءات المجمعة وإزالة المحتوى بأمان. ## فتح المستندات افتح `/applications?view=documents` أو اختر **المستندات** من التطبيقات. تعرض الصفحة تسلسل المستندات لمساحات العمل التي تستطيع الوصول إليها. استخدم مساحة العمل والمجلد الحاليين قبل إنشاء أي شيء أو رفعه. ## إضافة ملف أو مجلد 1. انتقل إلى المجلد الوجهة. 2. اختر **جديد**. 3. اختر **رفع ملف** لإضافة ملف إلى المجلد الحالي، أو **إنشاء مجلد** لإنشاء مجلد في الموقع الحالي. 4. عند إنشاء مجلد، أدخل اسمه واختر **لون المجلد** الأولي. 5. أكمل مربع الحوار وانتظر تحديث القائمة. إذا لم يظهر **جديد**، فلديك وصول عرض فقط أو لا يسمح الموقع الحالي بالإجراء. ## العثور على العناصر وتنظيمها استخدم البحث لمطابقة اسم عنصر في النطاق الحالي. افرز حسب **الاسم** أو **التاريخ** أو **الحجم**، ثم اختر الترتيب التصاعدي أو التنازلي. توضع العناصر المفضلة أولًا كي يسهل الوصول إلى المحتوى المستخدم باستمرار. استخدم **مسطح** للبحث عبر الملفات المتاحة من دون فتح كل مجلد، أو **مجلدات** للعودة إلى التسلسل. بدّل بين **شبكة** و**قائمة** من دون تغيير المحتوى أو الموقع. تساعدك مجموعات مساحة العمل والتطبيق والصفحة الافتراضية في التنقل في تسلسل المنتج، لكنها ليست مجلدات عادية يمكن دائمًا إعادة تسميتها أو حذفها. قد تعرض بطاقات الملفات وصفوفها الحجم وتاريخ التعديل والرافع وتسمية إصدار عند وجود أكثر من إصدار. افتح ملفًا مدعومًا لمعاينته؛ وتوفر ملفات ZIP والصيغ غير المدعومة تنزيلًا من دون معاينة. وعندما تسمح الأذونات، تشمل إجراءات الملف **عرض** و**تنزيل** و**إعادة تسمية** و**حذف** والإضافة إلى المفضلة أو إزالتها و**الأذونات**. قد تشمل إجراءات المجلد **الأذونات** و**تغيير اللون** و**إعادة تسمية** و**حذف** والتنزيل كملف ZIP. يظهر لون المجلد لكل من يستطيع تصفح الموقع؛ اختر **استخدام الافتراضي** لإزالة لون مخصص. تمثل عناصر مساحة العمل والتطبيق والصفحة مجموعات منتج، ولذلك لا تظهر لها إجراءات إعادة التسمية أو اللون أو الحذف أو أذونات المجلد. وقد توفر مجموعة Enterprise في منشئ التطبيقات أيضًا **فتح في منشئ التطبيقات**. | عنصر التحكم | ما الذي يفعله؟ | |---|---| | **تنزيل** | ينزل المجلدات المحددة ومحتوياتها كملف ZIP. | | **تحديد الكل** / **إلغاء تحديد الكل** | يحدد المجلدات القابلة للتحديد في العرض الحالي أو يمسحها. لا تدخل الملفات الفردية في هذا التحديد المجمع. | | **حذف (العدد)** | يحذف المجلدات المحددة وجميع مستنداتها نهائيًا بعد التأكيد. لا يمكن التراجع. | يعتمد سلوك الحذف على العنصر: - ينقل **حذف** ملفًا منفردًا إلى سلة المهملات حيث يمكن استعادته. - يحذف **حذف المجلد** المجلد وكل مستند داخله نهائيًا. - يحذف **حذف (العدد)** المجمع كل مجلد محدد ومحتوياته نهائيًا. اقرأ التأكيد كل مرة. لا تستطيع سلة المهملات استعادة مجلد أو تحديد مجمع يصفه التأكيد بأنه نهائي. ## فهم حالات الصفحة - تعني رسالة التحميل أو الهيكل أن المجلد الحالي ما زال قيد الجلب. - قد تعني الحالة الفارغة عدم وجود عناصر أو عدم تطابق البحث أو عدم وجود مستندات في نطاقك؛ امسح البحث قبل طلب الوصول. - إذا غاب إجراء، فلا يسمح به دورك أو الموقع الافتراضي الحالي. - إذا أبلغت الصفحة عن خطأ، فأعد المحاولة مرة واحدة من دون تكرار رفع أو حذف ربما اكتمل بالفعل. ## أدلة ذات صلة - [استخدام أذونات المستندات وسجلاتها ومعالجتها وسلة المهملات](https://raptix.app/user-guide/ar/50-applications/50-30-document-administration/) - [إكمال مهمة موافقة ومراجعة ملف PDF](https://raptix.app/user-guide/ar/50-applications/50-28-completing-approval-tasks/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-30-document-administration/ # استخدام أذونات المستندات وسجلاتها ومعالجتها وسلة المهملات > **الوحدة:** التطبيقات ← المستندات ← المزيد > > **الجمهور:** مديرو المستندات والمسؤولون > > **الوصول المطلوب:** يجب إسناد الإجراء الإداري الموافق إلى دورك. > > **ستتعلم:** أين تدير وصول المستندات وتراجع النشاط وتعالج المستندات وتستعيد الملفات المحذوفة. ## اختيار قائمة «المزيد» الصحيحة زر **المزيد** في رأس التطبيقات الرئيسي عام وقد يرتبط بـ**الأذونات** و**السجلات** و**معالجة المستندات**. بعد فتح **المستندات**، قد تتضمن قائمة **المزيد** الداخلية العناصر الخاصة بها: **الأذونات** و**السجلات** و**معالجة المستندات** و**سلة المهملات**. لا تظهر إلا الإجراءات المتاحة لدورك. لا تستخدم عنوانًا مباشرًا لتجاوز إجراء مفقود. | الوجهة | المسار الحالي | الغرض | |---|---|---| | **الأذونات** | `/documents/permission` | إدارة وصول المستندات. | | **السجلات** | `/documents/logs` | مراجعة نشاط تدقيق المستندات. | | **معالجة المستندات** | `/process-documents` | فتح **إدارة المستندات** لمساحة المعالجة. | | **سلة المهملات** | `/documents/trash` | عرض الملفات المحذوفة واستعادتها إلى مواقعها الأصلية. | ## إدارة وصول المستندات افتح **الأذونات** لمنح الوصول أو مراجعته في نطاق المستند الذي تعرضه الصفحة. طبّق أضيق وصول يفي بحاجة الشخص، ثم تحقق من النتيجة معه. التحكم بوصول التطبيقات في `/applications/permission` صفحة مستقلة لمساحات العمل والتطبيقات والصفحات. ## مراجعة السجلات افتح **السجلات** للتحقيق في نشاط المستند. استخدم اسم العنصر والمنفذ والتاريخ و**معرّف المثيل** عند توفره لتحديد الحدث. تشرح السجلات ما حدث، لكنها لا تستعيد ملفًا ولا تغيره. ## معالجة المستندات اختر **معالجة المستندات** لفتح **إدارة المستندات** في `/process-documents`. يعرض العدد والجدول المستندات المتاحة حاليًا لمساحة المعالجة. لا يرى المسؤولون **إعادة إسناد المستندات** إلا عندما يكتشف النظام مجلدات قديمة أو غير مسندة تحتاج إلى موقع مساحة عمل. إذا غاب العنصر، فلا يوجد شيء مؤهل. راجع [إعادة إسناد المستندات غير المصنفة إلى تطبيق](https://raptix.app/user-guide/ar/50-applications/50-32-reassign-documents/) للإجراء الكامل. ## الاستعادة من سلة المهملات 1. افتح **سلة المهملات**. 2. ابحث باسم الملف أو الموقع أو الشخص عندما تطول القائمة. امسح البحث للعودة إلى جميع الملفات المحذوفة. 3. راجع اسم الملف وموقع مساحة العمل والتطبيق والصفحة الأصلي والرافع وتاريخ الحذف والحجم. 4. اختر **استعادة** في الملف المطلوب. 5. تحقق من رسالة النجاح ومن توفر الموقع الأصلي بعد الاستعادة. يعرض رأس السلة عدد الملفات المحذوفة. استخدم **تحديث** بعد تغيير مسؤول آخر القائمة. تعيد الاستعادة الملف إلى موقعه الأصلي ولا تمنح المستخدم وصولًا جديدًا إليه. تستعيد الصفحة الحالية ملفات منفردة ولا تعرض إجراء حذف نهائي. ## أدلة ذات صلة - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) - [إعادة إسناد المستندات غير المصنفة إلى تطبيق](https://raptix.app/user-guide/ar/50-applications/50-32-reassign-documents/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [مراجعة نشاط التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-9-applications-activity-logs/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-31-pdf-viewer-signature-tools/ # استخدام عارض PDF وأدوات الرسم والتوقيع > **الوحدة:** مدير مهام سير العمل ← عارض PDF > > **الجمهور:** الأعضاء الذين يراجعون ملف PDF في مهمة مسندة > > **الوصول المطلوب:** الوصول إلى المهمة ومستندها؛ وتعتمد عناصر التحرير على إعداد المهمة > > **ستتعلم:** كيفية مراجعة PDF وإضافة علامات أو توقيع مرئي ورفع إصدار بديل وإكمال إجراء المهمة المضبوط. ## فتح العارض في السياق الصحيح من **التطبيقات ← سير العمل ← مهامي**، افتح المهمة واختر **فتح إجراء المهمة**. وفي **مدير مهام سير العمل**، اختر **فتح عارض PDF بأدوات التوقيع**. يفتح ذلك `/pdf-viewer-simple?...` بسياق سير العمل والمهمة المطلوب للإجراءات ومعالجة الإصدارات. قد يؤدي فتح المسار نفسه من دون سياق المهمة إلى عرض مستند للقراءة فقط ورسالة تعيدك إلى مدير المهام. ## مراجعة المستند استخدم التنقل بين الصفحات والتكبير لفحص كل صفحة مهمة. وفق المتصفح والمستند، قد يفتح **عرض في المتصفح** أو **فتح** الملف الأصلي. تحدد معلومات الإصدار النسخة قيد المراجعة. قد تشمل لوحات المهمة المحيطة: - **تفاصيل المهمة** للإسناد والتعليمات؛ - المستندات أو المرفقات المطلوبة؛ - **التعليقات السابقة** للمحادثة بين مستويات المهمة؛ - **بيانات سير العمل** للقيم التي يحملها؛ و - **إجراءات المهمة** للنتيجة المسموح لك بإرسالها. ## إضافة تعليقات أو توقيع مرئي عند التفعيل، استخدم شريط تعليقات PDF لإضافة نص أو حبر/رسم حر. تضع أداة التوقيع توقيعًا مرئيًا على الصفحة المختارة؛ فضعه بعناية قبل الحفظ. راجع كل علامة بحجم عادي كي لا تغطي محتوى مهمًا. تضيف هذه الأدوات تعليقات مرئية إلى PDF. ولا تشكل وحدها دليلًا على توقيع رقمي قائم على شهادة. ## رفع إصدار جديد أو حفظه لا يظهر **رفع إصدار جديد** إلا عندما تسمح المهمة باستبدال المستند. اختر الملف البديل الصحيح وتحقق من اسمه وحالة إصداره قبل المتابعة. قد تُحفظ التعليقات أو المستند المعلّم المرسل كإصدار جديد، فتظل الإصدارات السابقة في سجل المستند. ## إكمال إجراءات المهمة 1. اقرأ تعليمات المهمة والتعليقات السابقة. 2. راجع PDF وأضف العلامات المطلوبة فقط. 3. اختر الإجراء المضبوط ضمن **إجراءات المهمة**. 4. أكمل أي تعليق أو حقل مستند مطلوب. 5. راجع التأكيد ثم أرسل مرة واحدة. بعد الإرسال، عُد إلى **مهامي** أو صفحة تفاصيل سير العمل للتأكد من أن المهمة لم تعد تتطلب إجراء منك. ## استكشاف الأخطاء وإصلاحها **أدوات التعليق أو التوقيع مفقودة.** افتح PDF من مدير مهام سير العمل وتأكد من أن المهمة تسمح بالتحرير. لا تكشف المهمة المكتملة أو المعروضة للقراءة فقط العناصر نفسها. **رفع إصدار جديد مفقود.** لا تسمح المهمة الحالية باستبدال المستند. لا تحذف الملف الموجود للتحايل على القيد. **لا يمكن إرسال الإجراء.** تحقق من تعليق أو رفع أو تأكيد مطلوب لم يُكمل. ## أدلة ذات صلة - [إكمال مهمة موافقة ومراجعة ملف PDF](https://raptix.app/user-guide/ar/50-applications/50-28-completing-approval-tasks/) - [مراجعة مثيل سير عمل وحالة عمليته](https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/) - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-32-reassign-documents/ # إعادة إسناد المستندات غير المصنفة إلى تطبيق > **الوحدة:** التطبيقات ← المستندات ← معالجة المستندات > > **الجمهور:** المسؤولون عن مواقع المستندات > > **الوصول المطلوب:** وصول مسؤول ووصول إلى مساحة العمل والتطبيق الهدف > > **ستتعلم:** كيفية تحديد مجلدات مستندات غير مصنفة، واختيار مساحة عمل وتطبيق وصفحة اختيارية، وإعادة إسناد مجلد واحد أو الجميع، والتحقق من النجاح أو معالجة الأخطاء. ## متى تظهر هذه الصفحة؟ صفحة **إعادة إسناد المستندات** مخصصة لمجلدات المستندات القديمة التي لا تنتمي بعد إلى مساحة عمل. وليست أداة نقل عامة لكل مستند. لا يظهر الإجراء من **معالجة المستندات** إلا عندما تجد RAPTIX مجلدات غير مصنفة مؤهلة. إذا غاب الإجراء، فلا يوجد شيء ينتظر إعادة الإسناد. ## قبل أن تبدأ - تأكد من مساحة العمل والتطبيق الوجهة الصحيحين مع مالك المستند. - مساحة العمل والتطبيق مطلوبان، والصفحة اختيارية. - تغير إعادة الإسناد موقع ظهور المجلدات في التطبيقات، ولا تنشئ نسخة أخرى من كل ملف. - تجنب تنفيذ إعادة الإسناد نفسها في علامتي متصفح في الوقت نفسه. ## فتح إعادة إسناد المستندات 1. افتح **التطبيقات**. 2. افتح **المستندات**. 3. افتح **المزيد** ثم اختر **معالجة المستندات**. 4. اختر **إعادة إسناد المستندات**. تحمّل الصفحة جميع المجلدات غير المصنفة المؤهلة وتسلسل الوجهة المتاح. استخدم زر التحديث بجوار العنوان إذا تغيرت القائمة أثناء فتح الصفحة. ## اختيار الوجهة 1. اختر **مساحة عمل**. 2. اختر **تطبيقًا** داخلها. 3. اختر **صفحة** اختياريًا. إذا لم تختر صفحة، تعرض الصفحة **مستوى التطبيق (بلا صفحة)** وتُسند الملفات إلى مستوى التطبيق. يؤدي تغيير مساحة العمل إلى مسح التطبيق والصفحة المحددين، ويؤدي تغيير التطبيق إلى مسح الصفحة. راجع الحقول الثلاثة قبل الإرسال. تحمل مساحات العمل المخصصة للمستندات علامة **(مستندات)** في القائمة. ## تحديد المجلدات يحدد كل صف مجلدًا باستخدام قيم الكيان والمثيل والحقل المتاحة. ويعرض أيضًا عدد الملفات ومن رفعها عند توفره. - اختر صفًا لإضافة المجلد إلى التحديد. - اختره مجددًا لإزالته. - استخدم **تحديد الكل** لإضافة جميع المجلدات المؤهلة المحمّلة. - استخدم **إلغاء تحديد الكل** لمسح التحديد. يعرض الزر أسفل الصفحة العدد الحالي، مثل **إعادة إسناد المحدد (3)**. ## إعادة إسناد المجلدات المحددة 1. تأكد من مساحة العمل والتطبيق والصفحة الاختيارية الوجهة. 2. تأكد من عدد المجلدات المحددة. 3. اختر **إعادة إسناد المحدد**. 4. أبقِ الصفحة مفتوحة أثناء عرض **جارٍ إعادة الإسناد…**. بعد النجاح، تعرض RAPTIX **أعيد إسناد N مستند**، وتمسح التحديد وتحدث القائمة. تختفي المجلدات الناجحة من قائمة غير المصنفة. افتح **التطبيقات ← المستندات** وانتقل إلى الوجهة للتحقق من النتيجة. ## حالات الفراغ والأخطاء | الرسالة أو الحالة | المعنى | ما يجب فعله | |---|---|---| | **لا توجد مستندات غير مسندة — كل شيء مصنف ضمن مساحة عمل** | لا تحتاج أي مجلدات إلى إعادة الإسناد. | عُد إلى معالجة المستندات. | | **وصول المسؤول مطلوب** | لا يستطيع حسابك تنفيذ العملية. | اطلب من مسؤول مساحة العمل. | | **فشل تحميل المستندات غير المسندة** | تعذر جلب قائمة المجلدات أو التسلسل. | تحقق من الاتصال واستخدم تحديث. | | **فشلت إعادة الإسناد. حاول مجددًا** | تعذر تحديث الوجهة أو المجلدات. | حدّث وتأكد من بقاء المجلدات واختر الوجهة مجددًا وحاول. | | قائمة التطبيق معطلة | لم تُحدد مساحة عمل. | اختر مساحة أولًا. | | قائمة الصفحة معطلة | لم يُحدد تطبيق. | اختر تطبيقًا أولًا. | | زر إعادة الإسناد معطل | لا مجلدات محددة أو مساحة العمل والتطبيق المطلوبان مفقودان. | أكمل الوجهة وحدد مجلدًا واحدًا على الأقل. | ## إرشادات السلامة - لا تعد إسناد إلا المجلدات التي تفهم وجهتها العملية المقصودة. - استخدم صفحة فقط عندما تنتمي الملفات إليها تحديدًا؛ وإلا فأبقها على مستوى التطبيق. - بعد فشل جزئي، حدّث قبل إعادة المحاولة حتى لا تعمل على قائمة قديمة. - لا تمنح إعادة الإسناد المستخدمين وصولًا إلى الموقع الهدف. راجع أذونات التطبيقات والمستندات مستقلًا. ## أدلة ذات صلة - [استخدام أذونات المستندات وسجلاتها ومعالجتها وسلة المهملات](https://raptix.app/user-guide/ar/50-applications/50-30-document-administration/) - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [إدارة المستندات](https://raptix.app/user-guide/ar/20-documents/20-16-document-management/) --- URL: https://raptix.app/user-guide/ar/50-applications/50-34-custom-screens-actions-and-document-workspaces/ # إنشاء شاشات مخصصة بالبيانات وإجراءات سير العمل ومساحات عمل المستندات > **الوحدة:** التطبيقات > > **الجمهور:** منشئو التطبيقات ومشرفو مساحة العمل > > **الوصول المطلوب:** تتطلب الشاشات المخصصة وإمكانات منشئ التطبيقات المتقدمة خطة مؤهلة وصلاحيات البناء؛ ولا تتطلب مساحات العمل المخصصة للمستندات فقط شاشة مخصصة > > **ستتعلم:** كيف تختار سطح التطبيق المناسب، وتربط البيانات الظاهرة ومنطق الصفحة القابل لإعادة الاستخدام، وتبدأ مسارات سير العمل، وتكمل إجراءات المهام والاعتمادات من شاشة، وتستخدم مساحة عمل مستندات فقط عندما لا تحتاج إلى واجهة مخصصة. ## اختيار أبسط سطح مناسب يمكن أن تحتوي تطبيقات RAPTIX على عدة أنواع من أسطح العمل: | الاحتياج | أفضل نقطة بداية | |---|---| | جمع مجموعة محددة من القيم وبدء سير عمل | نموذج سير عمل | | إنشاء صفحة داخلية تفاعلية فوق بيانات مسموح بها | شاشة مخصصة في منشئ التطبيقات | | تنظيم الملفات وسياق العملية من دون صفحة مصممة خصيصًا | مساحة عمل تطبيق مخصصة للمستندات فقط | | السماح لشخص خارج مساحة العمل بإرسال معلومات | نموذج سير عمل عام مع وصول عام صريح | لا تلزم شاشة مخصصة لمجرد وضع مستندات داخل تطبيق. ابدأ بمساحة عمل للمستندات فقط عندما تكون المهمة حفظ ملفات العملية ومشاركتها ومراجعتها ومتابعتها؛ ولا تضف صفحة إلا عندما يحتاج المستخدمون إلى واجهة مصممة لغرض محدد. ## ربط شاشة مخصصة بالبيانات استخدم في منشئ التطبيقات الاستعلامات المدعومة وكائنات منطق الصفحة وأحداث الأدوات لاسترداد البيانات التي تحتاج إليها الصفحة فقط وعرضها. 1. عرّف الاستعلام أو مصدر البيانات المعتمد. 2. اربط النتيجة بجدول أو نموذج أو نص أو مخطط أو أداة أخرى مدعومة. 3. احتفظ بالتحويلات القابلة لإعادة الاستخدام وسلوك الصفحة في كائن المنطق الذي تدعمه الصفحة بدل تكرار التعبير نفسه عبر أدوات عدة. 4. اربط حدث أداة، مثل نقرة زر أو تحديد أو إرسال نموذج، بالاستعلام أو الإجراء المقصود. 5. اختبر حالات الفراغ والتحميل والنجاح ورفض الصلاحية والفشل. تعتمد عناصر التحكم المتاحة في المحرر على إصدار منشئ التطبيقات الحالي والخطة. لا تلصق أسرارًا في شفرة الصفحة، ولا تستخدم استعلامًا لتجاوز قواعد وصول RAPTIX. ## بدء سير عمل من زر ينبغي أن يوضح زر سير العمل العملية المقصودة ومدخلاتها. 1. اختر سير عمل نشطًا يدعم نوع مُشغّل الصفحة. 2. اربط قيم الصفحة أو الصف المحدد بالمدخلات المطلوبة. 3. سمِّ الزر بإجراء العمل، مثل **بدء مراجعة المورد (Start supplier review)**، بدلًا من **إرسال (Submit)** العام. 4. أضف تأكيدًا عندما ينشئ النقر عملًا ذا أثر. 5. اعرض مرجع المثيل المقبول أو خطأ قابلًا للتنفيذ بعد الطلب. ينبغي أن تنشئ النقرة الواحدة مثيلًا مقصودًا واحدًا. عطّل الإرسال المتكرر أثناء معالجة طلب البدء، ودع المستخدم يتحقق من الإيصال قبل إعادة المحاولة. ## إكمال إجراء مهمة من شاشة تربط **TaskActions** شاشة مخصصة بمهمة بشرية مسندة. بحسب تصميم المهمة، تستطيع الصفحة عرض سياقها وتوفير إجراءات خاصة بالمجال، مثل **اعتماد (Approve)** أو **طلب تعديلات (Request changes)** أو **رفض (Reject)**. يجب أن يحترم الإجراء متطلبات مدير المهام نفسها: - يجب أن يظل الشخص المسجّل دخوله مكلّفًا مؤهلًا؛ - يجب إكمال التعليقات أو الحقول أو الملفات أو قرارات الصفوف المطلوبة؛ - يجب أن تظل المهمة معلّقة؛ و - يجب أن يستخدم الإجراء سياق المهمة والمثيل الحاليين. إذا نفّذ مشارك مؤهل آخر الإجراء أولًا في مهمة مشتركة، فحدّث الصفحة واتبع النتيجة المسجلة بدلًا من إرسال قرار ثانٍ. ## استخدام جداول الاعتماد يستطيع جدول الاعتماد عرض القرارات على مستوى العناصر داخل شاشة مخصصة. أعدّ الصفوف الظاهرة والقرارات المسموح بها والتعليقات المطلوبة والربط مرة أخرى بسير العمل. قد تتطلب إمكانات العناصر المتقدمة أو الدفعات خطة مؤهلة. اختبر قبل النشر: - صفًا معتمدًا وآخر مرفوضًا؛ - التعليقات أو الملفات الداعمة المطلوبة؛ - الإكمال الجزئي ورسائل التحقق؛ - مهمة قديمة اكتملت بالفعل؛ و - ملخص سير العمل ومسار إعادة المحاولة. ## استخدام مساحة عمل للمستندات فقط أنشئ حاوية تطبيق أو اختر واحدة، ثم استخدم منطقة المستندات لتنظيم المجلدات والصلاحيات وملفات العملية والنشاط. يمنح ذلك الفريق سياق عمل مشتركًا من دون عرض صفحة منشئ تطبيقات فارغة أو غير ضرورية. يمكنك لاحقًا إرفاق نموذج سير عمل أو شاشة مخصصة من دون نقل سجل المستندات. تظل صلاحيات المستندات منفصلة عن صلاحية فتح صفحة تطبيق. ## النشر والتحقق من الوصول 1. عاين الصفحة ببيانات واقعية. 2. تحقق من منح التطبيق والصفحة للمستخدمين أو الأدوار المقصودة. 3. تحقق بصورة منفصلة من صلاحيات سير العمل والمهمة والمستند. 4. انشر الصفحة. 5. اختبر كعضو عادي، لا كمشرف فقط. 6. اختبر التسميات العربية والإنجليزية التي تعرضها الصفحة. لا يؤدي فتح التطبيق تلقائيًا إلى منح صلاحية لكل نتيجة استعلام أو سير عمل أو مهمة أو مستند أو مساعد مضمن فيه. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | أداة بلا بيانات | تحقق من مدخلات الاستعلام ومعالجة الحالة الفارغة وصلاحية المستخدم المسجّل دخوله للمصدر. | | زر سير العمل غير متاح | تأكد من الخطة وموصل الصفحة ونشاط سير العمل ونوع المُشغّل وربط المدخلات المطلوبة. | | أثارت النقرات المزدوجة قلقًا من التكرار | راجع الإيصال الأول و**كل المثيلات** قبل إعادة المحاولة. | | تقول TaskAction إن المهمة تغيرت | ربما أكملها مشارك آخر أو أُعيد إسنادها؛ حدّث حالة المهمة الحالية. | | لا يستطيع جدول اعتماد الإرسال | أكمل كل قرار صف وتعليق وحقل وملف مطلوب. | | يستطيع مستخدم فتح التطبيق لا مستنده أو إجرائه | تُقيّم صلاحيات الصفحة والمورد وسير العمل والمهمة والمستند بصورة منفصلة. | | لا يحتاج التطبيق إلا إلى ملفات | استخدم مساحة عمل مستندات فقط؛ فلا تمنح الشاشة المخصصة الفارغة المستخدم قيمة. | ## أدلة ذات صلة - [اختيار نموذج سير عمل أو صفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-12-choose-workflow-form-or-app-builder/) - [ربط صفحة منشئ التطبيقات بسير عمل](https://raptix.app/user-guide/ar/50-applications/50-13-app-builder-workflow-connector/) - [ربط مهمة سير عمل بصفحة منشئ التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-15-app-builder-task-actions/) - [استخدام جداول الاعتماد في مهام سير العمل](https://raptix.app/user-guide/ar/50-applications/50-17-approval-tables/) - [إعداد أدوات منشئ التطبيقات لسير عمل](https://raptix.app/user-guide/ar/50-applications/50-21-app-builder-widget-configuration/) - [إدارة المستندات في التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-29-managing-documents/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) --- URL: https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/ # اختيار عناوين RAPTIX وصناديق بريد الإرسال > **الوحدة:** التواصل > > **الجمهور:** الأعضاء الذين يستخدمون عنوان RAPTIX ومشرفو مساحة العمل الذين يعدّون الإرسال > > **الوصول المطلوب:** تعتمد العناوين المُدارة على طرح RAPTIX Mail؛ وتتطلب خيارات SMTP وMicrosoft 365 صلاحية المشرف وخطة مؤهلة ومزوّدًا معدًّا > > **ستتعلم:** الفرق بين عنوان RAPTIX مُدار وصندوق بريد متصل وإرسال SMTP أو Microsoft 365 وعنوان سير عمل؛ وكيف تختار الخيار الصحيح؛ وأين تنشئه أو تختبره أو تعيد تسميته أو تدوّره أو تلغيه. ## فهم أنواع العناوين الأربعة يمكن لـRAPTIX استخدام هويات بريد مختلفة لأعمال مختلفة. لا تظهر إلا الخيارات المعدّة لمساحة عملك. | النوع | استخدامه | الحد المهم | |---|---|---| | **عنوان RAPTIX شخصي أو للمؤسسة** | استلام البريد في تجارب RAPTIX المسموح بها، وتوفير هوية مرسل مُدارة. | يعتمد على الطرح؛ وليس صندوق بريد مستقلًا بكلمة مرور خاصة. | | **صندوق بريد متصل** | السماح لشخص مؤهل بالموافقة على الإرسال المدعوم من حساب مزوّد قائم. | لا يمنح اتصال الإرسال بحد ذاته صلاحية قراءة صندوق بريد الشخص. | | **صندوق إرسال SMTP أو Microsoft 365** | منح مساحة العمل مزوّدًا مُدارًا لبريد سير العمل. | يتطلب خطة مؤهلة وإعداد المزوّد. | | **عنوان سير العمل** | منح مُشغّل بريد واحد وجهة واردة ثابتة. | يُنشأ في منشئ التدفقات؛ وصفحة الإدارة مخصصة للنسخ والتدوير والإلغاء. | اختر وفق الرحلة، لا وفق تشابه عنوان البريد. يمكن لهوية الرد ومزوّد الإرسال وعنوان سير العمل الوارد أن تشارك كلها في عملية واحدة، مع بقائها عناصر تحكم منفصلة. ## إدارة عنوان RAPTIX الخاص بك عندما تكون العناوين المُدارة مفعّلة، افتح إعدادات البريد المتاحة لحسابك: 1. اختر **إنشاء عنواني (Create my address)** أو **إضافة عنوان آخر (Add another address)**. 2. أدخل الاسم الذي يسبق النطاق المُدار. 3. انتظر نتيجة الإتاحة أو اختر اسمًا مقترحًا. 4. أنشئ العنوان، ثم استخدم **نسخ (Copy)** عندما تحتاج إلى مشاركته. 5. إذا كان لديك أكثر من عنوان مؤهل، فاختر العنوان الافتراضي. تعرض الصفحة العدد الذي تسمح به الخطة الحالية أو سعة العناوين المشتراة. قد تُبقي إعادة التسمية العنوان القديم قادرًا على استقبال البريد خلال مهلة الانتقال الظاهرة على الشاشة. حدّث المرسلين والتكاملات قبل انتهائها. يعيد العنوان المُدار توجيه الردود وفق التجربة المعدّة؛ ولا ينشئ صندوق بريد شخصيًا آخر لتسجيل الدخول إليه. ## ربط صندوق بريد قائم إذا توفر **صناديق البريد المتصلة (Connected mailboxes)**: 1. اختر المزوّد المدعوم. 2. أكمل تسجيل الدخول إلى المزوّد وشاشة الموافقة. 3. ارجع إلى RAPTIX وتأكد من أن الصف يعرض **متصل (Connected)**. 4. استخدم **إرسال اختبار (Send test)** قبل الاعتماد عليه في سير عمل. اختر **إعادة الاتصال (Reconnect)** عندما يحتاج الاتصال إلى متابعة. لا تفصل الاتصال إلا بعد التحقق من مسارات سير العمل التي ترسل عبر ذلك الصندوق. يختلف تسجيل الدخول إلى المزوّد للإرسال عن تسجيل الدخول إلى RAPTIX نفسه باستخدام Microsoft أو Google. ## إعداد صندوق إرسال مُدار يستطيع مشرفو مساحة العمل إضافة SMTP أو Microsoft 365 عندما تكون الخيارات مفعّلة. بالنسبة إلى SMTP، أدخل الخادم والمنفذ واسم المستخدم والسر وأمان النقل والمرسل وعنوان الرد الاختياري وتسمية فريدة. وبالنسبة إلى Microsoft 365، استخدم قيم المؤسسة والتطبيق التي يتطلبها النموذج، وامنح صلاحية الإرسال لدى المزوّد كما هو موضح. احفظ وأرسل اختبارًا. تظل الأسرار المخزنة مخفية في التعديلات اللاحقة؛ ويؤدي ترك حقل السر المخفي فارغًا إلى الاحتفاظ بالقيمة المحفوظة. قد يصبح أول صندوق مؤهل هو الافتراضي، ويمكن لصندوق نشط آخر أن يحل محله لاحقًا. لا تختر **بلا أمان (None)** لأمان النقل إلا إذا وفّر مشرف البريد عمدًا بيئة موثوقة تتطلبه. ## صيانة عناوين سير العمل أنشئ عنوانًا واردًا من **مُشغّل البريد الإلكتروني (Email Trigger)** في منشئ التدفقات. يمكنك بعد ذلك من الإدارة: - **نسخه** لمرسل أو قاعدة إعادة توجيه؛ - **تدويره (Rotate)** لتغيير مخطط، مع بقاء القيمة القديمة صالحة خلال فترة الانتقال الظاهرة؛ أو - **إلغاؤه (Revoke)** فورًا عندما يجب أن يتوقف العنوان الحالي عن قبول الرسائل. التدوير أكثر أمانًا للترحيل العادي. أما الإلغاء فيقطع الخدمة فورًا، وينبغي استخدامه فقط عندما تكون هذه هي النتيجة المقصودة. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | قسم العنوان المُدار مفقود | ربما لم يُمكّن RAPTIX Mail لمساحة العمل أو الحساب. | | لا يمكن إنشاء عنوان آخر | راجع الحد الظاهر لكل شخص وسعة الفوترة. | | صندوق متصل يحتاج إلى متابعة | اختر **إعادة الاتصال**، وأكمل تسجيل دخول المزوّد، ثم أرسل اختبارًا. | | يفشل اختبار الإرسال | تحقق من بيانات اعتماد المزوّد والصلاحية وهوية المرسل وخيار النقل وأي فترة انتظار ظاهرة. | | عنوان سير العمل غير مدرج | أنشئ اشتراك مُشغّل البريد واحفظه في منشئ التدفقات أولًا. | | لا يمكن حذف الصندوق الافتراضي | اجعل صندوقًا نشطًا مؤهلًا آخر هو الافتراضي قبل الحذف. | ## أدلة ذات صلة - [إعداد العناوين وصناديق بريد الإرسال](https://raptix.app/user-guide/ar/70-administration/70-4-email/) - [أتمتة البريد بالقوالب والمُشغّلات وخطوات الانتظار](https://raptix.app/user-guide/ar/60-communication/60-2-templates-triggers-and-workflow-email/) - [إعداد عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [عقدة مُشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [فهم الفوترة والخطط والفترات التجريبية والأدوار](https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/) --- URL: https://raptix.app/user-guide/ar/60-communication/60-2-templates-triggers-and-workflow-email/ # أتمتة البريد بالقوالب والمُشغّلات وخطوات الانتظار > **الوحدة:** التواصل > > **الجمهور:** منشئو سير العمل ومشرفو التواصل > > **الوصول المطلوب:** صلاحية تحرير سير العمل وموارد التواصل الخاصة به؛ يتطلب الإرسال والاستلام المباشران مزوّدين معدّين، وتخضع بعض أدوات التشخيص أو عناصر التحكم المتقدمة للخطة > > **ستتعلم:** كيف تعمل قوالب التواصل القابلة لإعادة الاستخدام وتسليم بريد سير العمل ومُشغّلات البريد الوارد وخطوات انتظار البريد المطابق معًا؛ وكيف تختار عنصر التحكم الصحيح؛ وكيف تتحقق من رحلة الرسالة الناتجة. ## اختيار عنصر تحكم البريد الذي تحتاج إليه | الهدف | ما تستخدمه | |---|---| | إرسال رسالة أثناء سير عمل | **عقدة البريد الإلكتروني (Email node)** | | إعادة استخدام صياغة وتخطيط معتمدين | **قالب تواصل أو بريد** | | بدء سير عمل جديد عند وصول بريد | **مُشغّل البريد الإلكتروني (Email Trigger)** | | إيقاف تشغيل قائم حتى يصل رده | **انتظار بريد مطابق** | | إرسال تذكير قائم على التاريخ | **مجدول التذكيرات (Reminder Scheduler)** عندما توفره الخطة | يسهل فصل هذه المهام اختبار العملية. لا ينبغي استخدام مُشغّل البريد بديلًا لاستئناف التشغيل المحدد الذي طلب ردًا. ## إنشاء قالب قابل لإعادة الاستخدام وصيانته في مكتبة القوالب المتاحة لمساحة عملك: 1. أنشئ قالبًا أو انسخ واحدًا. 2. اكتب موضوعًا ونصًا واضحين في المحرر المرئي. 3. أدرج حقول الدمج التي يوفرها سياق سير العمل المقصود فقط. 4. عاين باستخدام بيانات دمج ممثلة بالعربية والإنجليزية عند الحاجة. 5. احفظ إصدارًا واتبع عملية المراجعة أو الاعتماد الظاهرة. 6. نشّط الإصدار المعتمد قبل اختياره في سير عمل مباشر. يساعد البحث وعوامل التصفية المشرفين على إدارة مكتبة أكبر. يوفّر **مرات الاستخدام (Times Used)** و**إجمالي الاستخدام (Total Usage)** مؤشري الاستخدام الحاليين على مستوى القالب؛ وتُراجع نتائج التسليم والأرشفة في عروض الرسالة أو سير العمل المقابلة. لا تضع كلمة مرور أو رمز وصول أو سر مزوّد في قالب أو حقل دمج. ## إرسال بريد من سير عمل أعدّ عقدة البريد الإلكتروني باستخدام: - صندوق إرسال مسموح أو الصندوق الافتراضي لمساحة العمل؛ - مستلمين ثابتين أو متغيرين؛ - قالب أو موضوع ونص مؤلفين عمدًا؛ - حقول دمج موجودة في كل مسار يصل إلى العقدة؛ - مرفقات ثابتة أو مرسلة ومدعومة؛ و - سلوك التسليم أو الأرشفة المتوقع الذي تعرضه العقدة. عاين الرسالة المعروضة. اختبر القيم الاختيارية المفقودة وكل فرع يستطيع الوصول إلى العقدة. عندما لا يكون المزوّد معدًّا، يظل بإمكان المنشئ عرض التصميم، بينما لا يتوفر التسليم المباشر. ## بدء سير عمل من البريد الوارد أعدّ مُشغّل البريد عندما ينبغي لكل رسالة مطابقة بدء مثيل جديد. استخدم عوامل التصفية المتاحة، مثل العنوان والمرسل والموضوع والنص واللغة ومرجع المستند أو المشروع وخصائص المرفق، لتضييق المطابقة. ثم: 1. عاين القاعدة أو اختبرها بعينة. 2. راجع جدول المُشغّل وحدود المعدل. 3. اربط قيم الرسالة والمرفقات المسموح بها بمدخلات سير العمل. 4. اختر سياسة الأرشيف التي يعرضها المُشغّل. 5. لا تنشّط سير العمل إلا بعد نجاح اختباري عدم المطابقة والمطابقة. قد تتطلب أدوات التشخيص المتقدمة أو إعادة التشغيل أو عروض الرسائل غير القابلة للتسليم خطة مؤهلة وبيئة بريد نشطة. استخدمها للتحقق، لا لإخفاء قاعدة واسعة جدًا. ## انتظار رد داخل التشغيل نفسه ضع انتظار البريد المطابق بعد الخطوة التي تطلب الرد. ضمّن مرجعًا أو وجهة لكل تشغيل في الرسالة الصادرة وقاعدة الانتظار معًا. وجّه الرسالة المستلمة إلى المعالجة، ووجّه انتهاء المهلة بصورة منفصلة إلى تذكير أو تصعيد أو إغلاق. لإجراء الإعداد والاختبار كاملًا، راجع [انتظار بريد إلكتروني مطابق داخل سير عمل جارٍ](https://raptix.app/user-guide/ar/10-workflows/10-36-wait-for-matching-email/). ## التحقق من الرحلة من البداية إلى النهاية 1. أرسل اختبارًا عبر المزوّد المحدد. 2. تحقق من الموضوع والنص واللغة وقيم الدمج والمرفقات. 3. أرسل رسالة لا ينبغي أن تطابق القاعدة الواردة. 4. أرسل الرسالة المتوقعة وتأكد من بدء مثيل واحد مقصود أو استئنافه. 5. افتح الخط الزمني لمثيل سير العمل. 6. افتح سجل أرشيف البريد المسموح به وتحقق من التسليم ومراحل الرسالة وحالة الملف. 7. اختبر نتيجة انتهاء المهلة أو الفشل من دون تغيير مستلمي الإنتاج. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | نص الدمج فارغ | تأكد من وجود المتغير في كل فرع وارد، وعاين ببيانات ممثلة. | | تستخدم الرسالة قالبًا قديمًا | اختر القالب المعتمد أو النشط الحالي واحفظ سير العمل؛ فالعُقد الحالية لا تتغير تلقائيًا. | | التسليم غير متاح | أعدّ مزوّد إرسال نشطًا واختبره، وحدد الافتراضي لمساحة العمل. | | رسائل كثيرة تبدأ مسارات سير عمل | ضيّق مُشغّل البريد بعنوان ثابت ومرجع عمل. | | يبدأ الرد تشغيلًا ثانيًا | استخدم انتظار بريد مطابق داخل العملية للمثيل النشط. | | وصلت رسالة لكنها مفقودة من الأرشيف | راجع شرط الأرشفة أو التخزين الظاهر؛ فقد يكون للتسليم والأرشفة نتيجتان منفصلتان. | | إعادة التشغيل أو التشخيص العميق غائبان | تحقق من الخطة وبيئة البريد؛ وابدأ بحالات المثيل والأرشيف الظاهرة للمستخدم. | ## أدلة ذات صلة - [إعادة استخدام قوالب البريد في منشئ التدفقات](https://raptix.app/user-guide/ar/10-workflows/10-9-email-templates-library/) - [إعداد عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [عقدة مُشغّل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [انتظار بريد مطابق](https://raptix.app/user-guide/ar/10-workflows/10-36-wait-for-matching-email/) - [استخدام متغيرات سير العمل وعلامات الدمج](https://raptix.app/user-guide/ar/10-workflows/10-10-variables-merge-tags/) - [البحث والأمان والاحتفاظ في بريد سير العمل](https://raptix.app/user-guide/ar/60-communication/60-3-email-archive-search-safety-and-retention/) --- URL: https://raptix.app/user-guide/ar/60-communication/60-3-email-archive-search-safety-and-retention/ # البحث في بريد سير العمل وفهم الأمان والاحتفاظ > **الوحدة:** التواصل > > **الجمهور:** الأعضاء الذين يشمل عملهم المسموح البريد، والمشرفون الذين يديرون الاحتفاظ بالرسائل > > **الوصول المطلوب:** صلاحية البريد في التطبيقات؛ يعتمد البحث والملفات على إعداد البريد والفهرس والأرشيف، بينما تتطلب إعدادات الملفات الأصلية والاحتفاظ مشرف مساحة عمل > > **ستتعلم:** كيف تعثر على الرسائل المسموح بها ونص المرفقات، وتقرأ رحلة رسالة مركزة، وتفهم فحص المرفقات، وتختار الاحتفاظ بالأصول، وتفهم أثر الاحتفاظ في الأرشيف والمستندات والبحث والمساعد. ## البحث في البريد المسموح لك برؤيته فقط افتح **التطبيقات (Applications)**، ثم اختر **البريد الإلكتروني (Email)**. يمكن أن يشمل البحث الموضوع والنص والمشاركين وأسماء الملفات ونص المرفقات القابل للقراءة. وعندما يتوفر الترتيب بالمعنى، يستطيع سؤال عربي العثور على محتوى إنجليزي ذي صلة والعكس. تستخدم نتائجك وعوامل التصفية والأعداد وإجابات المساعد حدود الوصول نفسها. ترى الرسائل التي تكون فيها مشاركًا مسموحًا، أو التي وصلت إلى عنوان تملكه، أو المرتبطة بسير عمل مسموح لك بإدارته. صلاحية البريد ليست صلاحية لأرشيف مساحة العمل كاملًا. استخدم عوامل تصفية الاتجاه والمرفقات والانتباه والشخص والتاريخ ورسائل النظام لتضييق القائمة. يؤدي فتح رسالة إلى صفحة مركزة في علامة تبويب مستقلة، حتى يظل الأرشيف المصفّى متاحًا. ## قراءة رحلة الرسالة يمكن أن يعرض العرض المركز: - الرسالة المستلمة أو المرسلة التي جرى التحقق منها؛ - السجل المقتبس، مع تسمية منفصلة عن الرسائل المتحقق منها استقلالًا؛ - محتوى منسق آمن أو نص عادي؛ - سياق سير العمل ومراحله؛ و - الملفات المسموح بها مع حالة أمانها المباشرة. يحذف القارئ تشخيصات النقل وتفاصيل التخزين الداخلية التي لا تساعد في قرار العمل. استخدم الخط الزمني لمثيل سير العمل لحالة العملية، والأرشيف لسجل التواصل. ## فهم النص القابل للبحث والأصول المخزنة التقاط البحث وتخزين الأصل خياران منفصلان: | المحتوى | الأصول غير محفوظة | **الاحتفاظ بالرسائل الأصلية وملفاتها (Keep the original messages and their files)** مفعّل | |---|---:|---:| | النص القابل للبحث من الرسالة والملفات المقروءة | متاح عند إعداد الفهرسة | متاح عند إعداد الفهرسة | | توفر الرسالة الأصلية لاحقًا | لا | نعم | | إمكان تنزيل المرفق الأصلي لاحقًا | لا | نعم، بعد نتيجة أمان سليمة | | تمثيل المرفق السليم في المستندات | لا | نعم | | احتسابه من مساحة تخزين مساحة العمل | لا يوجد أصل | الأصل والملفات المخزنة | يغيّر المشرف خيار تخزين الأصل في إعدادات البريد. ينطبق على الرسائل الجديدة ولا يستطيع استعادة أصل سبق التخلص منه. يؤدي إيقافه إلى منع تخزين أصول جديدة؛ بينما تتحكم إعدادات الاحتفاظ في الأصول المحفوظة بالفعل. ## انتظار نتيجة أمان المرفق تُعزل المرفقات المحتفظ بها إلى أن يكتمل فحص الأمان. | الحالة | النتيجة للمستخدم | |---|---| | الفحص قيد التنفيذ | قد يظهر اسم الملف، لكن التنزيل غير متاح. | | سليم | يصبح **التنزيل (Download)** متاحًا. | | غير آمن | يظل الملف محظورًا. | | أداة الفحص غير متاحة أو فشلت | يظل الملف غير متاح؛ ولا يطلقه RAPTIX من دون نتيجة سليمة. | لا يعرض الأرشيف رابط تخزين عامًا. يعيد التنزيل التحقق من صلاحيتك. ## فهم المستندات والاحتفاظ عند حفظ الأصول، قد يظهر المرفق السليم في مسار بريد مؤرخ داخل المستندات. إنه الملف المؤرشف، لا نسخة منفصلة غير مرتبطة. وتظل صلاحيات المستندات منطبقة. يمكن لإعداد الاحتفاظ في مساحة العمل حفظ البريد بلا أجل محدد أو إزالته بعد عدد الأيام الظاهر. يتطلب تقصير المدة تأكيدًا، لأن دورة الاحتفاظ التالية قد تزيل نص الرسالة والملفات المحفوظة وربط المستندات وتمثيل البحث. وقد تبقى حقيقة تدقيق مختصرة لتسجيل وقوع احتفاظ مخوّل. يُحسب العمر من وقت استلام RAPTIX الرسالة أو إرسالها. ولا تعتمد عملية الاحتفاظ على تاريخ مكتوب داخل البريد. ## سؤال المساعد عن البريد لا يستطيع المساعد البحث والمقارنة إلا في الرسائل المسموح لك برؤيتها. ويمكنه استخدام نص المرفق المفهرس حتى عندما لم يُحفظ الأصل، لكنه لا يستطيع توفير ملف لم يعد موجودًا. اطلب منه الاستشهاد بالرسالة، وحدد الإطار الزمني والمشاركين. بالنسبة إلى جداول البيانات، حدد الورقة وعامل التصفية والأعمدة والحساب. وبالنسبة إلى الصور الممسوحة، توقع قيدًا عندما لا يتوفر التعرف البصري. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | رسالة مفقودة | تأكد من مشاركتك أو علاقتك بسير العمل، ومن عدم إزالة الرسالة بالاحتفاظ. | | النص قابل للبحث لكن الملف غير متاح | لم يُحفظ الأصل، أو أزاله الاحتفاظ، أو نتيجة الأمان غير سليمة. | | ملف لا يظهر في المستندات | قد يكون حفظ الأصول متوقفًا، أو الفحص غير مكتمل، أو صلاحية المستند مختلفة. | | البحث بالمعنى غير متاح | يمكن أن يستمر البحث بالصياغة بينما الفهرس الدلالي غير متاح. | | صفحة ممسوحة بلا نص مقروء | ربما لم يُمكّن التعرف البصري؛ ابحث بالمرسل أو الموضوع أو اسم الملف. | | بريد مقتبس يحمل تسمية مختلفة | استُرد من نص رسالة أخرى ولم يُتحقق منه استقلالًا. | | يظهر شريط يتطلب الانتباه | اتبع إجراء الفهرسة أو الأرشيف أو التخزين أو التسليم الظاهر؛ ومجرد لحاق قائمة الانتظار لا يعني بالضرورة وجود فشل. | ## أدلة ذات صلة - [حفظ البريد الذي تتعامل معه مسارات سير العمل والعثور عليه وقراءته](https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/) - [اختيار عناوين RAPTIX وصناديق بريد الإرسال](https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/) - [أتمتة البريد بالقوالب والمُشغّلات وخطوات الانتظار](https://raptix.app/user-guide/ar/60-communication/60-2-templates-triggers-and-workflow-email/) - [طلب العثور على المعلومات وتشغيل مسارات سير العمل من مساعد RAPTIX](https://raptix.app/user-guide/ar/30-ai-agents/30-32-assistant-tools-and-workflow-commands/) - [إدارة المستندات وصلاحياتها وأمانها](https://raptix.app/user-guide/ar/20-documents/20-17-admin-roles-permissions-security/) --- URL: https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/ # استخدام الإدارة > **المنطقة:** الإدارة > > **الجمهور:** مسؤولو مساحة العمل > > **الوصول المطلوب:** مسؤول مساحة العمل > > **ما ستتعلمه:** كيفية قراءة ملخص الإدارة وفتح جميع وجهات الإدارة الحالية. ## ما الذي تحتويه الإدارة؟ افتح **الإدارة (`Admin`)** من التنقل الرئيسي على `/admin`. الصفحة الحالية ملخص حي لمساحة العمل بثلاث وجهات، وليست لوحة جداول البيانات الكبيرة التي استخدمتها إصدارات RAPTIX السابقة. | صف الإدارة | المعلومات الحية المعروضة | يفتح | |---|---|---| | **إدارة المستخدمين (`User management`)** | عدد الأعضاء، وعدد المنتظرين للانضمام عند وجودهم | `/user-management`: الأعضاء، وطلبات الانضمام، ونشاط تسجيل الدخول، وتسجيل الدخول وSSO | | **البريد الإلكتروني (`Email`)** | مفعّل أو غير معد؛ ومزود الإرسال النشط أو الافتراضي وعنوان المرسل عند توفره | `/admin/email-configuration`: العناوين المُدارة، وصناديق البريد المتصلة، وصناديق الإرسال، وعناوين سير العمل | | **الفوترة (`Billing`)** | الخطة ووسائل الدفع والفواتير وحدود الموارد وأرصدة الاستخدام | `/billing`: العرض المعتمد للاشتراك والاستخدام في مساحة العمل | لا يرى الصفحة إلا مسؤولو مساحة العمل. ولا تحتوي **الإدارة** حاليًا جداول تراخيص أو أدوات تحكم في الذاكرة المؤقتة أو بطاقات عامة لإضافة بيانات قاعدة البيانات وتعديلها وحذفها، ولا صفحة مستقلة لسجل الأمان. ## التعامل مع رسالة الانتباه لا تسمي الرسالة أعلى الصفوف إلا العناصر التي يستطيع المسؤول التصرف فيها: - **N ينتظرون الانضمام (`N waiting to join`)** تفتح **إدارة المستخدمين ← طلبات الانضمام**؛ - **البريد غير معد (`Email not set up`)** تفتح **البريد الإلكتروني**؛ - **كل شيء سليم (`All clear`)** تعني أن أيًا من الحالتين لا يحتاج إلى إجراء الآن. لا يمنع فشل طلب ملخص واحد تحميل الصفوف الأخرى. وتعني الشرطة أن القيمة الحية لذلك الصف لم تُحمّل؛ افتح الوجهة وحدّثها قبل افتراض أن القيمة صفر. ## اختيار الصفحة الصحيحة - استخدم [إدارة المستخدمين](https://raptix.app/user-guide/ar/70-administration/70-2-user-management/) لإدارة الأشخاص والطلبات وأدلة تسجيل الدخول وSSO. - استخدم [الأدوار والوصول](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) على `/org-roles` لتحديد الصفحات التي يستطيع كل دور فتحها. - استخدم [البريد الإلكتروني](https://raptix.app/user-guide/ar/70-administration/70-4-email/) لإعداد العناوين وصناديق البريد. - افتح [أرشيف البريد](https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/) من **التطبيقات ← البريد الإلكتروني** للعثور على رسائل سير العمل وقراءتها. يوجد الأرشيف مع العمل المرتبط به، لا كوجهة مستقلة في الإدارة. - استخدم **الفوترة** على `/billing` لمراجعة الخطة وحدود الموارد وأرصدة الاستخدام والفواتير. تبقى منح التطبيقات وسجلاتها داخل **التطبيقات**، وتبقى سجلات سير العمل وقوالبه في **قاعدة بيانات سير العمل**. ولا تحل الإدارة محل عناصر التحكم الخاصة بتلك المناطق. ## قبل إجراء تغيير - تأكد أن مساحة العمل الظاهرة هي التي تريد إدارتها. - استخدم أصغر تغيير في الدور أو وصول الصفحة يحل الطلب. - راجع نص التأكيد قبل إزالة عضو أو دور أو صندوق بريد أو عنوان أو إعداد مزود. - لا تلصق كلمات المرور أو أسرار العملاء أو بيانات صناديق البريد في رسائل الدعم. ## أدلة ذات صلة - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [استخدام قاعدة بيانات سير العمل](https://raptix.app/user-guide/ar/10-workflows/10-27-workflow-database-console/) - [الوصول مقيّد والصلاحية مرفوضة](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) --- URL: https://raptix.app/user-guide/ar/70-administration/70-2-user-management/ # إدارة الأعضاء وطلبات الانضمام ونشاط الدخول وSSO > **المنطقة:** الإدارة ← إدارة المستخدمين > > **الجمهور:** مسؤولو مساحة العمل > > **الوصول المطلوب:** مسؤول مساحة العمل ## استخدام علامات التبويب الأربع | علامة التبويب | الغرض الحالي | |---|---| | **الأعضاء (`Members`)** | البحث عن الأعضاء، ومراجعة الحالة وآخر دخول، وتغيير الأدوار، وفتح النشاط، ومعالجة الوصول المعلق، أو إزالة عضو. | | **طلبات الانضمام (`Join requests`)** | قبول أو رفض الأشخاص المنتظرين للانضمام. تعرض العلامة عدد الطلبات المعلقة. | | **نشاط تسجيل الدخول (`Sign-in activity`)** | مراجعة أحداث الدخول الحديثة وفتح تفاصيلها. | | **تسجيل الدخول وSSO (`Sign-in & SSO`)** | إعداد خيارات Microsoft أو Google التي تعرضها مساحة العمل للدخول. | تُحفظ العلامة المحددة في عنوان الصفحة. وتفتح الإدارة **طلبات الانضمام** مباشرة عند وجود طلبات منتظرة. ## إدارة الأعضاء 1. افتح **الأعضاء**. 2. ابحث بالاسم أو البريد، واستخدم مرشح الحالة، أو غيّر ترتيب العرض. 3. راجع دور الشخص وحالة العضوية وآخر تسجيل دخول. 4. غيّر الدور من داخل الصف عندما يلزم تعديل الوصول. تستخدم التغييرات الأدوار المحددة في **الأدوار والوصول**. 5. افتح إجراء الصف لعرض نشاط الدخول، أو قبول أو رفض شخص معلق، أو إزالة وصوله. يمنع RAPTIX المسؤول الوحيد المتبقي من خفض دور نفسه. أضف مسؤولًا آخر أو رقّه قبل محاولة ذلك. تنهي إزالة العضو وصوله إلى مساحة العمل، لكنها لا تمحو سجلات سير العمل أو النشاط التاريخية التي أنشأها أثناء عضويته. ## معالجة طلبات الانضمام افتح **طلبات الانضمام**، وتحقق من هوية الشخص والوصول المقصود إلى مساحة العمل، ثم اختر **قبول (`Approve`)** أو **رفض (`Decline`)**. يمنح القبول العضوية تحت الدور المسند أو الافتراضي؛ عدّل الدور من «الأعضاء» إذا لزم وصول مختلف. ## مراجعة نشاط تسجيل الدخول استخدم **نشاط تسجيل الدخول** لقائمة الأحداث على مستوى مساحة العمل. ومن صف عضو، افتح درج نشاط ذلك الشخص إذا بدأ التحقيق بعضو محدد. راجع الهوية والوقت والنتيجة والسياق الظاهر قبل اعتبار حدث غير مألوف دخولًا غير مصرح به. عرض النشاط دليل للمراجعة، لكنه لا يوقف العضو ولا يغير دوره بنفسه. ## إعداد تسجيل الدخول وSSO قد تعرض الصفحة الحالية بطاقات مزودي Microsoft وGoogle، ويتوقف توفرها على بيئة النشر. 1. اختر تطبيق المزود الذي تديره المنصة أو تطبيق مؤسستك عندما يتاح الوضعان. 2. إذا استخدمت تطبيق المؤسسة، فأدخل القيم المطلوبة المعروضة. قد يتطلب Microsoft معرّف الدليل أو المستأجر، ومعرّف العميل، وسر العميل؛ وقد يتطلب Google معرّف العميل وسره. 3. انسخ **عنوان إعادة التوجيه (`Redirect URI`)** الظاهر كما هو إلى إعداد المزود. 4. حدد إن كنت تريد **إظهار زر تسجيل الدخول (`Show login button`)**. 5. إذا فعّلت **السماح بالتسجيل (`Allow sign-up`)**، فقيّده عبر **نطاقات البريد المسموح بها (`Allowed email domains`)** عندما ينبغي قبول عناوين المؤسسة فقط. 6. اختر **حفظ وتحقق (`Save & verify`)** قبل الاعتماد على المزود. قد يبقى من سُمح له بالتسجيل معلقًا حتى يقبل المسؤول طلب الانضمام. ## فتح «الأدوار والوصول» اختر **الأدوار والوصول (`Roles & access`)** من ترويسة إدارة المستخدمين لإنشاء أدوار مخصصة أو إعادة تسميتها أو حذفها، وتحديد الصفحات التي يفتحها كل دور. ثم ارجع إلى **الأعضاء** لإسناد الدور النهائي. ## أدلة ذات صلة - [استخدام الإدارة](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) - [إدارة الأدوار والوصول إلى الصفحات](https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/) - [الوصول مقيّد والصلاحية مرفوضة](https://raptix.app/user-guide/ar/00-getting-started/00-17-access-restricted/) --- URL: https://raptix.app/user-guide/ar/70-administration/70-3-roles-and-access/ # إدارة الأدوار والوصول إلى الصفحات > **المنطقة:** الإدارة ← إدارة المستخدمين ← الأدوار والوصول > > **الجمهور:** مسؤولو مساحة العمل > > **الوصول المطلوب:** مسؤول مساحة العمل ## ما الذي تتحكم فيه المصفوفة؟ تعرض **الأدوار والوصول (`Roles & access`)** مصفوفة **الصفحات × الأدوار**. يبين كل عمود اسم الدور وعدد أعضائه، ويمثل كل صف قسمًا رئيسيًا أو صفحة داخله. تسمح علامة الاختيار لأعضاء الدور بفتح الصفحة. تُحفظ التغييرات فورًا وتُطبق عندما يحمّل عضو يحمل الدور الصفحة المتأثرة في المرة التالية. وفي الصفحة المتداخلة، فعّل قسمها الأب أولًا؛ فإذا لم يكن الأب متاحًا، يظل مربع الصفحة التابعة معطلًا لأنها لن تملك مدخل تنقل يمكن استخدامه. تتحكم المصفوفة في دخول الصفحة، لكنها لا تمنح تلقائيًا كل تطبيق أو مستند أو سجل سير عمل أو مورد آخر داخلها. استخدم شاشة الصلاحيات الخاصة بمنطقة المنتج لتلك المنح الأضيق. ## إنشاء دور 1. اختر **دور جديد (`New role`)**. 2. أدخل اسمًا واضحًا واختر **إنشاء (`Create`)**. يرسل Enter، ويلغي Escape. 3. فعّل الأقسام الأم والصفحات الفردية التي يحتاجها الدور. 4. ارجع إلى **إدارة المستخدمين ← الأعضاء** وأسند الدور. ## إعادة تسمية دور أو حذفه - اختر **إعادة تسمية (`Rename`)** في ترويسة دور مخصص، وعدّل الاسم ثم احفظه. - يوضح عدد الأعضاء الأدوار التي لا تزال مسندة إلى أشخاص. - لا يمكن حذف دور إلا إذا كان عدد أعضائه صفرًا. - دور المسؤول أو النظام مقفل ولا يمكن إعادة تسميته أو حذفه. - حذف دور مخصص غير مستخدم نهائي ويطلب تأكيدًا. أعد إسناد كل عضو قبل حذف الدور. يشرح عنصر الحذف ما إذا كان دور النظام أو عدد أعضاء غير صفري هو ما يمنع الإجراء. ## تطبيق أقل قدر من الوصول - أنشئ الأدوار حول مسؤوليات وظيفية مستقرة، لا حول أشخاص منفردين. - فعّل الصفحات اللازمة للمسؤولية فقط. - راجع القسم الأب وجميع الصفحات التابعة بعد إضافة منطقة منتج جديدة. - اختبر النتيجة بعضو غير مسؤول يحمل الدور. - استخدم **التحكم في وصول التطبيقات (`Applications Access Control`)** لموارد مساحة العمل والتطبيق والصفحة داخل «التطبيقات». ## أدلة ذات صلة - [إدارة الأعضاء وطلبات الانضمام ونشاط الدخول وSSO](https://raptix.app/user-guide/ar/70-administration/70-2-user-management/) - [إدارة الوصول إلى التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-5-applications-access-control/) - [فهم نطاقات صلاحيات التطبيقات](https://raptix.app/user-guide/ar/50-applications/50-6-permission-scopes-explained/) --- URL: https://raptix.app/user-guide/ar/70-administration/70-4-email/ # إعداد العناوين وصناديق الإرسال > **المنطقة:** الإدارة ← البريد الإلكتروني > > **الجمهور:** مسؤولو مساحة العمل الذين يديرون البريد > > **الوصول المطلوب:** مسؤول مساحة العمل ## فهم الأقسام توضح صفحة **البريد الإلكتروني (`Email`)** الحالية كيف يرسل RAPTIX البريد لمساحة العمل. ولا تظهر الأقسام إلا إذا كانت بيئة النشر تدعمها. | القسم | ما يمكنك فعله | |---|---| | **عنوان أو عناوين RAPTIX الخاصة بك (`Your RAPTIX address / addresses`)** | إنشاء عنوان على النطاق المُدار الظاهر، والتحقق من توفر الاسم، واستخدام المقترحات، والنسخ، وإعادة التسمية، وتعيين الافتراضي، أو الحذف ضمن الحد المعروض. تُحوّل الردود إلى صندوق البريد المعتاد للشخص. | | **صناديق البريد المتصلة (`Connected mailboxes`)** | ربط صناديق Microsoft أو Google المدعومة، وإرسال اختبار، وإعادة ربط اتصال يحتاج إلى انتباه، أو فصله. | | **صندوق الإرسال (`Sending mailbox`)** | إضافة إعدادات SMTP وMicrosoft 365 أو تعديلها أو اختبارها أو تفعيلها وتعطيلها أو اختيار الافتراضي أو حذفها. | | **عناوين سير العمل (`Workflow addresses`)** | نسخ العناوين الواردة التي أنشأتها عقدة تشغيل البريد في منشئ التدفق، أو تدويرها أو إبطالها. تُنشأ العناوين الجديدة في منشئ التدفق لا في هذه الصفحة. | يوفر عنوان RAPTIX المُدار هوية للمرسل وتحويلًا للردود؛ وليس صندوق وارد منفصلًا تفتحه داخل RAPTIX. تمنح صناديق البريد المتصلة سير العمل إذن الإرسال باسم الشخص المتصل. يطلب الاتصال صلاحية الإرسال لا قراءة بريد ذلك الشخص. يعرض الصف السليم **متصل (`Connected`)** و**إرسال اختبار (`Send test`)**، بينما يعرض الصف القديم **يحتاج إلى إعادة اتصال (`Needs reconnecting`)** و**إعادة الاتصال (`Reconnect`)**. ## إدارة عنوان RAPTIX 1. اختر **إنشاء عنواني (`Create my address`)** أو **إضافة عنوان آخر (`Add another address`)**. 2. أدخل الجزء السابق للنطاق الثابت. تتحقق الصفحة من التوفر أثناء الكتابة وتشرح الأسماء المحجوزة أو المستخدمة أو غير الصالحة. 3. استخدم اقتراحًا ظاهرًا إن ناسبك، ثم اختر **إنشاء العنوان (`Create address`)**. 4. لعنوان موجود، استخدم **نسخ (`Copy`)** أو **تعيين افتراضيًا (`Make default`)** أو **إعادة تسمية (`Rename`)** أو **حذف (`Delete`)**. تعرض الصفحة العدد والحد الحاليين. وعند إعادة التسمية، توضح رسالة النجاح مدة استمرار العنوان القديم في استقبال البريد. حدّث المرسلين قبل انتهاء فترة السماح. ## إضافة صندوق إرسال SMTP 1. تحت **صندوق الإرسال**، اختر **إضافة صندوق (`Add mailbox`)**. 2. اختر **خادم SMTP (`SMTP server`)**. 3. أدخل **خادم SMTP** و**المنفذ (`Port`)** و**اسم المستخدم (`Username`)** و**كلمة المرور (`Password`)**. 4. اختر **STARTTLS**، وعادة منفذه 587، أو **SSL/TLS**، وعادة 465، أو **None**، وعادة 25. وتحتفظ المنصة بأي منفذ مخصص اخترته عمدًا. 5. أدخل **بريد المرسل (`Sender email`)** و**اسم المرسل (`Sender name`)** و**الرد إلى (`Reply-to`)** الاختياري و**تسمية (`Label`)** فريدة. 6. أبقِ **نشط (`Active`)** مفعّلًا عندما ينبغي أن يرسل RAPTIX منه. 7. اختر **حفظ وإرسال اختبار (`Save & send test`)**. إذا أُرسل اختبار مؤخرًا، يصبح الزر **حفظ (`Save`)** ويبين وقت توفر الاختبار التالي. اتبع أي تحذير خاص بالمضيف يظهر في النموذج. قد تتطلب بيئات Gmail وMicrosoft SMTP إعدادات لدى المزود أو كلمة مرور تطبيق إضافة إلى القيم الموجودة في الصفحة. ## إضافة صندوق إرسال Microsoft 365 1. اختر **إضافة صندوق** ثم **Microsoft 365**. 2. أدخل **معرّف الدليل أو المستأجر (`Directory (tenant) ID`)** و**معرّف العميل (`Client ID`)** و**سر العميل (`Client secret`)** لتسجيل التطبيق. 3. امنح التطبيق صلاحية `Mail.Send` على مستوى التطبيق في Microsoft 365، وأكمل حقول «من» و«الرد إلى» والتسمية والحالة النشطة. 4. اختر **حفظ وإرسال اختبار**. إعداد SSO للدخول وإعداد إرسال بريد Microsoft 365 منفصلان. اضبط مزودي التوثيق في **إدارة المستخدمين ← تسجيل الدخول وSSO**. ## التعديل والاختبار واختيار الافتراضي والحذف افتح صف صندوق لتعديله. تُخفى كلمات المرور وأسرار العملاء المحفوظة؛ اترك حقل السر فارغًا للاحتفاظ بالقيمة. ولا يمكن إعادة تسمية تسمية الصندوق بعد إنشائه. - **الإرسال من هذا الصندوق (`Send from this mailbox`)** يجعل الصندوق غير الافتراضي هو الافتراضي لمساحة العمل. - يصبح الصندوق الأول افتراضيًا حتى يكون لدى RAPTIX مرسل. - يمكن لخيار **نشط** الاحتفاظ بالإعداد من دون السماح له بالإرسال. - يحفظ **حفظ وإرسال اختبار** الإعداد حتى لو احتاج اختبار التسليم اللاحق إلى تحقيق. - تفرض الصفحة انتظارًا متزايدًا بين الاختبارات المتكررة وتعرض الوقت المتبقي. - يجب استبدال صندوق افتراضي غير مُدار قبل حذفه. ## صيانة عناوين سير العمل تنتمي عناوين سير العمل إلى اشتراكات عقدة تشغيل البريد: - **نسخ** ينسخ العنوان الحالي؛ - **تدوير العنوان (`Rotate address`)** يصدر بديلًا ويبقي القديم عاملًا خلال فترة الانتقال المبينة في التأكيد، وهي حاليًا 30 يومًا؛ - **إبطال (`Revoke`)** يوقف العنوان فورًا. استخدم التدوير للانتقال المخطط. ولا تستخدم الإبطال إلا عندما يجب أن يتوقف العنوان الحالي عن قبول البريد فورًا. ## استكشاف المشكلات وحلها | المشكلة | ما ينبغي التحقق منه | |---|---| | تقول الإدارة **البريد غير معد** | أضف صندوق إرسال نشطًا واجعل أحدها افتراضيًا، ثم أعد فتح الإدارة. | | زر الاختبار في فترة انتظار | احفظ إن لزم وانتظر المدة المعروضة بدل تكرار الإرسال. | | يبدو حقل السر فارغًا أثناء التعديل | هناك سر مخفي محفوظ، وإبقاء الحقل فارغًا يحتفظ به. أدخل قيمة فقط لاستبداله. | | صندوق متصل يحتاج إلى انتباه | اختر **إعادة الاتصال** وأكمل دخول المزود مجددًا. | | لا يظهر عنوان سير عمل | أنشئ اشتراك عقدة تشغيل البريد واحفظه في منشئ التدفق. | ## أدلة ذات صلة - [استخدام الإدارة](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) - [إعداد عقدة البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-8-email-node/) - [إعداد عقدة تشغيل البريد الإلكتروني](https://raptix.app/user-guide/ar/10-workflows/10-33-email-trigger-node/) - [إدارة الأعضاء وطلبات الانضمام ونشاط الدخول وSSO](https://raptix.app/user-guide/ar/70-administration/70-2-user-management/) --- URL: https://raptix.app/user-guide/ar/70-administration/70-6-email-archive/ # حفظ رسائل البريد التي يعالجها سير العمل والعثور عليها وقراءتها > **المنطقة:** التطبيقات ← البريد الإلكتروني > > **الجمهور:** كل من يصل عمله عبر البريد، ومسؤولو مساحة العمل الذين يديرون مدة الاحتفاظ > > **الوصول المطلوب:** الوصول إلى البريد الإلكتروني في «التطبيقات». لا ترى إلا الرسائل التي كنت طرفًا فيها أو التي يُسمح لك بقراءتها. يتطلب حفظ الملفات الأصلية وضبط مدة الاحتفاظ مسؤول مساحة العمل. ## فهم وظيفة الأرشيف كل رسالة يستقبلها سير العمل أو يرسلها تصبح سجلًا قابلًا للبحث ومرتبطًا بسير العمل الذي عالجها. يحدث ذلك تلقائيًا، ولا يحتاج أحد إلى تشغيل التقاط البحث لكل سير عمل أو صندوق بريد. يشمل البحث الموضوع ونص الرسالة والأشخاص وأسماء الملفات و**النص داخل المرفقات القابلة للقراءة**. لذلك قد تعثر عبارة لا تظهر إلا في أمر شراء مرفق على الرسالة التي حملته. كما تعمل المطابقة بالمعنى إلى جانب الألفاظ؛ فيمكن لسؤال إنجليزي العثور على رسالة عربية والعكس. لا تُقرأ الصفحات الممسوحة ضوئيًا والصور لأن OCR غير مفعّل حاليًا. لكن يمكن العثور على رسائلها بالموضوع والمرسل واسم الملف، ويُوسم المرفق بأنه غير قابل للقراءة بدل الإيحاء باستخراج نص منه. ## معرفة ما يُحتفظ به التقاط النص للبحث مفعّل دائمًا. ويختار فضاء العمل ما إذا كانت **الرسالة والملفات الأصلية** ستبقى بعد التقاط نصها القابل للبحث. | | الوضع الافتراضي | مع **الاحتفاظ بالرسائل الأصلية وملفاتها (`Keep the original messages and their files`)** | |---|---|---| | النص القابل للبحث من الرسالة والمرفقات المقروءة | ✅ | ✅ | | إتاحة الرسالة والملفات الأصلية لاحقًا | ❌ | ✅ | | ظهور الملفات السليمة في «المستندات» | ❌ | ✅ | | إمكانية تنزيل الملفات من البريد | ❌ | ✅، بعد فحص البرمجيات الضارة | | احتسابها من سعة تخزين مساحة العمل | ❌ | ✅ | يظل لسير العمل الذي يتلقى ملفًا نسخة عمل مؤقتة ما دامت عملية التشغيل تحتاج إليها. تُزال بعد انتهاء التشغيل ولا تظهر في «المستندات» إلا إذا كانت مساحة العمل تحتفظ بالأصول. ## الاحتفاظ بالرسائل الأصلية وملفاتها 1. افتح **الإدارة ← البريد الإلكتروني**. 2. اعثر على **ما يتركه بريدك خلفه (`What your email leaves behind`)**. 3. فعّل **الاحتفاظ بالرسائل الأصلية وملفاتها**. يطبق الإعداد على الرسائل المستلمة بعد تفعيله. ولا يمكنه استرجاع ملفات أصلية حُذفت بالفعل بعد التقاط النص. إيقافه يمنع تخزين الأصول الجديدة ولا يحذف ما حُفظ سابقًا؛ إذ تتحكم مدة الاحتفاظ في حذفها لاحقًا. ## فهم سلامة المرفقات يُعزل كل مرفق محفوظ ويُفحص بحثًا عن البرمجيات الضارة قبل أن يتيحه RAPTIX للتنزيل أو ينشره في «المستندات». يتخذ الأرشيف الخيار الآمن عند أي فشل: | الحالة | ما يحدث | |---|---| | **جارٍ فحص الأمان (`Security scan in progress`)** | يظهر اسم الملف لكن لا يتاح التنزيل. | | نجح الفحص | تتغير الحالة تلقائيًا إلى **تنزيل (`Download`)**، ولا تحتاج إلى تحديث الصفحة. | | اكتُشف ملف غير آمن | يظل محظورًا ولا يمكن تنزيله. | | الماسح غير متاح أو فشلت المعالجة | يبقى الملف غير متاح بدل إطلاقه من دون نتيجة. | يتكيف فحص الحالة أثناء عمل الماسح، ويبدأ بفاصل قصير كي يتاح الملف العادي سريعًا من دون إعادة تحميل الرسالة كلها مرارًا. يعرض الأرشيف **تنزيل** فقط عن قصد. ولا يضيف إجراء «فتح في المستندات» ثانيًا بجانب الملف، لأن قارئ البريد ينبغي أن يقدم إجراء ملف واحدًا واضحًا، ولأنه لا يجوز معاينة الملف قبل اجتياز الفحص. ## العثور على ملف بريد في «المستندات» عند الاحتفاظ بالأصول واجتياز الملف للفحص، يظهر المرفق في **المستندات** تحت: ```text البريد الإلكتروني ← 2026-08 ← supplier@acme.example ← invoice.pdf ``` يوجد ملف مخزن واحد لا نسختان؛ ومدخل «المستندات» هو المرفق المؤرشف. إذا محا الاحتفاظ أو حذف مخول الرسالة، يُمحى المستند المرتبط معها. لا ترى ملف البريد إلا إذا كنت طرفًا فيه، كمرسل أو مستلم في `To` أو `Cc` أو مالك عنوان RAPTIX الذي وصله، أو إذا كنت تملك سير العمل الذي وصله. وتظل صلاحيات مستندات مساحة العمل سارية. ## تصفح الأرشيف والبحث فيه افتح **التطبيقات** ثم اختر **البريد الإلكتروني (`Email`)** في ترويسة الصفحة. | عنصر التحكم | وظيفته | |---|---| | **مربع البحث** | يطابق الموضوع ونص الرسالة والأشخاص وأسماء الملفات ونص المرفقات المقروءة. | | **الكل / المستلم / المرسل (`All / Received / Sent`)** | يرشح حسب اتجاه الرسالة. | | **يحتوي مرفقات (`Has attachments`)** | يعرض الرسائل التي تحمل ملفات. | | **يحتاج إلى انتباه (`Needs attention`)** | يعرض الرسائل التي بها حالة أرشفة أو فهرسة أو تسليم تحتاج إلى مراجعة. | | **المرشحات (`Filters`)** | تضيق النتائج بالشخص أو النطاق الزمني أو الرسائل التي أرسلها النظام. | عندما يتاح ترتيب النتائج بالمعنى، توضح القائمة ذلك. وإذا لم يتوفر، تصرح الصفحة بأن الترتيب يعتمد على الألفاظ فقط؛ ويستمر البحث النصي في العمل. ## فتح رسالة من دون فقد حالة الأرشيف اختر رسالة من قائمة الأرشيف. يفتحها RAPTIX في **علامة متصفح جديدة** عبر عنوانها القابل للمشاركة. لا تظهر ترويسة «التطبيقات» ولا عناصر التحكم العامة في تلك العلامة، لتظل الرسالة ورحلتها في سير العمل محور التركيز. ويبقى الأرشيف بمرشحاته مفتوحًا في العلامة الأصلية. تعرض الصفحة المركزة: - الموضوع وسياق سير العمل المرتبط؛ - الرسائل المتحققة والبريد المقتبس مرتبة زمنيًا؛ - الملفات المجمعة من تلك الرسائل؛ - حالة فحص المرفقات الحية. يظل العنوان القديم `/admin/email-archive` عاملًا للتوافق، ويعيد التوجيه إلى البريد الإلكتروني في «التطبيقات». ## قراءة الرسالة في العارض المركز اختر رسالة أو بريدًا مقتبسًا في الرحلة. يفتح داخل عارض وسطي على شكل رسالة، لا في لوحة جانبية. تصبح الخلفية معتمة قليلًا ومموهة بخفة كي تنفصل الرسالة بصريًا عن الرحلة خلفها. - يظهر **من (`From`)** و**إلى (`To`)** جنبًا إلى جنب في الشاشات العريضة، ويتراصان بوضوح على الهاتف. - لا يظهر `Cc` و`Bcc` و`Reply-To` إلا عند وجوده والسماح بعرضه. - تظهر نسخة منسقة آمنة افتراضيًا عندما يتوفر HTML الأصلي. - يبدل **نص عادي (`Plain text`)** إلى البديل النصي، ويعيد **عرض منسق (`Formatted view`)** التنسيق. - يُنظف النص المستخرج من آثار HTML الفارغة والأسطر البيضاء المتكررة، مع الحفاظ على الفقرات والقوائم. - تبقى الرسائل القصيرة في مساحة قراءة مدمجة، بينما تمرر الطويلة داخل العارض من دون دفع زر الإغلاق خارج الشاشة. - أغلق العارض بزر الإغلاق، أو مفتاح `Escape`، أو اختيار الخلفية المعتمة. يُسمى المحتوى المقتبس **بريد مقتبس (`Quoted email`)** لا «مستخرج». فهو مستعاد من نص رسالة مؤرشفة أخرى، وليس رسالة مستقلة تم التحقق من استلامها. وقد تعرض الرسالة المتحققة أيضًا **إظهار السجل المقتبس (`Show quoted history`)** حتى يبقى الفرق واضحًا. يحذف القارئ عمدًا ترويسات النقل ومعرفات الرسائل وحالة الالتقاط والتشخيصات التقنية الأخرى. فهي لا تساعد الشخص على قراءة الرسالة أو التصرف فيها، وليست جزءًا من المحتوى الموجه للمستخدم. ## تنزيل مرفق افتح الرسالة المتحققة أو استخدم قسم الملفات في الصفحة. بعد اجتياز الملف للفحص، اختر **تنزيل**. يعيد RAPTIX التحقق من صلاحياتك مع طلب التنزيل؛ ولا يكشف الأرشيف عنوان ملف عامًا. إذا كان خيار الاحتفاظ بالأصول متوقفًا عند وصول الرسالة، فقد يظل النص قابلًا للبحث لكن لا يوجد ملف مخزن لتنزيله لاحقًا. ## فهم من يرى ماذا ترى الرسالة إذا كنت طرفًا فيها كمرسل أو في `To` أو `Cc`، أو إذا وصلت إلى عنوان RAPTIX يخصك، أو إذا منحتك علاقتك بسير العمل الوصول. ولا يكشف وصولك إلى صفحة البريد جميع رسائل مساحة العمل. النسخة المخفية منفصلة؛ فلا يعرف قارئ الرسالة تلقائيًا من كان في `Bcc`. يتطلب ذلك صلاحية خاصة ويقتصر على المرسل والمشارك في النسخة المخفية. تستخدم التصفية والبحث والأعداد قاعدة الوصول نفسها. أي عدد تراه هو عدد الرسائل التي **يمكنك أنت** رؤيتها، لا إجمالي مساحة العمل من دون ترشيح. ## تحديد مدة الاحتفاظ بالبريد افتح إعدادات البريد واستخدم **مدة الاحتفاظ برسائل البريد (`How long emails are kept`)** لمساحة العمل: - اتركها فارغة للاحتفاظ بالبريد إلى أجل غير محدد، وهو الإعداد الافتراضي. - أدخل عدد أيام لحذف ما تجاوز المدة تلقائيًا. يطلب تقصير المدة تأكيدًا، لأن دورة الاحتفاظ التالية تحذف نهائيًا الرسالة ونصها ومرفقاتها ونسختها المخزنة وربطها بالمستندات وفهرس البحث. ويبقى سجل تدقيق منفصل يبين أن الحذف حدث وسببه. تعمل سياسة الاحتفاظ تلقائيًا. ويُقاس عمر الرسالة من وقت استقبال RAPTIX لها أو إرسالها، لا من تاريخ تدعيه الرسالة داخل محتواها. ## قراءة شريط الانتباه لا يظهر شريط الانتباه إلا عند وجود ما يتطلب إجراءً: | الرسالة | معناها | ما ينبغي فعله | |---|---|---| | تعذر جعل رسائل قابلة للبحث حتى الآن | تحاول الفهرسة مجددًا. وتبقى الرسائل المخزنة قابلة للبحث النصي حيثما أمكن. | تحقق من الاعتماد أو سبب النموذج المعروض. | | لن تصبح الرسائل قابلة للبحث | استنفدت الفهرسة محاولاتها. | أصلح السبب المعروض ثم شغّل الفهرسة مجددًا. | | سُلّمت الرسائل لكن تعذر أرشفتها | نجح التسليم لكن الأرشيف لم يحفظ السجل. | تحقق من التخزين وسبب الفشل المعروض. | غياب الشريط يعني عدم وجود شيء عالق. أما قائمة انتظار تلحق بالرسائل ببساطة فهي طبيعية ولا تظهر كفشل. ## سؤال المساعد بدل البحث يمكن لمساعدك الإجابة من الأرشيف بالعربية أو الإنجليزية، مثل: - «ماذا أرسل إلينا المورد بشأن المضخات المتأخرة؟» - “How many invoices arrived from Alpha Company this month?” - «لخّص كل ما استلمناه عن المناقصة الأسبوع الماضي.» لا يبحث المساعد إلا في الرسائل التي يسمح لك برؤيتها ويذكر البريد الذي استخدمه. وللأرقام داخل جدول، اسأل مباشرة؛ إذ يستعلم المساعد عن الصفوف القابلة للقراءة بدل التخمين من معاينة. ## استكشاف المشكلات وحلها | العَرَض | السبب المرجح | |---|---| | رسالة متوقعة مفقودة | ربما لا تملك الوصول إليها، أو حذفتها سياسة الاحتفاظ. التقاط النص نفسه مفعّل دائمًا. | | اختيار بريد يفتح علامة أخرى | هذا مقصود كي يبقى الأرشيف الأصلي ومرشحاته متاحين. | | بريد مقتبس موسوم بصورة مختلفة عن الرسالة الرئيسية | جاء من نص مقتبس، وليس رسالة مستقلة تم التحقق منها. | | فجوات بيضاء كبيرة داخل الرسالة | أعد فتحها بعد تحديث الصفحة. يزيل القارئ الحالي مسافات الاستخراج المتكررة ويفضل HTML الآمن. | | ملف يقول **جارٍ فحص الأمان** | انتظر في الصفحة؛ سيتغير تلقائيًا إلى **تنزيل** عند ثبوت سلامته، بلا تحديث. | | ملف يظل محظورًا أو غير متاح | إما أنه غير آمن، أو فشل الفحص، أو الماسح غير متاح. لا يطلقه RAPTIX من دون نتيجة سليمة. | | الرسالة قابلة للبحث لكن الملف لا يُنزّل | لم تكن المساحة تحتفظ بالأصول عند وصوله، أو لم يجتز الملف المحفوظ الفحص بعد. | | زميل لا يجد ملف البريد في «المستندات» | ربما لم يكن طرفًا في الرسالة ولا يملك سير العمل. شاركه كما تشارك أي مستند آخر. | | يقول البحث الذكي إن الترتيب بالألفاظ فقط | ترتيب المعنى غير متاح مؤقتًا، لكن البحث النصي غير متأثر. | | المرفق موسوم بأنه غير قابل للقراءة | غالبًا هو صفحة ممسوحة أو صورة، وOCR غير مفعّل حاليًا. | ## أدلة ذات صلة - [إعداد العناوين وصناديق الإرسال](https://raptix.app/user-guide/ar/70-administration/70-4-email/) - افتح **الفوترة** على `/billing` لمراجعة حدود مساحة العمل وأرصدة الاستخدام. - [فتح مثيل سير عمل ومتابعته](https://raptix.app/user-guide/ar/50-applications/50-27-workflow-instance-detail/) --- URL: https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/ # فهم الفوترة والخطط والفترات التجريبية والأدوار > **الوحدة:** الفوترة > > **الجمهور:** أعضاء مساحة العمل الذين يحتاجون إلى فهم الحدود، والمشرفون الذين لديهم صلاحية عرض الفوترة، ومالك الفوترة > > **الوصول المطلوب:** تعتمد رؤية الفوترة على صلاحية الحساب في مساحة العمل؛ ولا تظهر عناصر الدفع إلا لمالك الفوترة وفقط عند إعداد المدفوعات المستضافة > > **ستتعلم:** من أين تأتي حقائق الخطة الحالية، وما الذي تفعله الفترة التجريبية لـPro، وما الذي تعرضه نظرة الفوترة العامة، وكيف تختلف مسؤوليات العارض والمالك، وكيف ترتبط الخطة والمقاعد والرصيد وإتاحة الميزات. ## استخدام المصدر المباشر لحقائق الخطة يوفر RAPTIX دليل الخطط المعروض في صفحة **الأسعار (Pricing)** العامة وداخل **الفوترة (Billing)**. يزوّد النشر الحالي أسماء الخطط وأسعارها وحدودها ومقاعدها المضمنة وأرصدتها وفترات الفوترة. تعامل مع القيم المعروضة باعتبارها المرجع؛ ولا تعتمد على لقطة شاشة قديمة أو رقم منسوخ في مستند. قد يتضمن الدليل خطط **Free** و**Pro** و**Ultra** و**Enterprise**. وقد تعتمد الميزة أيضًا على إعداد المزوّد أو طرحها في مساحة العمل، لذلك لا تضمن تسمية الخطة وحدها إعداد خدمة خارجية. إذا تعذر تحميل خدمة الأسعار، يعرض RAPTIX حالة عدم إتاحة بدلًا من اختلاق سعر احتياطي. ## فهم الفترة التجريبية عندما يتوفر تسجيل مساحة العمل الجديدة والفترة التجريبية لـPro، تكون التجربة مصممة لتوفير: - 14 يومًا من صلاحية Pro؛ - البدء من دون بطاقة؛ - تجربة واحدة لمساحة العمل؛ و - الانتقال إلى Free عند النهاية إذا لم يبدأ اشتراك مدفوع، من دون خصم تلقائي أو حذف بيانات مساحة العمل. تاريخ نهاية التجربة والأيام المتبقية المعروضان في الفوترة هما القيمتان الخاصتان بمساحة عملك. قد يؤدي بدء صفحة الدفع المستضافة قرب حد التجربة إلى تعديل توقيت أول خصم الفعلي كما توضحه المراجعة على الشاشة؛ ولا يمنح تجربة أخرى أو رصيد تجربة إضافيًا. قد تختلف إتاحة التسجيل والتجربة بحسب الطرح المباشر. الصفحة التي تراها هي المرجع النهائي لإتاحة العرض لمساحة العمل. ## فتح نظرة الفوترة العامة افتح **الفوترة** مباشرة، أو اتبع **الإدارة ← الفوترة** عندما يتوفر الرابط. يمكن أن تعرض النظرة العامة: - الخطة الحالية والحالة وفترة الفوترة والتجديد وتاريخ الدفع حتى أو التجربة؛ - المقاعد المضمنة والمستخدمة؛ - رصيد الخطة المشترك والمبلغ المحجوز؛ - حدود مسارات سير العمل أو عمليات التشغيل المتزامنة أو التخزين أو العناوين أو مستويات الذكاء الاصطناعي؛ - فئات الاستخدام الحالية وسجل المحفظة؛ - تغييرات الخطة أو المقاعد أو الإلغاء المجدولة؛ - تنبيه دفع يحتاج إلى المالك؛ و - الخطط والحزم وعناصر الفواتير التي تعتمد على المزوّد. يتوقف بعض العمل المقاس بأمان عندما يصل الرصيد إلى صفر. توضح الفوترة السعة المتأثرة وإجراء الاستعادة في تجربة الفوترة الحالية. ## معرفة أدوار الفوترة | المسؤولية | عارض الفوترة أو المشرف المفوّض | مالك الفوترة | |---|---:|---:| | قراءة معلومات الخطة والحدود والاستخدام المسموح بها | عند منح الصلاحية | نعم | | إدارة أعضاء مساحة العمل وأدوارهم العادية | بصلاحية إدارية منفصلة فقط | بصلاحية إدارية منفصلة فقط | | بدء صفحة الدفع أو شراء حزمة رصيد | لا | عندما يكون المزوّد جاهزًا | | تغيير الاشتراك أو إلغاؤه أو استئنافه | لا | عندما يكون المزوّد جاهزًا | | إدارة طرق الدفع والفواتير | لا | عندما يكون المزوّد جاهزًا | | شراء سعة مقاعد أو عناوين مؤهلة | لا | عند تمكينها وتوفر التمويل | | نقل ملكية الفوترة | لا | عند وجود عضو مؤهل جرى التحقق منه | لا تُمنح صلاحية الفوترة بإنشاء دور مخصص. يتحكم تعيين مالك الفوترة في مساحة العمل في الإجراءات التي تنقل المال. وتظل صلاحية الصفحة وإدارة الموارد منفصلتين. ## فهم الخطط والمقاعد والرصيد - تحدد الخطة السعة المضمنة ومستويات الميزات المؤهلة. - تحدد المقاعد عدد الأشخاص الذين يمكن لمساحة العمل إبقاؤهم نشطين وفق الاستحقاق الحالي. - يمول الرصيد المشترك العمل المقاس، وعند الإعداد المقاعد الإضافية أو خانات العناوين المؤهلة. - تُستخدم حزم الرصيد المشتراة بحسب ترتيب الاستخدام وانتهاء الصلاحية الظاهرين في الفوترة. - قد تظهر خطة أو إضافة لكنها تظل غير متاحة للشراء إلى أن يصبح المزوّد أو السعر أو طرح القياس جاهزًا. قد تستخدم الواجهة اسم **Coins** لوحدة المحفظة الحالية، بينما تستخدم الشروحات العامة اسم **Credits**. اقرأ الكمية والدورة المعروضتين باعتبارهما القيمتين الفعليتين؛ تشير التسميتان إلى رصيد استخدام RAPTIX، لا إلى أموال مخزنة في مساحة العمل. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | الفوترة مفقودة | اسأل مالك الفوترة أو المشرف عما إذا كان حسابك يملك صلاحية عرضها. | | تختلف قيم الخطة عن مستند قديم | استخدم قيم الأسعار والفوترة المباشرة. | | التجربة غير معروضة | ربما استخدمتها مساحة العمل، أو لم يُمكّن طرح التسجيل أو التجربة. | | عنصر مدفوع معطل | لا يستطيع التنفيذ إلا مالك الفوترة، ويجب أن تكون صفحة الدفع المستضافة أو إدارة المزوّد جاهزة. | | ميزة لا تزال غير متاحة في الخطة المتوقعة | تحقق من صلاحية موردها والمزوّد أو الإعداد المطلوب إلى جانب الخطة. | | توقف العمل المقاس | راجع الرصيد والسعة المتأثرة، ثم اتبع خيارات الاستعادة في الفوترة. | ## أدلة ذات صلة - [إدارة الاشتراك والرصيد والمقاعد وسعة العناوين](https://raptix.app/user-guide/ar/80-billing/80-2-subscription-credits-seats-and-addresses/) - [استخدام إعدادات الدفع والتحقق والفواتير](https://raptix.app/user-guide/ar/80-billing/80-3-payment-verification-invoices-and-recovery/) - [إنشاء مساحة عمل RAPTIX جديدة](https://raptix.app/user-guide/ar/00-getting-started/00-20-create-workspace-signup/) - [استخدام الإدارة](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) - [اختيار عناوين RAPTIX وصناديق بريد الإرسال](https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/) --- URL: https://raptix.app/user-guide/ar/80-billing/80-2-subscription-credits-seats-and-addresses/ # إدارة الاشتراك والرصيد والمقاعد وسعة العناوين > **الوحدة:** الفوترة > > **الجمهور:** مالك الفوترة في مساحة العمل > > **الوصول المطلوب:** صلاحية إدارة الفوترة؛ يتطلب الاشتراك المستضاف وشراء حزم الرصيد جاهزية مزوّد الدفع، بينما تعتمد إجراءات المقاعد والعناوين أيضًا على الخطة والرصيد وطرح المنتج ذي الصلة > > **ستتعلم:** كيف تراجع اشتراكًا وتبدأه، وتعاين تغييرات الخطة، وتلغي أو تستأنف بأمان، وتشتري رصيدًا، وتضيف مقاعد أو سعة عناوين مؤهلة، وتضبط أولوية التجديد، وتتجنب الخصم المكرر أو تغييرات الوصول غير المقصودة. ## المراجعة قبل بدء صفحة الدفع لا تختر خطة مدفوعة مؤهلة في **الفوترة** إلا بعد مراجعة: - الخطة وفترة الفوترة؛ - السعر المباشر الحالي وشرح الضريبة؛ - سياق الاستخدام الشخصي أو التجاري عند طلبه؛ - المقاعد والرصيد المضمنين؛ - تاريخ التجربة أو أول خصم الفعلي؛ و - روابط الشروط وسياسة الخصوصية وسياسة الاسترداد والدعم. يراجع RAPTIX الطلب أولًا، ثم يفتح صفحة الدفع المستضافة لدى المزوّد. تبقى تفاصيل البطاقة في صفحة المزوّد. لا يحدث خصم لمجرد فتح مربع المراجعة. إذا لم تكن صفحة الدفع الآمنة جاهزة في البيئة الحالية، توضح الفوترة ذلك ولا تعرض مسار شراء معطلًا. تستخدم Enterprise مسار التواصل مع المبيعات الظاهر. ## إكمال صفحة الدفع والتحقق منها 1. اختر **المتابعة بأمان (Continue securely)** بعد مراجعة RAPTIX. 2. أكمل الدفع في صفحة المزوّد المستضافة والموثوقة. 3. ارجع إلى صفحة نتيجة RAPTIX. 4. انتظر التحقق من نتيجة الطلب. 5. اقرأ ما إذا كانت الحالة منفذة أو قيد المعالجة أو فاشلة أو ملغاة أو غير موجودة. 6. ارجع إلى الفوترة وحدّث النظرة العامة. لا تبدأ صفحة دفع ثانية لمجرد أن التأكيد لا يزال قيد المعالجة. استخدم مرجع الطلب وحدّث النتيجة. لا تخصم الصفحة الملغاة مبلغًا ولا تغيّر الخطة الحالية أو الرصيد. ## تغيير الاشتراك أو إلغاؤه أو استئنافه للاشتراك الذي يديره المزوّد: - يعرض **تغيير الخطة (Change plan)** أو **تغيير فترة الفوترة (Change billing period)** أولًا معاينة موثوقة. - قد تتطلب الترقية المؤهلة الدفع قبل تغير الوصول. - يسري التخفيض أو الانتقال إلى Free عادة عند نهاية الفترة المدفوعة الظاهرة. - يُبقي **الإلغاء عند نهاية الفترة (Cancel at period end)** الوصول المدفوع والبيانات حتى ذلك الحد، ويوقف التجديد التالي. - يزيل **الإبقاء على الاشتراك (Keep subscription)** إلغاءً معلّقًا. إذا كانت الخطة الأقل تشمل مقاعد أقل، فقد تطلب الفوترة منك ترتيب الأعضاء الذين سيحتفظون بالوصول أولًا. يبقى مالك الفوترة محميًا في هذا الترتيب. يُعلّق الأعضاء الذين لا يمكن تمويلهم من دون حذف بياناتهم بصمت. استخدم **طرق الدفع والفواتير (Payment methods & invoices)** لتفاصيل الدفع المستضافة لدى المزوّد. ينتج الدفع الذي يحتاج إلى مصادقة أو الذي فشل حالة انتباه ظاهرة؛ ولا يُستعاد الوصول المدفوع إلا بعد تأكيد المزوّد النجاح. ## شراء حزمة رصيد عندما تكون الحزم وصفحة الدفع مفعّلتين: 1. راجع كمية الحزمة والسعر المباشر وبيان الضريبة وسياق الاستخدام وانتهاء الصلاحية. 2. أكد الشراء عبر تحقق الفوترة الجديد. 3. أكمل صفحة الدفع المستضافة. 4. انتظر النتيجة المنفذة قبل اعتبار الرصيد متاحًا. يتبع الرصيد المشترى انتهاء الصلاحية وترتيب المحفظة الظاهرين في الفوترة. لا يعني شراء حزمة تفعيل الشحن التلقائي. لا تعرض واجهة العميل حاليًا زر استرداد ذاتي؛ استخدم سياسة الاسترداد الحالية ومسار الدعم لأسئلة الاسترداد. ## إضافة مقعد واحد تعرض الفوترة العدد الحالي والمستهدف للمقاعد والمقاعد المضمنة والسعر بالرصيد والمبلغ المستحق الآن والرصيد بعد الشراء وأي حد أقصى للخطة. 1. اختر **إضافة مقعد واحد (Add one seat)**. 2. راجع الهدف المطلق والعرض الحالي. 3. أكمل تحقق الفوترة الجديد. 4. أكد مرة واحدة. 5. انتظر نتيجة النجاح أو أنه نشط بالفعل. يتوفر المقعد الإضافي فور نجاح الإجراء، وقد يستخدم الرصيد مجددًا عند كل تجديد لدورة الاستخدام الظاهرة. ينبغي ألا تُعامل إعادة محاولة الهدف المؤكد نفسه سببًا لشراء مقعد إضافي آخر. ## إضافة سعة عناوين عندما تجعل عناوين RAPTIX والأسعار والخطة السعة الإضافية مؤهلة: 1. اختر عضو مساحة العمل النشط. 2. راجع حد عناوينه الحالي والمستهدف. 3. راجع المبلغ النسبي المستحق الآن ومبلغ التجديد اللاحق. 4. تحقق وأكد الإجراء. إذا لم يستطع الرصيد المشترك مستقبلًا تمويل عنوان إضافي، فقد تُعلّق الإضافة بدلًا من حذفها، ثم تعود عند توفر التمويل. يُدار العنوان نفسه من إعدادات البريد، ولا يُنشأ في صفحة الفوترة. ## ضبط أولوية تجديد الإضافات إذا كان الرصيد قد لا يغطي كل مقعد إضافي وعنوان بريد، فاختر الفئة التي تُموّل أولًا في دورة الاستخدام التالية. تُعلّق الإضافات غير الممولة من دون حذف أعضائها أو عناوينها أو بياناتها الأساسية. راجع هذه الأولوية كلما تغيرت احتياجات السعة أو الفريق. ## استكشاف الأخطاء وإصلاحها | المشكلة | ما يجب التحقق منه | |---|---| | لا يمكن فتح صفحة الدفع | تأكد من أنك مالك الفوترة ومن جاهزية المدفوعات المستضافة. | | تظل النتيجة قيد المعالجة | احتفظ بمرجع الطلب وحدّث النتيجة، ولا تنشئ طلبًا مكررًا. | | تغيير الخطة غير متاح | حل تغييرًا أو إلغاءً معلّقًا أو تنبيه المزوّد أولًا. | | لا يمكن إضافة مقعد | تحقق من الاشتراك النشط والحد الأقصى للخطة والسعر المعدّ وكفاية الرصيد. | | لا يمكن إضافة سعة عنوان | تحقق من طرح RAPTIX Mail وحالة العضو والحد لكل شخص وسعر الخطة والرصيد. | | قد يفقد عضو الوصول بعد التخفيض | راجع أولوية الأعضاء وأعد ترتيبها قبل التأكيد. | | عُلّقت إضافة | استعد رصيدًا كافيًا وتحقق من أولوية التجديد المحفوظة؛ فلا تُحذف البيانات الأساسية بالتعليق. | ## أدلة ذات صلة - [فهم الفوترة والخطط والفترات التجريبية والأدوار](https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/) - [استخدام إعدادات الدفع والتحقق والفواتير](https://raptix.app/user-guide/ar/80-billing/80-3-payment-verification-invoices-and-recovery/) - [إدارة الأعضاء وطلبات الانضمام ونشاط تسجيل الدخول وSSO](https://raptix.app/user-guide/ar/70-administration/70-2-user-management/) - [اختيار عناوين RAPTIX وصناديق بريد الإرسال](https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/) - [الحصول على المساعدة من الدعم](https://raptix.app/user-guide/ar/00-getting-started/00-19-getting-help-support/) --- URL: https://raptix.app/user-guide/ar/80-billing/80-3-payment-verification-invoices-and-recovery/ # استخدام إعدادات الدفع والتحقق والفواتير > **الوحدة:** الفوترة > > **الجمهور:** مالك الفوترة في مساحة العمل؛ يستطيع عارضو الفوترة المسموح لهم قراءة النظرة العامة غير الحساسة التي تسمح بها صلاحيتهم فقط > > **الوصول المطلوب:** ملكية الفوترة لتغييرات الدفع والوصول إلى الفواتير؛ لا تظهر عناصر المزوّد وسجلاته إلا عند إعداد تكامل الدفع > > **ستتعلم:** لماذا يطلب RAPTIX تحققًا جديدًا، وكيف تدير إعدادات الدفع المستضافة لدى المزوّد، وتقرأ نتائج صفحة الدفع، وتعثر على الفواتير وتنزّلها، وتستجيب لتنبيهات الدفع، وتنقل ملكية الفوترة، وتتعافى من الحدود من دون فقد العمل. ## تأكيد إجراء فوترة حساس تتطلب الإجراءات التي تنقل المال أو الملكية تفويض فوترة جديدًا لمرة واحدة. تسمّي لوحة التأكيد الإجراء الدقيق قبل تغيير أي شيء. 1. راجع الإجراء ومبلغه الحالي أو هدفه أو المالك الجديد. 2. لحساب كلمة مرور محلي، أدخل كلمة المرور الحالية عند طلبها. تتبع حسابات تسجيل الدخول عبر Microsoft أو Google التعليمات الظاهرة. 3. اختر **إرسال رمز التحقق (Send verification code)**. 4. أدخل الرمز المؤلف من ستة أرقام والمرسل إلى بريد الفوترة المسجل. 5. اختر **التحقق والمتابعة (Verify and continue)**. 6. أكمل الإجراء المحدد الذي راجعته قبل انتهاء صلاحية التفويض. يرتبط التفويض بإجراء واحد ولا يمكن إعادة استخدامه لشراء أو تغيير مختلف. إذا تغير السعر أو الرصيد أو الملكية أو الهدف أثناء التحقق، يطلب منك RAPTIX التحديث والمراجعة مجددًا. لا تشارك رمز التحقق أبدًا مع الدعم أو عضو آخر في مساحة العمل. ## إدارة طرق الدفع وفواتير المزوّد عندما تكون إدارة المزوّد جاهزة، اختر **طرق الدفع والفواتير (Payment methods & invoices)**. يتحقق RAPTIX من الإجراء، ثم يفتح بوابة المزوّد الموثوقة. لا يستلم RAPTIX رقم البطاقة أو رمز CVC المدخل هناك ولا يخزنهما. استخدم البوابة لطرق الدفع وسجلات المزوّد التي تعرضها. ارجع بعد ذلك إلى فوترة RAPTIX وحدّث حالة الخطة وتنبيه الدفع. ## العثور على سجل فواتير RAPTIX تظهر منطقة **الفواتير (Invoices)** لمالك الفوترة عندما تتوفر بيانات الفواتير. ويمكنها عرض طلبات الاشتراك أو الرصيد الحديثة والسماح بتنزيل PDF مسموح. اختر إجراء **تنزيل (Download)** للفاتورة. يتحقق RAPTIX من صلاحيتك الحالية قبل إعادة ملف PDF. قد يُنفذ طلب قبل توفر مرجع الفاتورة؛ ارجع لاحقًا بدلًا من اعتبار غياب PDF فشلًا في الاشتراك. لصفحة دفع جديدة، تعرض صفحة النتيجة المتحقق منها أيضًا الفاتورة عندما ينتج التنفيذ واحدة. ## الاستجابة لتنبيه الدفع | الحالة | معناها | ما يجب فعله | |---|---|---| | الدفع يحتاج إلى تأكيد | يتطلب المزوّد خطوة مصادقة إضافية. | افتح إعدادات الدفع وأكمل الإجراء المطلوب. | | فشل أحدث دفع | لا يمتد الوصول المدفوع بعد حد الدفع حتى الظاهر. | حدّث الطريقة أو أكمل مصادقة المزوّد، ثم اسمح للمحاولة المؤكدة باستعادة الوصول. | | صفحة الدفع قيد المعالجة | ينتظر RAPTIX نتيجة المزوّد الموقّعة. | احتفظ بمرجع الطلب وحدّث؛ ولا تنشئ طلبًا مكررًا. | | أُلغيت صفحة الدفع | أُغلقت الصفحة المستضافة من دون طلب مكتمل. | ارجع إلى الفوترة؛ تبقى الخطة والرصيد من دون تغيير. | | الفاتورة غير متاحة | الفاتورة غير جاهزة أو تغيرت صلاحيتك أو فشل الاسترداد. | حدّث الفوترة وحاول لاحقًا؛ تواصل مع الدعم بمرجع الطلب عند الحاجة. | ## نقل ملكية الفوترة عندما يكون عضو نشط مؤهل جرى التحقق منه مدرجًا: 1. اختر **نقل ملكية الفوترة (Transfer Billing ownership)**. 2. اختر المالك الجديد. 3. اقرأ تغيير الصلاحية الدائم بعناية. 4. أكمل تحقق فوترة جديدًا. 5. أكد مرة واحدة. يصبح المالك الجديد الشخص المخوّل بإدارة صفحة الدفع وتفاصيل الدفع والإلغاء وغيرها من الإجراءات المالية. يفقد المالك السابق هذه الصلاحية فورًا. ولا تحل أدوار إدارة مساحة العمل محل ملكية الفوترة. ## التعافي من حد سعة أو رصيد تعرض الفوترة السعة المتأثرة ومسار التعافي المناسب: - قلل العمل الذي يستهلك السعة المحدودة أو أكمله؛ - انتظر دورة رصيد الخطة التالية عند الحاجة؛ - اشترِ حزمة رصيد عندما تكون مفعّلة؛ - اختر خطة ذات الحد المباشر المطلوب؛ - أضف سعة مقعد أو عنوان مؤهلة؛ أو - اطلب من مالك الفوترة حل دفع فاشل أو اشتراك غير نشط. تتوقف مسارات سير العمل المقاسة بأمان قبل الخطوة التالية القابلة للفوترة عند نفاد الرصيد المتاح. بعد استعادة الرصيد أو الاشتراك، استخدم عنصر استعادة سير العمل الظاهر أو إرشادات المثيل؛ ولا تنشئ عملية عمل ثانية إلا إذا كانت هذه هي النتيجة المقصودة. ## استكشاف مشكلات التحقق وإصلاحها | المشكلة | ما يجب فعله | |---|---| | لم يصل رمز | تحقق من بريد الفوترة المسجل ومجلد الرسائل غير المرغوب فيها ومؤقت إعادة الإرسال. | | الرمز غير صالح أو منتهي | اطلب رمزًا جديدًا واستخدم الأحدث فقط. | | كلمة المرور المحلية مرفوضة | أدخل كلمة مرور RAPTIX الحالية؛ تتبع حسابات تسجيل الدخول عبر المزوّد تعليمات ترك كلمة المرور فارغة. | | انتهت صلاحية التفويض | راجع التفاصيل الحالية وتحقق مجددًا. لم يتغير شيء تلقائيًا. | | تغيرت ملكية الفوترة | حدّث الصفحة. لا يستطيع المتابعة إلا المالك الحالي. | | تغير الرصيد قبل التأكيد | حدّث عرض السعر وقرر مجددًا؛ لا يستطيع التفويض السابق فرض المبلغ القديم. | | لا تزال مشكلة دفع أو فاتورة قائمة | تواصل مع الدعم بمرجع الطلب أو الفاتورة، لا برقم بطاقة أو كلمة مرور أو رمز تحقق. | ## أدلة ذات صلة - [فهم الفوترة والخطط والفترات التجريبية والأدوار](https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/) - [إدارة الاشتراك والرصيد والمقاعد وسعة العناوين](https://raptix.app/user-guide/ar/80-billing/80-2-subscription-credits-seats-and-addresses/) - [الحصول على المساعدة من الدعم](https://raptix.app/user-guide/ar/00-getting-started/00-19-getting-help-support/) - [البقاء مسجّل الدخول وتسجيل الخروج بأمان](https://raptix.app/user-guide/ar/00-getting-started/00-16-sessions-and-logout/) - [إدارة الأعضاء وطلبات الانضمام ونشاط تسجيل الدخول وSSO](https://raptix.app/user-guide/ar/70-administration/70-2-user-management/) --- URL: https://raptix.app/user-guide/ar/glossary/ # مسرد RAPTIX > **الوحدة:** المنصة كاملة    **الجمهور:** جميع المستخدمين > المرجع الموحد لكل مصطلح منتج مستخدم في وثائق RAPTIX. > تتبع الأقسام الترتيب الأبجدي للأسماء الإنجليزية المرجعية، ويُذكر اسم الوحدة بعد التعريف عندما يختص المصطلح بوحدة معينة. --- ## A **سياسة الوصول (`Access Policy`)** *(المعرفة)* قاعدة مسماة تتحكم في الأدوار التي تستطيع قراءة جزء من محتوى قاعدة المعرفة، وما يحدث عند رفض الوصول؛ وتشمل الخيارات إخفاء المحتوى تمامًا، أو إرجاع رسالة لطيفة، أو عرض نسخة منقحة بأمان. *سبب الأهمية:* تضمن ألّا يتلقى المعلومات الحساسة عند سؤال مساعد الذكاء الاصطناعي إلا الأشخاص المناسبون. **زر الإجراء (`Action Button`)** *(سير العمل)* زر ذو تسمية يظهر للمكلّف بالمهمة على شاشة الموافقة، مثل «موافقة» أو «رفض» أو «إعادة للمراجعة». يضبط مصمم سير العمل اسم كل زر ولونه وسلوكه، ويحدد الزر المسار التالي للعملية. *سبب الأهمية:* يمنح أعضاء الفريق قرارات تناسب مجال العمل بدل نعم أو لا عامتين، فيقل الالتباس والتوجيه الخاطئ. **عقدة وكيل الذكاء الاصطناعي (`AI Agent Node`)** *(سير العمل)* خطوة في سير العمل تشغّل نموذج ذكاء اصطناعي لتحليل البيانات أو إنشاء المحتوى أو اتخاذ قرار توجيه، باستخدام قالب مطالبة، وبحث اختياري في قاعدة المعرفة، ومخرجات منظمة، وتفرع قائم على درجة الثقة. *سبب الأهمية:* تضيف حكمًا ذكيًا وآليًا إلى خطوة العملية من دون مراجعة بشرية لكل سجل. **دمج «الكل» (`ALL Merge`)** *(سير العمل)* إعداد في عقدة دمج الفروع يُبقي سير العمل عند عقدة الدمج حتى تنتهي جميع الفروع المتوازية قبل المتابعة. *سبب الأهمية:* يضمن عدم تخطي أي خطوة، وهو مفيد عندما يعتمد العمل اللاحق على اكتمال جميع الفروع. **دمج «أي فرع» (`ANY Merge`)** *(سير العمل)* إعداد في عقدة دمج الفروع يستأنف سير العمل فور انتهاء أول فرع متوازٍ، بصرف النظر عن الفروع الأخرى. *سبب الأهمية:* يحافظ على سرعة العملية وفق أسرع فريق من دون انتظار الفروع الأبطأ. **تطبيق (`App`)** *(التطبيقات)* أداة داخلية مستقلة متاحة عبر «التطبيقات». يمكن أن تحتوي صفحات منشئ التطبيقات، ونماذج سير عمل قابلة للتشغيل، ومستندات، ومسارات سير عمل، بحسب مساحة العمل ووصول المستخدم. *سبب الأهمية:* يخدم كل تطبيق غرضًا تجاريًا محددًا، من سجلات الدوام إلى نماذج المشتريات، ويمكن تحديثه من دون إعادة البناء من البداية. **منشئ التطبيقات (`App Builder`)** منشئ متاح لخطة Enterprise لإنشاء صفحات تطبيقات قائمة على البيانات وتعديلها. يُفتح من «التطبيقات» عندما تسمح خطة المستخدم وصلاحياته. *سبب الأهمية:* تستطيع الفرق صيانة النماذج ولوحات المعلومات الداخلية، مع فصل RAPTIX وصول البناء عن وصول تشغيل الصفحات المنشورة. **التطبيقات (`Applications`)** منطقة RAPTIX على `/applications` التي تجمع مساحات العمل والتطبيقات والصفحات ونماذج سير العمل القابلة للتشغيل والمستندات وسير العمل. يعتمد ما يظهر على خطة المستخدم وصلاحياته. *سبب الأهمية:* تمنح المستخدم مكانًا واحدًا للعثور على أدوات التشغيل المتاحة له وفتحها. **جدول الموافقة (`Approval Table`)** *(سير العمل)* عرض قرار لكل صف تستخدمه مهام الموافقة المضبوطة في سير العمل. يسجل قرار الموافقة أو الرفض أو التعليق، إلى جانب هوية الموافق والوقت. *سبب الأهمية:* يستطيع مديرو العمليات مراجعة مئات البنود دفعة واحدة، مع سجل تدقيق كامل لكل قرار منفرد. **الخط الزمني للموافقة (`Approval Timeline`)** *(سير العمل)* قائمة مرئية زمنية لكل خطوة في مثيل سير العمل، توضح من تصرف، والقرار الذي اتخذه، ووقته، وأي تعليق تركه. *سبب الأهمية:* تمنح المشاركين شفافية كاملة في العملية من دون الحاجة إلى السؤال عن حالتها. **المساعد (`Assistant`)** *(وكلاء الذكاء الاصطناعي)* شخصية ذكاء اصطناعي يضبطها المسؤول باسم ورمز ونطاق معرفة ومطالبة نظام وقيود وصول. يختار المستخدم مساعدًا من مركز وكلاء الذكاء الاصطناعي ويفتح محادثة معه. *سبب الأهمية:* يخدم كل مساعد غرضًا مختلفًا؛ فقد يجيب أحدهم عن سياسات الموارد البشرية ويتصفح آخر مستندات الهندسة، فيذهب المستخدم دائمًا إلى المصدر المناسب. **سجل التدقيق (`Audit Log`)** *(المستندات / التطبيقات / المعرفة)* سجل زمني مقاوم للعبث لكل إجراء نُفذ، مثل الرفع والتنزيل وتغيير الصلاحيات وإسناد السياسات وعرض الصفحات، مع هوية المنفذ ووقت الإجراء وموقعه. *سبب الأهمية:* يدعم مراجعات الامتثال والتحقيق في الحوادث عبر تاريخ كامل ودقيق لمن فعل ماذا. **الحفظ التلقائي (`Auto-Save`)** *(سير العمل)* عملية خلفية تحفظ تلقائيًا الحالة الحالية لسير العمل أثناء تصميمه، وتنشئ إصدارًا مؤرخًا كل 30 ثانية عند وجود تغييرات غير محفوظة. *سبب الأهمية:* لا يضيع العمل بسبب إغلاق المتصفح أو انقطاع الشبكة؛ إذ تبقى أحدث حالة محمية. **المزامنة التلقائية (`Auto-Sync`)** *(المعرفة)* قاعدة مضبوطة تكتشف تلقائيًا رفع مستند جديد إلى «المستندات»، وترسله فورًا إلى مسار معالجة قاعدة المعرفة من دون إجراء يدوي. *سبب الأهمية:* تظل قاعدة المعرفة حديثة بلا جهد إداري، وتتاح المستندات الجديدة سريعًا للبحث المدعوم بالذكاء الاصطناعي. --- ## B **الموافقة الدفعية (`Batch Approval`)** *(سير العمل)* وضع مهمة يراجع فيه المكلّف مجموعة بيانات كاملة، مثل جدول بنود مشتريات، ويسجل قرار موافقة أو رفض أو تعليق مستقلًا لكل صف في جلسة شاشة واحدة. *سبب الأهمية:* يقلل كثيرًا وقت معالجة كميات كبيرة من السجلات التي تحتاج قرارات منفردة. **الفرع (`Branch`)** *(سير العمل)* مسار مستقل على لوحة سير العمل. تُنشئ الفروع عقد التقسيم أو التفرع الشرطي أو الشرط الثنائي، وتسمح بتنفيذ منطق مختلف بالتوازي أو وفق شروط. *سبب الأهمية:* تمثل العمليات الواقعية التي تحتاج فيها نتائج أو أقسام مختلفة إلى العمل في الوقت نفسه أو بصورة مستقلة. **مسار التنقل (`Breadcrumb`)** *(المستندات / التطبيقات)* سلسلة روابط توضح الموضع الحالي داخل تسلسل هرمي، مثل «مساحة العمل ← المشروع أ ← مجلد الفواتير». ينقلك اختيار أي مستوى إليه مباشرة. *سبب الأهمية:* يعرف المستخدم مكانه دائمًا ويستطيع الصعود في التسلسل بنقرة واحدة. --- ## C **الذاكرة المؤقتة (`Cache`)** مخزن مؤقت لبيانات حُسبت حديثًا، يجعل الشاشات أسرع في التحميل. يدير RAPTIX التخزين المؤقت تلقائيًا، ولا توجد إعدادات له موجهة إلى المسؤول. *سبب الأهمية:* تُحمّل لوحات المعلومات والإحصاءات بسرعة حتى مع أحجام بيانات كبيرة، من دون ضبط يدوي. **الاستشهاد (`Citation`)** *(وكلاء الذكاء الاصطناعي)* مرجع مرقم، مثل `[1]` أو `[2]`، مضمّن في إجابة المساعد ويرتبط مباشرة بالمقطع الدقيق في المستند المصدر الذي يدعم العبارة. *سبب الأهمية:* يمكن التحقق من كل ادعاء واقعي بالنقر للوصول إلى المصدر، مما يبني الثقة في الإجابات المولدة. **التصنيف (`Classification`)** *(المعرفة)* وسم أمان يُسند إلى سياسة وصول. مستوياته المتاحة: عام، وداخلي، وسري، ومقيّد، وسري للغاية. يحدد من يرى المحتوى وما قواعد الإخفاء المطبقة. *سبب الأهمية:* تستطيع المؤسسة مواءمة أمان قاعدة المعرفة مع نظام تصنيف بياناتها المعتمد. **عقدة الشرط أو إذا/وإلا (`Condition Node / If/Else Node`)** *(سير العمل)* عقدة تقيّم شرط بيانات واحدًا أو أكثر، وتوجه العملية إلى فرع «نعم» أو «لا» بحسب النتيجة؛ كالتوجيه التلقائي إذا كان المبلغ دون حد معين. *سبب الأهمية:* تؤتمت قرارات التوجيه التي كانت تحتاج تقييمًا يدويًا، فتقلل التأخير والأخطاء البشرية. **عقدة التفرع الشرطي (`Conditional Branch Node`)** *(سير العمل)* عقدة تقيّم عدة شروط مسماة وتسلك مسار أول شرط مطابق. وعلى خلاف «إذا/وإلا»، تدعم أكثر من نتيجتين. *سبب الأهمية:* تعالج توجيهًا متعدد النتائج بوضوح، مثل الإرسال إلى المالية أو القانونية أو الموارد البشرية بحسب نوع الطلب، من دون تداخل عدة عقد ثنائية. **سلسلة المحادثة (`Conversation Thread`)** *(سير العمل / المستندات)* سجل زمني يشبه الدردشة لكل التعليقات التي يتركها المشاركون على جميع مستويات مهمة مستند أو سير عمل. *سبب الأهمية:* يجمع النقاش والأسئلة والتوضيحات المتعلقة بالطلب في مكان واحد بدل ضياعها بين سلاسل البريد. **دمج «العدد» (`COUNT Merge`)** *(سير العمل)* إعداد في عقدة دمج الفروع يستأنف سير العمل بعد اكتمال عدد محدد من الفروع المتوازية، من دون انتظار البقية. *سبب الأهمية:* يفيد عندما تستطيع العملية المتابعة بعد بلوغ النصاب من الموافقات أو الردود بدل اشتراط الإجماع. --- ## D **الوضع الداكن (`Dark Mode`)** مظهر مرئي لـRAPTIX يستخدم خلفيات داكنة ونصًا فاتحًا. يمكن تشغيله أو إيقافه من المبدّل في الشريط العلوي، ويُحفظ التفضيل بلا حد زمني. *سبب الأهمية:* يقلل إجهاد العين في الإضاءة الخافتة، وهو تفضيل شخصي يضبطه كل مستخدم باستقلال. **قائمة الرسائل المتعذرة (`Dead-Letter Queue` أو `DLQ`)** *(سير العمل — مشغل البريد)* منطقة تحفظ الرسائل التي استقبلتها عقدة تشغيل البريد ولم تستطع معالجتها بسبب أخطاء. وعندما يبلغ عدد الإخفاقات المتتالية الحد المضبوط، تتوقف العقدة تلقائيًا لتمنع مشكلات إضافية. *سبب الأهمية:* يستطيع المسؤول فحص الرسائل الفاشلة وحل المشكلة من دون فقد البيانات الواردة أو استمرار أتمتة خارجة عن السيطرة. **الموعد النهائي (`Deadline`)** *(سير العمل)* تاريخ استحقاق مضبوط في عقدة مهمة، تبدأ بعده التذكيرات وإجراءات التصعيد الآلية. قد يكون تاريخًا ثابتًا أو مدة نسبية أو قيمة مقروءة من بيانات سير العمل. *سبب الأهمية:* لا تضيع المهام؛ إذ تتصعد تلقائيًا عندما لا يُتخذ إجراء في الوقت المطلوب. **التوقيع الرقمي (`Digital Signature`)** *(المستندات)* أداة تعليق تضع علامة موافقة، مثل ختم أو خط يدوي أو نص مكتوب، على ملف PDF داخل عارض المستند. تُحفظ النسخة المعلّق عليها كإصدار جديد. *سبب الأهمية:* يمكن وسم المستندات والموافقة عليها رسميًا داخل المنصة من دون تنزيل أو طباعة أو خدمة توقيع أخرى. **التكرار (`Duplicate`) لسير العمل أو القالب** وظيفة تنسخ سير عمل أو قالب تواصل موجودًا إلى عنصر جديد مستقل قابل للتعديل. يحمل المستنسخ الإعدادات الأصلية كلها لكنه يُحفظ باسم جديد. *سبب الأهمية:* تعيد استخدام تصميمات مجربة كنقطة بداية، فتختصر وقت الإعداد وتقلل الأخطاء. --- ## E **مشغل البريد الإلكتروني (`Email Trigger`)** *(سير العمل)* عقدة بدء تراقب صندوق بريد محددًا وتشغّل سير عمل تلقائيًا عندما تطابق رسالة واردة قواعد ترشيح، مثل عنوان المرسل أو كلمة في الموضوع أو نوع المرفق. *سبب الأهمية:* تحول صندوق البريد إلى مدخل أتمتة؛ فتبدأ الفواتير أو الطلبات أو التنبيهات الواردة عملية موافقة منظمة من دون تدخل يدوي. **التضمين المتجهي (`Embedding`)** *(المعرفة)* عملية تحول مقطع مستند إلى تمثيل رياضي كي تعثر عليه قاعدة المعرفة بالبحث عن المعنى لا بمطابقة الكلمات فقط. *سبب الأهمية:* يمكن للمستخدم السؤال بلغة طبيعية، مثل «ما فترة صيانة الوحدة 5؟»، والحصول على إجابة دقيقة حتى إن اختلفت ألفاظ المستند. **عقدة النهاية (`End Node`)** *(سير العمل)* عقدة تحدد نقطة انتهاء فرع في سير العمل. عندما تصل العملية إليها، يُعد الفرع مكتملًا. ويمكن أن يحتوي سير العمل عدة عقد نهاية لنتائج مختلفة. *سبب الأهمية:* تحدد بوضوح نهاية كل مسار، وتضمن أن يسجل المحرك الاكتمال بصورة صحيحة. **لوحة المحرك (`Engine Dashboard`)** *(سير العمل)* شاشة المراقبة الرئيسية لسير العمل، وتعرض المثيلات الجارية والمكتملة مع حالتها وتفاصيل الإنشاء والتقدم، وتشمل مرشحات للحالة والمنشئ ونوع سير العمل. *سبب الأهمية:* تمنح المديرين والمسؤولين عرضًا حيًا للعمليات حتى يكتشفوا الاختناقات أو المثيلات العالقة. **الكيان (`Entity`)** *(المستندات)* أعلى وحدة تنظيمية في التسلسل الهرمي للمستندات، وتمثل عادة مشروعًا أو قسمًا أو كائن أعمال. يأتي تحت الكيان المثيلات ثم الحقول ثم الملفات. *سبب الأهمية:* تُحفظ المستندات دائمًا في سياق سجل المشروع الصحيح بدل بعثرتها في مجلدات غير منظمة. **التصعيد (`Escalation`)** *(سير العمل)* إجراء تلقائي يُنفذ عندما تتجاوز المهمة موعدها من دون رد، مثل إعادة إسنادها إلى شخص آخر، أو إرسال تنبيهات إضافية، أو دفع سير العمل إلى مسار احتياطي. *سبب الأهمية:* يضمن ألّا تُنسى المهام المتأخرة، وأن تستمر العملية حتى إن لم يستجب المكلّف الأصلي. **بوابة الموافق الخارجي (`External Approver Portal`)** *(سير العمل)* صفحة ويب آمنة لا تحتاج إلى تسجيل دخول، تُرسل برابط بريد إلى شخص خارج المؤسسة، كالمورد أو المتعاقد، ليوافق على مهمة أو يرفضها. الرابط للاستخدام مرة واحدة وينتهي بعد اتخاذ الإجراء. *سبب الأهمية:* يشارك الشركاء الخارجيون في الموافقة من دون حساب منصة، مع الحفاظ على الأمان وتقليل العوائق. --- ## F **الحقل (`Field`)** *(المستندات)* المستوى الثالث في تسلسل «المستندات»، ويأتي تحت مثيل سير العمل. يمثل عادة فئة مستند داخل سجل عملية، مثل «العقد الموقّع» أو «الفاتورة». *سبب الأهمية:* يفصل أنواع المستندات المختلفة داخل سجل العملية نفسه، ويحافظ على بنية ملفات متوقعة ومنظمة. **الملف (`File`)** *(المستندات)* المستند الفعلي المرفوع، كملف PDF أو Word أو جدول بيانات أو صورة، والمحفوظ أسفل تسلسل «مساحة العمل ← التطبيق ← الصفحة ← الكيان ← المثيل ← الحقل ← الملف». *سبب الأهمية:* يُحفظ المستند الفعلي دائمًا في سياقه، ويمكن العثور عليه بالتنقل في التسلسل أو البحث بالاسم. **عقدة «لكل عنصر» (`Foreach Node`)** *(سير العمل)* عقدة تكرر مجموعة خطوات داخلية لكل عنصر في قائمة، مثل إرسال إشعار مستقل لكل مرفق في طلب. *سبب الأهمية:* تعالج القوائم تلقائيًا من دون نسخ العقد يدويًا، وتحافظ على نظافة التصميم. **جامع النماذج (`Form Collector`)** *(منشئ التطبيقات، تكامل قديم)* تكامل توافق يجمع القيم من عناصر واجهة صفحة منشئ التطبيقات. تُعرض نماذج سير العمل الجديدة عادة من عقدة بدء يدوي، وتُفتح عبر «التطبيقات» على `/f/:token`. *سبب الأهمية:* تستمر صفحات منشئ التطبيقات الحالية في Enterprise بإرسال بيانات منظمة، بينما تستخدم النماذج الجديدة المسار الأصلي لنماذج سير العمل. --- ## G **الصلاحية العامة (`Global Permission`)** *(المستندات)* منحة وصول تطبق على جميع المستندات، سواء الموجودة أو المستقبلية أو كليهما، بدل مستند أو مجلد واحد. يمنحها المسؤول لمستخدم أو دور. *سبب الأهمية:* تتيح وصول فريق كامل إلى جميع المستندات ذات الصلة بإجراء واحد، بدل ضبط كل ملف على حدة. --- ## H **الشاشة الرئيسية (`Home Screen`)** أول شاشة بعد تسجيل الدخول. تلخص العمل الذي يحتاج إلى انتباه المستخدم، ومسارات سير العمل التي يشارك فيها، والعناصر الحديثة في «التطبيقات». ولا تظهر الأقسام إلا إذا توفر الوصول المطلوب. *سبب الأهمية:* يستأنف المستخدم عمله ويتصرف في العناصر العاجلة من دون البحث أولًا في الوحدات. --- ## I **عقدة شرط إذا/وإلا (`If/Else Condition Node`)** — راجع **عقدة الشرط**. **المثيل (`Instance`)** *(المستندات / سير العمل)* في «المستندات»، المثيل هو المستوى الثاني من التسلسل: حالة محددة من عملية، مثل مشروع أو طلب بعينه، تقع تحت كيان وتحتوي حقولًا وملفات. وفي «سير العمل»، المثيل، أو عملية التشغيل، هو تنفيذ واحد لتصميم سير عمل، أي حالة بعينها تُعالج عبر الخطوات المحددة. *سبب الأهمية:* يفصل كل حالة ويجعلها قابلة للتتبع، فلا تختلط مستندات الحالات وموافقاتها. --- ## J **كائن JavaScript ‏(`JavaScript Object` أو `JSObject`)** *(منشئ التطبيقات، متقدم)* كتلة JavaScript قابلة لإعادة الاستخدام مرتبطة بصفحة في منشئ التطبيقات، ويمكن استدعاؤها من أحداث عناصر الواجهة مثل النقر على زر أو إرسال نموذج. *سبب الأهمية:* تتيح للمطور كتابة المنطق المخصص مرة واحدة وإعادة استخدامه في الصفحة، مما يسهل صيانة التطبيقات وتحديثها. --- ## K **المعرفة (`Knowledge`)** *(المعرفة / وكلاء الذكاء الاصطناعي)* المستودع المركزي للمستندات المعالجة الذي يبحث فيه المساعد عند الإجابة. تمر المستندات بمسار متعدد المراحل قبل أن تصبح حية في قاعدة المعرفة. *سبب الأهمية:* تستند إجابات الذكاء الاصطناعي إلى مستندات المؤسسة بدل محتوى الإنترنت العام، فتكون أدق وقابلة للتدقيق. --- ## L **عقدة الحلقة (`Loop Node`)** *(سير العمل)* عقدة خاصة تسمح باتصال يعود إلى خطوات سابقة، فتنشئ دورة مقصودة؛ مثل إعادة مهمة إلى مرحلة سابقة للتصحيح قبل دخول سلسلة الموافقة مجددًا. *سبب الأهمية:* تمثل دورات المراجعة الواقعية بوضوح من دون إنشاء حلقات لا نهائية عرضية في التصميم. --- ## M **شاشة موافقة المدير (`Manager Approval Screen`)** *(سير العمل)* صفحة مهمة بملء الشاشة يراها الموافق عند فتح مهمة مسندة. تعرض بيانات الطلب، وعارض PDF مضمنًا، وأزرار إجراء ديناميكية، وحقل تعليق، ورفع ملفات، وسلسلة المحادثة. *سبب الأهمية:* يجد المدير كل ما يحتاجه للمراجعة والقرار في شاشة واحدة من دون التنقل بين تطبيقات. **عقدة دمج الفروع (`Merge Branches Node`)** *(سير العمل)* عقدة تعيد وصل الفروع المتوازية التي قُسمت سابقًا. ويمكن ضبطها لانتظار كل الفروع أو أي فرع أو عدد محدد قبل المتابعة. *سبب الأهمية:* تتحكم بدقة في وقت إعادة مزامنة العملية المتوازية، وتمنح المصمم سيطرة واضحة على التسلسل. **وسم الدمج (`Merge Tag`)** *(سير العمل / التواصل)* عنصر نائب بالصيغة `{{variable_name}}` يُستخدم في موضوع البريد أو نصه أو قالب الإشعار. عند الإرسال، يُستبدل تلقائيًا بالقيمة الحقيقية من بيانات سير العمل. *سبب الأهمية:* تخصص كل رسالة آلية ببيانات حية، كاسم المستلم والمبلغ والتاريخ وأي متغير آخر، من دون تعديل يدوي. **تسجيل Microsoft الموحد (`Microsoft SSO`)** طريقة دخول تستخدم حساب Microsoft المؤسسي الحالي بدل كلمة مرور مستقلة لـRAPTIX. يضبطها المسؤول في إعدادات تسجيل الدخول. *سبب الأهمية:* يدخل المستخدم فورًا ببيانات يعرفها، وتحتفظ تقنية المعلومات بالتحكم عبر أدوات Microsoft الحالية ومنها التحقق متعدد العوامل. **الموافقة متعددة المستويات (`Multi-Level Approval`)** *(سير العمل)* إعداد مهمة يجب فيه أن يمر مستند أو قرار عبر أكثر من موافق بالتتابع، مثل قائد الفريق ثم رئيس القسم ثم المالية، قبل متابعة سير العمل. *سبب الأهمية:* يفرض تسلسل الاعتماد المؤسسي تلقائيًا من دون تتبع يدوي لمن راجع ماذا. --- ## N **العقدة (`Node`)** *(سير العمل)* خطوة واحدة على لوحة سير العمل، تمثلها بطاقة برمز وتسمية يناسبان نوعها. تتصل العقد بأسهم، أو حواف، تحدد مسار العملية. ومن أنواعها البدء والمهمة والبريد والشرط ووكيل الذكاء الاصطناعي والإيقاف المؤقت والنهاية. *سبب الأهمية:* تمثل كل عقدة إجراء عمل ذريًا واحدًا، فيصبح مجمل العملية مخططًا مرئيًا سهل القراءة والصيانة. --- ## O **التطبيقات (`Applications`)** منطقة RAPTIX لتصفح مساحات العمل والتطبيقات والصفحات والمستندات ونماذج سير العمل القابلة للتشغيل. ويتاح منشئ التطبيقات للتطبيقات والخطط المؤهلة. *سبب الأهمية:* هي المكان الذي تفتح منه الموارد المسندة إليك وتديرها حيثما سُمح لك. **وكلاء الذكاء الاصطناعي (`AI Agents`)** قدرة المساعد الذكي في RAPTIX. يسأل المستخدم بلغة طبيعية ويتلقى إجابات موثقة باستشهادات من مستندات المؤسسة. يضبط المسؤول مساعدِين مسمّين لفرق أو أغراض مختلفة. *سبب الأهمية:* يحصل الموظف على إجابات دقيقة وفورية من مستندات الشركة بدل البحث في أنظمة الملفات أو انتظار رد زميل. **المستندات (`Documents`)** قدرة إدارة المستندات في RAPTIX، وتنظم الملفات في تسلسل مرتبط بسجلات العمليات. وتشمل الإصدارات وسجل التدقيق والتعليق على PDF وإدارة الصلاحيات وفهرسة الذكاء الاصطناعي. *سبب الأهمية:* تعيش المستندات في سياق العملية التابعة لها، مع تتبع كامل لكل إجراء على كل ملف. **سير العمل (`Workflows`)** قدرة أتمتة سير العمل والعمليات في RAPTIX. يصمم المستخدم العمليات على لوحة مرئية، وتنفذها المنصة بتوجيه المهام وإرسال البريد واتخاذ قرارات ذكية وتتبع كل إجراء. *سبب الأهمية:* تعمل عمليات الموافقة والأتمتة المعقدة بصورة موثوقة من دون تنسيق يدوي، حتى إن امتدت أيامًا أو أسابيع أو أشهرًا. **OneLogic Technology** الشركة التي تشغّل RAPTIX. اسم المنتج الظاهر في التطبيق وفي هذا الدليل هو RAPTIX. *سبب الأهمية:* تبقى تعليمات المنتج متسقة، بينما تظل الملكية ومعلومات الدعم واضحتين. **المعرفة (`Knowledge`)** قدرة قاعدة المعرفة وتحليلات الذكاء الاصطناعي في RAPTIX. يرفع المسؤول المستندات أو يزامنها، ويمررها عبر مسار معالجة متعدد المراحل، ويضبط سياسات الوصول، ويراقب استخدام الذكاء الاصطناعي بتحليلات مفصلة. *سبب الأهمية:* تغذي إجابات «وكلاء الذكاء الاصطناعي» بمحتوى المؤسسة، فتضمن الدقة وقابلية التدقيق. --- ## P **الصفحة (`Page`)** *(التطبيقات / منشئ التطبيقات)* شاشة واحدة داخل تطبيق. قد تحتوي صفحة منشئ التطبيقات في Enterprise عناصر واجهة واستعلامات بيانات ومنطق أعمال؛ ويُفتح نموذج سير العمل القابل للتشغيل عبر عنوانه `/f/:token`. *سبب الأهمية:* تخدم كل صفحة مهمة بعينها، مثل نموذج أو لوحة معلومات أو صندوق موافقات، فيصل المستخدم إلى الشاشة المطلوبة مباشرة. **عقدة الإيقاف أو التأخير (`Pause / Delay Node`)** *(سير العمل)* عقدة توقف العملية مدة محددة قبل المتابعة، إما مدة ثابتة مثل ثلاثة أيام، أو تاريخًا ووقتًا محددين، أو قيمة تاريخ من بيانات سير العمل. *سبب الأهمية:* تبني فترات انتظار منضبطة داخل العمليات الآلية، مثل تعليق الموافقة حتى بدء العقد، من دون مراقبة يدوية. **عارض PDF (`PDF Viewer`)** *(المستندات / وكلاء الذكاء الاصطناعي)* لوحة داخل المتصفح تفتح ملفات PDF وتعرضها من دون تنزيل. يدعم في «المستندات» أدوات التعليق، وفي «وكلاء الذكاء الاصطناعي» يبرز الجملة الدقيقة المستشهد بها في الإجابة. *سبب الأهمية:* يراجع المستخدم مستندات متعددة الصفحات فورًا وفي سياقها، من دون تثبيت قارئ أو مغادرة المنصة. **المهام المعلقة (`Pending Tasks`)** *(سير العمل)* صندوق المهام الشخصي الذي يعرض كل خطوة مسندة حاليًا إلى المستخدم المسجل وتنتظر إجراءه. وتعرض شارة في الشريط العلوي العدد دائمًا. *سبب الأهمية:* يعرف المستخدم بنظرة مقدار العمل الذي ينتظره، من دون فحص البريد أو دخول نظام آخر. **الصلاحية (`Permission`)** حزمة مسماة من حقوق الوصول تتحكم فيما يستطيع المستخدم فعله عبر المنصة: موارد «التطبيقات» التي يعرضها أو يعدلها، وسير العمل الذي يراه أو يشغله، والوكلاء الذين يستخدمهم، وقدرات النظام التي يفتحها. *سبب الأهمية:* يغطي كائن صلاحية واحد المناطق الأربع، ويؤثر تحديثه فورًا في كل مستخدم يحمل الدور المرتبط. **مسار المعالجة (`Pipeline`)** *(المعرفة)* تسلسل من خمس مراحل يحول المستند الخام إلى مدخل قابل للبحث: تحلل الأولى النص، وتقسمه الثانية إلى مقاطع، وتلخص الثالثة الجداول، وتثريه الرابعة بكيانات يستخرجها الذكاء الاصطناعي، وتضمّنه الخامسة وتفهرسه. *سبب الأهمية:* يمر كل مستند بعملية جودة متسقة وقابلة للضبط قبل البحث، فتكون إجابات الذكاء الاصطناعي دقيقة وكاملة. **السياسة (`Policy`)** — راجع **سياسة الوصول**. **الإعداد المسبق (`Preset`)** *(المعرفة)* مجموعة إعدادات محفوظة ومسمّاة لمراحل مسار المعالجة، يمكن تطبيقها على أي مستند بنقرة واحدة. تضمن معالجة المستندات من النوع نفسه بصورة متسقة. *سبب الأهمية:* اضبط الإعداد الأمثل مرة لكل نوع مستند، ثم طبقه على مئات الملفات من دون تكرار الإعداد. **إعداد المعالجة المسبق (`Processing Preset`)** — راجع **الإعداد المسبق**. **تطبيق الويب التقدمي (`PWA`)** ميزة تتيح تثبيت RAPTIX كتطبيق على الهاتف أو الجهاز اللوحي أو الحاسوب، وتشغيله من الشاشة الرئيسية أو شريط المهام كتطبيق أصلي. *سبب الأهمية:* يحصل المستخدم على وصول فوري بلمسة واحدة، من دون فتح المتصفح وكتابة العنوان. --- ## R **التحكم في الوصول حسب الدور (`RBAC`)** نموذج أمان RAPTIX الذي يُسند فيه إلى كل مستخدم دور واحد أو أكثر، ويحمل كل دور صلاحيات. يؤدي تغيير صلاحيات الدور إلى تحديث وصول المستخدمين الحاملين له. *سبب الأهمية:* تبقى إدارة الوصول بسيطة مع نمو المؤسسة؛ فإضافة عضو جديد لا تتطلب إلا إسناد الدور الصحيح. **وضع الاستدلال (`Reasoning Mode`)** *(وكلاء الذكاء الاصطناعي)* عرض اختياري في مساعد من نوع webhook، تظهر فيه خطوات تفكير الذكاء الاصطناعي كتدفق ثانوي بعنوان «جارٍ التفكير…» قبل الإجابة النهائية. *سبب الأهمية:* يرى المستخدم كيف وصل المساعد إلى النتيجة، مما يبني الثقة ويساعد على اكتشاف الاستدلال المعيب. **التذكير (`Reminder`)** *(سير العمل)* رسالة آلية تُرسل إلى المكلّف بالمهمة على فواصل مضبوطة قبل الموعد النهائي، وتحثه على الإجراء. تتوقف التذكيرات تلقائيًا عند إكمال المهمة. *سبب الأهمية:* يتلقى المكلّفون تنبيهًا استباقيًا، فتتحقق المواعيد من دون متابعة يدوية من المدير. **عقدة مجدول التذكير (`Reminder Scheduler Node`)** *(سير العمل)* عقدة تراقب عمود تاريخ في مجموعة بيانات وترسل تلقائيًا رسائل تذكير عند مدد مضبوطة قبل كل تاريخ، مثل 30 يومًا قبل انتهاء عقد. *سبب الأهمية:* تراقب المنصة التواريخ المهمة باستمرار وترسل التنبيهات، فتمنع ضياع التجديدات والمواعيد عبر مجموعات كبيرة. **الدور (`Role`)** مجموعة مسماة تجمع صلاحيات ويمكن إسنادها إلى مستخدم أو أكثر. تشمل الأدوار المضمنة المسؤول والمدير والمستخدم، ويمكن للمسؤول إنشاء أدوار مخصصة. *سبب الأهمية:* يُمنح الوصول بالدور لا لكل فرد، فيحصل العضو الجديد على القدرات المناسبة بمجرد إسناده. **الموافقة على مستوى الصف (`Row-Level Approval`)** *(سير العمل)* وضع يسجل فيه المكلّف قرارًا مستقلًا، موافقة أو رفضًا أو تعليقًا، لكل صف في مجموعة البيانات المعروضة في المهمة بدل قرار واحد للطلب كله. *سبب الأهمية:* يجعل الموافقة الجزئية ممكنة؛ فتقبل بعض البنود وترفض غيرها في شاشة واحدة مع سجل كامل لكل صف. --- ## S **مشغل الجدول الزمني (`Schedule Trigger`)** *(سير العمل)* عقدة بدء تطلق العملية تلقائيًا وفق وقت محدد، مثل كل اثنين الساعة 8 صباحًا، أو أول كل شهر، أو مرة واحدة في تاريخ ووقت بعينهما. *سبب الأهمية:* تبدأ العمليات المتكررة، كالتقارير الشهرية والمراجعات الأسبوعية، من دون أن يتذكر أحد تشغيلها. **نشاط تسجيل الدخول (`Sign-in activity`)** سجل يراه المسؤول في علامة «نشاط تسجيل الدخول» ضمن إدارة المستخدمين، ويعرض تاريخ دخول كل مستخدم وعنوان IP وتفاصيل المتصفح وعدد المحاولات الفاشلة وأي حالة قفل للحساب. *سبب الأهمية:* يكتشف المسؤول نشاطًا مريبًا، مثل إخفاقات عديدة من عنوان غير معتاد، ويتصرف قبل اختراق الحساب. **الجلسة (`Session`)** *(وكلاء الذكاء الاصطناعي)* محادثة واحدة مع مساعد ذكاء اصطناعي. لكل جلسة عنوان دائم وفريد، ويمكن إعادة تسميتها وتلوينها ومشاركتها أو حذفها. ويستطيع المستخدم العودة إلى أي جلسة سابقة ومتابعتها. *سبب الأهمية:* لا تضيع المحادثات؛ فكل تبادل محفوظ برابط مباشر يمكن زيارته أو مشاركته. **اتفاقية مستوى الخدمة (`SLA`)** *(سير العمل)* مجموعة إعدادات الموعد النهائي والتذكير والتصعيد في عقدة مهمة، وتحدد معًا زمن الاستجابة المتوقع والعواقب الآلية لعدم الالتزام به. *سبب الأهمية:* يفرض النظام التزامات زمن الاستجابة تلقائيًا بدل الاعتماد على انضباط الأفراد. **النشر الذكي (`Smart Deploy`)** *(منشئ التطبيقات، Enterprise)* تكامل Enterprise يُضبط من منشئ التدفق ويربط صفحة منشئ التطبيقات ببدء سير عمل أو مهمة. ولا تحتاج نماذج سير العمل الأصلية إلى النشر الذكي. *سبب الأهمية:* تشارك الصفحات القائمة على البيانات في سير عمل RAPTIX من دون تكرار منطق العملية داخل الصفحة. **الحذف المرن أو سلة المحذوفات (`Soft Delete / Trash`)** نمط حذف يوسم المستند أو القالب بأنه محذوف وينقله إلى عرض «سلة المحذوفات» من دون إتلافه نهائيًا. يستطيع المسؤول استعادة العناصر المحذوفة مرنًا. *سبب الأهمية:* يمكن استرجاع الحذف العرضي؛ فلا يختفي شيء نهائيًا حتى يفرغ المسؤول السلة صراحة. **بطاقة المصدر (`Source Card`)** *(وكلاء الذكاء الاصطناعي)* بطاقة أسفل إجابة المساعد تعرض اسم المستند ورقم الصفحة ودرجة الصلة ومقتطفًا لكل استشهاد مستخدم. ترتبط البطاقة بالمستند الأصلي في عارض PDF. *سبب الأهمية:* يتحقق المستخدم من كل عبارة بالانتقال إلى مصدرها الأصلي بنقرة واحدة. **عقدة تقسيم الفروع (`Split Branches Node`)** *(سير العمل)* عقدة تقسم العملية إلى فرعين متوازيين أو أكثر تعمل كلها في الوقت نفسه، فتسمح لأعمال مستقلة بالمتابعة معًا. *سبب الأهمية:* لا يستغرق إخطار ثلاثة أقسام أو تشغيل ثلاثة فحوص إلا مدة أبطأ واحد منها، بدل مجموع مددها. **تسجيل الدخول الموحد (`SSO`)** — راجع **تسجيل Microsoft الموحد**. **سير العمل الفرعي (`Sub-Workflow`)** *(سير العمل)* سير عمل مصمم ليبدأه سير عمل آخر، لا مستخدم أو جدول مباشرة. يتلقى مدخلات محددة النوع من العملية الأم ويمكنه إرجاع نتائج. *سبب الأهمية:* يمكن تقسيم العمليات المعقدة إلى مكونات معيارية قابلة لإعادة الاستخدام؛ فتحديث الفرعي مرة يفيد كل عملية أم تستدعيه. **صلاحية النظام (`System Permission`)** واحدة من أكثر من 25 قدرة مسماة تتحكم في الوصول على مستوى المنصة، مثل إدارة المستخدمين أو إعداد البريد أو عرض سجل التدقيق أو دخول لوحة الإدارة. وهي أحد المستويات الأربعة في حزمة الصلاحيات. *سبب الأهمية:* تُسند قدرات النظام الدقيقة عمدًا، فلا يكتسب مستخدم سلطة إدارية عن طريق الخطأ. --- ## T **المهمة (`Task`)** *(سير العمل)* خطوة سير عمل مسندة إلى مستخدم أو دور محدد، وتتطلب قرارًا أو إجراءً بشريًا قبل المتابعة. تظهر في صندوق المهام المعلقة، وقد تشمل مراجعة مستند أو إدخال بيانات أو موافقة. *سبب الأهمية:* تُسند كل خطوة بشرية بوضوح، وتُتبع، وتُصعّد إن لم تكتمل في موعدها. **درجة الإبداع (`Temperature`)** *(وكلاء الذكاء الاصطناعي / المعرفة)* إعداد يتحكم في التوازن بين الدقة الواقعية عند القيمة المنخفضة والتنوع الإبداعي عند القيمة المرتفعة في الإجابات المولدة. يمكن ضبطه لكل مساعد وتعديله في كل جلسة. *سبب الأهمية:* يكيّف المستخدم المساعد مع المهمة؛ أدق عند البحث عن مواصفات، وأكثر إبداعًا عند توليد الأفكار. **وراثة الصلاحيات ثلاثية المستويات (`Three-Tier Permission Inheritance`)** *(المستندات)* نموذج حسم صلاحيات «المستندات»: تُطبق المنح العامة أولًا، ثم منح المجلد، ثم منح المستند. وتفوز أكثر القواعد المطبقة سماحًا. *سبب الأهمية:* يستطيع المسؤول منح وصول واسع ثم تضييقه لمستندات حساسة، من دون قواعد متضاربة أو مربكة. **سلة المحذوفات (`Trash`)** — راجع **الحذف المرن أو سلة المحذوفات**. **المشغل (`Trigger`)** *(سير العمل)* الحدث أو الشرط الذي يبدأ سير العمل. يدعم «سير العمل» خمسة أنواع: يدوي بنقرة زر، وWebhook باستدعاء نظام خارجي، وجدول زمني، وسير عمل فرعي، وبريد وارد يطابق قواعد الترشيح. *سبب الأهمية:* يبدأ سير العمل بالحدث الصحيح وفي الوقت الصحيح، من دون مراقبة أو تسليم يدوي. --- ## V **المتغير (`Variable`)** *(سير العمل)* بيان مسمى يُنشأ ويُمرر بين العقد ويُستخدم عبر سير العمل. قد يحمل نصًا أو رقمًا أو تاريخًا أو قائمة أو ملفًا، ويمكن الرجوع إليه في الشروط والبريد ومطالبات الذكاء الاصطناعي بالصيغة `{{variable_name}}`. *سبب الأهمية:* تتاح البيانات المقدمة في البداية لكل خطوة؛ فيعمل الموافقون والبريد والوكلاء والأنظمة الخارجية بالقيم الحية نفسها. **لوحة المتغيرات (`Variable Panel`)** *(سير العمل)* لوحة منزلقة في المصمم المرئي تسرد كل متغير تحت العقدة التي أنشأته مع نوعه وزر نسخ لعنصره النائب `{{variable_name}}`. *سبب الأهمية:* لا يحتاج المصمم إلى حفظ أسماء الحقول؛ فكل البيانات المتاحة ظاهرة وقابلة للنسخ. **الإصدار أو سجل الإصدارات (`Version / Version History`)** *(سير العمل / المستندات / المعرفة)* لقطة مؤرخة لتصميم سير عمل أو ملف مستند أو Markdown معالج في وقت محدد. ينشئ كل حفظ، يدوي أو تلقائي، إصدارًا جديدًا، ويمكن استعادة أي إصدار سابق. *سبب الأهمية:* لا تكون الأخطاء نهائية؛ إذ يمكن التراجع باستعادة إصدار سابق، مع بقاء تاريخ تغييرات كامل للمراجعة. **المصمم المرئي (`Visual Designer`)** *(سير العمل)* لوحة سحب وإفلات لبناء تصاميم سير العمل وتعديلها. يسحب المستخدم العقد من الشريط الجانبي، ويصلها بأسهم، ويضبط كل عقدة من لوحة جانبية. *سبب الأهمية:* تُصمم العمليات المعقدة بصريًا من دون برمجة؛ ويكون المخطط هو المواصفات والعملية القابلة للتنفيذ معًا. --- ## W **خطاف الويب (`Webhook`)** *(سير العمل)* آلية لربط المنصة بنظام خارجي عبر طلب HTTP. يبدأ webhook الوارد سير عمل عند إرسال النظام طلبًا، بينما ترسل عقدة webhook الصادرة بيانات إلى نظام خارجي أثناء سير العمل. *سبب الأهمية:* يتكامل سير العمل مع أي برنامج خارجي، مثل ERP أو CRM أو نظام تذاكر، من دون موصل مخصص. **عنصر الواجهة (`Widget`)** *(منشئ التطبيقات)* مكوّن جاهز، مثل حقل نص أو قائمة منسدلة أو جدول أو منتقي تاريخ أو زر رفع ملف، يوضع على الصفحة لإنشاء واجهة تطبيق. *سبب الأهمية:* تُبنى التطبيقات بتجميع مكونات جاهزة بدل كتابة كود واجهة، فيمكن إنشاء النماذج واللوحات خلال دقائق. **سير العمل (`Workflow`)** *(سير العمل)* تصميم عملية محدد وقابل لإعادة الاستخدام، يُنشأ في المصمم المرئي ويحدد كل خطوة ونقطة قرار وإسناد وإشعار من البداية إلى النهاية. التصميم هو المخطط، وعند تشغيله ينشأ مثيل سير عمل. *سبب الأهمية:* توحّد عمليات الأعمال وتؤتمت؛ فتمر كل حالة بالمسار نفسه بجودة متسقة وتتبع كامل. **مثيل سير العمل (`Workflow Instance`)** — راجع **المثيل**. **مساحة العمل (`Workspace`)** *(التطبيقات)* أعلى وحدة تنظيمية في «التطبيقات»، وتجمع تطبيقات مترابطة. تقابل مساحة العمل عادة قسمًا أو مجال أعمال. *سبب الأهمية:* تُنظم التطبيقات كي تعثر الفرق على أدوات منطقتها من دون التنقل في كتالوج عشوائي. --- ## Z **تنزيل ZIP (`ZIP Download`)** *(المستندات / سير العمل)* وظيفة تجمع عدة ملفات أو مجلدًا كاملًا، مع الحفاظ على البنية الأصلية، في أرشيف مضغوط واحد يُنزّل بإجراء واحد. *سبب الأهمية:* يسترجع المستخدم جميع مستندات مشروع أو مثيل سير عمل دفعة واحدة بدل تنزيل الملفات منفردة. --- *آخر تحديث: 2026-07-16. للاستفسار عن مصطلحات المنصة، راجع الدليل المناسب أو تواصل مع مسؤول النظام.* --- URL: https://raptix.app/user-guide/ar/capabilities/ # RAPTIX Capabilities & Benefits Catalog / كتالوج قدرات وفوائد RAPTIX RAPTIX brings workflows, documents, AI, internal applications, communication, access control, and billing into one permission-aware workspace. This catalog explains what people can accomplish, in English and Arabic, without exposing implementation details. يجمع RAPTIX سير العمل والمستندات والذكاء الاصطناعي والتطبيقات الداخلية والاتصالات والتحكم في الوصول والفوترة داخل مساحة عمل واحدة تراعي الصلاحيات. يوضح هذا الكتالوج ما يستطيع المستخدم إنجازه بالعربية والإنجليزية، من دون عرض تفاصيل التنفيذ التقنية. > **Coverage / التغطية:** This public catalog contains **99 customer-facing capabilities** validated from the current 107-record product register. The remaining eight records are intentionally not published here because they are platform-operator-only or are not approved as current customer features. / يحتوي هذا الكتالوج العام على **99 قدرة موجهة للعملاء** جرى التحقق منها من سجل المنتج الحالي ذي 107 سجلات. لم تُنشر السجلات الثمانية الأخرى عمدًا لأنها خاصة بمشغّلي المنصة أو غير معتمدة كميزات حالية للعملاء. ## Find the right starting point / اختر نقطة البداية المناسبة Each capability row below has a stable `CAP-*` reference, a bilingual user value, and a truthful availability boundary. Use this map for the primary audience and the task or product page that explains the area in context. / لكل قدرة أدناه مرجع `CAP-*` ثابت وفائدة ثنائية اللغة وحد توفر دقيق. استخدم هذه الخريطة لمعرفة الجمهور الأساسي ودليل المهمة أو صفحة المنتج التي تشرح المجال في سياقه. | Area / المجال | Primary people / المستخدمون الأساسيون | Task guide / دليل المهمة | Product overview EN / AR | |---|---|---|---| | Access, Home, Support, Administration / الوصول والرئيسية والدعم والإدارة | Members, workspace creators, administrators / الأعضاء ومنشئو مساحات العمل والمسؤولون | [Getting Started](https://raptix.app/user-guide/ar/00-getting-started/00-21-welcome-preferences-and-guided-tours/), [Administration](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) / [البدء](https://raptix.app/user-guide/ar/00-getting-started/00-21-welcome-preferences-and-guided-tours/)، [الإدارة](https://raptix.app/user-guide/ar/70-administration/70-1-admin-overview/) | [EN](https://raptix.app/product) / [AR](https://raptix.app/ar/product) | | Applications and Custom Screens / التطبيقات والشاشات المخصصة | Members, application builders, administrators / الأعضاء وبناة التطبيقات والمسؤولون | [Applications and Custom Screens](https://raptix.app/user-guide/ar/50-applications/50-34-custom-screens-actions-and-document-workspaces/) / [التطبيقات والشاشات المخصصة](https://raptix.app/user-guide/ar/50-applications/50-34-custom-screens-actions-and-document-workspaces/) | [EN](https://raptix.app/product/applications) / [AR](https://raptix.app/ar/product/applications) | | Workflows, tasks, and external work / سير العمل والمهام والعمل الخارجي | Workflow builders, assignees, approvers / بناة سير العمل والمكلفون والموافقون | [Workflow Quick Start](https://raptix.app/user-guide/ar/10-workflows/10-1-quickstart-first-workflow/), [Task Forms](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) / [البدء السريع](https://raptix.app/user-guide/ar/10-workflows/10-1-quickstart-first-workflow/)، [نماذج المهام](https://raptix.app/user-guide/ar/10-workflows/10-35-task-forms/) | [EN](https://raptix.app/product/workflow) / [AR](https://raptix.app/ar/product/workflow) | | Documents and reports / المستندات والتقارير | Members, reviewers, document administrators / الأعضاء والمراجعون ومسؤولو المستندات | [Documents Overview](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) / [نظرة المستندات](https://raptix.app/user-guide/ar/20-documents/20-1-documents-overview-document-hierarchy/) | [EN](https://raptix.app/product/documents) / [AR](https://raptix.app/ar/product/documents) | | AI Agents and RAPTIX chat / وكلاء الذكاء الاصطناعي ومحادثة RAPTIX | Members, assistant administrators / الأعضاء ومسؤولو المساعدين | [Assistant Tools and Workflow Commands](https://raptix.app/user-guide/ar/30-ai-agents/30-32-assistant-tools-and-workflow-commands/) / [أدوات المساعد وأوامر سير العمل](https://raptix.app/user-guide/ar/30-ai-agents/30-32-assistant-tools-and-workflow-commands/) | [EN](https://raptix.app/product/ai-knowledge) / [AR](https://raptix.app/ar/product/ai-knowledge) | | Knowledge / المعرفة | Knowledge and AI administrators / مسؤولو المعرفة والذكاء الاصطناعي | [Manage Knowledge Documents](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) / [إدارة مستندات المعرفة](https://raptix.app/user-guide/ar/40-knowledge/40-27-knowledge-documents-current/) | [EN](https://raptix.app/product/ai-knowledge) / [AR](https://raptix.app/ar/product/ai-knowledge) | | Email and Communication / البريد والاتصالات | Members, Workflow builders, communication administrators / الأعضاء وبناة سير العمل ومسؤولو الاتصالات | [Communication](https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/) / [الاتصالات](https://raptix.app/user-guide/ar/60-communication/60-1-addresses-and-sending-mailboxes/) | [EN](https://raptix.app/product/communication) / [AR](https://raptix.app/ar/product/communication) | | Billing, plans, and entitlements / الفوترة والخطط والاستحقاقات | Billing viewers and the Billing Owner / مشاهدو الفوترة ومالك الفوترة | [Billing](https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/) / [الفوترة](https://raptix.app/user-guide/ar/80-billing/80-1-billing-plans-trial-and-roles/) | [EN](https://raptix.app/pricing) / [AR](https://raptix.app/ar/pricing) | ## Availability guide / دليل التوفر - **Available / متاح:** available to eligible users, subject to their workspace permissions. / متاح للمستخدمين المؤهلين وفق صلاحيات مساحة العمل. - **Plan / الخطة:** requires the named plan or entitlement. Current prices, limits, and included allowances always come from the live Pricing page and the workspace Billing page. / يتطلب الخطة أو الاستحقاق المذكور. وتأتي الأسعار والحدود والحصص المضمنة الحالية دائمًا من صفحة Pricing الحية وصفحة Billing في مساحة العمل. - **Configuration / الإعداد:** appears only after an administrator connects or enables the required provider or service. / لا يظهر إلا بعد أن يصل المسؤول المزوّد أو الخدمة المطلوبة أو يفعّلها. - **Controlled rollout / طرح مضبوط:** availability can differ between workspaces. Check the control in your workspace or contact RAPTIX Support before depending on it. / قد يختلف التوفر بين مساحات العمل؛ تحقق من عنصر التحكم داخل مساحة عملك أو تواصل مع دعم RAPTIX قبل الاعتماد عليه. لا تعني رؤية وحدة في التنقل أن كل محتواها متاح للمستخدم. تتحكم صلاحيات الصفحة والموارد والخطة وإعدادات مساحة العمل في ما يمكن لكل شخص عرضه أو تنفيذه. / Seeing a module in navigation does not grant access to all of its content. Page permissions, resource access, plan entitlements, and workspace configuration determine what each person can view or do. --- ## Access, Home, Support, and Administration / الوصول والرئيسية والدعم والإدارة | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-ACC-01 | **Bilingual public site** / موقع عام ثنائي اللغة | Explore product, solutions, pricing, security, help, company, and legal information at stable English and Arabic addresses. / استكشف المنتج والحلول والأسعار والأمان والمساعدة والشركة والمعلومات القانونية عبر عناوين ثابتة بالإنجليزية والعربية. | Available / متاح | | CAP-ACC-02 | **Workspace signup and verification** / إنشاء مساحة العمل والتحقق | Enter identity and work details, choose and validate a workspace address, verify email, and join or request access when the current signup journey permits it. / أدخل بيانات الهوية والعمل، واختر عنوان مساحة العمل وتحقق منه، ثم تحقق من البريد وانضم أو اطلب الوصول عندما تسمح رحلة التسجيل الحالية. | Controlled signup rollout / طرح التسجيل مضبوط | | CAP-ACC-03 | **Password access and recovery** / الدخول واستعادة كلمة المرور | Sign in with a safe return to the intended page, show or hide the password, reset a forgotten password, renew the session, and sign out fully. / سجّل الدخول مع عودة آمنة إلى الصفحة المطلوبة، وأظهر كلمة المرور أو أخفها، واستعدها عند نسيانها، وجدّد الجلسة وسجّل الخروج بالكامل. | Available / متاح | | CAP-ACC-04 | **Microsoft and Google sign-in** / الدخول عبر Microsoft وGoogle | Use an organization-approved identity provider without a separate RAPTIX password when that provider is configured. / استخدم مزوّد الهوية المعتمد في المؤسسة من دون كلمة مرور RAPTIX منفصلة عند تهيئة ذلك المزوّد. | Configured provider; SSO plan rules apply / مزوّد مهيأ؛ وتطبق شروط خطة SSO | | CAP-ACC-05 | **Membership rejoin request** / طلب العودة إلى المؤسسة | Request access again after removal instead of reaching a dead end. / اطلب الوصول مجددًا بعد إزالة العضوية بدل الوصول إلى طريق مسدود. | Available / متاح | | CAP-ACC-06 | **Permission-aware navigation** / تنقل يراعي الصلاحيات | See only Home and permitted modules, with a task badge that reflects visible pending work. / اعرض Home والوحدات المسموح بها فقط، مع شارة مهام تعكس العمل المعلّق المرئي لك. | Available / متاح | | CAP-ACC-07 | **Language, direction, theme, and tour preferences** / تفضيلات اللغة والاتجاه والمظهر والجولة | Keep English or Arabic, RTL or LTR direction, light or dark appearance, and replayable guidance aligned with personal preferences. / احفظ تفضيلات الإنجليزية أو العربية واتجاه RTL أو LTR والمظهر الفاتح أو الداكن، وأعد تشغيل الإرشاد عند الحاجة. | Current preferences available / التفضيلات الحالية متاحة | | CAP-ACC-08 | **Personalized Home** / رئيسية مخصصة | Start with assigned work, overdue items, recent activity and applications, and useful next actions instead of a generic dashboard. / ابدأ بالعمل المسند إليك والعناصر المتأخرة والنشاط والتطبيقات الحديثة والإجراءات التالية المفيدة بدل لوحة عامة. | Available / متاح | | CAP-ACC-09 | **Welcome and guided tours** / الترحيب والجولات الإرشادية | Follow permission-aware onboarding and contextual tours for Documents, Knowledge, Tasks, and the workflow canvas, then replay them when needed. / اتبع مسارات ترحيب تراعي الصلاحيات وجولات سياقية للمستندات والمعرفة والمهام ولوحة سير العمل، ثم أعد تشغيلها عند الحاجة. | Available / متاح | | CAP-ACC-10 | **Installable responsive app** / تطبيق متجاوب قابل للتثبيت | Work from mobile navigation, install RAPTIX as a PWA, use shortcuts, understand online or offline state, and receive clear action feedback. / استخدم التنقل على الهاتف، وثبّت RAPTIX كتطبيق PWA، واستفد من الاختصارات وحالة الاتصال وملاحظات نتيجة الإجراء. | Available / متاح | | CAP-SUP-01 | **Customer support tickets** / تذاكر دعم العملاء | Create and categorize tickets, follow their status, reply or reopen them, and attach permitted files in one support history. / أنشئ التذاكر وصنّفها وتابع حالتها ورد عليها أو أعد فتحها وأرفق الملفات المسموح بها ضمن سجل دعم واحد. | Available / متاح | | CAP-ADM-01 | **Members and join requests** / الأعضاء وطلبات الانضمام | Search members, approve or decline requests, assign roles, remove access safely, and preserve who performed each action. / ابحث عن الأعضاء، ووافق على الطلبات أو ارفضها، وأسند الأدوار، وأزل الوصول بأمان مع حفظ منفّذ كل إجراء. | Available to admins; multi-seat rules depend on plan / متاح للمسؤولين؛ وتعدد المقاعد حسب الخطة | | CAP-ADM-02 | **Roles and page-access matrix** / الأدوار ومصفوفة وصول الصفحات | Create custom roles, grant parent or child page access, protect system roles, and understand member counts. / أنشئ أدوارًا مخصصة، وامنح وصولًا إلى الصفحات الأصل أو الفرعية، واحمِ أدوار النظام واعرف أعداد الأعضاء. | Available to admins / متاح للمسؤولين | | CAP-ADM-03 | **Resource-level access** / صلاحيات على مستوى الموارد | Keep app, workflow, document, assistant, and email access separate from general page visibility, so people see only the resources assigned to them. / افصل وصول التطبيقات وسير العمل والمستندات والمساعدين والبريد عن ظهور الصفحة العام، ليشاهد كل شخص الموارد المسندة إليه فقط. | Available / متاح | | CAP-ADM-04 | **Sign-in activity and user security view** / نشاط الدخول وعرض أمان المستخدم | Review scoped sign-in history, failed attempts, lock state, IP address, and device information without exposing internal defense settings. / راجع سجل الدخول المحدد النطاق والمحاولات الفاشلة وحالة القفل وعنوان IP ومعلومات الجهاز من دون كشف إعدادات الدفاع الداخلية. | Available to admins / متاح للمسؤولين | | CAP-ADM-05 | **Workspace SSO settings** / إعداد SSO لمساحة العمل | Configure permitted Microsoft or Google sign-in modes, allowed domains, buttons, signup behavior, and safe verification. / هيئ أوضاع دخول Microsoft أو Google المسموح بها والنطاقات والأزرار وسلوك التسجيل والتحقق الآمن. | Enterprise; configured provider / Enterprise؛ ويتطلب مزوّدًا مهيأً | ## Applications and Custom Screens / التطبيقات والشاشات المخصصة | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-APP-01 | **Permission-filtered application hierarchy** / تسلسل تطبيقات يراعي الصلاحيات | Move through workspaces, applications, and pages with breadcrumbs, stable URLs, search, counts, and useful empty states. / تنقّل بين المساحات والتطبيقات والصفحات عبر مسارات تنقل وعناوين ثابتة وبحث وأعداد وحالات فارغة مفيدة. | Available / متاح | | CAP-APP-02 | **Workspace and application management** / إدارة المساحات والتطبيقات | Create and rename containers, preserve required workspaces, and reassign older applications to the right context. / أنشئ الحاويات وأعد تسميتها، وحافظ على المساحات المطلوبة، وأعد إسناد التطبيقات القديمة إلى سياقها الصحيح. | Available to eligible users / متاح للمستخدمين المؤهلين | | CAP-APP-03 | **Contextual pages, documents, workflows, and email** / صفحات ومستندات وسير عمل وبريد ضمن السياق | Keep related actions inside the selected application so records, files, processes, and communication remain together. / أبقِ الإجراءات المرتبطة داخل التطبيق المحدد لتظل السجلات والملفات والعمليات والاتصالات معًا. | Available / متاح | | CAP-APP-04 | **Application access and activity** / صلاحيات التطبيقات ونشاطها | Grant or revoke access by user or role with inheritance, then filter activity and review summaries. / امنح الصلاحيات أو اسحبها حسب المستخدم أو الدور مع التوريث، ثم صفِّ النشاط وراجع الملخصات. | Access controls available; activity logs require Enterprise / الصلاحيات متاحة؛ وسجلات النشاط تتطلب Enterprise | | CAP-APP-05 | **Custom Screens** / الشاشات المخصصة | Visually build internal tools over organization data and connect those tools to workflows. / ابنِ أدوات داخلية بصريًا فوق بيانات المؤسسة واربطها بسير العمل. | Enterprise / Enterprise | | CAP-APP-06 | **Queries, JSObjects, and widget events** / الاستعلامات وكائنات JavaScript وأحداث العناصر | Connect approved data and page behavior inside an enabled Custom Screen. / اربط البيانات المعتمدة وسلوك الصفحة داخل شاشة مخصصة مفعّلة. | Enterprise; controls depend on the enabled editor / Enterprise؛ وتعتمد الأدوات على المحرر المفعّل | | CAP-APP-07 | **Workflow buttons, TaskActions, and approval tables** / أزرار سير العمل وإجراءات المهام وجداول الموافقات | Start processes and make work decisions directly from a Custom Screen, including structured row-level approvals where enabled. / ابدأ العمليات واتخذ قرارات العمل مباشرة من شاشة مخصصة، بما فيها موافقات منظمة لكل صف عند تفعيلها. | Enterprise / Enterprise | | CAP-APP-08 | **Document-only application workspaces** / مساحات تطبيقات للمستندات فقط | Organize documents and process context without having to build a Custom Screen application. / نظّم المستندات وسياق العملية من دون الحاجة إلى بناء تطبيق شاشة مخصصة. | Available / متاح | | CAP-APP-09 | **Public application forms** / نماذج التطبيقات العامة | Collect typed data and files and start one workflow without requiring the visitor to hold a member session. / اجمع بيانات محددة الأنواع وملفات وابدأ حالة سير عمل واحدة من دون اشتراط جلسة عضو للزائر. | Available when published by an authorized owner / متاح عند نشره بواسطة مالك مصرح له | ## Workflow Design, Automation, Tasks, and External Work / تصميم وأتمتة سير العمل والمهام الخارجية | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-WF-01 | **Workflow library** / مكتبة سير العمل | List, search, create, describe, duplicate, inspect, and delete eligible workflows inside the correct scope. / اعرض سير العمل وابحث فيه وأنشئه ووصفه وكرره وافحصه واحذف المؤهل منه داخل النطاق الصحيح. | Available / متاح | | CAP-WF-02 | **Visual designer** / المصمم المرئي | Place, connect, and configure steps on a canvas with pan, zoom, grid, minimap, variables, and automatic layout. / ضع الخطوات واربطها وهيئها على لوحة تدعم التحريك والتكبير والشبكة والخريطة المصغرة والمتغيرات والتخطيط التلقائي. | Available / متاح | | CAP-WF-03 | **Workflow validation** / التحقق من سير العمل | Find missing endpoints, disconnected steps, invalid settings or references, and unsafe graph conditions without losing the draft. / اكتشف نقاط النهاية المفقودة والخطوات غير المتصلة والإعدادات أو المراجع غير الصالحة وحالات الرسم غير الآمنة من دون فقد المسودة. | Available / متاح | | CAP-WF-04 | **Save, autosave, versions, and revert** / الحفظ التلقائي والإصدارات والاسترجاع | Preserve workflow designs and safely return to an earlier checkpoint. / احفظ تصميمات سير العمل وارجع بأمان إلى نقطة تحقق سابقة. | Available / متاح | | CAP-WF-05 | **Workflow import and export** / استيراد وتصدير سير العمل | Move, back up, or reuse a validated workflow definition. / انقل تعريف سير عمل متحقق منه أو احتفظ بنسخة احتياطية منه أو أعد استخدامه. | Available / متاح | | CAP-WF-06 | **Activation, manual run, and safe input** / التفعيل والتشغيل اليدوي والمدخلات الآمنة | Activate an eligible design and start exactly one authorized process only when intended. / فعّل التصميم المؤهل وابدأ عملية مصرحًا بها واحدة فقط عندما يقصد المستخدم ذلك. | Available / متاح | | CAP-WF-07 | **Entry triggers** / مشغلات البدء | Start a workflow manually, from a form, on a schedule and timezone, through incoming email, HTTP, a Custom Screen, or a public form. / ابدأ سير العمل يدويًا أو من نموذج أو وفق جدول ومنطقة زمنية أو عبر بريد وارد أو HTTP أو شاشة مخصصة أو نموذج عام. | Core triggers available; HTTP requires Ultra; Custom Screen trigger requires Enterprise; email requires configuration / المشغلات الأساسية متاحة؛ HTTP يتطلب Ultra؛ ومشغل الشاشة المخصصة يتطلب Enterprise؛ والبريد يتطلب إعدادًا | | CAP-WF-08 | **Human tasks and custom actions** / المهام البشرية والإجراءات المخصصة | Assign by user, role, or email; require comments, files, or fields; and present decision labels that match the business task. / أسند حسب المستخدم أو الدور أو البريد، واشترط تعليقات أو ملفات أو حقولًا، واعرض تسميات قرار تناسب المهمة. | Available / متاح | | CAP-WF-09 | **Approvals, batch decisions, and per-item decisions** / الموافقات والقرارات الجماعية ولكل عنصر | Run ordered review levels, decide multiple rows, view summaries, and retry only the items that need attention. / نفّذ مستويات مراجعة مرتبة، واتخذ قرارات لصفوف متعددة، واعرض الملخصات وأعد محاولة العناصر التي تحتاج اهتمامًا فقط. | Core approvals available; advanced per-item decisions require Ultra / الموافقات الأساسية متاحة؛ والقرارات المتقدمة لكل عنصر تتطلب Ultra | | CAP-WF-10 | **Deadlines, reminders, and escalation** / المواعيد والتذكير والتصعيد | Track due states, send one-time reminders, reassign or escalate overdue work, and retain the result. / تابع حالات الاستحقاق، وأرسل تذكيرات لمرة واحدة، وأعد إسناد العمل المتأخر أو صعّده، واحتفظ بالنتيجة. | Core deadlines available; Reminder Scheduler requires Ultra / المواعيد الأساسية متاحة؛ وReminder Scheduler يتطلب Ultra | | CAP-WF-11 | **Routing and long-running control** / التوجيه والتحكم طويل الأمد | Model conditions, multiple branches, parallel work, ALL, ANY, or COUNT merges, pauses, loops, and item-by-item processing. / صمّم الشروط والفروع المتعددة والعمل المتوازي وعمليات الدمج ALL أو ANY أو COUNT والتوقف والتكرار والمعالجة لكل عنصر. | Core routing available; For Each requires Ultra / التوجيه الأساسي متاح؛ وFor Each يتطلب Ultra | | CAP-WF-12 | **Advanced automation steps** / خطوات الأتمتة المتقدمة | Add approved Python logic, database reads or writes and data triggers, outbound webhooks, and date-driven reminders. / أضف منطق Python معتمدًا، وقراءة أو كتابة قواعد البيانات ومشغلات البيانات، وwebhooks صادرة، وتذكيرات مدفوعة بالتاريخ. | Python requires Pro; database, For Each, and Reminder steps require Ultra / Python يتطلب Pro؛ وخطوات قاعدة البيانات وFor Each وReminder تتطلب Ultra | | CAP-WF-13 | **Document and report steps** / خطوات المستندات والتقارير | Retrieve or archive files, create structured ZIP packages, fill Word templates, validate placeholders, create PDFs, and file the result. / استرد الملفات أو أرشفها، وأنشئ حزم ZIP منظمة، واملأ قوالب Word، وتحقق من placeholders، وأنشئ PDF واحفظ الناتج. | Core steps available; attaching a submission PDF requires Ultra / الخطوات الأساسية متاحة؛ وإرفاق PDF للطلب يتطلب Ultra | | CAP-WF-14 | **AI Agent steps and versioned skills** / خطوات الوكيل والمهارات ذات الإصدارات | Use cited knowledge and structured decisions, route by confidence, review skill versions, approve or roll back changes, and explicitly accept or reject AI Builder proposals. / استخدم معرفة موثقة وقرارات منظمة، ووجّه حسب الثقة، وراجع إصدارات المهارات واعتمد التغييرات أو استرجعها، واقبل اقتراحات AI Builder أو ارفضها صراحة. | Core available; Balanced and Deep tiers require Pro; test console requires Ultra; AI provider required / النواة متاحة؛ ومستويات Balanced وDeep تتطلب Pro؛ ووحدة الاختبار تتطلب Ultra؛ ويلزم مزوّد AI | | CAP-WF-15 | **AI-assisted builder and flow assistant** / منشئ ومساعد سير العمل بالذكاء الاصطناعي | Describe a workflow or change in plain language, review the proposed graph or change set, and apply it only after approval. / صف سير العمل أو التغيير بلغة طبيعية، وراجع الرسم أو مجموعة التغييرات المقترحة، ولا تطبقها إلا بعد الموافقة. | Configured AI provider / يتطلب مزوّد AI مهيأً | | CAP-WF-16 | **Monitoring, timeline, conversation, and cancellation** / المراقبة والخط الزمني والمحادثة والإلغاء | Follow permitted runs, current step, assignments, files, comments, timing, and errors, then stop an eligible run safely. / تابع التشغيلات المسموح بها والخطوة الحالية والإسنادات والملفات والتعليقات والتوقيت والأخطاء، ثم أوقف التشغيل المؤهل بأمان. | Available / متاح | | CAP-WF-17 | **Personal task inbox and manager review** / صندوق المهام ومراجعة المدير | Decide with request data, documents, annotations, comments, and history visible in the same context. / اتخذ القرار مع بيانات الطلب والمستندات والتعليقات التوضيحية والتعليقات والسجل في السياق نفسه. | Available / متاح | | CAP-WF-18 | **Branded public start forms** / نماذج بدء عامة بهوية المؤسسة | Publish or revoke a public or private form with consent, validation, files, and return URL, and create one process instance per accepted submission. / انشر أو اسحب نموذجًا عامًا أو خاصًا مع الموافقة والتحقق والملفات وعنوان العودة، وأنشئ حالة عملية واحدة لكل إرسال مقبول. | Available to authorized publishers / متاح للناشرين المصرح لهم | | CAP-WF-19 | **Signed external action** / إجراء خارجي برابط آمن | Let an external participant review one task, comment or upload, act once, and see a final confirmation without receiving broader workspace access. / اسمح لمشارك خارجي بمراجعة مهمة واحدة والتعليق أو الرفع واتخاذ الإجراء مرة واحدة ورؤية تأكيد نهائي من دون منحه وصولًا أوسع إلى مساحة العمل. | Available when the task owner enables external action / متاح عندما يفعّل مالك المهمة الإجراء الخارجي | | CAP-WF-20 | **Workflow commands inside RAPTIX AI chat** / تشغيل سير العمل من محادثة RAPTIX | Discover permitted manual workflows, provide required inputs, start a run, receive a receipt, and track status without leaving the conversation. / اكتشف سير العمل اليدوي المسموح به، وقدّم المدخلات المطلوبة، وابدأ التشغيل، واستلم إيصالًا وتابع الحالة من داخل المحادثة. | Requires an eligible assistant and workflow / يتطلب مساعدًا وسير عمل مؤهلين | | CAP-WF-22 | **Wait for a matching email mid-workflow** / انتظار بريد مطابق داخل سير العمل | Pause an active process until a matching message arrives, then resume with message data or follow the configured timeout path. / أوقف العملية النشطة مؤقتًا حتى تصل رسالة مطابقة، ثم استأنفها ببيانات الرسالة أو اتبع مسار المهلة المهيأ. | Configured mail provider; Ultra for diagnostics / يتطلب مزوّد بريد مهيأً؛ والتشخيص يتطلب Ultra | ## Documents and Reports / المستندات والتقارير | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-DOC-01 | **Scope-aware document explorer** / مستكشف مستندات يراعي السياق | Browse flat or folder views with hierarchy, breadcrumbs, bookmarkable URLs, search, sort, grid or list layouts, counts, colors, and favorites. / تصفح عرضًا مسطحًا أو مجلدات مع تسلسل هرمي ومسارات تنقل وعناوين قابلة للحفظ وبحث وفرز وشبكة أو قائمة وأعداد وألوان ومفضلة. | Available / متاح | | CAP-DOC-02 | **Friendly upload destination** / وجهة رفع سهلة | Use one clear “Save in” choice that starts with the current folder or General uploads, while supporting multiple files and safe metadata. / استخدم خيارًا واضحًا واحدًا «Save in» يبدأ بالمجلد الحالي أو General uploads، مع دعم ملفات متعددة وبيانات وصفية آمنة. | Available / متاح | | CAP-DOC-03 | **Preview and download** / المعاينة والتنزيل | View supported PDF, image, text, video, and Office content, then download files or structured folder ZIPs. / اعرض محتوى PDF والصور والنص والفيديو وOffice المدعوم، ثم نزّل الملفات أو حزم ZIP منظمة للمجلدات. | Available / متاح | | CAP-DOC-04 | **PDF review and annotations** / مراجعة PDF والتعليقات التوضيحية | Add supported annotations and complete a linked approval while the document remains in context. / أضف التعليقات التوضيحية المدعومة وأكمل الموافقة المرتبطة مع بقاء المستند في السياق. | Verified annotation modes only / أوضاع التعليق التوضيحي المتحقق منها فقط | | CAP-DOC-05 | **Stable version history** / سجل إصدارات ثابت | Replace or edit a file without losing its lineage, identify the current revision, and download an exact historical revision. / استبدل الملف أو حرره من دون فقد تسلسل إصداراته، وحدد المراجعة الحالية ونزّل مراجعة تاريخية بعينها. | Available / متاح | | CAP-DOC-06 | **Folders and naming** / المجلدات والتسمية | Create and rename eligible folders and files while preserving content and access, with explicit confirmation for permanent folder deletion. / أنشئ المجلدات والملفات المؤهلة وأعد تسميتها مع الحفاظ على المحتوى والوصول، وتأكيد صريح لحذف المجلد نهائيًا. | Available / متاح | | CAP-DOC-07 | **Trash and recovery** / المهملات والاستعادة | Soft-delete individual files, restore them inside the correct scope, retain history, and keep permanent deletion explicit. / احذف الملفات الفردية مبدئيًا واستعدها داخل النطاق الصحيح مع حفظ السجل، واجعل الحذف النهائي صريحًا. | Available / متاح | | CAP-DOC-08 | **Document, folder, and global permissions** / صلاحيات المستند والمجلد والصلاحيات العامة | Apply user or role grants consistently across lists, links, downloads, search, and AI results. / طبّق منح المستخدم أو الدور باتساق على القوائم والروابط والتنزيلات والبحث ونتائج الذكاء الاصطناعي. | Available / متاح | | CAP-DOC-09 | **Document activity trail** / سجل نشاط المستند | Review scoped uploads, views, downloads, renames, deletion, restoration, permission changes, search, filters, and event details. / راجع عمليات الرفع والعرض والتنزيل وإعادة التسمية والحذف والاستعادة وتغييرات الصلاحيات والبحث والفلاتر وتفاصيل الأحداث ضمن النطاق. | Enterprise / Enterprise | | CAP-DOC-10 | **Documents-to-Knowledge auto-sync** / مزامنة المستندات تلقائيًا إلى المعرفة | Define rules, test them with a dry run, backfill existing files, inspect job history and statistics, and retry or cancel eligible jobs. / عرّف القواعد واختبرها بتشغيل جاف، وعالج الملفات الحالية، وافحص سجل المهام والإحصاءات، وأعد محاولة المهام المؤهلة أو ألغها. | When Knowledge is enabled / عند تفعيل Knowledge | | CAP-DOC-11 | **Document tools inside the assistant** / أدوات المستندات داخل المساعد | Search by meaning, name, location, uploader, or index state; inspect counts and versions; summarize folders; read permitted files; and use OCR when available. / ابحث بالمعنى أو الاسم أو الموقع أو الرافع أو حالة الفهرسة، وافحص الأعداد والإصدارات، ولخّص المجلدات واقرأ الملفات المسموح بها واستخدم OCR عند توفره. | Core tools available; Knowledge and OCR configuration apply / الأدوات الأساسية متاحة؛ ويطبق إعداد Knowledge وOCR | | CAP-DOC-12 | **Bulk document actions** / إجراءات المستندات الجماعية | Select multiple permitted documents and download or delete them together with clear scope and confirmation rules. / حدد عدة مستندات مسموح بها ونزّلها أو احذفها معًا وفق قواعد نطاق وتأكيد واضحة. | Available / متاح | ## AI Agents and RAPTIX Chat / وكلاء الذكاء الاصطناعي ومحادثة RAPTIX | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-AI-01 | **RAPTIX Smart Assistant** / مساعد RAPTIX الذكي | Work with one access-aware assistant across permitted documents, workflows, tasks, email, attachments, and policy-approved web tools. / اعمل مع مساعد واحد يراعي الوصول عبر المستندات وسير العمل والمهام والبريد والمرفقات وأدوات الويب التي تسمح بها السياسة. | Dependent tools must be enabled and permitted / يجب تفعيل الأدوات التابعة والسماح بها | | CAP-AI-02 | **Assistant discovery** / اكتشاف المساعدين | Find permitted assistants through cards, All, Connected, or Document filters, search, and safe direct access. / اعثر على المساعدين المسموح بهم عبر البطاقات ومرشحات All أو Connected أو Document والبحث والوصول المباشر الآمن. | Available / متاح | | CAP-AI-03 | **Persistent bilingual conversations** / محادثات ثنائية اللغة محفوظة | Return to permanent session links with streamed replies, ordered history, timestamps, correct Arabic or English direction, and safe retry states. / ارجع إلى روابط جلسات دائمة مع ردود متدفقة وسجل مرتب وطوابع زمنية واتجاه صحيح للعربية أو الإنجليزية وحالات آمنة لإعادة المحاولة. | Configured AI provider / يتطلب مزوّد AI مهيأً | | CAP-AI-04 | **Grounded answers and citations** / إجابات موثقة بالمصادر | Verify permitted answers through filename, page, excerpt, relevance, and correctly highlighted PDF context instead of relying on an unsupported source claim. / تحقق من الإجابات المسموح بها عبر اسم الملف والصفحة والمقتطف ودرجة الصلة والسياق المميز داخل PDF بدل الاعتماد على مصدر غير مسنود. | When document retrieval is enabled / عند تفعيل استرجاع المستندات | | CAP-AI-05 | **Visible tool receipts** / إيصالات مرئية لاستخدام الأدوات | See a safe status for a search or tool and its result without exposing private reasoning or secrets. / شاهد حالة آمنة للبحث أو الأداة ونتيجتها من دون كشف الاستدلال الخاص أو الأسرار. | Available for supported tools / متاح للأدوات المدعومة | | CAP-AI-06 | **Session organization** / تنظيم الجلسات | Reopen, rename, color, paginate, and delete conversations while preserving ordered history. / أعد فتح المحادثات وتسميتها وتلوينها وتقسيمها إلى صفحات وحذفها مع الحفاظ على ترتيب السجل. | Available / متاح | | CAP-AI-07 | **Controlled session sharing** / مشاركة الجلسات بصلاحية | Share with users or roles, show message attribution, inspect access, copy the link, and revoke sharing without creating a link-based bypass. / شارك مع المستخدمين أو الأدوار، وأظهر إسناد الرسائل، وافحص الوصول وانسخ الرابط وألغِ المشاركة من دون إنشاء تجاوز قائم على الرابط. | Available / متاح | | CAP-AI-08 | **Chat files, feedback, and export** / ملفات المحادثة والتقييم والتصدير | Upload supported documents, see processing receipts, rate answers, and export the visible conversation transcript. / ارفع المستندات المدعومة وشاهد إيصالات المعالجة وقيّم الإجابات وصدّر نص المحادثة الظاهر. | Available for supported file types and assistants / متاح لأنواع الملفات والمساعدين المدعومين | | CAP-AI-09 | **Custom assistants** / المساعدون المخصصون | Configure assistant type, AI tier or model, bilingual instructions, knowledge or workflow scope, tools, web access, visibility, and appearance. / هيئ نوع المساعد وفئة أو نموذج AI والتعليمات ثنائية اللغة ونطاق المعرفة أو سير العمل والأدوات والوصول إلى الويب والظهور والمظهر. | Available to eligible admins; advanced tiers depend on plan / متاح للمسؤولين المؤهلين؛ والفئات المتقدمة حسب الخطة | | CAP-AI-10 | **Connected assistants** / المساعدون المتصلون | Connect an allowed external assistant endpoint while preserving the familiar RAPTIX conversation experience. / صل نقطة نهاية خارجية مسموح بها للمساعد مع الحفاظ على تجربة محادثة RAPTIX المألوفة. | When configured / عند الإعداد | | CAP-AI-11 | **Floating chat** / المحادثة العائمة | Choose up to eight permitted assistants and work without leaving the current product context. / اختر ما يصل إلى ثمانية مساعدين مسموح بهم واعمل من دون مغادرة سياق المنتج الحالي. | Available / متاح | | CAP-AI-12 | **Email and attachment intelligence** / ذكاء البريد والمرفقات | Search across languages and by meaning, read permitted threads or pages, bring files into chat, analyze multiple messages, and perform bounded spreadsheet filtering or aggregation. / ابحث عبر اللغات وبالمعنى، واقرأ السلاسل أو الصفحات المسموح بها، وانقل الملفات إلى المحادثة، وحلل رسائل متعددة، ونفّذ تصفية أو تجميعًا محدودًا لجداول البيانات. | When Email Archive and its index are enabled / عند تفعيل أرشيف البريد وفهرسه | | CAP-AI-13 | **AI administration and safe usage** / إدارة الذكاء الاصطناعي والاستخدام الآمن | Activate or deactivate assistants, manage access lists, understand usage or error states, and count successful metered actions once. / فعّل المساعدين أو عطّلهم، وأدر قوائم الوصول، وافهم حالات الاستخدام أو الأخطاء، واحتسب الإجراءات المقاسة الناجحة مرة واحدة. | Admin access; provider and metering configuration apply / يتطلب وصول مسؤول؛ ويطبق إعداد المزوّد والقياس | ## Knowledge / المعرفة | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-KNW-01 | **Import and deduplicate knowledge** / استيراد المعرفة ومنع التكرار | Build knowledge from accessible PDF, DOCX, TXT, MD, HTML, pasted Markdown, or Documents sources without duplicating the same source. / ابنِ المعرفة من مصادر PDF أو DOCX أو TXT أو MD أو HTML المتاحة أو Markdown الملصق أو مصادر المستندات من دون تكرار المصدر نفسه. | When Knowledge is enabled / عند تفعيل Knowledge | | CAP-KNW-02 | **Visible processing pipeline** / مراحل معالجة مرئية | Follow parsing or OCR, structure, chunks, table summaries, enrichment, access policy, and embedding through visible stages that support eligible retries. / تابع التحليل أو OCR والبنية والمقاطع وملخصات الجداول والإثراء وسياسة الوصول والتضمين عبر مراحل مرئية تدعم إعادة المحاولة المؤهلة. | Knowledge and provider configuration required / يتطلب إعداد Knowledge والمزوّد | | CAP-KNW-03 | **Parsed Markdown and processing-stage history** / Markdown المعالج وتاريخ مراحل المعالجة | Inspect or edit the selected Markdown or JSON artifact, review completed stage versions, select a compatible earlier stage for later processing, and delete eligible stage versions. / افحص أو حرر عنصر Markdown أو JSON المحدد، وراجع نسخ المراحل المكتملة، واختر مرحلة سابقة متوافقة للمعالجة اللاحقة، واحذف نسخ المراحل المؤهلة. | When Knowledge is enabled; editing replaces the selected artifact / عند تفعيل Knowledge؛ ويستبدل التحرير العنصر المحدد | | CAP-KNW-04 | **Tables, entities, and sensitive-data enrichment** / إثراء الجداول والكيانات والبيانات الحساسة | Retain source order, pages, and headings, and make permitted table summaries editable and searchable under access control. / احتفظ بترتيب المصدر والصفحات والعناوين، واجعل ملخصات الجداول المسموح بها قابلة للتحرير والبحث تحت التحكم في الوصول. | When supported by the configured provider / عند دعم المزوّد المهيأ | | CAP-KNW-05 | **Document, page, and content-level access policy** / سياسة وصول للمستند والصفحة والمحتوى | Hide, deny, or mask sensitive material and use visible entity or sensitive-data assignment and bulk removal controls. / أخفِ المواد الحساسة أو امنعها أو احجبها، واستخدم عناصر التحكم المرئية لإسناد الكيانات أو البيانات الحساسة وإزالتها جماعيًا. | When Knowledge is enabled / عند تفعيل Knowledge | | CAP-KNW-06 | **Cited semantic retrieval** / استرجاع دلالي بالمراجع | Receive an answer in the user’s language after query refinement and retrieval, with permitted source images, navigation, and feedback. / احصل على إجابة بلغة المستخدم بعد تحسين السؤال والاسترجاع، مع صور المصادر المسموح بها والتنقل والتقييم. | Knowledge and AI provider required / يتطلب Knowledge ومزوّد AI | | CAP-KNW-07 | **Visible retrieval quality setup** / إعداد مرئي لجودة الاسترجاع | Choose a compatible embedding tier, run visible similarity and nearest-neighbor checks, and reuse retrieval presets before depending on an index. / اختر فئة تضمين متوافقة، وشغّل فحوص التشابه وأقرب جار المرئية، وأعد استخدام إعدادات الاسترجاع المسبقة قبل الاعتماد على الفهرس. | Admin access; Knowledge and provider configuration required / يتطلب وصول مسؤول وإعداد Knowledge والمزوّد | | CAP-KNW-08 | **Auto-sync rules** / قواعد المزامنة التلقائية | Scope processing by upload, app, user, role, workflow, file, or page, then dry-run, run now, inspect, retry, or cancel eligible work. / حدد نطاق المعالجة حسب الرفع أو التطبيق أو المستخدم أو الدور أو سير العمل أو الملف أو الصفحة، ثم نفّذ تشغيلًا جافًا أو فوريًا وافحص العمل المؤهل أو أعد محاولته أو ألغِه. | When Knowledge is enabled / عند تفعيل Knowledge | | CAP-KNW-09 | **Knowledge analytics** / تحليلات المعرفة | Review usage and questions, document coverage, processing time, quality, security decisions, gaps, and date-range details. / راجع الاستخدام والأسئلة وتغطية المستندات ووقت المعالجة والجودة وقرارات الأمان والفجوات والتفاصيل حسب نطاق التاريخ. | Ultra; Knowledge enabled / Ultra؛ مع تفعيل Knowledge | ## Email and Communication / البريد والاتصالات | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-MAIL-01 | **Managed RAPTIX addresses** / عناوين RAPTIX المُدارة | Use eligible personal and organization addresses, manage allowed aliases, check availability, follow rename grace, choose a default, and review the admin directory. / استخدم العناوين الشخصية وعناوين المؤسسة المؤهلة، وأدر الأسماء المستعارة المسموح بها، وتحقق من التوفر ومهلة إعادة التسمية، واختر عنوانًا افتراضيًا وراجع دليل الإدارة. | Controlled RAPTIX Mail rollout / طرح RAPTIX Mail مضبوط | | CAP-MAIL-02 | **Custom SMTP** / SMTP مخصص | Configure, mask, test, update, delete, and select an eligible sending account. / هيئ حساب إرسال مؤهلًا وأخفِ بياناته واختبره وحدّثه واحذفه واختره. | Ultra; configured provider / Ultra؛ ويتطلب مزوّدًا مهيأً | | CAP-MAIL-03 | **Connected Microsoft 365 mailbox** / صندوق Microsoft 365 متصل | Connect, test, and disconnect a real mailbox for permitted sending. / صل صندوق بريد حقيقيًا واختبره وافصله للإرسال المسموح به. | Ultra; configured provider / Ultra؛ ويتطلب مزوّدًا مهيأً | | CAP-MAIL-04 | **Communication template lifecycle** / دورة حياة قوالب الاتصال | Create and visually edit templates, preview merge data, create draft versions and copies, approve and activate, search and filter, and review visible usage indicators. / أنشئ القوالب وحررها بصريًا، وعاين بيانات الدمج، وأنشئ إصدارات مسودة ونسخًا، واعتمدها وفعّلها، وابحث وصفِّ النتائج، وراجع مؤشرات الاستخدام الظاهرة. | Available to eligible users / متاح للمستخدمين المؤهلين | | CAP-MAIL-05 | **Workflow email delivery** / إرسال البريد من سير العمل | Send to dynamic recipients with merge tags, static or submitted attachments, reusable templates, and visible delivery or archive state. / أرسل إلى مستلمين ديناميكيين باستخدام وسوم الدمج ومرفقات ثابتة أو مقدمة وقوالب قابلة لإعادة الاستخدام وحالة تسليم أو أرشفة مرئية. | Configured provider; some options depend on plan / يتطلب مزوّدًا مهيأً؛ وبعض الخيارات حسب الخطة | | CAP-MAIL-06 | **Email-triggered workflows** / تشغيل سير العمل بالبريد | Match sender, subject, body, language, document, project, or attachment; control schedule and rate; preview and test; and manage eligible diagnostics and recovery. / طابق المرسل أو الموضوع أو النص أو اللغة أو المستند أو المشروع أو المرفق، وتحكم في الجدول والمعدل، وعاين واختبر، وأدر التشخيص والتعافي المؤهلين. | Mail must be enabled; diagnostics and replay require Ultra / يجب تفعيل البريد؛ والتشخيص وإعادة التشغيل يتطلبان Ultra | | CAP-MAIL-07 | **Permission-scoped archive and search** / أرشيف وبحث حسب الصلاحية | List, search, and filter only messages related to the permitted participant, address, or workflow, including cross-language attachment content. / اعرض وابحث وصفِّ الرسائل المرتبطة فقط بالمشارك أو العنوان أو سير العمل المسموح، بما فيها محتوى المرفقات العابر للغات. | When Email Archive is enabled / عند تفعيل أرشيف البريد | | CAP-MAIL-08 | **Focused message journey and safe reader** / رحلة رسالة مركزة وقارئ آمن | Follow verified message stages, quoted history, formatted or plain content, and workflow context, then return to the previous filters. / تابع مراحل الرسالة المتحقق منها والسجل المقتبس والمحتوى المنسق أو العادي وسياق سير العمل، ثم ارجع إلى المرشحات السابقة. | When Email Archive is enabled / عند تفعيل أرشيف البريد | | CAP-MAIL-09 | **Attachment malware gate** / بوابة فحص المرفقات من البرمجيات الخبيثة | See an attachment move from scanning to permitted download, with no direct storage link and no release after an unsafe or failed scan. / شاهد انتقال المرفق من الفحص إلى التنزيل المسموح، من دون رابط تخزين مباشر ومن دون إفراج بعد فحص غير آمن أو فاشل. | When Email Archive scanning is enabled / عند تفعيل فحص أرشيف البريد | | CAP-MAIL-10 | **Retention and deletion** / الاحتفاظ والحذف | Apply indefinite or day-based retention, confirm shorter retention, and remove message body, files, and search binding while preserving minimal audit evidence. / طبّق احتفاظًا غير محدد المدة أو قائمًا على الأيام، وأكد تقصير المدة، وأزل نص الرسالة والملفات وارتباط البحث مع حفظ الحد الأدنى من دليل التدقيق. | When Email Archive is enabled / عند تفعيل أرشيف البريد | | CAP-MAIL-11 | **Keep original email and files** / الاحتفاظ بأصل الرسالة وملفاتها | Let an admin control whether the original message and attachments are retained; when they are not retained, permission-scoped indexed text can remain searchable. / اسمح للمسؤول بالتحكم في الاحتفاظ بالرسالة الأصلية ومرفقاتها؛ وعند عدم الاحتفاظ بها يمكن أن يظل النص المفهرس قابلًا للبحث حسب الصلاحية. | When Email Archive is enabled / عند تفعيل أرشيف البريد | ## Billing, Plans, and Entitlements / الفوترة والخطط والاستحقاقات | Ref | Capability / الميزة | User benefit / فائدة المستخدم | Availability / التوفر | |---|---|---|---| | CAP-BILL-01 | **Live plan catalog** / كتالوج الخطط الحي | Compare the current Free, Pro, Ultra, and Enterprise prices, limits, features, and monthly or annual basis, with a safe unavailable state when live data cannot load. / قارن أسعار وحدود وميزات خطط Free وPro وUltra وEnterprise الحالية والأساس الشهري أو السنوي، مع حالة آمنة عند تعذر تحميل البيانات الحية. | Live Pricing data is authoritative / بيانات Pricing الحية هي المرجع | | CAP-BILL-02 | **No-card Pro trial** / تجربة Pro بلا بطاقة | When offered in the current signup rollout, try Pro for 14 days once, then move to Free without an automatic charge or data deletion. / عند تقديمها في طرح التسجيل الحالي، جرّب Pro لمدة 14 يومًا مرة واحدة، ثم انتقل إلى Free من دون تحصيل تلقائي أو حذف البيانات. | Controlled signup rollout / طرح التسجيل مضبوط | | CAP-BILL-03 | **Billing overview and ownership** / نظرة الفوترة والملكية | Review plan, renewal, limits, storage, workflow and AI credits, and warnings, with separate view and management permissions for the Billing Owner. / راجع الخطة والتجديد والحدود والتخزين ورصيد سير العمل والذكاء الاصطناعي والتحذيرات، مع فصل صلاحيات العرض والإدارة لمالك الفوترة. | Billing view available; usage balances depend on metering rollout / عرض الفوترة متاح؛ وأرصدة الاستخدام تعتمد على طرح القياس | | CAP-BILL-04 | **Hosted checkout and subscription management** / الدفع المستضاف وإدارة الاشتراك | When enabled, complete hosted checkout, verify the result, open the billing portal, preview or apply plan changes, cancel or resume, or contact Sales for Enterprise. / عند التفعيل، أكمل الدفع المستضاف وتحقق من النتيجة وافتح بوابة الفوترة وعاين تغييرات الخطة أو طبقها وألغِ أو استأنف، أو تواصل مع المبيعات لخطة Enterprise. | Only when hosted payments are enabled / فقط عند تفعيل الدفع المستضاف | | CAP-BILL-05 | **Seats and additional addresses** / المقاعد والعناوين الإضافية | Understand included seats, eligible purchase or ownership transfer, address quotes or purchase, and current limits. / اعرف المقاعد المضمنة والشراء المؤهل أو نقل الملكية وعروض أسعار العناوين أو شرائها والحدود الحالية. | Depends on plan, Mail, and metering / يعتمد على الخطة والبريد والقياس | | CAP-BILL-06 | **Credits, packs, wallet, and funding priority** / الرصيد والحزم والمحفظة وأولوية التمويل | Review balances by source and their ledger, understand renewal funding rules, purchase and expiry, and recover after reaching a limit. / راجع الأرصدة حسب المصدر ودفتر حركاتها، وافهم قواعد تمويل التجديد والشراء وانتهاء الصلاحية والتعافي بعد بلوغ الحد. | When metering and payments are enabled / عند تفعيل القياس والدفع | | CAP-BILL-07 | **Invoices** / الفواتير | Review invoice history and open permitted PDF invoices supplied by the billing provider. / راجع سجل الفواتير وافتح ملفات PDF المسموح بها التي يوفرها مزوّد الفوترة. | Provider-dependent / يعتمد على المزوّد | | CAP-BILL-09 | **Pricing feedback** / ملاحظات التسعير | Record survey status and send price feedback from inside the product when the survey is offered. / سجّل حالة الاستبيان وأرسل ملاحظات عن السعر من داخل المنتج عند عرض الاستبيان. | Available when the survey is shown / متاح عند ظهور الاستبيان | --- ## A truthful promise / وعد دقيق RAPTIX presents only the capabilities a person is allowed to use. A feature can therefore be part of the platform while remaining hidden until the correct plan, permission, provider, or workspace setting is in place. Every availability label in this catalog is part of the product promise. يعرض RAPTIX فقط القدرات المسموح لكل شخص باستخدامها. لذلك قد تكون الميزة جزءًا من المنصة وتظل مخفية حتى تتوفر الخطة أو الصلاحية أو المزوّد أو إعداد مساحة العمل الصحيح. وتعد كل تسمية توفر في هذا الكتالوج جزءًا من وعد المنتج. For exact prices, quotas, and current commercial availability, use the live Pricing and Billing pages. For task instructions, continue to the relevant module in the RAPTIX User Guide. للحصول على الأسعار والحصص والتوفر التجاري الحالي بدقة، استخدم صفحتي Pricing وBilling الحيتين. ولتعليمات تنفيذ المهام، انتقل إلى الوحدة المناسبة في دليل مستخدم RAPTIX.