---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Anwenderkompetenzrangliste -- Global

# Anwenderkompetenzrangliste -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Anwenderkompetenzrangliste Die API bietet Methoden zum Konfigurieren von Optionen zur Auswahl des richtigen Anwenders und zum Abrufen einer sortierten Liste qualifizierter Anwender basierend auf der Anzahl der übereinstimmenden Kompetenzen und der Kompetenzniveaulücke.

Diese API erfordert KompetenzmanagementPlugin (com.snc.Skills_Management), das Sie aktivieren können, wenn Sie über die Administratorrolle verfügen.

Siehe [Qualifizieren und ordnen Sie Anwender basierend auf Kompetenzen und Kompetenzniveaus](https://www.servicenow.com/docs/access?context=assign-work-based-on-skills&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

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

Instanziiert ein AnwenderkompetenzRanking-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 AnforderungsSkillsJson, Zeichenfolge usersJson, ZeichenfolgenrangType, boolescher isSkillLevelEnforced) {#ariaid-title3}

Stellt eine Liste qualifizierter Anwender basierend auf übereinstimmenden obligatorischen Kompetenzen und Niveaus bereit, falls vorhanden `IsSkillLevelEnforced `Parameter ist „wahr").
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AnforderungKompetenzJSON | Zeichenfolge | Liste der erforderlichen Kompetenzen zur Qualifizierung von Anwendern. Jede Kompetenz wird als JSON-Eintrag im folgenden Format aufgelistet: * sys_ID: Zeichenfolge. SYS-ID der Kompetenz aus der Tabelle „Kompetenzen" \[cmn_Skill\]. * Is_obligatorisch: Boolescher Wert. Kennzeichnung, die angibt, ob die Kompetenz obligatorisch ist. * Ebene: Zeichenfolge. SYS-ID aus der Tabelle „Kompetenzstufen" \[cmn_Skill_level\]. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| AnwenderJSON | 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. |
| RangType | Zeichenfolge | Ermöglicht das Sortieren qualifizierter Anwender basierend auf dem Rangfolgetyp. Mögliche Werte sind Komparatoren, um eine sortierte Liste qualifizierter Anwender basierend auf der Anzahl der übereinstimmenden Kompetenzen und der Kompetenzniveaulücke bereitzustellen: * NO_RANKING (Standard): Wird verwendet, wenn ein leerer Wert angegeben wird. * NUM_SKILLS: Anzahl der Kompetenzen, die mit den erforderlichen Kompetenzen abgeglichen wurden. * NUM_SKILL_ MATCHING_LEVEL: Anzahl der Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen. * LEAST_SKILL_ LEVEL_GAP: Sucht nach Anwenderkompetenz, die die Mindestanforderungen an das Kompetenzniveau am besten erfüllt. * MOST_SKILL_ LEVEL_GAP: Sucht nach einem Anwender, der die Mindestanforderungen an das Kompetenzniveau am wenigsten erfüllt. * BEST_OPTIMUM_-ANWENDER: Findet den optimalen Anwender für alle Kompetenzstufen. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| IsSkillLevelEnforced | Boolean | „Wahr", wenn der Anwender über ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen verfügen muss, andernfalls „falsch". Standard: Falsch. |
[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 fehlerhafte JSON angegeben werden. |
[Tabelle : 3. Rückgaben]

{#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);


