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

getRootUserGroups

الحصول على جميع مجموعات المستخدمين من المستوى الأعلى.

الوصف​

يجلب مجموعات المستخدمين من المستوى الأعلى، أي تلك التي ليس لها أصل. يُعيد مصفوفة من كائنات IUserGroupEntity.

.getRootUserGroups(

);

مخطط المعلمات​

Schema

langCode: string
رمز اللغة. الافتراضي: langCode المُمرَّر إلى defineOneEntry ("en_US" إذا لم يُمرَّر).
مثال: "en_US"

أمثلة​

مثال بسيط​

const response = await UserGroups.getRootUserGroups();

مثال على الاستجابة​

[
{
"id": 1,
"depth": 0,
"parentId": null,
"localizeInfos": {
"title": "Guest"
},
"isVisible": true,
"childrenCount": "0",
"identifier": "guest",
"isSync": false,
"attributeValues": {}
},
{
"id": 2,
"depth": 0,
"parentId": null,
"localizeInfos": {
"title": "sd"
},
"isVisible": true,
"childrenCount": "0",
"identifier": "wewe",
"isSync": false,
"attributeValues": {}
}
]

مخطط الاستجابة​

المخطط: IUserGroupEntity[]

id: number
معرّف مجموعة المستخدمين.
مثال: 1

depth: number
مستوى المجموعة في الشجرة: 0 للمجموعة في المستوى الأعلى، وdepth للمجموعة الأم زائد 1 للمجموعة الفرعية.
مثال: 0

parentId: number | null
معرّف المجموعة الأصل، وnull للمجموعة من المستوى الأعلى.
مثال: null

localizeInfos: ILocalizeInfo
العنوان المترجم للمجموعة.

isVisible: boolean
هل المجموعة ظاهرة.
مثال: true

childrenCount: string
عدد المجموعات الفرعية. تُرسله واجهة API كسلسلة نصية وليس كرقم.
مثال: "0"

identifier: string
المعرّف النصي (العلامة) للمجموعة.
مثال: "guest"

isSync: boolean
ما إذا كان فهرس سمات المجموعة مبنيًا للغة المطلوبة. عندما تكون القيمة false، فإن attributeValues الفارغة تعني أن القيم لم تُفهرس بعد، لا أنها غير موجودة.
مثال: false

attributeValues: IAttributeValues
قيم سمات المجموعة.

version: number
رقم إصدار المجموعة. تُرجعه فقط getUserGroupById() وgetUserGroupByMarker()؛ وتُغفله طرق القوائم (getUserGroups() وgetRootUserGroups() وgetChildUserGroupsByMarker()).