Katategorie – Umfang

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

    • Die Katategorie Die API bietet Methoden, mit denen Sie Servicekatalog-Kategorien mithilfe von Skripts erstellen und ändern können.

    Diese API wird in ausgeführt sn_sc Namespace.

    Wichtig:
    Auf diese API kann zugegriffen werden. Die empfohlene Implementierung ist jedoch Servicekatalog-REST-API .

    CatCategory – available ForUserCriteria (Zeichenfolgenaktion, Array-KriteriaIDs)

    Fügt hinzu Available ForAnwenderkriterien für die aktuelle Katalogkategorie.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Aktion Zeichenfolge Auszuführende Aktion.
    • Hinzufügen : Fügt die Anwenderkriterien zu hinzu Verfügbar Für Liste.
    • Löschen : Löscht die Anwenderkriterien aus der Verfügbar Für Liste.
    criteriaIDs Array Array der Benutzerkriterien sys_ids.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    void 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory – canView (boolescher Wert isMobile, Zeichenfolge userSysId)

    Bestimmt, ob ein angegebener Anwender eine bestimmte Kategorie auf einem Mobilgerät oder Desktop anzeigen kann.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    isMobile Boolean Kennzeichnung, die angibt, ob der Anwender für den Zugriff auf einem Mobilgerät oder Desktop überprüft werden soll.
    • Wahr: Validieren für Mobilgeräte.
    • Falsch: Für Desktop validieren.
    userSysId Zeichenfolge SYS_ID des zu validierenden Anwenders.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Anwender die zugehörige Kategorie anzeigen kann.
    • Wahr: Der Anwender kann die Kategorie anzeigen.
    • Falsch: Der Anwender kann die Kategorie nicht anzeigen.
    		 
    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

    CatCategory – create(Boolean standardUpdate)

    Fügen Sie die definierte Kategorie ein.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge SYS_ID des eingefügten Variablendatensatzes. 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory – deleteRecord(Boolean standardUpdate)

    Löscht den Kategoriedatensatz, in dem die CatCategory-Klasse ursprünglich instanziiert wurde.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    void 
    var categoryDelete = new sn_sc.CatCategory(categorySysId);
categoryDelete.deleteRecord();
var category = new sn_sc.CatCategory(categorySysId);
values = category.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("", values.title,"Category should title");

    CatCategory – getID()

    Gibt die sys_ID der aktuellen Kategorie zurück.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge SYS_ID der aktuellen Kategorie.

    Beispiel:

    var cart = new sn_sc.CatCategory("2809952237b1300054b6a3549dbe5dd4");
var categoryID = cart.getID();
gs.info(categoryID);

    Ausgabe:

    2809952237b1300054b6a3549dbe5dd4

    CatCategory – notAvailableForUserCriteria(Zeichenfolgenaktion, Array[] CriteriaIDs)

    Fügt hinzu Not Available ForAnwenderkriterien für eine Katalogkategorie.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Aktion Zeichenfolge Auszuführende Aktion.
    • Hinzufügen : Fügt die Anwenderkriterien zu hinzu Nicht Verfügbar Für Liste.
    • Löschen : Löscht die Anwenderkriterien aus der Nicht Verfügbar Für Liste.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory – read(Object columns, Boolean standardUpdate)

    Gibt eine Zuordnung der Kategorie zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    columns Objekt Satz von Spalten, für die Sie die Werte erhalten möchten.
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Objekt Zuordnung von Spaltennamen zu Werten. 
    var category = new sn_sc.CatCategory("a96277509f300200b407b89a442e704e");
var values = category.read({"title" : ""}, true);
gs.log(values.title);

    CatCategory – setAttributes(Object attributes)

    Definiert die Attributwerte für diese Kategorie.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    attributes Objekt Attribute für die neuen Feld- und Wertpaare.
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    void 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory – setTableName(String tableName)

    Definiert den Tabellennamen für diese Kategorie.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, die „sc_category“ erweitert.
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    void 
    var categoryRead = new sn_sc.CatCategory(categorySysId);
categoryRead.setTableName("test_category");
var values = categoryRead.read({"title" : "", "sc_catalog":"", "test": ""}, false);
gs.info(categorySysId);
gs.info(values.title);
gs.info(values.test);
global.Assert.assertEquals("testValue", values.test,"Category extends sc_category and stores its extended value");

    CatCategory – update(Object columnValues, Boolean standardUpdate)

    Aktualisiert die aktuelle Kategorie mit den angegebenen Name-Wert-Paaren.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    columnValues Objekt Zuordnung von Spaltennamen zu Werten.
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    void 
    var categoryUpdate = new sn_sc.CatCategory(categorySysId);
categoryUpdate.update({"title" : "test changed scoped category"}, true);
values = categoryUpdate.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("test changed scoped category", values.title,"Category should title");