---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Kategoriekategorie : Bereichsbezogen

# Kategoriekategorie : Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die CatCategory- API stellt Methoden bereit, mit denen Sie Servicekatalogkategorien mithilfe von Skripts erstellen und ändern können.

Diese API wird im Namespace `sn_sc ausgeführt`.  
Wichtig:  
Diese API ist zugänglich. Die empfohlene Implementierung ist jedoch die [Servicekatalog-REST-API](https://www.servicenow.com/docs/~~IcpD3QO_50Zh0r6Fhf1A#c_ServiceCatalogAPI "Die Servicekatalog- API stellt Endpunkte bereit, die von einem [ Servicekatalog aus auf die Konfiguration und Aktionen von Serviceportalzugreifen.").

## CatCategory -availableForUserCriteria(Zeichenfolgenaktion, Array-KriterienIDs) {#ariaid-title2}

Fügt der aktuellen Katalogkategorie die Anwenderkriterien Available For hinzu.
{#r_CCS-availableForUserCriteria_S_A__table_oz2_pln_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aktion | Zeichenfolge | Auszuführende Aktion. * <kbd class="ph userinput">add</kbd>: Fügt die Anwenderkriterien der Liste „ Verfügbar für " hinzu. * <kbd class="ph userinput">delete</kbd>: Löscht die Anwenderkriterien aus der Liste „ Verfügbar für ". {#r_CCS-availableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
| criteriaIDs | Array | Array der Benutzerkriterien sys_ids. |
[Tabelle : 1. Parameter]

{#r_CCS-availableForUserCriteria_S_A__table_oz2_pln_vz} {#r_CCS-availableForUserCriteria_S_A__table_pz2_pln_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 2. Ergebnisse]

{#r_CCS-availableForUserCriteria_S_A__table_pz2_pln_vz}  

    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
    item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatCategory -- canView(Boolean isMobile, Zeichenfolge userSysId) {#ariaid-title3}

Bestimmt, ob ein angegebener Anwender eine angegebene Kategorie auf einem Mobilgerät oder einem Desktop-Computer anzeigen kann.
{#CCS-canView_B_S__table_j5n_smk_chb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| isMobile | Boolean | Kennzeichnung, die angibt, ob der Zugriff des Anwenders auf einem Mobilgerät oder auf einem Desktop überprüft werden soll. * „true": Für Mobilgeräte validieren. * „falsch": Validiert den Desktop. |
| userSysId | Zeichenfolge | Sys_id des zu validierenden Anwenders. |
[Tabelle : 3. Parameter]

{#CCS-canView_B_S__table_j5n_smk_chb} {#CCS-canView_B_S__table_k5n_smk_chb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Anwender die zugeordnete Kategorie anzeigen kann. * wahr: Der Anwender kann die Kategorie anzeigen. * „falsch": Der Anwender kann die Kategorie nicht anzeigen. {#CCS-canView_B_S__ul_iwk_ynk_chb} |
[Tabelle : 4. Ergebnisse]

{#CCS-canView_B_S__table_k5n_smk_chb}  

    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
    scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

## CatCategory -- create(Boolean standardUpdate) {#ariaid-title4}

Fügen Sie die definierte Kategorie ein.
{#r_CatCategory-create_Boolean__table_afn_1b2_ns__entry__3}

| 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 Workflows aktivieren. * „falsch": Engines und Workflow nicht aktiviert. {#r_CatCategory-create_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 5. Parameter]

{#r_CatCategory-create_Boolean__table_afn_1b2_ns} {#r_CatCategory-create_Boolean__table_bfn_1b2_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id des eingefügten Variablendatensatzes. |
[Tabelle : 6. Ergebnisse]

{#r_CatCategory-create_Boolean__table_bfn_1b2_ns}  

    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) {#ariaid-title5}

Löscht den Kategoriedatensatz, in dem die CatCategory-Klasse ursprünglich instanziiert wurde.
{#r_CatCategory-deleteRecord_Boolean__table_xzp_4b2_ns__entry__3}

| 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 Workflows aktivieren. * „falsch": Engines und Workflow nicht aktiviert. {#r_CatCategory-deleteRecord_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 7. Parameter]

{#r_CatCategory-deleteRecord_Boolean__table_xzp_4b2_ns} {#r_CatCategory-deleteRecord_Boolean__table_yzp_4b2_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 8. Ergebnisse]

{#r_CatCategory-deleteRecord_Boolean__table_yzp_4b2_ns}  

    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() {#ariaid-title6}

Gibt die sys_id der aktuellen Kategorie zurück.
{#CCS-getID__table_db4_h4d_sbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#CCS-getID__table_db4_h4d_sbb} {#CCS-getID__table_eb4_h4d_sbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id der aktuellen Kategorie. |
[Tabelle : 10. Ergebnisse]

{#CCS-getID__table_eb4_h4d_sbb}  
Beispiel:

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

Ausgabe:

    2809952237b1300054b6a3549dbe5dd4

## CatCategory -- notAvailableForUserCriteria(Zeichenfolgenaktion, Array\[\] KriterienIDs) {#ariaid-title7}

Fügt die Anwenderkriterien Not Available For zu einer Katalogkategorie hinzu.
{#r_CCS-notAvailableForUserCriteria_S_A__table_yxb_1mn_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aktion | Zeichenfolge | Auszuführende Aktion. * <kbd class="ph userinput">add</kbd>: Fügt die Anwenderkriterien der Liste „ Nicht verfügbar für " hinzu. * <kbd class="ph userinput">delete</kbd>: Löscht die Anwenderkriterien aus der Liste „ Nicht verfügbar für ". {#r_CCS-notAvailableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
[Tabelle : 11. Parameter]

{#r_CCS-notAvailableForUserCriteria_S_A__table_yxb_1mn_vz} {#r_CCS-notAvailableForUserCriteria_S_A__table_zxb_1mn_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 12. Ergebnisse]

{#r_CCS-notAvailableForUserCriteria_S_A__table_zxb_1mn_vz}  

    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
    item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatCategory -- read(Object columns, Boolean standardUpdate) {#ariaid-title8}

Gibt eine Zuordnung der Kategorie zurück.
{#r_CatCategory-read_Object_Boolean__table_p2h_5b2_ns__entry__3}

| 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 Workflows aktivieren. * „falsch": Engines und Workflow nicht aktiviert. {#r_CatCategory-read_Object_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 13. Parameter]

{#r_CatCategory-read_Object_Boolean__table_p2h_5b2_ns} {#r_CatCategory-read_Object_Boolean__table_q2h_5b2_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Zuordnung von Spaltennamen zu Werten. |
[Tabelle : 14. Ergebnisse]

{#r_CatCategory-read_Object_Boolean__table_q2h_5b2_ns}  

    var category = new sn_sc.CatCategory("a96277509f300200b407b89a442e704e");
    var values = category.read({"title" : ""}, true);
    gs.log(values.title);

## CatCategory -- setAttributes(Object attributes) {#ariaid-title9}

Definiert die Attributwerte für diese Kategorie.
{#r_CatCategory-setAttributes_Object__table_psn_512_ns__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| attributes | Objekt | Attribute für die neuen Feld-Wert-Paare. |
[Tabelle : 15. Parameter]

{#r_CatCategory-setAttributes_Object__table_psn_512_ns} {#r_CatCategory-setAttributes_Object__table_qsn_512_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 16. Ergebnisse]

{#r_CatCategory-setAttributes_Object__table_qsn_512_ns}  

    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) {#ariaid-title10}

Definiert den Tabellennamen für diese Kategorie.
{#r_CatCategory-setTableName_String__table_vh4_3dl_qs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, die „sc_category" erweitert. |
[Tabelle : 17. Parameter]

{#r_CatCategory-setTableName_String__table_vh4_3dl_qs} {#r_CatCategory-setTableName_String__table_wh4_3dl_qs__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 18. Ergebnisse]

{#r_CatCategory-setTableName_String__table_wh4_3dl_qs}  

    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) {#ariaid-title11}

Aktualisiert die aktuelle Kategorie mit den angegebenen Name-Wert-Paaren.
{#r_CatCategory-update_Object_Boolean__table_dfz_fb2_ns__entry__3}

| 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 Workflows aktivieren. * „falsch": Engines und Workflow nicht aktiviert. {#r_CatCategory-update_Object_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 19. Parameter]

{#r_CatCategory-update_Object_Boolean__table_dfz_fb2_ns} {#r_CatCategory-update_Object_Boolean__table_efz_fb2_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 20. Ergebnisse]

{#r_CatCategory-update_Object_Boolean__table_efz_fb2_ns}  

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