SkillDeterminationUtils – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Die SkillDeterminationUtils Die Skripteinbindung stellt Dienstprogrammmethoden zum Abrufen oder Festlegen von Kompetenzdaten für Arbeitselemente bereit.

    Diese Skripteinbindung erfordert das Plugin „Kompetenzbestimmung“ (com.snc.Skill_Determination) und wird in bereitgestellt sn_Skill_rule Namespace.

    SkillDeterminationUtils: SkillDeterminationUtils()

    Konstruktor zum Erstellen einer Instanz von SkillDeterminationUtils.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    var util = new sn_skill_rule.SkillDeterminationUtils();

    SkillDeterminationUtils – assignSkillsToWorkItem(Array-Kompetenzen, GlideRecord Now_GR)

    Weist einem Arbeitselement ein Array aktiver Kompetenzobjekte zu.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Kompetenzen Array Array aktiver Kompetenzobjekte, die zugewiesen werden sollen.
    Kompetenz.SkillName Zeichenfolge Name der Kompetenz.
    Kompetenz.SkillSysId Zeichenfolge SYS-ID der Kompetenz.
    Kompetenz.obligatorisch Boolean „Wahr“, wenn die Kompetenz obligatorisch ist, andernfalls „falsch“.
    Kompetenz.skillLevelName Zeichenfolge Optionaler Kompetenzniveauname.
    Kompetenz.KompetenzLevelSysId Zeichenfolge SYS-ID für optionale Kompetenzstufe.
    Now_GR GlideRecord GlideRecord des Arbeitselements, dem Kompetenzen zugewiesen werden sollen.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Keine

    Die folgenden Beispiele erstellen einen Interaktionsdatensatz mithilfe des Tabellennamens (Interaktion) und zeigen, wie Kompetenzen dem Interaktionsarbeitselement zugewiesen werden, indem ein Datensatz in der Tabelle „Interaktionskompetenzen“ [Interaction_m2m_Skill] erstellt wird.

    Anwendungsfall 1: Verwenden Sie zurückgegebene Ergebnisse aus determineWorkItemSkills(), um einem Arbeitselement aus der Interaktionstabelle Kompetenzen zuzuweisen.

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    // Get interaction skills interaction 
    // and specify if any are mandatory
    var result = util.determineWorkItemSkills(now_GR);
    
    // Assign skills determined by result and 
    // assign them to the interaction work item
    util.assignSkillsToWorkItem(result, now_GR);

    Anwendungsfall 2: Kompetenzarray manuell einfügen. Weisen Sie in diesem Fall dem Interaktionsarbeitselement IT-Kompetenzen zu.

    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    var skills = [{"skillSysId":"2eb1c2029f100200a3bc1471367fcfe4", "skillName":"IT", "mandatory":true, "skillLevelName":"", "skillLevelSysId":null}];
    
    util.assignSkillsToWorkItem(skills, now_GR);

    SkillDeterminationUtils – determineWorkItemSkills(GlideRecord Now_GR)

    Ruft Kompetenzen für ein angegebenes Arbeitselement ab, gibt an, ob die Kompetenzen obligatorisch sind, und listet alle Kompetenzniveaus auf.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Now_GR GlideRecord GlideRecord eines Arbeitselements aus einer beliebigen Interaktion oder Aufgabentabellenerweiterung.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Array Mindestens ein Kompetenzobjekt.
    • SkillSysId: Zeichenfolge. SYS-ID der Kompetenz aus der Tabelle „Kompetenzen“ [cmn_Skill].
    • SkillName: Zeichenfolge. Name der Kompetenz.
    • Obligatorisch: Boolescher Wert. „Wahr“, wenn obligatorisch, andernfalls „falsch“.
    • SkillLevelName: Wenn Kompetenz vorhanden ist, Name des Kompetenzniveaus.
    • SkillLevelSysId: Wenn Kompetenz vorhanden ist, SYS-ID des Kompetenzniveaus aus der Tabelle „Kompetenzniveaus“ [cmn_Skill_level].

    Das folgende Skript erstellt einen Interaktionsdatensatz, ruft Kompetenzen für das Interaktionsarbeitselement ab und gibt an, ob die Kompetenzen obligatorisch sind.

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    var result = util.determineWorkItemSkills(now_GR);
    gs.info(JSON.stringify(result));

    Ausgabe:

    [{"skillSysId":"6c0f025c7f672300a8b1bdc8adfa917f",
    "skillName":"Premier Support Certified",
    "mandatory":false,"skillLevelName":"",
    "skillLevelSysId":null}]