إعدادات المسؤول
مجموعات الصلاحيات
Section titled “مجموعات الصلاحيات”تأتي الحزمة مع ثلاث مجموعات صلاحيات. يحتاج كل مستخدم للمكوّن على الأقل إلى المجموعة الأساسية.
| مجموعة الصلاحيات | مطلوبة لـ | تمنح |
|---|---|---|
| Tucario Files (الأساسية) | جميع مستخدمي المكوّن | الوصول إلى التطبيق (“Smarter Files by Tucario”)، وعمليات CRUD على كائن الربط Tucario_File_Visibility__c، والوصول إلى TucarioFileDownloadController وTucarioVisibilityController |
| Tucario - Manage File Categories | المسؤولون وأصحاب الفئات | الصلاحية المخصصة Tucario_Manage_Categories — تعيين الفئات على الملفات عبر “Set Category”، وتجاوز تصفية الفئات (هؤلاء المستخدمون يرون جميع الملفات دائماً) |
| Tucario - View Private Documents | المسؤولون والموارد البشرية ومسؤولو الامتثال | الصلاحية المخصصة Tucario_View_Private_Documents — عرض الملفات التي علّمها مستخدمون آخرون كخاصة |
قيود الرفع
Section titled “قيود الرفع”تُضبط قواعد الرفع — الامتدادات المسموحة والمستبعدة والحجم الأقصى — لكل مثيل من المكوّن عبر خصائص التصميم في App Builder، وليس بشكل عام. راجع إعداد المكوّن للاطلاع على قائمة الخصائص الكاملة.
هذا يعني إمكانية وضع قواعد رفع مختلفة على صفحات سجلات مختلفة، أو حتى نسخ متعددة على نفس صفحة السجل بقواعد مختلفة.
قواعد الرؤية — Tucario_Visibility_Rule__mdt
Section titled “قواعد الرؤية — Tucario_Visibility_Rule__mdt”تُخزَّن قواعد الرؤية كسجلات Custom Metadata Type وتُدار عبر معالج التكوين — ولا تُحرَّر مباشرةً في Setup.
| الحقل | النوع | الغرض |
|---|---|---|
| Category | نص | اسم نوع المستند (مثل HR Documents أو Contracts). تشير الملفات إلى هذه السلسلة النصية في حقل Visibility_Category__c. |
| Permitted Roles | منطقة نص طويل | قائمة مفصولة بفاصلة منقوطة من قيم DeveloperName للأدوار (مثل CEO;HR_Manager;HR_Specialist). يمكن للمستخدمين الذين يطابق دورهم أحد هذه القيم رؤية الملفات في هذه الفئة. |
| Is Active | خانة اختيار | ما إذا كانت القاعدة مطبّقة. القواعد غير النشطة تتصرف كأنها غير موجودة (الفئة تعود إلى الوضع المفتوح الافتراضي). |
| Description | نص | وصف موجّه للمسؤول يشرح محتوى الفئة. |
كائن ربط رؤية الملف — Tucario_File_Visibility__c
Section titled “كائن ربط رؤية الملف — Tucario_File_Visibility__c”ينشئ Smarter Files سجل كائن ربط مخصص لكل ملف يُدار في وضع التخزين Isolated (وكذلك لأي ملف له فئة أو علامة خصوصية، بغض النظر عن الوضع).
| الحقل | النوع | الغرض |
|---|---|---|
| Content Document Id | نص (معرّف خارجي، فريد) | مرجع إلى ContentDocument في Salesforce. سجل ربط واحد لكل ملف لكل سجل رئيسي. |
| Parent Record Id | نص (18) | معرّف السجل الرئيسي المؤلف من 18 حرفاً والذي يُرفق به الملف. |
| Visibility Category | نص (80) | اسم الفئة من Tucario_Visibility_Rule__mdt. الحقل الفارغ يعني عدم وجود قيد على الفئة. |
| Is Private | خانة اختيار | يُشير إلى أن الملف قد عُلِّم كخاص. |
| Owner Id | بحث (مستخدم) | المستخدم الذي علّم الملف كخاص. مطلوب عندما تكون Is Private صحيحة (مفروض بواسطة قاعدة التحقق Owner_Required_When_Private). |
التسمية التلقائية: تستخدم السجلات الصيغة FV-{0000}.
نموذج المشاركة: ReadWrite. تعمل SOQL/DML على هذا الكائن في USER_MODE، لذا يرى المستخدمون ويعدّلون سجلات الربط التي يملكون الوصول إليها فقط.
الصلاحيات المخصصة
Section titled “الصلاحيات المخصصة”| اسم API | تستخدمها |
|---|---|
Tucario_Manage_Categories | تُمنح عبر مجموعة صلاحيات Tucario - Manage File Categories. تتحكم في ظهور عنصر قائمة Set Category وتتجاوز التصفية القائمة على الفئات. |
Tucario_View_Private_Documents | تُمنح عبر مجموعة صلاحيات Tucario - View Private Documents. تتيح رؤية الملفات الخاصة المملوكة لمستخدمين آخرين. |
يمكنك تعيين هذه الصلاحيات المخصصة من خلال مجموعات صلاحياتك الخاصة إذا أردت دمجها مع أدوار خاصة بمؤسستك بدلاً من استخدام مجموعات الصلاحيات المشحونة مع الحزمة.
فئات Apex المكشوفة
Section titled “فئات Apex المكشوفة”وحدتا تحكم يمكن الوصول إليهما من مكوّنات Lightning — كلتاهما تعمل with sharing وتستخدم USER_MODE لعمليات SOQL/DML:
TucarioFileDownloadController— عمليات CRUD على الملفات، الرفع والتنزيل، إنشاء الروابط العامة، تعيين الفئات، تبديل علامة الخصوصية.TucarioVisibilityController— الواجهة الخلفية لمعالج التكوين (قائمة الأدوار، نشر القواعد، استطلاع حالة النشر)، عناصر التحكم في الترحيل الجماعي، فحوصات الصلاحيات.
امنح الوصول عبر مجموعة صلاحيات Tucario Files (مُفعَّلة بالفعل هناك) — لا توجد عادةً أسباب لتفعيل هذه الفئات من خلال مجموعات صلاحيات أخرى.