انتقل إلى المحتوى الرئيسي

المقدمة

استرجع معلومات حول حسابات المسؤولين، وأدوارهم، وأذوناتهم.

لمزيد من المعلومات حول واجهة مستخدم الوحدة، قم بزيارة https://doc.oneentry.cloud/docs/category/administrators (يفتح في علامة تبويب جديدة)

🎯 ماذا تفعل هذه الوحدة؟​

وحدة Admins هي للقراءة فقط: تسترجع حسابات المسؤولين لمشروع OneEntry الخاص بك وقيم سماته، مع إمكانية التصفية الاختيارية. يتم إنشاء الحسابات، وتعيين الأدوار، وإلغاء الوصول في لوحة تحكم OneEntry — هذه الوحدة من SDK تقرأ فقط تلك المعلومات حتى تتمكن تطبيقك من رؤية من لديه الوصول وماذا يمكنهم أن يفعلوا.

🚀 البدء السريع​

قم بتهيئة الوحدة من defineOneEntry:


const {  } = defineOneEntry(
  , {
    
  }
);

استرجع المسؤولين، مع إمكانية التصفية حسب شروط السمات:

// Filter body: admins whose "num" attribute is greater than 1.
const body = [
  { attributeMarker: "num", conditionMarker: "mth", conditionValue: 1 },
];

// getAdminsInfo(body, langCode, offset, limit) — all optional except defaults.
const admins = await Admins.getAdminsInfo(body, "en_US", 0, 30);

admins.forEach((admin) => {
  console.log(admin.id, admin.identifier);
});

مرر مصفوفة فارغة ([]) للجسم عندما لا تحتاج إلى التصفية.

✨ المفاهيم الأساسية​

ما هو المسؤول؟​

المسؤول (admin) هو حساب له وصول مرتفع لإدارة مشروع OneEntry الخاص بك. كل مسؤول يكشف عن:

  • المعرف - المعرف الفريد للمسؤول
  • مجموعة السمات - مجموعة السمات التي ينتمي إليها المسؤول (attributeSetIdentifier)
  • قيم السمات - الحقول المكونة (attributeValues)
  • الأدوار / الأذونات - المكونة في لوحة التحكم؛ يقرأها SDK عبر قيم السمات

المسؤول مقابل المستخدم العادي​

النوعالغرضالمثال
المسؤوليدير النظام (الواجهة الخلفية)أنت، أعضاء فريقك
المستخدم العادييستخدم تطبيقك/موقعك (الواجهة الأمامية)عملاؤك، زوار الموقع

يدير المسؤولون المحتوى؛ المستخدمون يستهلكون المحتوى.

📋 ما تحتاج إلى معرفته​

سمات المسؤول​

كل كائن مسؤول يحتوي على هذه الحقول الرئيسية:

{
  id: 123,                          // Unique admin ID
  attributeSetId: 27,               // Attribute set ID
  identifier: "admin",              // Unique identifier
  attributeSetIdentifier: "admins", // Attribute set identifier
  position: 1,                      // Position
  isSync: true,                     // Whether synced with the backend
  attributeValues: {}               // Attribute values
}

تصفية المسؤولين​

قم بالتصفية عبر جسم الطلب — مصفوفة من الشروط، كل منها يجمع بين attributeMarker، وconditionMarker، وconditionValue (نفس العلامات كما في وحدة المنتجات):

العلامةالمعنىالمثال
eqيساويstatusId = 1 (نشط فقط)
neqلا يساويrole ≠ "مشاهد"
inيحتوي على (واحد من)role in ["محرر", "مدير"]
ninلا يحتوي علىemail not in ["@temp.com"]
mthأكثر من (أكبر)createdYear > 2020
lthأقل منloginCount < 5
exsموجود (له قيمة)Has lastLogin
nexsغير موجودلم يسجل الدخول أبداً
patيتطابق مع النمطidentifier matches "man"
sameيتطابق مع القيمة بالضبطidentifier is exactly "admin1"
same_partيتطابق مع جزء من القيمة بالضبطجزء من المعرف هو بالضبط "adm"

📊 جدول المرجع السريع​

الطريقةالوصف
getAdminsInfo()الحصول على حسابات المسؤولين، مع إمكانية التصفية الاختيارية
getAdminsByVectorSearch()بحث دلالي (متجه) عن المسؤولين

المعلمات​


const  = [
  {
    ,
    ,
    
  }
];

const response = await Admins.getAdminsInfo(body, "en_US", 0, 30);

المخطط: (الجسم)

attributeMarker: string
معرف نصي للسمة
مثال: price

conditionMarker: string
معرف نصي للشرط، القيم الممكنة: 'in' - يحتوي، 'nin' - لا يحتوي، 'eq' - يساوي، 'neq' - لا يساوي، 'mth' - أكثر من، 'lth' - أقل من، 'exs' - موجود، 'nexs' - غير موجود، 'pat' - يتطابق مع النمط، 'same' - يتطابق مع القيمة بالضبط، 'same_part' - يتطابق مع جزء من القيمة بالضبط
مثال: in
Enum: [ in, nin, eq, neq, mth, lth, exs, nexs, pat, same, same_part ]

conditionValue: number
قيمة الشرط
مثال: 1

❓ الأسئلة الشائعة (FAQ)​

ما الفرق بين وحدتي Admins و Users؟​

  • Admins - حسابات فريق الواجهة الخلفية التي تدير النظام (للقراءة فقط هنا).
  • Users - حسابات الواجهة الأمامية التي تستخدم تطبيقك/موقعك (وحدة المستخدمين).

هل يمكنني إنشاء أو تعديل المسؤولين باستخدام هذه الوحدة؟​

لا. وحدة Admins هي للقراءة فقط. قم بإنشاء حسابات، وتعيين الأدوار والأذونات (يفتح في علامة تبويب جديدة)، وإلغاء الوصول في لوحة تحكم OneEntry.

🎓 أفضل الممارسات​

  • لا تكشف أبداً عن بيانات اعتماد المسؤول أو الرموز المميزة المميزة في كود الواجهة الأمامية.
  • استخدم الفلاتر لجلب فقط المسؤولين الذين تحتاجهم بدلاً من القائمة الكاملة.
  • نفذ أقل امتياز عند تكوين الأدوار في لوحة التحكم.

🔗 الوثائق ذات الصلة​