---
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


---

# Anwenderkompetenzanalyse -- Global

# Anwenderkompetenzanalyse -- Global {#ariaid-title1}

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

Die Anwenderkompetenzanalyse Die API bietet Methoden zur Analyse von Anwenderkompetenzen anhand von Kompetenzen, die zum Abschließen von Arbeitselementen erforderlich sind.

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).

## UserSkillAnalyzer -- UserSkillAnalyzer() {#ariaid-title2}

Instanziiert ein neues AnwenderSkillAnalyzer-Objekt.
{#USA-UserSkillAnalyzer__table_shf_4b1_whb__entry__3}

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

{#USA-UserSkillAnalyzer__table_shf_4b1_whb}  


    var userSkillAnalyzer = new SNC.UserSkillAnalyzer();

## UserSkillAnalyzer -- analyzeUserByID(Zeichenfolge AnforderungsSkillsJson, Zeichenfolge userID, boolescher Wert isSkillLevelEnforced) {#ariaid-title3}

Analysiert Anwenderkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, die Kompetenzniveaulücke und die Qualifizierung fest, die von einer Instanz erfasst werden können.
Analysiert, ob ein Service Desk-Mitarbeiter für die Arbeit an einer Aufgabe qualifiziert ist, indem überprüft wird, ob der Service Desk-Mitarbeiter über die Kompetenzen und Kompetenzniveaus verfügt, die zum Abschließen der Aufgabe erforderlich sind. Wenn ein Service Desk-Mitarbeiter für die Arbeit an einer Aufgabe qualifiziert ist, analysiert die API die Ebenenlücke zwischen erforderlichen Kompetenzen und dem Kompetenzniveau des Anwenders, die von der Anwendung weiter verwendet werden kann, um den besten Service Desk-Mitarbeiter basierend auf der Ebenenlücke auszuwählen. Außerdem wird die Gesamtzahl der Kompetenzen mit und ohne Kompetenzstufen analysiert, die der Service Desk-Mitarbeiter zur Ausführung dieser Aufgabe hat.
{#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AnforderungKompetenzJSON | Zeichenfolge | Liste der erforderlichen Kompetenzen, die mit dem Anwender verglichen werden sollen. 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\]. {#USA-analyzeUserById_S_S_B__ul_q2f_xsw_33b} |
| userID | Zeichenfolge | SYS-ID aus der Anwendertabelle \[sys_user\]. |
| 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]

{#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb} {#USA-analyzeUserById_S_S_B__table_kct_qrw_33b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | JSON, das alle erforderlichen Informationen über den Anwender basierend auf der Zuordnung der Analysekompetenzen wie folgt enthält: * sys_ID: Zeichenfolge. SYS-ID aus der Anwendertabelle \[sys_user\]. * Is_Qualified: Boolescher Wert. Kennzeichnung, die angibt, ob der Anwender für die erforderlichen Kompetenzen qualifiziert ist. * „Wahr", wenn der Anwender über alle obligatorischen Kompetenzen verfügt und das Kompetenzniveau erzwungen wird. * Falsch, wenn der Anwender nicht über alle obligatorischen Kompetenzen verfügt oder die Ebenenanforderungen nicht erfüllt. {#USA-analyzeUserById_S_S_B__ul_ql2_rhq_g3b} * num_Skills: Nummer. Kompetenzen, die mit den erforderlichen Kompetenzen abgeglichen wurden. * num_skills_matching_level:-Nummer. Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen. * total_skill_level_gap:-Nummer. Die Kompetenzniveaulücke hilft dem Rangfolgealgorithmus, einen optimalen Anwender zu finden, der die Mindestanforderungen an das Kompetenzniveau erfüllt Berechnet basierend auf der Gesamtlücke zwischen Aufgabenkompetenzniveau und Anwenderkompetenzniveau. Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen. * optional_skill_level_gap:-Nummer. Stellt eine Kompetenzniveaulücke nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen dem gesamten Kompetenzniveau und der optionalen Kompetenzniveaulücke. {#USA-analyzeUserById_S_S_B__ul_q1n_msd_f3b} Fehler, wenn ungenaue Parameter oder fehlerhafte JSON angegeben werden. |
[Tabelle : 3. Rückgaben]

{#USA-analyzeUserById_S_S_B__table_kct_qrw_33b}  

    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
    			  {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
    var userSysID = "a8f98bb0eb32010045e1a5115206fe3a";
    var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
    var result = userSkillAnalyzer.analyzeUserById(JSON.stringify(skills), userSysID, true);
    gs.info('Results: ' + result);

Ausgabe:

    Calling user analyzer
    *** Script: Results: {"sys_id":"a8f98bb0eb32010045e1a5115206fe3a","is_qualified":false,"num_skills":0,"num_skills_matching_level":0,"total_skill_level_gap":0,"optional_skill_level_gap":0}

## UserSkillAnalyzer -- analyzeUserBySkills(Zeichenfolge AnforderungsSkillsJson, Zeichenfolge userSkillsJson, boolescher isSkillLevelEnforced) {#ariaid-title4}

Analysiert Anwenderkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, die Lücke auf Kompetenzniveau und die Qualifizierung fest, die von einer Instanz erfasst werden können.
{#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AnforderungKompetenzJSON | Zeichenfolge | Liste der erforderlichen Kompetenzen, für die die Anwender qualifiziert werden sollen. 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\]. {#USA-analyzeUserBySkills_S_S_B__ul_imx_vsw_33b} |
| UserSkillsJson | Zeichenfolge | Liste der Anwenderkompetenzen, um die Qualifizierung für erforderliche Kompetenzen zu bestimmen. 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\]. {#USA-analyzeUserBySkills_S_S_B__ul_kj3_h1c_j3b} |
| IsSkillLevelEnforced | Boolean | „Wahr", wenn der Anwender über ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen verfügen muss, andernfalls „falsch". Standard: Falsch. |
[Tabelle : 4. Parameter]

{#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb} {#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | JSON, das alle erforderlichen Informationen über den Anwender basierend auf der Zuordnung der Analysekompetenzen wie folgt enthält: * sys_ID: Zeichenfolge. SYS-ID aus der Anwendertabelle \[sys_user\]. * Is_Qualified: Boolescher Wert. Kennzeichnung, die angibt, ob der Anwender für die erforderlichen Kompetenzen qualifiziert ist. * „Wahr", wenn der Anwender über alle obligatorischen Kompetenzen verfügt und das Kompetenzniveau erzwungen wird. * Falsch, wenn der Anwender nicht über alle obligatorischen Kompetenzen verfügt oder die Ebenenanforderungen nicht erfüllt. {#USA-analyzeUserBySkills_S_S_B__ul_ql2_rhq_g3b} * num_Skills: Nummer. Kompetenzen, die mit den erforderlichen Kompetenzen abgeglichen wurden. * num_skills_matching_level:-Nummer. Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen. * total_skill_level_gap:-Nummer. Die Kompetenzniveaulücke hilft dem Rangfolgealgorithmus, einen optimalen Anwender zu finden, der die Mindestanforderungen an das Kompetenzniveau erfüllt Berechnet basierend auf der Gesamtlücke zwischen Aufgabenkompetenzniveau und Anwenderkompetenzniveau. Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen. * optional_skill_level_gap:-Nummer. Stellt eine Kompetenzniveaulücke nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen dem gesamten Kompetenzniveau und der optionalen Kompetenzniveaulücke. {#USA-analyzeUserBySkills_S_S_B__ul_q1n_msd_f3b} Fehler, wenn ungenaue Parameter oder fehlerhafte JSON angegeben werden. |
[Tabelle : 5. Rückgaben]

{#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b}  

    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
    				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
    var userSkills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
    		    {"sys_id":"k, th", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
    var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
    var result = userSkillAnalyzer.analyzeUserBySkills(JSON.stringify(skills), JSON.stringify(userSkills));
    gs.info('Results: ' + result);


