Katalogkategorie – Umfang

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 3 Minuten Lesedauer

    • Die Katalogkategorie 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:
    Diese API ist zugänglich. 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 Verfügbar Für Liste.
    KriteriaIDs Array Array der sys_IDs der Anwenderkriterien.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Ungültig 
    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 ein Mobilgerät oder einen 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: Anwender kann die Kategorie nicht anzeigen.
    		 
    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

    CatCategory – erstellen (boolescher Standard – Update)

    Fügen Sie die definierte Kategorie ein.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Standardaktualisierung 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 (boolescher Standard – Update)

    Löscht den Kategoriedatensatz, für den die Kategorie-Klasse anfänglich instanziiert wurde.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Standardaktualisierung 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
    Ungültig 
    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. Rückgaben
    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 Nicht Verfügbar Für Liste.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Ungültig 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory – Lesen (Objektspalten, boolescher Standard Update)

    Gibt eine Zuordnung der Kategorie zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    columns Objekt Satz von Spalten, für die Sie die Werte wünschen.
    Standardaktualisierung 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 (Objektattribute)

    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
    Ungültig 
    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(Zeichenfolge 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
    Ungültig 
    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, boolescher Standard Update)

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

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    ColumnValues Objekt Zuordnung von Spaltennamen zu Werten.
    Standardaktualisierung 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
    Ungültig 
    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");