---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UserSkillBewertungsliste -- Global

# UserSkillBewertungsliste -- Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die UserSkillranking- API bietet Methoden zum Konfigurieren von Optionen für die Auswahl des richtigen Benutzers und das Abrufen einer sortierten Liste qualifizierter Benutzer basierend auf der Anzahl der übereinstimmenden Kompetenzen und dem Kompetenzdefizit.

Diese API erfordert das Plugin Kompetenzmanagement (com.snc.skills_management), das Sie mit der Administratorrolle aktivieren können.

Weitere Informationen finden Sie [unter Benutzer basierend auf Kompetenzen und Kompetenzniveau qualifizieren und einstufen](https://www.servicenow.com/docs/access?context=assign-work-based-on-skills&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

## UserSkillRanging: UserSkillRanging() {#ariaid-title2}

Instanziiert ein UserSkillranking-Objekt.
{#SR-UserSkillRanking__table_shf_4b1_whb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#SR-UserSkillRanking__table_shf_4b1_whb}

## UserSkillranking - getQualifiedrankedusers(Zeichenfolge erforderlichSkillsJson, Zeichenfolge usersJson, Zeichenfolge rangType, Boolesche isSkillLevelEnforced) {#ariaid-title3}

Stellt eine Liste qualifizierter Benutzer basierend auf den übereinstimmenden obligatorischen Kompetenzen und Niveaus bereit, wenn der Parameter `„isSkillLevelEnforced"` auf „wahr" festgelegt ist.
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ErforderlicheKompetenzenJson | Zeichenfolge | Liste der erforderlichen Kompetenzen zum Qualifizieren von Anwendern. Jede Kompetenz wird als JSON-Eintrag im folgenden Format aufgelistet: * sys_id: Zeichenfolge. Sys-ID der Kompetenz aus der Kompetenztabelle \[cmn_skill\]. * is_mandanten: Boolesch. Kennzeichnung, die angibt, ob die Kompetenz obligatorisch ist. * Ebene: Zeichenfolge Sys-ID aus der Tabelle „Kompetenzniveaus" \[cmn_skill_level\] {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| usersJson | Zeichenfolge | Liste der Anwender-Sys-IDs aus der Tabelle „sys_user" (im JSON-Format), die Anwender darstellen, die für die erforderlichen Kompetenzen qualifiziert werden sollen. |
| rankType | Zeichenfolge | Aktiviert die Sortierung qualifizierter Benutzer nach dem Rangfolgetyp. Mögliche Werte sind Vergleichswerte, um eine sortierte Liste qualifizierter Anwender basierend auf der Anzahl der übereinstimmenden Kompetenzen und der Lücke bei den Kompetenzniveaus bereitzustellen: * NO_RANking (Standard): Wird verwendet, wenn ein leerer Wert angegeben wird. * NUM_SKILLS: Anzahl der Kompetenzen, die mit den erforderlichen Kompetenzen übereinstimmen. * NUM_SKILL_ MATCHING_LEVEL: Anzahl der Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen. * LEAST_SKILL_ LEVEL_GAP -- Sucht nach Anwenderkompetenzen, die den Mindestanforderungen an das Kompetenzniveau am nächsten kommen. * MOST_SKILL_ LEVEL_GAP: Sucht nach dem Anwender, der die Mindestanforderungen an Kompetenzniveaus am wenigsten erfüllt. * BEST_OPMUM_ USER: Sucht nach dem optimalen Benutzer für alle Kompetenzstufen. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| istKompetenzniveauerzwungen | Boolean | „Wahr", wenn der Anwender über ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen verfügen muss, andernfalls „falsch". Standard: false. |
[Tabelle : 2. Parameter]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb} {#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Liste der qualifizierten Anwender als JSON. Fehler, wenn ungenaue Parameter oder falsch formatiertes JSON angegeben werden. |
[Tabelle : 3. Ergebnisse]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb}  

    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
    				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4eS"}];
    var users = ["a8f98bb0eb32010045e1a5115206fe3a", "62826bf03710200044e0bfc8bcbe5df1"];
    var userSkillRanking = new SNC.UserSkillRanking();
    var qualifiedUsers = userSkillRanking.getQualifiedRankedUsers(JSON.stringify(skills), JSON.stringify(users), "BEST_OPTIMUM_USER", true);