---
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


---

# Katalog-Client-Skripts

# Katalog-Client-Skripts {#ariaid-title1}

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

Clientseitige Skripts können Formularen dynamische Effekte und Validierungen hinzufügen. Skripts können auf Servicekatalogelemente oder Variablensätze angewendet werden, sodass Administratoren dieselbe Funktionalität verwenden können, die in anderen Formularen verfügbar ist.

Sie können clientseitige Skripts verwenden, um:

* Ruft Variablenwerte ab, oder legen Sie sie fest.
* Variablen ausblenden oder anzeigen.
* Variablen obligatorisch machen oder nicht.
* Validieren Sie die Formularübermittlung.
* Fügen Sie dem Einkaufswagen etwas hinzu.
* Bestellen Sie sofort etwas.
{#c_CatalogClientScriptCreation__ul_fs2_2c1_dq}

## Überlegungen zum Katalog-Client-Skript {#ariaid-title2}

Beachten Sie beim Erstellen von Katalog-Client-Skripts die folgenden Überlegungen.
* Katalog-Client-Skripts werden ausgeführt, wenn ein Anwender ein Element aus dem Servicekatalog bestellt. Katalog-Client-Skripts können auch ausgeführt werden, wenn Variablen oder Variablensätze für ein Katalogelement angezeigt werden, wenn ein Anwender dieses Element anfordert.
* Damit eine Variable über ein Katalog-Client-Skript zugänglich ist, muss sie einen Variablennamen haben. Variablen ohne Namen werden nicht in der Liste der verfügbaren Variablen angezeigt.
* Wenn Sie Standard-Client-Skripts für ein angefordertes Element oder ein Katalogaufgabenformular verwenden, notieren Sie sich Felder mit dem gleichen Namen wie Variablen. Wenn ein Tabellenfeld und eine Variable mit demselben Namen in einem Formular vorhanden sind, wird das Tabellenfeld abgeglichen, wenn mit einem Skript darauf zugegriffen wird. Wenn dies geschieht, adressieren Sie die Variable insbesondere, indem Sie sie benennen `Variables.Variablenname `. Beispiel: `g_form.setValue('variables.replacement', „falsch"); `
* Wenn Sie Datensatzersteller verwenden, um Variablen aus dem Servicekatalog an andere Datensatztypen zu übergeben, werden diese Variablen in diesen Datensätzen mit einem Variableneditor sichtbar gemacht, z. B. dem UI-Formatierer „Change-Variableneditor" in Change-Anforderungsformularen. Sie können diese Variablen mit standardmäßigen Client-Skriptmethoden bearbeiten, z. B. `SetAnzeige `, `Setobligatorisch `, `SetValue `, Und `GetValue `.
* Katalog-Client-Skripts können für Katalogelemente verwendet werden, die in einem Assistenten enthalten sind.
* Sie können verwenden `G_Form.refreshSlushbucket(fieldName) `API zum Aktualisieren einer Listensammlervariable.

## Unterschiede beim Katalog-Client-Skript {#ariaid-title3}

Katalog-Client-Skripts ähneln Standard-Client-Skripts sehr, mit einigen wichtigen Unterschieden.
* Anstatt eine Tabelle wie Incident für das Skript auszuwählen, wählen Sie ein Katalogelement oder einen Variablensatz aus. Da Ihr System möglicherweise eine große Anzahl von Katalogelementen hat, sollten Sie ein Katalogelement oder einen Variablensatz mithilfe eines Referenzfelds anstelle der Auswahlliste auswählen, die das standardmäßige Clientskript-Formular verwendet.
* Bei Verwendung von <var class="keyword varname">OnChange() </var>Katalog-Client-Skript. Es ist mit einer bestimmten Variable anstelle eines Felds verknüpft. Das System füllt die Auswahlliste für Variablennamen automatisch mit allen benannten Variablen aus dem ausgewählten Katalogelement oder Variablensatz aus.
{#r_CatalogClientScriptDifferences__ul_dvh_llb_jbb}

## Erstellen Sie ein Katalog-Client-Skript {#ariaid-title4}

Führen Sie dieses Verfahren aus, um ein Katalog-Client-Skript zu erstellen.

### Prozedur

1. Navigieren zu AlleServicekatalogKatalogverwaltungKatalog-Client-Skriptsan.  
   Eine Liste der aktuellen anwenderdefinierten Katalog-Client-Skripts wird angezeigt.
2. Klicken Sie auf Neu.
3. Füllen Sie die Felder nach Bedarf aus (siehe Tabelle).  
   {#create-catalog-client-script__table_bw1_3g1_dq__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Name | Geben Sie einen eindeutigen Namen für das Katalog-Client-Skript ein. |
   | Beschreibung | Wählen Sie den Elementtyp aus, für den dieses Client-Skript gilt: * Ein Katalogelement : Aktiviert das Feld „Katalogelement". * Ein Variablensatz : Aktiviert das Feld „Variablensatz". {#create-catalog-client-script__ul_nx1_3g1_dq} |
   | Aktiv | Aktivieren Sie das Kontrollkästchen, um das Client-Skript zu aktivieren. Deaktivieren Sie das Kontrollkästchen, um das Skript zu deaktivieren. |
   | UI-Typ | Gibt an, ob dies auf Desktop, Mobilgeräte oder beides angewendet werden soll. |
   | Skript | Geben Sie das Clientskript ein, das für das Servicekatalogelement ausgeführt werden soll. |
   | Typ | Wählen Sie aus, wann das Skript ausgeführt werden soll, z. B. ONLOAD Oder OnAbsenden . |
   | Katalogelement oder Variablensatz | Wählen Sie ein Katalogelement oder einen Variablensatz aus der Liste aus. Der Feldname und die verfügbaren Optionen hängen von der Auswahl in ab Gilt für Feld. |
   | Betrifft die Ansicht eines Katalogelements | Aktivieren Sie das Kontrollkästchen, um das Katalog-Client-Skript auf Katalogelemente anzuwenden, die auf dem Bestellbildschirm im Servicekatalog angezeigt werden. Verfügbar in der Ansicht „anfordernde Person". |
   | Betrifft angeforderte Artikel | Aktivieren Sie das Kontrollkästchen, um das Katalog-Client-Skript auf ein Formular „angefordertes Element" anzuwenden, nachdem das Element angefordert wurde. Verfügbar in der Erfüller-Ansicht. Siehe [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). |
   | Betrifft Katalogaufgaben | Aktivieren Sie das Kontrollkästchen, um das Katalog-Client-Skript anzuwenden, wenn ein Katalogaufgabenformular für das Element angezeigt wird. Verfügbar in der Erfüller-Ansicht. Siehe [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). |
   | Gilt für den Zieldatensatz | Aktivieren Sie das Kontrollkästchen, um die Katalog-UI-Richtlinie für einen Datensatz zu unterstützen, der über Datensatzersteller für aufgabenerweiterte Tabellen erstellt wurde. Siehe [Standardvariableneditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). |
   [ ]

   {#create-catalog-client-script__table_bw1_3g1_dq}
4. Klicken Sie auf Absenden.

## Beispiele für Katalog-Client-Skript {#ariaid-title5}

Beispiele für Client-Skripts zum Ausführen allgemeiner Aktionen.  

### Ruft den Wert einer Variablen ab

Verwenden Sie die folgende Syntax, um den Wert einer Katalogvariablen abzurufen. Beachten Sie, dass die Variable einen Namen haben muss. Ersetzen `Variablenname `Mit dem Namen der Variablen.

    g_form.getValue('variable_name');

### Beschränken Sie die Anzahl der Zeichen, die ein Anwender in eine Variable eingeben kann

Dies ist ein Beispiel für ein Skript, das ausgeführt wird, wenn die Variable angezeigt wird und nicht, wenn das Element bestellt wird.

    function onLoad(){
      var sd = g_form.getControl('short_description');
      sd.maxLength=80;
    }


