UserSkillAnalyzer : Global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Die UserSkillAnalyzer- API bietet Methoden zum Analysieren von Benutzerkompetenzen im Hinblick auf Kompetenzen, die zum Abschließen von Arbeitselementen erforderlich sind.

    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.

    UserSkillAnalyzer: UserSkillAnalyzer()

    Instanziiert ein neues UserSkillAnalyzer-Objekt.

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

    UserSkillAnalyzer – analysierenUserByID(Zeichenfolge erforderlichSkillsJson, Zeichenfolge userID, Boolesche isSkillLevelEnforced)

    Analysiert die Benutzerkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, das Kompetenzdefizit und die Qualifikation fest, die von einer Instanz gesammelt werden können.

    Analysiert, ob ein Mitarbeiter für die Bearbeitung einer Aufgabe qualifiziert ist, indem überprüft wird, ob der Mitarbeiter über die erforderlichen Kompetenzen und Kompetenzniveaus verfügt, um die Aufgabe abzuschließen Wenn ein Service Desk-Mitarbeiter für die Bearbeitung einer Aufgabe qualifiziert ist, analysiert die API den Stufenabstand zwischen den erforderlichen Kompetenzen und dem Kompetenzniveau des Anwenders. Dies kann von der Anwendung weiter genutzt werden, um den besten Service Desk-Mitarbeiter basierend auf dem Stufenabstand auszuwählen. Außerdem wird die Gesamtanzahl der Kompetenzen mit und ohne Kompetenzniveaus analysiert, die der Service Desk-Mitarbeiter für die Ausführung dieser Aufgabe benötigt.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    ErforderlicheKompetenzenJson Zeichenfolge Liste der erforderlichen Kompetenzen zum Vergleich mit dem Benutzer.
    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]
    userID Zeichenfolge Sys-ID aus der Benutzertabelle [sys_user].
    istKompetenzniveauerzwungen Boolean „Wahr“, wenn der Anwender ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen haben muss, andernfalls „falsch“. Standard: false.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Zeichenfolge JSON, die alle erforderlichen Informationen über den Anwender basierend auf der Kompetenzzuordnung des Analysators wie folgt enthält:
    • sys_id: Zeichenfolge. Sys-ID aus der Benutzertabelle [sys_user].
    • is_qualified: Boolesch. Kennzeichnung, die angibt, ob der Benutzer 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 Niveauanforderungen nicht erfüllt.
    • 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: Anzahl. Kompetenzdefizite helfen dem Rangfolgealgorithmus, optimale Anwender zu finden, die die Mindestanforderungen an Kompetenzen erfüllen. Berechnet basierend auf der Gesamtlücke zwischen Kompetenzniveau für Aufgabe und Kompetenzniveau des Benutzers. Der Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen.
    • optional_skill_level_gap: Zahl. Stellt Kompetenzdefizite nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen Gesamtkompetenzniveau und optionalem Kompetenzdefizit.

    Fehler, wenn ungenaue Parameter oder falsch formatiertes 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 – analysiertUserBySkills(Zeichenfolge erforderlichSkillsJson, Zeichenfolge userSkillsJson, Boolescher Wert isSkillLevelEnforced)

    Analysiert die Benutzerkompetenzen anhand der erforderlichen Kompetenzen und legt die Anzahl der übereinstimmenden Kompetenzen, die Lücke bei Kompetenzniveaus und die Qualifikation fest, die von einer Instanz gesammelt werden können.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    ErforderlicheKompetenzenJson Zeichenfolge Liste der erforderlichen Kompetenzen, für die sich die Anwender qualifizieren sollen
    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]
    userSkillsJson Zeichenfolge Liste der Anwenderkompetenzen zur Bestimmung der Qualifikation für erforderliche Kompetenzen.
    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]
    istKompetenzniveauerzwungen Boolean „Wahr“, wenn der Anwender über ein Mindestkompetenzniveau für alle erforderlichen obligatorischen Kompetenzen verfügen muss, andernfalls „falsch“. Standard: false.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Zeichenfolge JSON, die alle erforderlichen Informationen über den Anwender basierend auf der Kompetenzzuordnung des Analysators wie folgt enthält:
    • sys_id: Zeichenfolge. Sys-ID aus der Benutzertabelle [sys_user].
    • is_qualified: Boolesch. Kennzeichnung, die angibt, ob der Benutzer 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 Niveauanforderungen nicht erfüllt.
    • 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: Anzahl. Kompetenzdefizite helfen dem Rangfolgealgorithmus, optimale Anwender zu finden, die die Mindestanforderungen an Kompetenzen erfüllen. Berechnet basierend auf der Gesamtlücke zwischen Kompetenzniveau für Aufgabe und Kompetenzniveau des Benutzers. Der Anwender muss über das erforderliche Kompetenzniveau für obligatorische Kompetenzen verfügen.
    • optional_skill_level_gap: Zahl. Stellt Kompetenzdefizite nur für optionale Kompetenzen bereit. Unterstützt die Endpunkte bei der Unterscheidung zwischen Gesamtkompetenzniveau und optionalem Kompetenzdefizit.

    Fehler, wenn ungenaue Parameter oder falsch formatiertes 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);