عناصر التحكم في الرؤية

import { Image } from ‘astro:assets’; import setCategory from ’../../../../assets/screenshots/set-category-modal.png’; import wizardDefine from ’../../../../assets/screenshots/wizard-define-types.png’; import wizardDefineMultiple from ’../../../../assets/screenshots/wizard-define-types-multiple.png’; import wizardRoles from ’../../../../assets/screenshots/wizard-assign-roles.png’; import wizardReview from ’../../../../assets/screenshots/wizard-review-deploy.png’; import wizardWelcome from ’../../../../assets/screenshots/wizard-welcome.png’; import wizardHome from ’../../../../assets/screenshots/wizard-home.png’;

ملاحظة

متاحة في إصدار AppExchange فقط. يجب أن يكون وضع التخزين للمكوّن مضبوطاً على Isolated لتطبيق عناصر التحكم في الرؤية.

نظرة عامة

تتيح عناصر التحكم في الرؤية للمسؤولين تقييد الوصول إلى الملفات حسب فئة المستند (مرتبطة بأدوار في التسلسل الهرمي لأدوار Salesforce) وتتيح لأي مستخدم تعليم ملفات فردية كـخاصة. تحدث جميع عمليات التصفية من جانب الخادم في getFilesList() — الملفات المقيّدة لا تصل إلى المتصفحات غير المخوّلة أبداً.

متطلبات وضع التخزين

	القياسي	المعزول
الملفات مرئية في قائمة الملفات المرتبطة القياسية	نعم	لا
تعيين الفئات	غير متاح	متاح
التعليم كخاص	غير متاح	متاح
التصفية القائمة على الأدوار	غير متاح	متاح

في الوضع القياسي لا يُنشأ سجل ربط، لذا لا يوجد مكان لتخزين الفئة أو علامة الخصوصية. انتقل إلى الوضع المعزول لأي سجل تكون فيه تصفية الرؤية ضرورية.

فئات المستندات

الفئة هي تسمية تُعيَّن لملف تحدد من يمكنه رؤيته. تعيش الفئات في سجلات Tucario_Visibility_Rule__mdt وتُدار عبر معالج التكوين.

أمثلة شائعة: HR Documents، Underwriting Documents، Financial Reports، Legal Contracts، Medical Records.

آلية التصفية

تربط كل قاعدة فئةً بقائمة من قيم DeveloperName للأدوار المسموح بها. لكل ملف:

• الملف بلا فئة ← مرئي للجميع (مفتوح افتراضياً).
• الملف له فئة، دور المستخدم في القائمة المسموحة ← مرئي.
• الملف له فئة، دور المستخدم غير مسموح ← مخفي.
• الملف له فئة، القاعدة غير نشطة (Is_Active = false) ← مرئي للجميع (القواعد غير النشطة لا تُصفِّي).
• المستخدم لديه الصلاحية المخصصة Manage Categories ← يتجاوز تصفية الفئات (يرى جميع الملفات دائماً).

تتحد قواعد متعددة تشير إلى نفس الفئة بمنطق OR — يجتاز المستخدم الفحص إذا كان دوره في أي قائمة مسموحة للفئة.

تعيين فئة لملف

يمكن للمستخدمين الذين لديهم صلاحية Manage Categories تعيين فئة من القائمة السياقية للملف:

1. افتح القائمة السياقية للملف واختر Set Category.
2. اختر فئة من المنتقي، أو اختر No Category لإلغاء التعيين.
3. تتحدث رؤية الملف فوراً.

تنبيه

المستخدمون الذين لا يمتلكون صلاحية Manage Categories يرون خيار Set Category لكن يظهر لهم تحذير تأكيد بأن الملف قد يختفي من عرضهم الخاص فور تطبيق فئة مقيّدة (لأنهم لا يتجاوزون التصفية).

تكوين قواعد الرؤية

افتح تطبيق Smarter Files by Tucario من App Launcher. يفتح معالج التكوين على الشاشة الرئيسية بكارتين: Manage Document Categories وPrivate Documents.

انقر على Manage Document Categories للدخول إلى معالج القواعد ذي الثلاث خطوات.

الخطوة 1 — تحديد أنواع المستندات

أضف أنواع المستندات التي تريد التحكم فيها. لكل نوع اسم ووصف اختياري.

الخطوة 2 — تعيين الأدوار

لكل نوع مستند، اختر الأدوار المسموح لها برؤية الملفات في تلك الفئة. يُعبأ الصندوق المزدوج من التسلسل الهرمي للأدوار في مؤسستك (بحد أقصى 1000 دور).

الخطوة 3 — المراجعة والنشر

راجع الفئات النشطة وغير النشطة، ثم انقر Deploy Configuration. يستدعي المعالج Metadata.Operations.enqueueDeployment() لكتابة القواعد كسجلات Tucario_Visibility_Rule__mdt بشكل غير متزامن مع استطلاع حالة الاكتمال. يظهر مؤشر تقدم خلال ذلك.

ملاحظة

إزالة فئة: إزالة نوع مستند من المعالج والنشر لا تحذف سجل CMT — بل تضبط Is_Active = false. لا تدعم Salesforce Metadata API حذف سجلات CMT من Apex، لذا يُعدّ إلغاء التنشيط أقرب ما يمكن. الفئات غير النشطة لم تعد تظهر في المنتقي أو تُصفِّي الملفات، ويمكن إعادة تنشيطها لاحقاً بإضافة فئة بنفس الاسم.

المستندات الخاصة

بالإضافة إلى التصفية القائمة على الفئات، يمكن لأي مستخدم تعليم ملفات فردية كخاصة — مرئية فقط لنفسه وللمستخدمين الذين لديهم صلاحية View Private Documents. راجع المستندات الخاصة للاطلاع على التدفق الكامل.

منطق التصفية المجتمعة

عندما يملك الملف فئةً وعلامة خصوصية معاً، يجب نجاح كلا الفحصين لكي يكون الملف مرئياً. الكود الزائف لـ getFilesList():

For each file on the record:
  1. Private check:
     If Is_Private AND user is not Owner_Id
     AND user lacks "View Private Documents" → HIDE

  2. Category check:
     If Visibility_Category is set
     AND a matching active rule exists
     AND user's role is not in Permitted_Roles
     AND user lacks "Manage Categories" → HIDE

  3. Otherwise → SHOW

يفوز الأكثر تقييداً بين الفحصين.

مجموعات الصلاحيات

مجموعة الصلاحيات	الغرض
Tucario Files	الوصول الأساسي. مطلوبة لكل مستخدم. تمنح التطبيق ووحدات التحكم وكائن الربط.
Tucario - Manage File Categories	الوصول إلى قائمة Set Category + تجاوز تصفية الفئات (رؤية جميع الملفات دائماً).
Tucario - View Private Documents	رؤية الملفات التي علّمها مستخدمون آخرون كخاصة.

حالات الاستخدام

• مستندات الموارد البشرية مرئية فقط لأدوار الموارد البشرية، مع التعليم الخاص للسجلات الفردية للموظفين.
• التقارير المالية مقيدة لأدوار المالية، بغض النظر عن من رفعها.
• العقود القانونية مقفلة لأدوار القسم القانوني، مع التعليم الخاص على مسودات العقود.
• مستندات الاكتتاب التي تحتوي على معلومات شخصية، مقيدة لأدوار المكتتبين.
• المرفقات السرية على سجل مشترك — نسخة ثانية من المكوّن في الوضع المعزول مع تطبيق فئات، مخفية تماماً عن قائمة الملفات المرتبطة القياسية.