AnwenderSkillAnalyzer – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

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

    Diese API erfordert Kompetenzmanagement Plugin (com.snc.Skills_Management), das Sie aktivieren können, wenn Sie die Administratorrolle innehaben.

    Siehe Qualifizieren und ordnen Sie Anwender basierend auf Kompetenzen und Kompetenzniveaus .

    UserSkillAnalyzer: UserSkillAnalyzer()

    Instanziiert ein neues UserSkillAnalyzer-Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();

    UserSkillAnalyzer – analyzeUserByID(Zeichenfolge AnforderungsSkillsJson, Zeichenfolge userID, boolescher Wert isSkillLevelEnforced)

    Analysiert Anwenderkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, die Kompetenzlücke und die Qualifizierung fest, die aus einer Instanz erfasst werden können.

    Analysiert, ob ein Service Desk-Mitarbeiter für die Bearbeitung 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 qualifiziert ist, an einer Aufgabe zu arbeiten, 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 Kompetenzniveaus analysiert, die der Service Desk-Mitarbeiter zur Ausführung dieser Aufgabe hat.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    ErforderlicheKompetenzJSON Zeichenfolge Liste der erforderlichen Kompetenzen zum Vergleich mit dem Anwender.
    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 „Kompetenzniveaus“ [cmn_Skill_level].
    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 : 3. Rückgaben
    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.
    • num_Skills: Nummer. Kompetenzen, die mit den erforderlichen Kompetenzen abgeglichen wurden.
    • num_Skills_matching_level: Zahl. Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen.
    • Total_Skill_level_GAP: Zahl. Kompetenzniveaulücke hilft dem Rangfolgealgorithmus, optimale Anwender zu finden, die die Mindestanforderungen an das Kompetenzniveau erfüllen. Berechnet basierend auf der Gesamtlücke zwischen Aufgabenkompetenzniveau und Anwenderkompetenzniveau. Der Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen.
    • Optional_Skill_level_GAP: Zahl. Stellt eine Kompetenzlücke nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen dem gesamten Kompetenzniveau und dem optionalen Kompetenzniveauabstand.

    Fehler, wenn ungenaue Parameter oder fehlerhafte JSON angegeben werden.

    		 
    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 erforderlichSkillsJson, Zeichenfolge userSkillsJson, Boolean isSkillLevelEnforced)

    Analysiert Anwenderkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, die Kompetenzlücke und die Qualifizierung fest, die aus einer Instanz erfasst werden können.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    ErforderlicheKompetenzJSON 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 „Kompetenzniveaus“ [cmn_Skill_level].
    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 „Kompetenzniveaus“ [cmn_Skill_level].
    IsSkillLevelEnforced Boolean „Wahr“, wenn der Anwender über ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen verfügen muss, andernfalls „falsch“. Standard: Falsch.
    Tabelle : 5. Rückgaben
    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.
    • num_Skills: Nummer. Kompetenzen, die mit den erforderlichen Kompetenzen abgeglichen wurden.
    • num_Skills_matching_level: Zahl. Anwenderkompetenzen, die dem erforderlichen Kompetenzniveau entsprechen.
    • Total_Skill_level_GAP: Zahl. Kompetenzniveaulücke hilft dem Rangfolgealgorithmus, optimale Anwender zu finden, die die Mindestanforderungen an das Kompetenzniveau erfüllen. Berechnet basierend auf der Gesamtlücke zwischen Aufgabenkompetenzniveau und Anwenderkompetenzniveau. Der Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen.
    • Optional_Skill_level_GAP: Zahl. Stellt eine Kompetenzlücke nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen dem gesamten Kompetenzniveau und dem optionalen Kompetenzniveauabstand.

    Fehler, wenn ungenaue Parameter oder fehlerhafte JSON angegeben werden.

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