---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Katalogelement -- Umfang

# Katalogelement -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 Minuten Lesedauer

Die Katalogelement Die API bietet Methoden, mit denen Sie Servicekatalogelemente mithilfe von Skripts erstellen und ändern können.

Diese API wird in ausgeführt `sn_sc `Namespace.

## CatItem -- available ForUserCriteria (Zeichenfolgenaktion, Array CriteriaIDs) {#ariaid-title2}

Fügt hinzu Available ForAnwenderkriterien für das aktuelle Katalogelement.
{#r_CIS-availableForUserCriteria_S_A__table_mbk_f5f_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aktion | Zeichenfolge | Auszuführende Aktion. * <kbd class="ph userinput">Hinzufügen </kbd>: Fügt die Anwenderkriterien zu hinzu Verfügbar Für Liste. * <kbd class="ph userinput">Löschen </kbd>: Löscht die Anwenderkriterien aus Verfügbar Für Liste. {#r_CIS-availableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
| KriteriaIDs | Array | Array der sys_IDs der Anwenderkriterien. |
[Tabelle : 1. Parameter]

{#r_CIS-availableForUserCriteria_S_A__table_mbk_f5f_vz} {#r_CIS-availableForUserCriteria_S_A__table_nbk_f5f_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#r_CIS-availableForUserCriteria_S_A__table_nbk_f5f_vz}  
Dieses Beispiel zeigt, wie die angegebene hinzugefügt wird Available ForAnwenderkriterien.

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

## CatItem -- canViewInDomain() {#ariaid-title3}

Überprüft, ob das aktuelle Katalogelement in der ausgewählten Domäne angezeigt werden kann (Domäne, die in der Domänenauswahl ausgewählt wurde).
Katalogelemente in der globalen Domäne sind in allen Domänen verfügbar.
{#CI-canViewInDomain__table_gww_bbd_thb__entry__3}

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

{#CI-canViewInDomain__table_gww_bbd_thb} {#CI-canViewInDomain__table_hww_bbd_thb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die validiert, ob das aktuelle Katalogelement in der ausgewählten Domäne angezeigt werden kann. Gültige Werte: * Wahr: Katalogelement kann in der Domäne angezeigt werden * Falsch: Katalogelement kann in der Domäne nicht angezeigt werden {#CI-canViewInDomain__ul_sfm_gdy_shb} |
[Tabelle : 4. Rückgaben]

{#CI-canViewInDomain__table_hww_bbd_thb}  
Dieses Beispiel zeigt, wie überprüft wird, ob ein Katalogelement in der aktuell ausgewählten Domäne angezeigt werden kann.

    var catItem = new sn_sc.CatItem("060f3afa3731300054b6a3549dbe5d3e");
    gs.info(catItem.canViewInDomain());

## CatItem -- canViewOnSearch (boolescher Wert isMobile) {#ariaid-title4}

Bestimmt, ob der Anwender Zugriff zum Anzeigen des Katalogelements in der globalen Suche hat.
{#CI-canViewOnSearch_B__table_pqy_zl2_sbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| isMobile | Boolean | Kennzeichnung, die angibt, ob die Suche nach der Mobil- oder Desktop-Ansicht durchgeführt werden soll. Gültige Werte: * Wahr: Suche nach der mobilen Ansicht durchführen. * Falsch: Suche nach der Desktop-Ansicht durchführen. |
[Tabelle : 5. Parameter]

{#CI-canViewOnSearch_B__table_pqy_zl2_sbb} {#CI-canViewOnSearch_B__table_qqy_zl2_sbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Anwender Zugriff zum Anzeigen des Katalogelements in der globalen Suche hat. Gültige Werte: * Wahr: Der Anwender hat Zugriff, um das Katalogelement in der globalen Suche anzuzeigen. * Falsch: Der Anwender hat keinen Zugriff zum Anzeigen des Katalogelements in der globalen Suche. |
[Tabelle : 6. Rückgaben]

{#CI-canViewOnSearch_B__table_qqy_zl2_sbb}  
Dieses Codebeispiel zeigt, wie überprüft wird, ob der Anwender Zugriff zum Anzeigen des Katalogelements in der globalen Suche in der Desktop-Ansicht hat.

    var catItem = new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");
    var canView = catItem.canViewOnSearch('false');
    gs.info("Can view on global search: " + canView);

Ausgabe:

    Can view on global search: true

## CatItem -- erstellen (boolescher Standard -- Update) {#ariaid-title5}

Fügt das definierte Katalogelement ein.
{#r_CatItem-create_Boolean__table_uh4_31n_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Standardaktualisierung | Boolean | Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll. Gültige Werte: * Wahr: Aktivieren Sie die Ausführung von Engines und Workflows. * Falsch: Aktivieren Sie die Ausführung von Engines und Workflows nicht. Beachten Sie, dass die erstellten und aktualisierten Systemdatumsspalten in der Tabelle nicht aktualisiert werden. {#r_CatItem-create_Boolean__ul_olr_kf4_pnb} |
[Tabelle : 7. Parameter]

{#r_CatItem-create_Boolean__table_uh4_31n_ms} {#r_CatItem-create_Boolean__table_vh4_31n_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des neu erstellten Katalogelements. |
[Tabelle : 8. Rückgaben]

{#r_CatItem-create_Boolean__table_vh4_31n_ms}  
In diesem Beispiel wird ein neues Katalogelement erstellt und ein Variablen- und Variablensatz hinzugefügt.

    createCatalogItem('Catalog Item Name', 'Short Description', 'e0d08b13c3330100c8b837659bba8fb4', '109f0438c6112276003ae8ac13e7009d'); 

    function createCatalogItem(name, short_desc, catalogId, categoryId) {
        var catalogItem = new sn_sc.CatItem();
        catalogItem.setAttributes({
            "name": name,
            "short_description": short_desc
        });
        catalogItem.setCatalogs(catalogId); // set catalog
        catalogItem.setCategories(categoryId); // set category

        var catItemSysId = catalogItem.create(); // create new catalog item
        gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);

        // add variables and variable set
        addDefaultVariables(catItemSysId);
        addDefaultVariableSet(catItemSysId);
    }

    // creates a new variable and adds it to the catalog item
    function addDefaultVariables(catItemSysId) {
        var myVarAttrs = {
            "type": "6", // type 6 is single line text
            "cat_item": catItemSysId,
            "question_text": "First Name",
            "name": "first_name",
            'order': 50
        };
        var myVar = new sn_sc.CatalogItemVariable();
        myVar.setAttributes(myVarAttrs);
        var varRec = myVar.create(true);
        gs.info('Variable added to catalog item and record created in table item_option_new with sys_id ' + varRec);
    }

    // adds an existing variable set to the catalog item
    function addDefaultVariableSet(catItemSysId) {
        var varset = new sn_sc.CatalogItemVariableSetM2M();
        // fields used in object are from table io_set_item 
        var attr = {
            'variable_set': 'e01cab1a4f334200086eeed18110c71f', // required
            'sc_cat_item': catItemSysId, // required
            'order': 100 // optional
        };
        varset.setAttributes(attr);
        var m2mRec = varset.create(true);
        gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);
    }

Ausgabe:

    Catalog item created in table sc_cat_item with sys_id be5c771e876370103a730f2d0ebb3556
    Variable added to catalog item and record created in table item_option_new with sys_id b65cb71e876370103a730f2d0ebb3535
    Variable set added to catalog item and M2M record created in table io_set_item with sys_id 8b5cb71e876370103a730f2d0ebb354b

## CatItem -- deleteRecord (boolescher Standard -- Update) {#ariaid-title6}

Löscht ein Katalogelement.
{#r_CatItem-delete_Boolean__table_g1q_mfn_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Standardaktualisierung | Boolean | Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll. Gültige Werte: * Wahr: Aktivieren Sie die Ausführung von Engines und Workflows. * Falsch: Aktivieren Sie die Ausführung von Engines und Workflows nicht. |
[Tabelle : 9. Parameter]

{#r_CatItem-delete_Boolean__table_g1q_mfn_ms} {#r_CatItem-delete_Boolean__table_h1q_mfn_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

{#r_CatItem-delete_Boolean__table_h1q_mfn_ms}  
In diesem Beispiel werden alle inaktiven Katalogelemente gelöscht.

    var catalogItem = new GlideRecord('sc_cat_item');
    catalogItem.addQuery('active', 'false'); // get all inactive catalog items
    catalogItem.query();
    while (catalogItem.next()) {

        // before deleting a catalog item, delete its associated variable set M2M records
        var variableSetM2M = new GlideRecord('io_set_item'); // M2M table linking variable set and catalog item
        variableSetM2M.addQuery('sc_cat_item', catalogItem.getUniqueValue()); // get M2M records for the catalog item
        variableSetM2M.query();
        while (variableSetM2M.next()) {
            var varset = new sn_sc.CatalogItemVariableSetM2M(variableSetM2M.getUniqueValue()); // M2M record sys_id
            varset.deleteRecord(true); // delete M2M record
        }

        // then delete the catalog item
        var item = new sn_sc.CatItem(catalogItem.getUniqueValue()); 
        item.deleteRecord(true);
    }

## CatItem -- getFirstAccessibleCategoryForSearch(Zeichenfolge katalogId) {#ariaid-title7}

Gibt die erste Kategorie zurück, die der Anwender in einem Katalog anzeigen kann.
{#CI-getFirstAccessibleCategoryForSearch_S__table_x4w_2g5_qbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| KatalogId | Zeichenfolge | SYS_ID des Katalogs. |
[Tabelle : 11. Parameter]

{#CI-getFirstAccessibleCategoryForSearch_S__table_x4w_2g5_qbb} {#CI-getFirstAccessibleCategoryForSearch_S__table_y4w_2g5_qbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID der ersten Kategorie, die der Anwender in einem Katalog anzeigen kann. |
[Tabelle : 12. Rückgaben]

{#CI-getFirstAccessibleCategoryForSearch_S__table_y4w_2g5_qbb}  
Beispiel:

    var CatItem=new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");	
    	console.log(CatItem.getFirstAccessibleCategoryForSearch("e0d08b13c3330100c8b837659bba8fb4"));

Ausgabe:

    d258b953c611227a0146101fb1be7c31

## CatItem -- getInvalidDelegatedUsers(Array requestForUsers) {#ariaid-title8}

Gibt ein Array von Anwendern zurück, für die das zugeordnete Element nicht delegiert werden kann (angefordert im Namen von).
Die Methode verifiziert jeden der im Array übergebenen Anwender.
{#CI-getInvalidDelegatedUsers_A__table_avj_5n3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AnforderungForAnwender | Objekt | Array von Anwender-sys_IDs, um zu überprüfen, ob der zugeordnete Anwender das aktuelle Element abrufen kann und ob das Element im Namen des Anwenders angefordert werden kann. Tabelle: Anwender \[sys_user\] |
[Tabelle : 13. Parameter]

{#CI-getInvalidDelegatedUsers_A__table_avj_5n3_nlb} {#CI-getInvalidDelegatedUsers_A__table_bvj_5n3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Liste der Anwendernamen (Spalte „Name" aus der Tabelle „Anwender" \[sys_user\]), für die das Element nicht von einem Delegierten angefordert werden kann. |
[Tabelle : 14. Rückgaben]

{#CI-getInvalidDelegatedUsers_A__table_bvj_5n3_nlb}  
Dieses Beispiel zeigt, wie eine Liste von Anwendernamen abgerufen wird, für die das Element nicht von einem Delegierten angefordert werden kann.

    function getInvalidDelegatedUsers(itemId, userIds) {
    var catItem = new sn_sc.CatItem(itemId);
    var invalidUsers = catItem.getInvalidDelegatedUsers(userIds);
    return invalidUsers;
    }

Ausgabe:

    [
      "Joe Smith",
      "Jenny Brown",
      "Fred Bennet",
      "Alice Jones"
    ]

## CatItem -- getRecordClass() {#ariaid-title9}

Gibt den Klassennamen für den aktuellen Katalogelementdatensatz zurück.
{#CI-getRecordClass__table_jld_nl2_sbb__entry__3}

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

{#CI-getRecordClass__table_jld_nl2_sbb} {#CI-getRecordClass__table_kld_nl2_sbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Klassenname für den aktuellen Katalogelementdatensatz. |
[Tabelle : 16. Rückgaben]

{#CI-getRecordClass__table_kld_nl2_sbb}  
Beispiel:

    var CatItem=new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");	
    	console.log(CatItem.getRecordClass());

Ausgabe:

    sc_cat_item

## CatItem -- isDelegationAllow(Zeichenfolge delegiertUser) {#ariaid-title10}

Überprüft, ob der angegebene delegierte Anwender über Beschaffungsrechte für das aktuelle Servicekatalogelement verfügt.
{#CI-isDelegationAllowed_S__table_spd_p3q_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Delegierter Anwender | Zeichenfolge | Optional. SYS_ID des Anwenders, für den das Servicekatalogelement angefordert werden soll (Delegierter). Die Methode überprüft, ob der Anwender über Beschaffungsrechte für den Artikel verfügt. Standard: Überprüft, ob der aufrufende Anwender über Beschaffungsrechte für das Element verfügt. |
[Tabelle : 17. Parameter]

{#CI-isDelegationAllowed_S__table_spd_p3q_nlb} {#CI-isDelegationAllowed_S__table_tpd_p3q_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Anwender über Erwerbsrechte für das aktuelle Servicekatalogelement verfügt. Gültige Werte: * Wahr: Der Anwender hat Beschaffungsrechte für den Artikel. * Falsch: Anwender hat keine Beschaffungsrechte für den Artikel. {#CI-isDelegationAllowed_S__ul_sxh_kqq_nlb} |
[Tabelle : 18. Rückgaben]

{#CI-isDelegationAllowed_S__table_tpd_p3q_nlb}  
Dieses Codebeispiel zeigt, wie bestimmt wird, ob die Delegierung für das Katalogelement zulässig ist.

    function canRequestFor(itemId, user) {
      var catItem = new sn_sc.CatItem(itemId);
      var result = catItem.isDelegationAllowed(user);
      return result;
    }

Ausgabe: Wahr

## CatItem -- isVisibleServicePortal() {#ariaid-title11}

Bestimmt, ob das aktuelle Katalogelement im Serviceportal verfügbar ist.
{#CI-isVisibleServicePortal__table_rdm_bn2_sbb__entry__3}

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

{#CI-isVisibleServicePortal__table_rdm_bn2_sbb} {#CI-isVisibleServicePortal__table_sdm_bn2_sbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Katalogelement im Serviceportal verfügbar ist. Gültige Werte: * Wahr: Verfügbar im Serviceportal. * Falsch: Nicht verfügbar im Serviceportal. |
[Tabelle : 20. Rückgaben]

{#CI-isVisibleServicePortal__table_sdm_bn2_sbb}  
Beispiel:

    var catItem = new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");
    var catItemAvail = catItem.isVisibleServicePortal();
    gs.info("Is item available on Service Portal: " + catItemAvail);

Ausgabe:

    Is item available on Service Portal: true

## CatItem -- notAvailableForUserCriteria (Zeichenfolgenaktion, Array CriteriaIDs) {#ariaid-title12}

Fügt hinzu Not Available ForAnwenderkriterien für ein Katalogelement.
{#r_CIS-notAvailableForUserCriteria_S_A__table_wdk_tkn_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aktion | Zeichenfolge | Auszuführende Aktion. * <kbd class="ph userinput">Hinzufügen </kbd>: Fügt die Anwenderkriterien zu hinzu Nicht Verfügbar Für Liste. * <kbd class="ph userinput">Löschen </kbd>: Löscht die Anwenderkriterien aus Nicht Verfügbar Für Liste. {#r_CIS-notAvailableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
[Tabelle : 21. Parameter]

{#r_CIS-notAvailableForUserCriteria_S_A__table_wdk_tkn_vz} {#r_CIS-notAvailableForUserCriteria_S_A__table_xdk_tkn_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 22. Rückgaben]

{#r_CIS-notAvailableForUserCriteria_S_A__table_xdk_tkn_vz}  
Dieses Beispiel zeigt, wie die angegebene hinzugefügt wird Not Available ForAnwenderkriterien.

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

## CatItem -- Lesen (Objektspalten, boolescher Standard -- Update) {#ariaid-title13}

Gibt eine Zuordnung von Katalogelement-Attributwerten zurück.
{#r_CatItem-read_Object_Boolean__table_hsf_kgn_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| columns | Objekt | Name-Wert-Paare von Spalten, für die Werte zurückgegeben werden sollen. |
| Standardaktualisierung | Boolean | Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll. Gültige Werte: * Wahr: Aktivieren Sie die Ausführung von Engines und Workflows. * Falsch: Aktivieren Sie die Ausführung von Engines und Workflows nicht. {#r_CatItem-read_Object_Boolean__ul_alx_f3p_kpb} |
[Tabelle : 23. Parameter]

{#r_CatItem-read_Object_Boolean__table_hsf_kgn_ms} {#r_CatItem-read_Object_Boolean__table_isf_kgn_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Zuordnung von Spaltennamen zu Werten. |
[Tabelle : 24. Rückgaben]

{#r_CatItem-read_Object_Boolean__table_isf_kgn_ms}  
Dieses Beispiel liest die Felder „Name" und „Preis" eines Katalogelements.

    var catItem = new sn_sc.CatItem("a96277509f300200b407b89a442e704e");
    var values = catItem.read({"name" : "", "price" : ""}, true);
    gs.info("Catalog item name: " + values.name);
    gs.info("Catalog item price: " + values.price);

Ausgabe:

    Catalog item name: Standard Laptop
    Catalog item price: 1100

## CatItem -- setAttributes (Objektattribute) {#ariaid-title14}

Legt Attribute für ein Katalogelement fest.
{#r_CatItem-setAttributes_Object__table_lgj_33n_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| attributes | Objekt | Name-Wert-Paare der Spalten, für die festgelegt werden soll. |
[Tabelle : 25. Parameter]

{#r_CatItem-setAttributes_Object__table_lgj_33n_ms} {#r_CatItem-setAttributes_Object__table_mgj_33n_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 26. Rückgaben]

{#r_CatItem-setAttributes_Object__table_mgj_33n_ms}  
Dieses Beispiel legt Attribute für ein neues Katalogelement fest.

    createCatalogItem('Name of your Catalog Item', 'Short Description of your Catalog Item', 'e0d08b13c3330100c8b837659bba8fb4', '109f0438c6112276003ae8ac13e7009d'); 

    function createCatalogItem(name, short_desc, catalogId, categoryId) {
        var catalogItem = new sn_sc.CatItem();
        // catalog item column values
        var attributes ={
            "name": name,
            "short_description": short_desc,
    	 "description": "<p>This is a test catalog item.</p>",
    	 "workflow":"0287f2c64a36232700820846b1f8bdce" // sys_id of workflow
        };
        catalogItem.setAttributes(attributes); // set catalog item attributes
        catalogItem.setCatalogs(catalogId); // set catalog
        catalogItem.setCategories(categoryId); // set category

        var catItemSysId = catalogItem.create(); // create new catalog item
        gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);
    }

Ausgabe:

    Catalog item created in table sc_cat_item with sys_id 706948a287e370103a730f2d0ebb351e

## CatItem -- setCatalogs (Zeichenfolgenkataloge) {#ariaid-title15}

Definiert die Kataloge, denen dieses Katalogelement zugeordnet ist.
{#r_CatItem-setCatalogs_String__table_enx_v3n_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Kataloge | Zeichenfolge | Kommagetrennte Liste von sys_IDs der Kataloge, die dem Element zugeordnet werden sollen. |
[Tabelle : 27. Parameter]

{#r_CatItem-setCatalogs_String__table_enx_v3n_ms} {#r_CatItem-setCatalogs_String__table_fnx_v3n_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 28. Rückgaben]

{#r_CatItem-setCatalogs_String__table_fnx_v3n_ms}  
In diesem Beispiel wird ein Katalogelement zwei Katalogen zugeordnet.

    var short_desc = 'This is a short description of my catalog item.';
    var catalogItem = new sn_sc.CatItem();
    catalogItem.setAttributes({
        "name": 'My Catalog Item',
        "short_description": short_desc
    });
    catalogItem.setCatalogs('e0d08b13c3330100c8b837659bba8fb4,742ce428d7211100f2d224837e61036d'); // set Service Catalog and Technical Catalog

    var catItemSysId = catalogItem.create(); // create new catalog item
    gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);

Ausgabe:

    Catalog item created in table sc_cat_item with sys_id d0c5dcaa872770103a730f2d0ebb35cb

## CatItem -- SetCategories (Zeichenfolgenkategorien) {#ariaid-title16}

Definiert die Kategorien, denen dieses Katalogelement zugeordnet ist.
{#r_CatItem-setCategories_String__table_c3s_djn_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| categories | Zeichenfolge | Kommagetrennte Liste der sys_IDs der Kategorien, die dem Element zugeordnet werden sollen. |
[Tabelle : 29. Parameter]

{#r_CatItem-setCategories_String__table_c3s_djn_ms} {#r_CatItem-setCategories_String__table_d3s_djn_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 30. Rückgaben]

{#r_CatItem-setCategories_String__table_d3s_djn_ms}  
Dieses Beispiel zeigt, wie einem Element zwei Kategorien zugeordnet werden.

    var catItem = new sn_sc.CatItem("060f3afa3731300054b6a3549dbe5d3e");
    catItem.setCatagories("af443cfa5f130100a9ad2572f2b47747", "d467125fd7500200d74460affd6103a1");

## CatItem -- setImage (Zeichenfolge dbImageSysId, Zeichenfolgentyp) {#ariaid-title17}

Fügt einem Katalogelement ein Bild hinzu.
{#r_CatItem-setImage_String_String__table_nwf_kjn_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| DbImageSysId | Zeichenfolge | SYS_ID des Images aus der Imagetabelle \[DB_image\]. |
| Typ | Zeichenfolge | Typ des Bilds. Gültige Werte: * Bild * icon {#r_CatItem-setImage_String_String__ul_p4n_ksp_kpb} |
[Tabelle : 31. Parameter]

{#r_CatItem-setImage_String_String__table_nwf_kjn_ms} {#r_CatItem-setImage_String_String__table_owf_kjn_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 32. Rückgaben]

{#r_CatItem-setImage_String_String__table_owf_kjn_ms}  
In diesem Beispiel wird einem Katalogelement ein Bild hinzugefügt.

    var catItem = new sn_sc.CatItem("1fc0bd968777301093d5ec6d0ebb3548"); // sys_id of catalog item to update
    // update fields if needed
    var attr = {
        'name': 'New Name of Catalog Item - 123',
        'description': '<p>This is an updated description.</p><p> My description new line 1</p><p>My description new line 2</p>',
        'short_description': 'New Short Description of Catalog Item' 
    };
    catItem.update(attr, true);
    catItem.setImage('1b443cfa5f130100a9ad2572f2b47746', 'picture'); // sys_id of image from table db_image

## CatItem -- setTableName(Zeichenfolge tableName) {#ariaid-title18}

Definiert den Tabellennamen für dieses Katalogelement.
{#r_CatItem-setTableName_String__table_yzb_bpd_ns__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, die das Katalogelement \[sc_Cat_item\] erweitert. |
[Tabelle : 33. Parameter]

{#r_CatItem-setTableName_String__table_yzb_bpd_ns} {#r_CatItem-setTableName_String__table_zzb_bpd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 34. Rückgaben]

{#r_CatItem-setTableName_String__table_zzb_bpd_ns}  
Dieses Beispiel zeigt, wie der Name einer erweiterten Tabelle festgelegt wird.

    var catItem = new sn_sc.CatItem();
    catItem.setTableName("New_catalog_table");

## CatItem -- submitProducer (Objektwerte) {#ariaid-title19}

Erstellt einen Datensatz mit einem angegebenen ServicekatalogDatensatzersteller.
{#CI-submitProducer_O__table_gdj_y4n_crb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Werte | Objekt | Enthält die Feldwerte und den Datensatzersteller, die beim Erstellen des Datensatzes verwendet werden sollen. { "variables": {Object}, "sysparm_id": "String" } |
| Werte.Variablen | Objekt | Die Feldwerte, die für den neuen Datensatz festgelegt werden sollen. { "field": "String", "field": "String" } |
| Values.sysparm_ID | Zeichenfolge | SYS_ID des Datensatzerstellers, der aus der Tabelle „Datensatzersteller" \[sc_cat_item_producer\] verwendet werden soll. |
[Tabelle : 35. Parameter]

{#CI-submitProducer_O__table_gdj_y4n_crb} {#CI-submitProducer_O__table_hdj_y4n_crb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Enthält Informationen zum erstellten Datensatz. { "number": "String", "parent_id": "String", "parent_table": "String", "record": "String", "redirect_portal_url": "String", "redirect_to": "String", "redirect_url": "String", "sys_id": "String", "table": "String" } |
| \<Object\>.Nummer | Wert von Nummer Feld des erstellten Datensatzes. Datentyp: Zeichenfolge |
| \<Object\>.Parent_ID | SYS_ID des übergeordneten Datensatzes. Datentyp: Zeichenfolge |
| \<Object\>.Parent_table | Die übergeordnete Tabelle der Tabelle, in der der Datensatz erstellt wurde. Datentyp: Zeichenfolge |
| \<Object\>.Datensatz | XML des erstellten Datensatzes. Datentyp: Zeichenfolge |
| \<Object\>.Redirect_Portal_url | URL, zu der umgeleitet werden soll Serviceportal. Datentyp: Zeichenfolge |
| \<Object\>.Umleiten_an | Umleitungswert. Datentyp: Zeichenfolge |
| \<Object\>.Redirect_url | URL des erstellten Datensatzes. Datentyp: Zeichenfolge |
| \<Object\>.Sys_ID | SYS_ID des erstellten Datensatzes. Datentyp: Zeichenfolge |
| \<Object\>.Tabelle | Die Tabelle, in der der Datensatz erstellt wurde. Datentyp: Zeichenfolge |
[Tabelle : 36. Rückgaben]

{#CI-submitProducer_O__table_hdj_y4n_crb}  
In diesem Beispiel wird ein Incident mithilfe des Datensatzerstellers „Incident erstellen" erstellt.

    var catalogItem = new sn_sc.CatItem('3f1dd0320a0a0b99000a53f7604a2ef9');  //sys_id of the Create Incident record producer 
    var values = {
       "variables": {"urgency" : "2", "comments" : "Laptop is in a brick state"},
       "sysparm_id": "3f1dd0320a0a0b99000a53f7604a2ef9"
    }
    var targetRecordDetails = catalogItem.submitProducer(values);
    gs.info(JSON.stringify(targetRecordDetails, null, 3));

Ausgabe:

    {
       "sys_id": "133b2ee1875f30103a730f2d0ebb35f9",
       "number": "INC0010002",
       "parent_id": null,
       "record": "api/now/table/incident/133b2ee1875f30103a730f2d0ebb35f9",
       "redirect_portal_url": "",
       "parent_table": "task",
       "redirect_url": "incident.do?sys_id=133b2ee1875f30103a730f2d0ebb35f9&sysparm_view=ess",
       "table": "incident",
       "redirect_to": "generated_record"
    }

## CatItem -- Update(Object columnValues, boolescher Standard Update) {#ariaid-title20}

Aktualisiert die Werte für die angegebenen Felder eines Katalogelements.
{#r_CatItem-update_Object_Boolean__table_uv3_npd_ns__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ColumnValues | Objekt | Name-Wert-Paare der zu aktualisierenden Felder und der zugehörigen Werte. |
| Standardaktualisierung | Boolean | Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll. Gültige Werte: * Wahr: Aktivieren Sie die Ausführung von Engines und Workflows. * Falsch: Aktivieren Sie die Ausführung von Engines und Workflows nicht. {#r_CatItem-update_Object_Boolean__ul_rpk_xsp_kpb} |
[Tabelle : 37. Parameter]

{#r_CatItem-update_Object_Boolean__table_uv3_npd_ns} {#r_CatItem-update_Object_Boolean__table_vv3_npd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 38. Rückgaben]

{#r_CatItem-update_Object_Boolean__table_vv3_npd_ns}  
Dieses Beispiel aktualisiert den Namen, die Kurzbeschreibung und den Preis eines vorhandenen Katalogelements.

    var catItem = new sn_sc.CatItem("1fc0bd968777301093d5ec6d0ebb3548"); // sys_id of catalog item to update
    printCatalogItem(); // print current catalog item values
    // object containing fields to update
    var attr = {
        "name": "New Name of Catalog Item",
        "short_description": "New Short Description of Catalog Item", 
        "price": "450"
    };
    catItem.update(attr, true);
    printCatalogItem(); // print new catalog item values

    // prints the name, short description, and price of the catalog item
    function printCatalogItem(){
        // object containing fields to read
        var readValues = {
            "name" : "", 
            "short_description" : "", 
            "price" : ""
        };
        var values = catItem.read(readValues, true); // read the field values
        gs.info("Catalog item name: " + values.name);
        gs.info("Catalog item short description: " + values.short_description);
        gs.info("Catalog item price: " + values.price);
    }

Ausgabe:

    Catalog item name: Example Catalog Item
    Catalog item short description: Example Short Description
    Catalog item price: 300
    Catalog item name: New Name of Catalog Item
    Catalog item short description: New Short Description of Catalog Item
    Catalog item price: 450


